Documentation

​
​

Development

User Acquisition

Monetization

Industry

User Acquisition

Advertising Management API

Advertising Statistics API

User Acquisition

User Acquisition
​
​
Getting started
  • User Acquisition attribution and data-sharing
Attribution
  • Campaign attribution
    • Campaign attribution fundamentals
    • Integrate attribution links with Unity
    • Test attribution links
    • Attribution link parameter reference
Data-sharing
  • App data-sharing
Custom server integration
  • Custom server-to-server integration
  1. Unity User Acquisition
  3. User Acquisition attribution and data-sharing

Test attribution links with the Ad Testing app

Test your attribution links the Unity Ads Ad Testing app to ensure functionality.
Read time 4 minutes
Last updated 2 months ago
Before you go live with a new campaign, use the Attribution Links Tester to ensure that your links function as expected. Use the following instructions to test your attribution link.

Prerequisites

There are several prerequisites to testing your attribution links. Review and ensure that 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 doesn't 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:
  1. Enable Ad Testing tracking.
  2. 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

  1. 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:
  2. Toggle the Allow Apps to Request to Track setting off.
  3. When prompted, select Ask Apps to Stop Tracking.
  4. Toggle the Allow Apps to Request to Track setting on again.

Enable Ad Testing on Android devices using Android 12 and later

  1. 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

  1. Select Settings > Google services > Ads, and disable the Opt out of Ads Personalization setting to ensure that Google can track your device across apps.
  2. 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:
  1. From the Unity User Acquisition dashboard, select the campaign you want to test and go to the Attribution links section.
  2. Select Test attribution link: Show QR code. This option is only available after you enter and save your attribution tracking links, and the campaign has at least one approved creative pack.
    The attribution link QR code button in campaign setup.
  3. In the Ad Testing app, select Scan QR, and allow the app to access your device's camera.
  4. Scan the QR code from the dashboard.
  5. Following the on-screen prompts to initialize the ad.
  6. Play the ad and select the ad's call to action to install the app on your device.
  7. Open the advertised app to give it time to send postbacks to the MMP. The MMP will then forward install postbacks to Unity.
  8. 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 mins. Tapping Check Install Postback Status on the Attribution Link Tester starts the first validation attempt. If the first attempt doesn't 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 Mobile Measurement Partner (MMP) requires more than 12 mins to return the install attribution data.
Important
Unity doesn't support testing for Android standalone campaign attribution links or cross-promotion campaign attribution links.
Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour Privacy Choices (Cookie Settings)

"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S and elsewhere (more info here). Other names or brands are trademarks of their respective owners.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.

  • On this page

    • Prerequisites

    • Enable Ad Testing tracking

      • Enable Ad Testing on iOS devices

      • Enable Ad Testing on Android devices using Android 12 and later

      • Enable Ad Testing on other Android devices

    • Use the Attribution Links Tester