Test your callbacks

Before you launch your campaign, you should test your callback URLs to make sure they work as expected.

Before campaign launch

Adjust maintains a dedicated test link that you can use to test your callback URL. The cbtest link sends a simulated callback to your callback URL. You can use the following parameters to test your callback URL:

  • callback
  • install_callback
  • event_callback

Test a callback URL

  1. Replace the link token in your link with cbtest. For example: https://app.adjust.com/cbtest?install_callback=http%3A%2F%2Fmynetworkserver.com%2Fcallback.php%3Fparameter%3D{parameter}
  2. Select the cbtest link to trigger your callback. This link doesn't redirect you to the app store and doesn't require a test install. If your callback triggers successfully, you should see the following in your server logs:
callbackTest called: http://mynetworkserver.com/callback.php?parameter={parameter}

Test a conditional callback

If you want to test conditional callbacks with an event token, you must hardcode the event token value to be 41i3c9.

Error message

After campaign launch


Before your test a live link with the install_callback parameter, you need to make sure you are sending a new install to Adjust. To do this, ensure you do one of the following:

You can test your callback URLs using a live link and live app. To do this:

  1. Request a link from your client, and add your encoded install callback URL to it.
    • If you've integrated with Campaign Lab, then the campaign link contains the install callback URL.
  2. Select the encoded URL. You are redirected to the app store. As soon as you install and open the app, your callback is triggered. Adjust attributes your device to the campaign link when you install and open the app for the first time.
  3. Check that you received data according to the placeholders that you appended in the callback.

If you experience issues setting up your callback URL, contact integration@adjust.com.

Test attribution with the campaign link

Testing your campaign links ensures that you receive attribution information and that callbacks trigger as expected. To test your links, follow these steps:

  1. Uninstall the app from your device (if it's currently installed).
  2. Ask your client to remove your device's information from Adjust so that new attribution information is received.
  3. Download the Adjust Insights app and copy the advertising ID of your device.
  4. Add the device's advertising ID to the end of the campaign link (for deterministic matching) as seen below:
    • iOS: https://app.adjust.com/pthdmn2?idfa=AC336E89-3144-4CA3-A801-E90F38E9ADE2...
    • Android: https://app.adjust.com/pthdmn2?gps_adid=0d9ca8ff-e9ea-4941-a927-53851df0b304...

Dynamic partners must append the callback URL to the campaign link. For ad networks integrated with Adjust, you need to ask the advertiser to enable the network for their app in Adjust.

  1. Find a way to host your campaign link for testing. You can choose a method or tool that works best for you.
  2. Select the campaign link you want to test using the device you want to install the app on.
  3. Install the app from the relevant store. Launch it and trigger some events.
  4. Ask the advertiser to check the testing console to see if the install was recorded and attributed. Once confirmed, check to see if you have received the callback.
    • Dynamic integration: If you receive the install callback, this means the install was successfully recorded and attributed to you.
    • Ad network integrations: If you receive the install callback, this means the install was recorded. However, it doesn't confirm it was attributed to you. Ask the advertiser to confirm this in Adjust.
  5. The advertiser can check their data in Datascape.

Attribution information may take up to 30 minutes to appear in Adjust.