Whitelisting test devices

Whitelist devices to test SDK integration and interoperation between the app and AppsFlyer

Devices can be whitelisted for testing purposes enabling you to test that app installs are recorded in AppsFlyer. The reason whitelisting is needed is due to the AppsFlyer 90-day re-attribution policy. This means that AppsFlyer after recording the first app install ignores all additional installs for 90 days. During testing, you will use the same devices frequently and repeatedly. By whitelisting the device, all installs originating from the device are recognized. The installs will display inAppsFlyer.

Use one of the following methods to whitelist devices:

Using the AppsFlyer whitelisting app


Only the app owner (Advertiser) can use this method to whitelist devices

Using AppsFlyer device ID app, you can view the device ID and add the device to your AppsFlyer account whitelist. Devices in the whitelist are used for testing purposes. Note: The same whitelist is used by all apps in your account. The app allows you to share the device ID information.

  1. Download the app.
  2. After downloading the app, a screen displays.




  3. Tap Whitelist (for Android, tap Whitelist Device and then tap Whitelist in the next screen).

    When prompted, enter your AppsFlyer login credentials.
    The device is whitelisted as a test device in your AppsFlyer account.

  4. Tap Share to share the Device ID information using the system share dialogue.

Adding a device to the test device list in AppsFlyer

Note: Any team member can use this method to whitelist devices.

To add a device to the test device list in AppsFlyer:

  1. Log in to AppsFlyer.
    The list of apps displays.

  2. In the user name drop-down, click Test Devices.
    The Test Devices window opens.

  3. Click Add device.
    A new device row displays.
  4. Select the OS. 
  5. Fill in a Name to identify the device.
  6. Fill in the following depending on device type follows:
    • iOS: IDFA in upper case and with hyphens
    • Android: complete one or more of the following: AID, AndroidID, IMEI. See here.

      Download the AppsFlyer Device ID App, here.

      You can also use the method below:

      Finding Your IMEI
      Open your dialer and enter *#06#* using the keypad
      Finding Your Android ID
      Open your dialer and enter *#*#8255#*#* using the keypad
      Google Advertising ID
  7. Click Save.
    A green confirmation pop-up appears in the lower right-hand corner of the screen.
    The device is added to the list of whitelisted devices and remains in the list until deleted.
    Note: Only team members with admin rights can delete test devices.

  8. Once the device is added to the whitelist, generate a click to launch a newly installed app on the test device. In the AppsFlyer dashboard, an additional click and non-organic install will show in the dashboard.


  • Up to 40 devices can be whitelisted per account
Was this article helpful?
13 out of 24 found this helpful

Page Contents: