External device identifiers
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.
An external device identifier is a case-sensitive, custom value that you can assign to a device or user. They can help you to recognize users across sessions and platforms. They can also help you to deduplicate installs by user so that the same user isn't counted multiple times.
You can also use an external device ID as a custom identifier for a device. This can be useful if you use these identifiers elsewhere and want to keep continuity.
You need to set your external device ID before you initialize the Adjust SDK. This is because the SDK sends this information at launch to create a device record. If the external device ID is not available until a user has logged in, it will not be available to the Adjust SDK at launch.
SDK requirements
- iOS, Android, Unity, Corona: v4.20.0
- Adobe AIR, Cordova, Xamarin, React Native, Flutter: v4.21.0
- Cocos-2dx: v4.22.0
- Titanium: v4.23.0
- Web: v5.1.0
Use cases
External device identifiers can be useful in the following scenarios:
- If you want to deduplicate installs by user so that the same user isn't counted as multiple new installs.
- If you currently use custom IDs for devices and you want to continue using these for reporting.
- If you want to be able to recognize users across different devices and platforms.
Importing external device identifiers
If you are moving to Adjust from a different system, you can import your external device IDs as part of your setup. Your Adjust representative can help you with importing this data. You can also check our migration guide for more information. When a logged in user then updates their app to a version containing the Adjust SDK, the external device ID will be available. This will allow you to continue recording users using your identifiers from day one.