Test attribution tracking links with the Ad Testing app
Before you go live with a new campaign, use the Attribution Links Tester to ensure that your links are properly configured. Use the following instructions to test your attribution link.
Prerequisites
There are several prerequisites to testing your attribution links. Please review and ensure you meet the following requirements:
| Prerequisite | Details | Notes |
|---|---|---|
| Install the Ad Testing app | To download and install the Ad Testing app, go to its Apple App Store or Google Play page. You can also search “Ad Testing” in the app store. | Ensure that you install version 2.4.1 or higher for iOS, and version 2.4.0 or higher for Android. |
| Add at least one creative pack | Include at least one approved creative pack in the campaign you’re testing. Without an approved creative pack, the Attribution Link Tester won’t work. | |
| Assign a campaign budget | Set the campaign budget for the campaign you’re testing. Without a budget, the Attribution Link Tester will not work. | |
| Use a device without the test app previously installed | Use a device that does not already have the test app installed. If the device already has the app installed, it will disrupt the test flow and prevent attribution link validation. |
Testing your attribution links involves the following tasks:
- Enable Ad Testing tracking.
- Use the Attribution Links Tester.
Enable Ad Testing tracking
When you open the Ad Testing app, it will prompt you to allow tracking. Alternatively, you can access the data tracking permission in your device’s settings.
Enable Ad Testing to request permission to track data across apps on your device. When you open the Ad Testing app, it will prompt you to allow tracking. Alternatively, you can access the data tracking permission in your device’s settings.
Enable Ad Testing on iOS devices
- Go to Settings > Privacy > Allow Apps to Request to Track and enable the setting. If this setting was already enabled, you must reset your device’s Identifier for Advertisers (IDFA). To reset the IDFA, do the following:
- Toggle the Allow Apps to Request to Track setting off.
- When prompted, select Ask Apps to Stop Tracking.
- Toggle the Allow Apps to Request to Track setting on again.
Enable Ad Testing on Android devices using Android 12 and later
Go to Settings > Google services > Ads, and select Get new advertising ID to confirm that Google can track your device across apps.
Note: If Delete advertising ID displays instead, it means the device has opted-in to ads personalization.
From the ads settings screen, select Reset advertising ID and confirm that you want to reset your Android Advertising ID.
Enable Ad Testing on other Android devices
- Select Settings > Google services > Ads, and disable the Opt out of Ads Personalization setting to ensure that Google can track your device across apps.
- From the ads settings screen, select Reset advertising ID and confirm that you want to reset your Android Advertising ID.
Use the Attribution Links Tester
Do the following to test your attribution tracking links:
- From the Unity Ads User Acquisition dashboard, select the campaign you want to test and go to the Attribution links section.
- Select Test attribution link: Show QR code. This option is only available after you’ve entered and saved your attribution tracking links, and the campaign has at least one approved creative pack.
- In the Ad Testing app, click Scan QR, and allow the app to access your device’s camera.
- Scan the QR code from the dashboard.
- Following the on-screen prompts to initialize the ad.
- Play the ad and select the ad’s call to action to install the app on your device.
- Open the advertised app to give it time to send postbacks to the MMP. The MMP will then forward install postbacks to Unity.
- Return to the test app and select Check Install Postback Status.
Note: It might take a few minutes before Unity receives install postbacks from MMPs. Unity supports a validation period of up to 12 minutes. Tapping Check Install Postback Status on the Attribution Link Tester initiates the first validation attempt. If the first attempt does not yield a positive result, wait a few minutes and try again. If additional attempts continue to fail, the attribution links are either not correct, or the MMP requires more than 12 minutes to return the install attribution data.
Important: Unity doesn't support testing for Android standalone campaign attribution links or cross-promotion campaign attribution links.