Test install recording

Installs are one of the most important things to record in your app. The Adjust SDK records an install when a user installs your app on their device. Adjust then attributes the install to the responsible campaign. You can use the Adjust testing console to verify install information and ensure you're receiving information properly before deploying to production.

There are two types of install you can test:

  • Organic – installs that occur without the user interacting with a campaign link
  • Non-organic – installs that occur when the user interacts with a campaign link
Important:
Make sure to set your SDK environment to Production after you finish testing. This ensures your app works in production mode.

Use these tools to test the SDK:

Organic installs

To test organic installs in your app:

  1. Follow the get started guide for your platform to integrate the Adjust SDK.
  2. Set the environment to sandbox. This ensures that your app only sends information to the testing console.
  3. Set your log level to verbose to capture all logging information from your app.
  4. Set up a test device or an emulated device and find the device's advertising ID. You can install the Adjust Insights app to find this information.
  5. If you've previously used the device for testing:
    1. Delete your app from the test device.
    2. Clear the device's advertising ID from the testing console. Follow the instructions for the Testing console in AppView.
    3. Alternatively, call the forget device endpoint to remove existing information about the device.
  6. Download and open the test version of your app that contains the Adjust SDK.
  7. Open the testing console and check the device's advertising ID status.

Non-organic installs

To test non-organic installs in your app:

  1. Follow the get started guide for your platform to integrate the Adjust SDK.

  2. Set the environment to sandbox. This ensures that your app only sends information to the testing console.

  3. Set your log level to verbose to capture all logging information from your app.

  4. Set up a test device or an emulated device and find the device's advertising ID. You can install the Adjust Insights app to find this information.

  5. If you've previously used the device for testing:

    1. Delete your app from the test device.
    2. Clear the device's advertising ID from the testing console. Follow the instructions for the Testing console in AppView.
    3. Alternatively, call the forget device endpoint
  6. Create a test tracker.

    1. If you want to test probabilistic modeling, enable Probablistic modeling for clicks at the app level or link level.
    2. If you want to test device ID matching, add your device advertising ID to your campaign URL:
    https://app.adjust.com/abc1234?idfa=test_device_id
    https://app.adjust.com/abc1234?gps_adid=test_device_id 
  7. Set up your test tracker in a web environment.

  8. Select your test tracker link on your test device.

  9. Download and open the test version of your app that contains the Adjust SDK.

Successful install

Testing console

Open the testing console and check the device's advertising ID status. If the install data is recorded successfully, an entry is shown for the device's advertising ID.

Device information in the Testing console in AppView.

1/2

IDE logging

Open the logging console in your IDE and look for events logged by Adjust. If the install is recorded successfully, the message Install tracked is loggd.

Unsuccessful install

If the install fails, nothing is recorded in the testing console. When you search for the device's advertising ID the message Advertising ID not found is shown in the console output.

Make sure you follow all steps in the Get started guide for your platform. Contact your Adjust representative or the support team if you're experiencing issues.