# Tenjin

This is a multi-step guide for setting up your Digital Turbine campaign with Tenjin.

{% stepper %}
{% step %}

#### [Add Digital Turbine as a Channel](#add-digital-turbine-as-a-channel-1)

Set up Digital Turbine as a Channel on the Tenjin dashboard.
{% endstep %}

{% step %}

#### [Add a Campaign](#add-a-campaign-1)

Configure a campaign and generate tracking URLs.
{% endstep %}

{% step %}

#### [Configure Attribution and Postback Settings](#configure-attribution-and-postback-settings-1)

Set up event callbacks and define custom event settings.
{% endstep %}

{% step %}

#### [Configure Lookback Settings](#configure-lookback-settings-1)

Configure partner-specific lookback settings for attribution.
{% endstep %}
{% endstepper %}

## Add Digital Turbine as a Channel

To add Digital Turbine as a channel:

1. From the [Tenjin dashboard](https://dashboard.tenjin.com/login), go to **CONFIGURE→Channels**.

<div align="left" data-full-width="false" data-with-frame="true"><figure><img src="https://2566531741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNtLj6BGAMwZZCRHt4uCw%2Fuploads%2FxjfZQoJqkOURVZ6eRX6t%2Fimage%20(13).jpg?alt=media&#x26;token=6d5565ab-8a03-4ebe-a386-36587a2ca1db" alt=""><figcaption></figcaption></figure></div>

2. Click **Add a Channel**.\
   The **New Marketing Channel** page 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%2F4aX9GL5ZtUGybyKHlf7j%2Fimage%20(21).jpg?alt=media&#x26;token=10ffa23f-1bc4-4a5d-a31f-66367fbfd985" alt=""><figcaption></figcaption></figure></div>

3. Search for `Digital Turbine`, and click the tile for **Digital Turbine Media**.\
   The **Account Info** details appear.
4. Enter your Digital Turbine **Client Id** and **Client Secret** provided by your Digital Turbine representative.

<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%2F0uQexCvIe2QwrdLM57MA%2Fimage%20(15).jpg?alt=media&#x26;token=7c43a3f7-5692-461b-9c7e-030b264b2e7e" alt=""><figcaption></figcaption></figure></div>

5. Click **Add Ad Account**.

## Add a Campaign

To add a campaign:

1. From the Tenjin dashboard, go to **CONFIGURE→Campaigns**.\
   The **Campaigns** page 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%2FDNk4XMU2cLd0rzmZLoVP%2Fimage%20(12).jpg?alt=media&#x26;token=9d263ae3-3a00-44ee-96a0-77d342419e4e" alt="" width="524"><figcaption></figcaption></figure></div>

2. Click **Create Campaign**.\
   The **New Campaign** 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%2FVjnBeWSdUTK5ZdvSBlBk%2Fimage%20(19).jpg?alt=media&#x26;token=cab4fd4c-ff6d-49a0-911d-c0bc2d2cbb87" alt=""><figcaption></figcaption></figure></div>

<div align="left" data-with-frame="true"><img src="https://content.gitbook.com/content/NtLj6BGAMwZZCRHt4uCw/blobs/umNmD41piDIs3wZbQMfv/25488575541916" alt=""></div>

3. From the **MARKETING ACCOUNT** drop-down list, select **Digital Turbine Media Account**.
4. From the **APP** drop-down list, select your app.
5. In the **NAME** field, enter a name for the campaign.
6. Click **Create Campaign**.\
   The new campaign is added.&#x20;
7. On the **Campaigns** page, click the newly created campaign in the list of campaigns.\
   The **CAMPAIGN DETAILS** page appears.

<div align="left" data-with-frame="true"><img src="https://content.gitbook.com/content/NtLj6BGAMwZZCRHt4uCw/blobs/gEPMvEYQPr8ywVJwONEI/25488593096220" alt=""></div>

8. Copy the **Click Tracking URL** and **Impression Tracking URL** and send them to your Digital Turbine representative.

## Configure Attribution and Postback Settings

To configure attribution and postback settings:

1. From the **CAMPAIGN DETAILS** page, or the main menu, click your **App** name.\
   The **App** settings appear.

<div align="left" data-with-frame="true"><img src="https://content.gitbook.com/content/NtLj6BGAMwZZCRHt4uCw/blobs/ltQQmah4RDOd4WLQiZ8k/25488575542172" alt=""></div>

2. Go to **Callbacks**.

<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%2FiwA8e0LmdszmFPFlQd1o%2Fimage%20(16).jpg?alt=media&#x26;token=5f4f67b1-9eba-4a75-8eaa-8030c602aa32" alt=""><figcaption></figcaption></figure></div>

3. On the **Integrations** tab, click the **CHANNELS AND PARTNERS** from the drop-down list and then search for and select `Digital Turbine Media`.
4. Ensure that the **STATUS** toggle is **On** for the **First App Open** event (the Tenjin install event).
5. Ensure that the **USER FILTER** is set to **all users**.
6. To add custom DT events and map them to the respective Tenjin events, click **+ ADD EVENTS**.\
   The **Digital Turbine Media custom event** window appears.\
   For more information, see [DT event name](#dt-event-name).

<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%2F3nvM5vuU32E4yU4Az5bc%2Fimage%20(20).jpg?alt=media&#x26;token=2701486a-106a-483b-a4ef-0bfd78d7d3e6" alt=""><figcaption></figcaption></figure></div>

7. For each custom event, ensure that you have specified the following settings:

* From the **EVENT NAME** drop-down list, select a Tenjin event.
* Ensure that the **USER FILTER** is set to **all users**.
* Specify the standard DT event name that you want to associate with the selected Tenjin event.

<details>

<summary>DT 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:

* `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>

8. Click **Save**.

## Configure Lookback Settings

To set partner-specific lookback windows:

1. From the **Apps** window, go to the **Attribution** tab.\
   The default Tenjin lookback settings for the app appear.

<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%2FvWPw7R5kqDDt5XZLAzLf%2Fimage%20(17).jpg?alt=media&#x26;token=23f6df36-bab8-4723-9590-ea960e20ce9a" alt=""><figcaption></figcaption></figure></div>

2. Under **CHANNELS AND PARTNERS**, search for and select `Digital Turbine Media`.\
   The lookback settings for the **Digital Turbine Media** channel appear.

<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%2F9zXhrxwgJlkFldh6U0z2%2Fimage%20(18).jpg?alt=media&#x26;token=0d10d7f1-6199-42d9-98b9-6fd15aaa45b4" alt=""><figcaption></figcaption></figure></div>

3. Set the **Override App Settings** toggle to **On**.
4. Set **Device Matching** to `30 days`.
