We constantly publish updates to our documentation, which may not yet be available in your language. For the most current information, use the English version.

for Developers

Set external device ID

Note:

If you want to use external device IDs, 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 a user isn't counted as multiple new installs.

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.

Check out our external device identifiers article for more information.

Before you start

Requirements

Android SDK v4.20.0 and later.

Guide

Tip:

You need to set your external device ID before initializing the Adjust SDK.

To set an external device ID, assign the identifier to the externalDeviceId property of your config instance. The external device ID is case-sensitive. If you have imported external device IDs, you need to make sure the value you pass matches the imported value.

Java

Javascript

AdjustConfig.setExternalDeviceId("YourExternalDeviceId");

If you want to use the external device ID in your business analytics, you can pass it as a session callback parameter. See our guide to session callback parameters for more information.

You can import existing external device IDs into Adjust. This ensures that the backend matches future data to your existing device records. If you want to do this, please contact your Adjust representative.