# AppsFlyer

This guide helps you add Digital Turbine as an integrated partner with AppsFlyer, set up event postbacks, create tracking links, establish cost integration, and utilize the AppsFlyer Audiences tool to manage suppression lists.

{% hint style="info" %}
Some of the features described in the steps below require an active **AppsFlyer ROI360 Advanced** subscription to access.
{% endhint %}

{% stepper %}
{% step %}

#### [Configure Digital Turbine as an Integrated Partner](#step1-dt-partner)

Configure Digital Turbine as an Integrated Partner on the AppsFlyer dashboard.
{% endstep %}

{% step %}

#### [Configure Event Postbacks](#step2-postbacks)

Configure event postbacks on the AppsFlyer Dashboard.

{% hint style="info" %}
Sharing ad revenue data as a postback is available only with an active **ROI360 Advanced** subscription.
{% endhint %}
{% endstep %}

{% step %}

#### [Create a Tracking Link](#step3-tracking-link)

Create an tracking links for Digital Turbine clicks and impressions.
{% endstep %}

{% step %}

#### [Enable Cost Tracking](#step4-cost-tracking)

Set up cost integration between Digital Turbine and AppsFlyer.

{% hint style="info" %}
Cost aggregation data is available only with an active **ROI360 Advanced** subscription.
{% endhint %}
{% endstep %}

{% step %}

#### [Set Up a Suppression List with Audiences](#step5-audiences)

Using the AppsFlyer **Audiences** tool, set up a suppression list.
{% endstep %}
{% endstepper %}

## Configure Digital Turbine as an Integrated Partner <a href="#step1-dt-partner" id="step1-dt-partner"></a>

1. On the AppsFlyer dashboard, navigate to **My Apps**.
2. From the left panel, navigate to **Collaborate→Integrated Partners**.
3. Select the required app from the **App** dropdown list.
4. Search for **Digital Turbine** in the search field and select the required **Digital Turbine** partner from the results.

<div align="left" data-with-frame="true"><img src="https://2566531741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNtLj6BGAMwZZCRHt4uCw%2Fuploads%2FEhvIv016eo0BvsczJqN9%2F23610909881884?alt=media&#x26;token=81bc51ba-e211-4021-bd86-2c4392215942" alt=""></div>

5. In the **Integration** tab, click **Activate Partner** and enable the **Share organic/non-organic indication** toggle in the **General Settings** area.

<div align="left" data-with-frame="true"><img src="https://2566531741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNtLj6BGAMwZZCRHt4uCw%2Fuploads%2F4EtmHo0drFHKo5u7QKju%2F23610926615196?alt=media&#x26;token=62780597-7bfa-4b56-a43a-98a434380d4d" alt=""></div>

6. Select the appropriate tab to continue with platform-specific requirements.

{% tabs %}
{% tab title="Android" %}
{% hint style="info" %}
AppsFlyer enables preload attribution by default to ensure accurate tracking when an app is installed directly on a device.
{% endhint %}

