Campaign attribution fundamentals
Review attribution types, conversion types, and how attribution links work with Unity User Acquisition campaigns.
Read time 3 minutesLast updated 2 months ago
Attribution indicates whether a user installed your app after watching one of your ads and which ad network displayed the ad. This data confirms the number of installs and informs campaign models. You must pass attribution data to Unity to run a Unity User Acquisition campaign.
Attribution links
To accurately track installs and measure campaign performance, you need install postbacks called attribution links. These links verify, attribute, and timestamp app installs. The recommended best practice is to retrieve attribution links with a Mobile Measurement Partner (MMP). You can implement a custom integration with your app’s server to generate attribution links. However, Unity provides only limited support for issues that arise in the integration process. For detailed instructions on how to generate attribution links with your preferred attribution partner, refer to your MMP’s individual Partner integration documentation. To integrate these links with Unity in the User Acquisition dashboard, follow the instructions in Integrate attribution links with Unity. The following sections detail the data that attribution links pass to Unity.Attribution types
An attribution link type indicates how a user found your app. It also identifies which ad network served the ad. Refer to the following table for descriptions of these attribution types:Attribution type | Description | Notes |
|---|---|---|
| Unity-attributed | Users install your game after watching your ad on the Unity Ads network. | |
| Unattributed | Users install your game after watching your ad on another ad network. | Most MMPs don't pass unattributed data by default. The recommended best practice is to enable unattributed data because it enriches Unity's models and can improve campaign performance. |
| Organic | Users install your game without watching an ad. | Unity counts organic installs as Unattributed. |
Conversion types
Attribution links can track either ad clicks or ad views that lead to installs. While only click links are required to run a User Acquisition campaign, the recommended best practice is to use both click and start (view) links because it can help to expand your campaign's reach. Refer to the following table for descriptions of these conversion types and whether they're required with Unity:Conversion type | Description | Required | Notes |
|---|---|---|---|
| Click | Users installed your app after clicking on your ad. | Yes | Also known as click-through attribution |
| Start | Users installed your app after viewing your ad. | Recommended | Also known as view-through attribution |
App-level attribution links
If you create more than one campaign for an app, you can assign your attribution links as app-level links in the User Acquisition dashboard. App-level links automatically apply to all of your app's associated campaigns. By integrating your attribution links as app-level links, you can create multiple campaigns without individually entering individual attribution links for each campaign. You can also edit the links for all associated campaigns by editing just the app-level link. Refer to Integrate attribution links with Unity for step-by-step instructions for creating app-level links.Important
If you set an attribution link as app-level, the campaigns associated with that app will inherit the app-level link.
Attribution links tester
Testing your attribution links is an important step in your campaign setup and partner integration, as successful attribution is critical for correct reporting and campaign performance data. The Attribution Links Tester is a feature of Unity's Ad Testing app, which you can download from the Apple App Store for your iOS device, or from the Google Play Store for your Android device. The recommended best practice is to test your attribution links when you generate them with your MMP or send them with a custom server-to-server integration. Testing your links with the Attribution Links Tester does two important things:- Simulates a user installing the advertised game, and checks that Unity attributes the install correctly.
- Reduces your risk of failed attribution, incorrect reporting, misleading campaign performance data, and related issues.