Testing Console

Use the Testing Console to see test device data. Enter your advertising ID to review attribution data and check event activity. You can also "forget" your device. This clears your device data from Adjust, letting you run tests on the same device multiple times.

Before you begin

Here's what you need to know before getting started.

Requirements

  • Admin, Editor, or Custom Editor permissions
  • Advertising ID - IDFA (iOS) | IDFV (iOS) | ADID Google Advertising ID (Android) | Android ID (Android) | Open Anonymous Device Identifier (OAID - Android) | IMEI | Windows Advertising ID (Windows) | Fire Advertising ID (Kindle)
    • iPhones and iPads - Find your advertising ID with the Adjust Insights app for iOS. Download the app from the Apple App Store and open it to see your IDFA. You can select your IDFA to copy it to your clipboard or share it via the icon at the top right.
    • Android devices - Find your advertising ID with the Adjust Insights Android app. Download the app and open it. You can select your Google advertising identifier or Android identifier to copy it to your clipboard, or send it via email.
Tip:

To let Adjust attribute by device matching, append your advertising ID to the corresponding Adjust parameter in your link URL. If you do not, make sure that probabilistic modeling is turned ON.

  • iPhone example: https://app.adjust.com/abc123?idfa=XXXX-XXXX-XXXX-XXXX

  • Android example: https://app.adjust.com/abc123?gps_adid=XXXX-XXXX-XXXX-XXXX

Best practices for testing

Make note of the following points while:

Testing attribution

When testing attribution, you must wait at least 60 seconds between clicking the same link.

If you repeatedly click an Adjust link within one minute, we identify this as click spamming and reject the click.

Testing reattribution

When testing reattribution, wait at least 30 minutes between installing and reopening your app. This does not apply if you have configured your app for instant reattribution.

Testing event measurement

In-app events are only measured following an app install. If you clear your device between tests, reinstall your app before triggering an in-app event.

Testing with Facebook or Twitter campaign data

Facebook campaigns

For Facebook campaigns, your link token will always display as unattr and the link name as Unattributed. This ensures that Adjust supports end-user privacy and remains compliant.

Twitter campaigns

For Twitter campaigns, check whether you've signed the necessary T&C agreements. If you haven't, the Testing Console will display your link token as twinst and the link name as Twitter Installs.

Check device data

Before you use the Testing Cosole, make sure you use a mobile device that:

On your test device

  1. Click on your Adjust link.
  2. Download the latest app version with the Adjust SDK integrated.
  3. Open the app.
  4. (iOS apps) If the app asks for permission to track, select Allow.

In AppView

  1. Access the Testing Console from your app card or from the Data management tab of your app setup.
    • (Admin, Editor, or Custom Editor permissions only) To access the Testing Console from the app card, under AppView, select All apps. Find your app and select Testing Console.
    • To access the Testing Console from the Data management tab of your app setup, under AppView, select All apps. Select your app, and then select the Data management tab. Under Testing console, select Go to testing console.
  2. Enter the Advertising ID.
  3. Select View device data.

Available device data

When you request to view your device data, you can see the following fields. Expand the rows to see their available values and what they mean.

Identification information

Advertising ID

Example: 38400000-8cf0-11bd-b23e-10b96e40000d

ADID

The ADID is an internal Adjust ID.

Example: 18546f6171f67e29d1cb983322ad1329

App information

Last app version

Example: 4.3.2.1001

Last SDK version

Example: ios4.37.2

Last app version short

Example: 4.3.2

====

Last session time

Example: 2021-01-01T12:00:00Z

Environment

Available values: sandbox or production

Install state

Available values: Installed or Uninstalled or Reinstalled

Install state tells you whether a user has installed, uninstalled, or reinstalled the app.

Note: A user can have, for example, their State as Installed and their Install state as uninstalled.

Push token

Example: pushToken

Attribution information

State

Available values: Installed or Reattributed

State tells you if Adjust attributes the user to their install link or reattributes them to a later source.

Link

Example: abc123

Link name

Example: Organic

Click time

Example: 2021-01-01T12:00:00Z

Install time

Example: 2021-01-01T12:00:00Z

Last event times

Event name

Example: Accept terms

Event token

Example: kgecul

Last event time (UTC)

Example: 2021-01-01T12:00:00Z

SDK Signature information

Signature verification result

The Signature Verification Result fields let you see whether an install had a valid, invalid, or missing signature.

Available values: Valid signature or Invalid signature or Missing Signature

Signature acceptance status

Available values: Accepted or Rejected

The Signature Acceptance Status shows you whether your test install was Accepted or Rejected by SDK Signature.

Signature version

Available values: 2 or 3.

Secret ID

The Secret ID field returns one of the following values.

-1 (minus one): You will see “-1” if an install’s secret ID is invalid
(no value): You will see no value ( ) if there was no signature sent with the install
Secret ID: You will see the Secret ID from the install

Forget device

Adjust counts an install as the first app open from an unrecognized device. This means an install can only occur once per device. To test install or unique event measurement on the same device multiple times, you need to clear it from Adjust. This removes its advertising ID and activity history.

Use the Forget device option in the Testing console to clear your device data in Adjust on a per-app basis. This means you clear your device of all its previously measured activity for your app.

To clear your device from Adjust, follow these steps.

On your test device

Delete your app from the test device.

In AppView

  1. Access the Testing Console from your app card or from the Data management tab of your app setup.
    • (Admin, Editor, or Custom Editor permissions only) To access the Testing Console from the app card, under AppView, select All apps. Find your app and select Testing Console.
    • To access the Testing Console from the Data management tab of your app setup, under AppView, select All apps. Select your app, and then select the Data management tab. Under Testing console, select Go to testing console.
  2. Enter the Advertising ID.
  3. Select View device data.
  4. Select Forget device.