# Singular

This guide helps you to set up and manage Digital Turbine campaigns within Singular. Use this guide to configure event postbacks, create tracking links for both Android and iOS platforms, and optionally set up cost tracking connectors to monitor the performance of your Singular campaigns.

{% stepper %}
{% step %}

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

Set up event postbacks for a campaign.
{% endstep %}

{% step %}

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

Create a tracking link for Android and/or iOS apps and designate fallback sites.
{% endstep %}

{% step %}

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

Set up cost tracking connectors. This step is optional.
{% endstep %}
{% endstepper %}

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

By default, Singular sends install postbacks for the configured campaign.

In addition, postbacks for any other events (for example, post-install events) can be sent by configuring the settings for the app at the Partner Configuration page.

Complete the following steps to set up event postbacks:

1. Go to **Attribution→Partner Configuration**.

<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%2FymZ7VxWYVGksaS0rJ83j%2F16022206182556?alt=media&#x26;token=7fae8cba-327e-4a64-aa76-1643b57a5dd8" alt=""></div>

2. In the search field at the top right, start typing *Digital Turbine Media* (or click **+Add Partner** and search).
3. Click **+Add App Site**.

<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%2Fnzesj0YTH7rTW6xqVr7g%2F13956996814108?alt=media&#x26;token=95565df5-7000-4cc2-ae8e-5d2f3540b309" alt=""></div>

{% hint style="info" %}
To edit an existing configuration, hover over a line and click the pencil icon on the right side.
{% endhint %}

4. Select the App Site.

<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%2FLeukVgCnYSD0EYynWHeD%2F13958464011548?alt=media&#x26;token=5c1f1db3-8b63-4f90-8b61-d14e741e0de7" alt=""></div>

5. Check the boxes for:

* **Send View-Through Postbacks**. This will let Digital Turbine receive conversion postbacks tied to impressions.
* **Send Fraud Postbacks**. This will let Digital Turbine be aware of any installs blocked by fraud algorithms for troubleshooting purposes.
* **Send all**. This will let Digital Turbine receive unattributed install postbacks for optimization purposes.

6. Set the **Click-Through Window** for attribution lookback to *30 days*.

{% hint style="warning" %}
Digital Turbine requires a 30-day attribution window.
{% endhint %}

7. Set **View-Through Window** to *24 hours*.
8. On the **In-App Event Postbacks** tab, click **+ Add a new event**.

<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%2FvJXz6p76VQKmQjrtydAV%2F13958464025244?alt=media&#x26;token=c50125b9-c286-4dce-a900-6fea17463198" 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%2Fy7yKysnSIHfU8fXDweNu%2F14281456500892?alt=media&#x26;token=58d255a2-9bea-431b-bee5-136eff7ed6b7" alt=""></div>

{% hint style="info" %}
If the **Event Name** field is not showing, delete the event using the ✗ (cross) icon and recreate a new one using the + (plus) icon.
{% endhint %}

