# Kochava

This guide provides detailed instructions for setting up and managing your Kachava campaigns by configuring Digital Turbine as a partner, setting up postbacks for installation events, defining lookback windows for attribution, and establishing cost tracking connections to track your campaign performance.

{% stepper %}
{% step %}

#### [**Create Campaign and Tracker**](#step1-campaign-tracker)

Set up a campaign and tracker in the Kochava console.
{% endstep %}

{% step %}

#### [Set up Partner Configuration](#step2-partner-config)

Configure Digital Turbine as a Kochava partner.
{% endstep %}

{% step %}

#### [Set Up Postbacks](#step3-install-postbacks)

Configure postbacks for events such as installations.
{% endstep %}

{% step %}

#### [Set Up Lookback Windows](#step4-lookback-windows)

Configure lookback windows for attribution.
{% endstep %}

{% step %}

#### [Set Up Cost Tracking](#step5-cost-tracking)

Configure cost tracking connections.
{% endstep %}
{% endstepper %}

## Create a Campaign and Tracker <a href="#step1-campaign-tracker" id="step1-campaign-tracker"></a>

To create a campaign and add a tracker:

1. From the [Kochava](https://console.kochava.com/) console, on the left panel, go to **Engagement→Campaign Manager**.

<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%2FDY9ptXdRnhRFy5ikLiI6%2F20737307104796?alt=media&#x26;token=e9469fa5-8449-4de6-bce7-b8f77ddc0a65" alt=""></div>

2. From the **Select App** dropdown list, select your app.\
   The **Campaign Manager** section for the app appears.
3. To add a campaign, in the **Campaign** column, click **+ Add**.\
   The **Add Campaign** window appears.

<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%2FmyYwLWBXTQCBw5LBmdRE%2F20737347333020?alt=media&#x26;token=d72c12ed-48b8-4bae-999f-416a426c3a94" alt=""></div>

4. Enter the **Name** and **Default Destination URL** and click **Add**.
5. To add a segment, in the **Segments** column, click **+ Add**.\
   The **Add Segment** window appears.

<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%2FDwXza96P7XLYWTWUPSNK%2F20737307105052?alt=media&#x26;token=f5699e04-6191-4a1b-96e0-a741f44c42af" alt=""></div>

6. Enter the **Name** and **Description** and click **Add**.

{% hint style="info" %}
In Kochava, trackers must be linked to both a campaign and a segment. This is automatically defaulted by the platform.
{% endhint %}

7. To add a Tracker, in the **Trackers** column, click **+ Add**.\
   The **Add Tracker** window appears.

<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%2F0zmmkBNHvt3vaMH2U7I9%2F20737347333148?alt=media&#x26;token=e7e74b1e-18b0-4a02-91ca-65a10c84008b" alt=""></div>

<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%2Fu1LAbgejSZikDioOoBos%2F20737347333532?alt=media&#x26;token=c3df4ad8-217a-4661-ac45-0f92f02c5225" alt=""></div>

8. Enter your tracker **Name**.

{% hint style="success" %}
Enter Digital Turbine here or follow your naming convention for trackers.
{% endhint %}

9. From the **Tracker Type** dropdown, select `Acquisition`.
10. From the **Media Partner** dropdown list, select one of the following:

{% tabs %}
{% tab title="Android" %}
**Digital Turbine – Android**
{% endtab %}

{% tab title="iOS" %}
**Digital Turbine – iOS**

{% hint style="info" %}
**Note**

iOS campaigns where probabilistic matching is desired require specific privacy settings:
{% endhint %}

1. Go to **Apps & Assets→Privacy Profiles**.\
   The **Privacy Profiles** section opens.

<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%2FMRV4gmoM8DtX4jOw5QAl%2F20737347333788?alt=media&#x26;token=286bb688-4fce-4d4d-91c8-23d95f7c5c3d" alt="2025-06-19_08-47-43.jpg"></div>

<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%2FMRV4gmoM8DtX4jOw5QAl%2F20737347333788?alt=media&#x26;token=286bb688-4fce-4d4d-91c8-23d95f7c5c3d" alt=""></div>

2. To add a privacy profile, click **Add a Profile,** or to edit a privacy profile, click **⋮** and then select **Edit**.\
   The privacy profile window appears.
3. Enter the **Name** and **Description** as required.

<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%2FCXrQXxHR4UBbvDl9VRVE%2F20737307105692?alt=media&#x26;token=93cda81e-30a2-4142-af12-ab88fd27e99b" alt=""></div>

4. In the **Settings** area, enable the **Collect** toggle for **User Agent**.
5. Set the **IP Address** and **User Agent** attribution to **Paid & Owned Media**.

<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%2F45iDgtAwumf1uXGi7joZ%2F20737347334428?alt=media&#x26;token=3d03be79-fec6-434c-8b57-056239c67f24" alt=""></div>

6. Click **Save**.

For more information, see [Kochava's Privacy Profiles](https://console.support.kochava.com/articles/create-manage-apps/32768-creating-and-editing-privacy-profiles/) or contact your Digital Turbine representative.
{% endtab %}
{% endtabs %}

11. Check the **SHARE WITH PUBLISHER** checkbox.
12. Leave **Destination URL** settings as default.
13. Click **Save & Create Postback**.
14. Copy the **Click URL** and **Impression URL** from the **Tracker** details panel and send them to your Digital Turbine representative.

<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%2FfjGkIjJ2of8kbOof6p9O%2F20737307106204?alt=media&#x26;token=2328c184-d5cb-4502-a9c4-88d6c29a7402" alt=""></div>

## Set Up Partner Configuration <a href="#step2-partner-config" id="step2-partner-config"></a>

To set up a partner configuration:

1. Go to **Apps & Assets→Partner Configuration**.
2. From the **Select App** dropdown list, select your app.
3. To add a Configuration, click **+ Add a Configuration**.\
   The **Add Configuration** window appears.

<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%2FB8JClGbyLBnMQUwhBbkm%2F20737307106588?alt=media&#x26;token=4914e856-d637-4acf-99e5-a9545b2e9388" alt=""></div>

4. From the **Media Partner** dropdown list, select one of the following:
   * **Digital Turbine – Android**
   * **Digital Turbine – iOS**
5. Click **Save**.\
   The added Partner appears.

## Set Up Postbacks <a href="#step3-install-postbacks" id="step3-install-postbacks"></a>

DT requires you to set up the following postbacks for the following events:

* SessionBegin
* Install
* Any event used for a KPI or optimization, for example, purchase, level reached, or first delivery.

DT recommends you set up postbacks for the following events:

* Any event used for secondary KPIs.
* Any event used for upper funnel metrics that are leading indicators of primary KPIs, for example, registration, tutorial complete, or add to cart.

To set up postbacks:

1. Go to **Apps & Assets→Partner Configuration**.
2. From the **Select App** dropdown list, select your app and then click the icon with two arrows ( ![](https://2566531741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNtLj6BGAMwZZCRHt4uCw%2Fuploads%2FNm99v4FbbHdI9nWFgzy9%2Fmceclip0.png?alt=media\&token=a3958fab-5a31-4d0a-aba5-d49c9eaa523a) ).\
   A list of postbacks appears.

<div align="left" data-with-frame="true"><figure><img src="https://2566531741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNtLj6BGAMwZZCRHt4uCw%2Fuploads%2FDWxGE4Sde10teVYpussH%2F2025-06-19_10-09-18.jpg?alt=media&#x26;token=e9ce9421-f6fa-4f34-b68b-0a84ff8c5542" alt=""><figcaption></figcaption></figure></div>

3. Select the required postback and click the **Edit** icon.\
   The **Edit Postback** window appears.

<div align="left" data-with-frame="true"><figure><img src="https://2566531741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNtLj6BGAMwZZCRHt4uCw%2Fuploads%2FOhyNSV818j8OHyT6HRek%2FScreenshot%202026-01-13%20120728.png?alt=media&#x26;token=ca398f83-b0f0-4d68-9464-22a52802a264" alt="" width="365"><figcaption></figcaption></figure></div>

{% hint style="success" %}
To add additional postbacks, see [Create an Event](https://console.support.kochava.com/articles/campaign-management/733-post-install-event-creation-and-configuration/#create-an-event) in Kochava's documentation.
{% endhint %}

4. In the **App Store ID** field, enter the app store identifier.\
   For Android apps, enter the bundle ID. For example, enter `com.games.myfungame`.\
   For iOS apps, enter the Apple App ID. For example, if your iOS App ID is `ID1234567890`, enter `1234567890`.

{% hint style="warning" %}
You must enter an **App Store ID** in order for DT to process the postback correctly.
{% endhint %}

5. If there is a ROAS target, toggle the **Send Revenue Value** option `ON` for events with a revenue value, such as, `purchase`, `adview`, or `checkout`.
6. In the **Event Name** field, enter a name for the postback event.

<details>

<summary>Digital Turbine Event Names</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:

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

You can add an arbitrary event name if there's no suitable name on this list for an event. However, make sure there are no spaces and special characters in it other than the underscore (*`_`*).

</details>

7. Configure the following settings as shown below.

| POSTBACK SETTING | VALUE               |
| ---------------- | ------------------- |
| Delivery Delay   | `Realtime Delivery` |
| Retry Attempts   | `3 Attempts`        |
| Delivery Method  | `All`               |

8. Ensure that the **Respect Data Controlled flag** option is toggled `OFF`.
9. Click **Save**.\
   The configured postbacks now appear below each app.
10. Repeat Steps 3-9 for each postback you want to configure.

## Set Up Lookback Windows <a href="#step4-lookback-windows" id="step4-lookback-windows"></a>

To set up lookback windows for proper attribution:

1. Go to **Apps & Assets→Partner Configuration**, click the ⋮ icon for your app, and select **Reconciliation**.\
   The **Reconciliation** window appears.

<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%2FG8jXnSDKrKIPVG8wCgrk%2F20737307107868?alt=media&#x26;token=3aceb772-a6f8-4dcc-ada3-6ab00a424d60" alt=""></div>

2. To customize the reconciliation settings, select the **Enable Customer Settings** checkbox.
3. Configure the settings as shown below and click **Apply Custom Settings**.

<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%2FwXuBvPWfTx5LyavYkCfC%2F20737307108252?alt=media&#x26;token=b6da5d43-4c3d-4204-8fc3-5d7aa0d0c67b" alt=""></div>

<table><thead><tr><th width="190.4383544921875">IMPRESSION PARAMETER</th><th width="114.3919677734375">VALUE</th><th>COMMENT</th></tr></thead><tbody><tr><td>Device Lookback</td><td>24 hours</td><td>Device Lookback determines how far back, from the time of install, to consider engagements for attribution on a standard device match.</td></tr><tr><td>Modeled Lookback</td><td>24 hours</td><td>Modeled Lookback determines how far back, from the time of install, to consider engagements for attribution on a Modeled-based match.</td></tr><tr><td>IP Lookback</td><td>Disabled</td><td>IP Lookback determines how far back, from the time of install, to consider engagements for attribution on an IP-based match.</td></tr><tr><td>Partial IP Lookback</td><td>Disabled</td><td>Partial IP Lookback determines how far back, from the time of install, to consider engagements for attribution on a Partial IP-based match.</td></tr><tr><td>Device Attribution Behavior</td><td>Standard</td><td>Device Attribution Behavior determines whether modeled matching will be attempted if a Device ID is present on click. The Standard setting will not attempt modeled attribution if a Device ID is present on click. The Inclusive setting will attempt modeled attribution on all clicks.</td></tr></tbody></table>

<table><thead><tr><th width="193.6383056640625">CLICK PARAMETER</th><th width="117.51678466796875">VALUE</th><th>COMMENT</th></tr></thead><tbody><tr><td>Device Lookback</td><td>30 days</td><td>Device Lookback determines how far back, from the time of install, to consider engagements for attribution on a standard device match.</td></tr><tr><td>Modeled Lookback</td><td>30 days</td><td>Modeled Lookback determines how far back, from the time of install, to consider engagements for attribution on a Modeled-based match.</td></tr><tr><td>IP and Partial IP Lookback</td><td>Disabled</td><td>IP and Partial IP Lookback determines how far back, from the time of install, to consider engagements for attribution on an IP or Partial IP based match.</td></tr><tr><td>Device Attribution Behavior</td><td>Standard</td><td>Device Attribution Behavior determines whether modeled matching will be attempted if a Device ID is present on click. The Standard setting will not attempt modeled attribution if a Device ID is present on click. The Inclusive setting will attempt modeled attribution on all clicks.</td></tr><tr><td>Modeled Attribution Tier</td><td>Standard</td><td>Modeled Attribution Tier determines the Modeled validation configuration. The Standard setting validates based on a combination of IP Address and User Agent. The Full IP Address setting validates based on the IP Address, regardless of the User Agent. The Partial IP Address setting validates based on the first three stanzas of the IP Address.</td></tr></tbody></table>

{% hint style="info" %}
For more information about specific settings, see [Partner Reconciliation Settings](https://console.support.kochava.com/articles/campaign-management/15961-partner-reconciliation-settings/) in Kochava's documentation.
{% endhint %}

## Set Up Cost Tracking <a href="#step5-cost-tracking" id="step5-cost-tracking"></a>

To set up cost tracking:

1. Go to **Cost→Configuration** and click **+ Add a Media Partner**.\
   The **New Media Partner** window appears.

<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%2F0wsLt4oouA8a7JxgC2kV%2F20737347338908?alt=media&#x26;token=2b3e1814-62f4-483c-a70b-8b4d69f36cfb" alt=""></div>

2. From the **Media Partner** dropdown list, select **Digital Turbine**.
3. Enter the required values as described below:

<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%2FiWGtJZVxyEiHyt8pAcMS%2F20737347339420?alt=media&#x26;token=6d1d1e87-1051-4b42-afbb-dc280fd59292" alt=""></div>

| PARAMETER                               | VALUE                                                                  |
| --------------------------------------- | ---------------------------------------------------------------------- |
| Configuration Name                      | The recommended value is `Digital Turbine`.                            |
| Client ID                               | Value provided by your Digital Turbine representative.                 |
| Client Secret                           | Value provided by your Digital Turbine representative.                 |
| Product                                 | <p><code>-dtgrowth</code><br>Product must be written in lowercase.</p> |
| Time Zone                               | Select the desired reporting timezone.                                 |
| Currency                                | Select the desired reporting currency.                                 |
| <p>Notifications<br>Add an email(s)</p> | For notifications regarding cost.                                      |

4. Enable the **Active** toggle.
5. Click **Save**.\
   The lookback windows are configured.