English

External device identifiers

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

An external device identifier is a 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.

Before you begin

Availability

Helpful information

  • External device identifiers are case-sensitive.
  • 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. If you are moving to Adjust from a different system, you can import your external device IDs as part of your setup. When a logged in user then updates their app to a version containing the Adjust SDK the external device ID will be available.

Use cases

External device identifiers can be useful in the following scenarios:

  1. If you want to deduplicate installs by user so that a user isn't counted as multiple new installs.
  2. If you currently use custom IDs for devices and you want to continue using these for reporting.
  3. 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. This will allow you to continue tracking users using your identifiers from day one.

Please see our migration guide for more information.

FAQs

Can I send external device IDs in S2S events?

Are external device identifiers available in CSV uploads and callbacks?