9. In the first column, select the in-app **SDK Event Name** as sent from the app to Singular’s attribution service.
10. Next, add the [Event Name](#event-names).

<details>

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

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

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

</details>

9. Set the **Lookback** for the event. We recommend selecting `None` as that will ensure we receive all event postbacks to reduce discrepancies.
10. If the event includes a value that you want to deliver to Digital Turbine (for example, in-app purchase includes a revenue value), check the **Include Revenue** checkbox.
11. Click the plus (+) icon and repeat the process until all events are added.
12. Click **Save** when finished.

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

Singular offers the ability to configure one link for Android and/or iOS. You can configure one or both and the link will redirect based on the operating system of the device engaging with the link. Alternatively, it will send the user to a designated fallback destination that you provide.

1. In the left navigation menu, click **Attribution→Manage Links**.
2. Start typing the name of your app in the search bar and select it.

<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%2FYhxYnWdMioeO2Ez3zBPF%2F13958464035228?alt=media&#x26;token=b2a950b3-fe5a-4680-8bea-db0085c13be0" alt=""></div>

3. Click **Create Link**.

<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%2FsO33YxgUO36fbtg7WLc9%2F13958502927900?alt=media&#x26;token=604b65ca-8739-4cf7-aeb0-0adc178a1e57" alt=""></div>

4. In the section that opens, for **Link Type** select `Partner`.

<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%2Fmr2Hgz3NN3vLZgWTBME1%2F13993868953372?alt=media&#x26;token=d3c1be5a-229d-4446-9bca-e025c69d2720" alt=""></div>

5. For **Source Name**, select `Digital Turbine Media`.
6. Enter an arbitrary **Tracking Link Name**.
7. Click on **Link Settings and Redirects**.

<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%2FX3P2EzxyLAuiS3zZdQtO%2F13993868956444?alt=media&#x26;token=7048e837-6e2e-4d90-8e63-21ce7e70abf4" alt=""></div>

8. Select the **Link Sub-Domain**.
9. Complete the next steps depending on the platform.

{% tabs %}
{% tab title="Android" %}

* Check the **Enable Android Tracking** checkbox.
* The value of **Site** drop-down gets populated automatically.

<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%2FcQbAjoE0GlkH6k1NYA25%2F13993854330140?alt=media&#x26;token=5c52bd86-1217-46e5-b5bc-7cda9efee22d" alt=""></div>
{% endtab %}

{% tab title="iOS" %}

* Check the **Enable iOS tracking** checkbox.
* Check the **Enable Probabilistic Attribution** checkbox.
* The value of **Site** gets populated automatically.

<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%2FBnJ54kM0eGcRwjkSfb1k%2F13993854319772?alt=media&#x26;token=e041a28b-8734-4897-8723-764336ee2478" alt=""></div>

* In the **If the app is not installed go to:** drop-down, select a URL.
* Optionally, in the **If the app is already installed go to (deeplink):** drop-down, add the deferred deeplink destination.

<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%2FTTwtdfFsFDWK2F3bNA3a%2F13993854324636?alt=media&#x26;token=5c2f879e-a8fa-42b9-b048-15737466f761" alt=""><figcaption></figcaption></figure></div>
{% endtab %}
{% endtabs %}

10. In **Fallback Destination for Other Platforms**, set a web page for non-Android and non-iOS users to be redirected to.

<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%2FCM3whltGmwuixA4MpluV%2F13993868995100?alt=media&#x26;token=40eb37ec-4024-4fa9-bd73-716774d3f8c4" alt=""></div>

{% hint style="info" %}
Attribution Settings are not required unless you want to change the partner lookback settings (for this link only) OR to enable re-engagement tracking for the link.
{% endhint %}

11. Click **Generate**. A new item, **Link Summary**, will appear.
12. Click on **Link Summary** to expand it. Copy the links and send them to Digital Turbine.

<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%2FPLDJIY5neAmliSoj0q00%2F13993854344860?alt=media&#x26;token=cc5fd7ed-6b96-4176-b957-de40893792de" alt=""></div>

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

1. Go to **Settings→Data Connectors**.

<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%2FxAFX0RBkuSSLqZx4uKrF%2F13993869010332?alt=media&#x26;token=ffb81ba7-1b53-4e76-add0-cd7f39bdc2a8" alt=""></div>

2. Click on **+Add Data Connector**.

<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%2Fi0NtxbXq6p1MMWwotMpE%2F13993854352156?alt=media&#x26;token=0192004e-ea5a-4806-ad6e-2e70b51dcf8c" alt=""></div>

3. Search and select `Digital Turbine Media`.
4. Your Digital Turbine representative will provide you with the **Client ID** and **Client Secret** via encrypted email. Optionally, you can add a description for the configuration.

<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%2FvAlzbFV7iPwibzGvoJEW%2F13993854359964?alt=media&#x26;token=71b0d84f-3192-42ea-9a33-a14ae23ae240" alt=""></div>

5. Click **Submit**.\
   Upon setting up the cost tracking connector, a red status indicator displays a message that there is `Action Required`. Disregard this message during the first 24 hours after setting up the cost tracking connector. If the message persists after the first cost report is schedule to be delivered (after midnight UTC daily), contact Digital Turbine.

<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%2F80f5RPQ9HUXeIVyhj73a%2F13997150347932?alt=media&#x26;token=3a6d54ed-e7a8-49db-95ee-02ebb7e2a11f" alt=""></div>