* Keep the **Preload Attribution** toggle enabled.
* Set the **Preload lookback window** to at least *90 days* (AppsFlyer's recommended default).

{% hint style="success" %}
To prevent attribution loss post successful app preload, consider extending the lookback window to up to *180* days.
{% endhint %}

<div align="left" data-with-frame="true"><img src="https://2566531741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNtLj6BGAMwZZCRHt4uCw%2Fuploads%2FOmUmMKfu54yrySt5eyyj%2FpreloadAttribution.jpg?alt=media&#x26;token=96185942-bfa7-49ac-91dd-ae79c7756f33" alt=""></div>

{% hint style="warning" %}

* Preload Attribution requires AppsFlyer SDK 6.8.0 and later
* Preload Attribution is applicable for on-device inventory only.
* Enabling Preload Attribution gives Digital Turbine longer lookback window options, deterministic matching without a device ID, and preload attribution priority for Digital Turbine above other ad engagements (impressions and clicks). Credit goes to Digital Turbine because the app is installed directly on the device as opposed to redirecting to the Store.
* Ensure that **Preload equal attribution priority** toggle is off.
  {% endhint %}
  {% endtab %}

{% tab title="iOS" %}

* Turn off the **Enable** **Advanced Privacy** toggle.\
  For more information, see [Advanced Privacy](https://support.appsflyer.com/hc/en-us/articles/360011316197-Advanced-Privacy-guide-postback-macros-for-ad-networks).\
  This is required for probabilistic matching to be enabled.

<div align="left" data-with-frame="true"><img src="https://2566531741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNtLj6BGAMwZZCRHt4uCw%2Fuploads%2FBwIPDO6QtP6drSyR3Zcw%2F23610926615836?alt=media&#x26;token=c1179c24-5d28-4a8a-a256-c983048f4a96" alt=""></div>
{% endtab %}
{% endtabs %}

7. Enable the **Install View-Through Attribution** toggle.

<div align="left" data-with-frame="true"><img src="https://2566531741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNtLj6BGAMwZZCRHt4uCw%2Fuploads%2Fq2C0450yMwf9OgPRYfaM%2F23610926616348?alt=media&#x26;token=995b165e-5242-44ca-83c8-4e1945d21693" alt=""></div>

8. Enable the **In-app event postbacks** toggle and set the **In-app events Postback window** to **Lifetime**.

<div align="left" data-with-frame="true"><img src="https://2566531741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNtLj6BGAMwZZCRHt4uCw%2Fuploads%2FtUrStQkm7T4qtWu34qof%2F23610926616604?alt=media&#x26;token=f2258e94-890b-43d9-965b-ae6f4abe1aa8" alt=""></div>

{% hint style="info" %}
Partner integration automatically triggers default postbacks for user actions that occur before the app launch—such as installs, rejected installs, and re-engagements.
{% endhint %}

## Configure Event Postbacks <a href="#step2-postbacks" id="step2-postbacks"></a>

{% hint style="info" %}
Sharing ad revenue data is available only with an **ROI360 Advanced** subscription.
{% endhint %}

1. In the **In-app event postbacks** area, click **Add event**.
2. Select the required events and map it to the corresponding [partner events](#partner-events).
3. To share ad revenue data, add the `af_ad_revenue` postback event and map it to the partner identifier.

<div align="left" data-with-frame="true"><img src="https://2566531741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNtLj6BGAMwZZCRHt4uCw%2Fuploads%2FW21CWXSHxXQowoxg1D8W%2F23610926618780?alt=media&#x26;token=91a5a572-89b6-40f7-8d7c-8aff4de1c7ed" alt=""></div>

<details>

<summary>Partner Events</summary>

Digital Turbine machine learning algorithms rely on standard event names to improve ad targeting, optimization, measurement, and insights.

For best results, use these names for event mapping:

* `af_ad_revenue`
* `app_open`
* `purchase`
* `level_achieved`
* `ad_click`
* `ad_view`
* `login`
* `add_payment_info`
* `add_to_cart`
* `add_to_wishlist`
* `checkout_initiated`
* `complete_registration`
* `complete_tutorial`
* `reservation`
* `update`
* `subscribe`
* `search`
* `view_content`
* `credits_spent`
* `achievement_unlocked`
* `app_rated`
* `tutorial_complete`
* `social_share`

If there's no suitable name on this list for an event, you can add an arbitrary event name. Use custom names without spaces or special characters other than the underscore ( \_ ).

</details>

4. For all designated events, including `af_ad_revenue`, select:

* **All media sources, including organic** from the **for users from** dropdown list.
* **Values & revenue** from the **including** dropdown list.

5. Click **Save Integration**.

## Create a Tracking Link <a href="#step3-tracking-link" id="step3-tracking-link"></a>

1. Under the **Attribution Link** tab, ensure that **Single-platform link** is selected.

{% hint style="info" %}
Digital Turbine does not support **OneLink**.
{% endhint %}

2. Configure the following attribution windows:

* **Click-through window:** 30 days
* **View-through window:** 24 hours

<div align="left" data-with-frame="true"><img src="https://2566531741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNtLj6BGAMwZZCRHt4uCw%2Fuploads%2FUENqznMP7hPJxHGIgP0o%2F23610909884060?alt=media&#x26;token=27d75988-0f6d-483a-a3e1-aaf2fe248c61" alt=""></div>

3. Click **Save Attribution Link**.
4. Copy and send the two links to your Digital Turbine representative.

## Enable Cost Tracking <a href="#step4-cost-tracking" id="step4-cost-tracking"></a>

{% hint style="info" %}
Cost aggregation data is available only with an **ROI360 Advanced** subscription.
{% endhint %}

This section guides you through setting up cost integration between Digital Turbine and AppsFlyer.

1. Navigate to **Configuration→Active Integrations** and open the **Cost** tab.

<div align="left" data-with-frame="true"><img src="https://2566531741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNtLj6BGAMwZZCRHt4uCw%2Fuploads%2F4ybcdiH3c5vQmMywLDfg%2F13479241033756?alt=media&#x26;token=c3dc2dda-1f80-440e-bc60-2b244487966a" alt=""></div>

2. Enable the **Get cost data** toggle and click **Save Cost**.

<div align="left" data-with-frame="true"><img src="https://2566531741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNtLj6BGAMwZZCRHt4uCw%2Fuploads%2FqPtpv5yaivyaj52zJO0i%2Fcost.png?alt=media&#x26;token=f8445d3d-9f8a-44fc-8203-962d1c5b608a" alt=""></div>

{% hint style="info" %}
If you are using another MMP for cost tracking or an alternate cost reporting method, leave this toggle off to avoid data discrepancies.
{% endhint %}

3. Under the **Permissions** tab, enable the **Ad network permissions** to allow the ad network to view your app's traffic in their dashboard.
4. To share ad revenue data, enable the **Access ad revenue raw data** checkbox.
5. In the **Sending option** area, select **All media sources, including organic** as a sending option, including, `af_ad_revenue`.
6. Click **Save Permissions**.
7. Notify the ad network that you granted permission to access cost and ad revenue data.

<div align="left" data-with-frame="true"><img src="https://2566531741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNtLj6BGAMwZZCRHt4uCw%2Fuploads%2FgB4l86x13sLQHaO9RvB3%2F13344337598236?alt=media&#x26;token=4981cb0d-a753-43b6-b6bb-f3346da4586f" alt=""></div>

{% hint style="success" %}
We also recommend granting the following permissions to better optimize campaigns and assist in troubleshooting any issues that arise:
{% endhint %}

<div align="left" data-with-frame="true"><img src="https://2566531741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNtLj6BGAMwZZCRHt4uCw%2Fuploads%2FwX55Eviw9g8c90gHblRH%2F14285398122012?alt=media&#x26;token=48b116fc-8ddc-4ab5-be8d-3c5033972ee7" alt=""></div>

## Set Up a Suppression List With Audiences <a href="#step5-audiences" id="step5-audiences"></a>

{% hint style="info" %}
Digital Turbine requires suppression lists of existing devices through historical audience lists and real-time unattributed install postbacks (set up in a previous section). This section explains how to set up historical audience lists for suppression through AppsFlyer’s **Audiences** tool and only applies if you have this enabled on your AppsFlyer account.
{% endhint %}

1. Add an audience by following the steps outlined in [AppsFlyer's support documentation](https://support.appsflyer.com/hc/en-us/articles/115002689186-Audiences-guide#get-started).
2. Go to **Engage→Audiences→Connections**.
3. Click **+ New connection**.

{% hint style="info" %}
If you are creating a new partner connection from within the Audience Builder, click on **+ Add partner connection** within the **Manage audience connections** window.
{% endhint %}

4. Select **Appreciate** from the **Partner name** dropdown list.
5. Enter **Digital Turbine** in the **Connection name** field.

<div align="left" data-with-frame="true"><img src="https://2566531741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNtLj6BGAMwZZCRHt4uCw%2Fuploads%2F21uExFgZRz43xXrNfM7O%2F23610926619292?alt=media&#x26;token=1de89f66-1310-42b7-9ff5-7af8df03cc97" alt="" width="563"></div>

6. Enter the **Your** **buyer ID** and **API key** values in the partner connection. Your Digital Turbine representative will provide these values to you.

<div align="left" data-with-frame="true"><img src="https://2566531741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNtLj6BGAMwZZCRHt4uCw%2Fuploads%2FOttoXh90MJVh7wwuy9CY%2F23610909885084?alt=media&#x26;token=75e2cd75-9831-4af1-99f7-f4e23ce41f79" alt="" width="563"></div>

7. Select **GAID** and **IDFA** as the user identifiers that you authorize for sharing with this partner, then click **Save**