Configure external device ID

An external device identifier is a custom value that you can assign to a device or user. This helps you recognize users across sessions and platforms. External device IDs also help you deduplicate installs by user, to avoid counting multiple new installs associated with the same user.

Using external device IDs can produce different results depending on your setup. If you want to use them, contact your Adjust representative. They will talk you through the best approach for your use case.

You must set your external device ID in your AdjustAdobeExtensionConfig instance before you call AdjustAdobeExtension.setConfiguration. You can’t change this property after you’ve initialized the extension.

Reference

To set an external device ID, call the setExternalDeviceId method of your AdjustAdobeExtensionConfig instance with the following argument:

externalDeviceId: String: Your external device identifier.

Tutorial: Set an external device ID

To set an external device ID, you need to set the ID using your AdjustAdobeExtensionConfig instance. If you followed the integration guide, your MainApp.java file should look something like this:

1
import android.app.Application;
2
import android.util.Log;
3

4
import com.adjust.adobeextension.AdjustAdobeExtension;
5
import com.adjust.adobeextension.AdjustAdobeExtensionConfig;
6
import com.adobe.marketing.mobile.AdobeCallback;
7
import com.adobe.marketing.mobile.Extension;
8
import com.adobe.marketing.mobile.Analytics;
9
import com.adobe.marketing.mobile.Identity;
10
import com.adobe.marketing.mobile.LoggingMode;
11
import com.adobe.marketing.mobile.MobileCore;
12

13
public class MainApp extends Application {
14
   @Override
15
   public void onCreate() {
16
      super.onCreate();
17

18
      MobileCore.setApplication(this);
19
      MobileCore.setLogLevel(LoggingMode.VERBOSE);
20

21
      try {
22
         MobileCore.configureWithAppID("your_adobe_app_id");
23

24
         AdjustAdobeExtensionConfig config =
25
               new AdjustAdobeExtensionConfig(AdjustAdobeExtensionConfig.ENVIRONMENT_SANDBOX);
26
         AdjustAdobeExtension.setConfiguration(config);
27
      } catch (Exception e) {
28
         Log.e("example", "Exception occurred during configuration: " + e.getMessage());
29
      }
30

31
      try {
32
         List<Class<? extends Extension>> extensions = Arrays.asList(
33
               Analytics.EXTENSION,
34
               Identity.EXTENSION,
35
               AdjustAdobeExtension.EXTENSION);
36
         MobileCore.registerExtensions(extensions, new AdobeCallback<Object>() {
37
            @Override
38
            public void call(Object o) {
39
               Log.d("example", "Adjust Adobe Extension SDK initialized");
40
            }
41
         });
42
      } catch (Exception e) {
43
         Log.e("example", "Exception occurred while registering Extension: " + e.getMessage());
44
      }
45
   }
46
}

To set a default link token for preinstalled apps, pass the link token to the setExternalDeviceId method of the AdjustAdobeExtensionConfig instance. The ID is sent to Adjust with each session.

In this example, the external device ID is set to 1a42b171-faa5-46da-b5ae-6f4be6d05167.

21
try {
22
   MobileCore.configureWithAppID("your_adobe_app_id");
23

24
   AdjustAdobeExtensionConfig config =
25
         new AdjustAdobeExtensionConfig(AdjustAdobeExtensionConfig.ENVIRONMENT_SANDBOX);
26
   config.setExternalDeviceId("1a42b171-faa5-46da-b5ae-6f4be6d05167");
27
   AdjustAdobeExtension.setConfiguration(config);
28
} catch (Exception e) {
29
   Log.e("example", "Exception occurred during configuration: " + e.getMessage());
30
}