Ctrlk
DT Employee Sign-In
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

1

Configure Event Postbacks

Set up event postbacks for a campaign.

2

Create a Tracking Link

Create a tracking link for Android and/or iOS apps and designate fallback sites.

3

Enable Cost Tracking

Set up cost tracking connectors. This step is optional.

Configure Event Postbacks

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 app settings on the Partner Configuration page.

Complete the following steps to set up event postbacks:

  1. Go to Attribution Setup→Partner Configuration.

  1. In the search field at the top right, enter Digital Turbine Media (or click +Add Partner and search).

  2. Click +Add App Site.

To edit an existing configuration, hover over a line and click the pencil icon on the right side.

  1. Select the App Site.

  1. In the Attribution Windows Settings→Attribution Postbacks area, select the following checkboxes:

    • Send View-Through. This will let Digital Turbine receive conversion postbacks tied to impressions.

    • Send all. This will let Digital Turbine receive unattributed install postbacks for optimization purposes.

    • Send Fraud Postbacks. This will let Digital Turbine be aware of any installs blocked by fraud algorithms for troubleshooting purposes.

  2. In the Attribution Windows Settings→Installs area:

    • Set the Click Through Deterministic to 30 days.

    • Set the Click Through Probabilistic to 24 hours.

Digital Turbine requires a 30-day attribution window.

  1. On the In app Event Postbacks tab, click + Add a new event.

  1. In the first column, select the in-app SDK Event Name as sent from the app to Singular’s attribution service.

If the Event Name field is not showing, delete the event using the ✗ (cross) icon and recreate a new one using the + (plus) icon.

  1. Next, add the Event Name.

Event Names

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 (_).

  1. Set the Lookback for the event. We recommend selecting None as that will ensure we receive all event postbacks to reduce discrepancies.

  2. If the event includes a value that you want to deliver to Digital Turbine (for example, an in-app purchase includes a revenue value), check the Include Revenue checkbox.

  3. Click the plus (+) icon and repeat the process until all events are added.

  4. Click Save when finished.

Create a Tracking Link

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. Enter your app's name in the search bar and select it.

  1. Click Create Link.

  1. In the Link Type dropdown list, select Partner.

  1. For Source Name, select Digital Turbine Media.

  2. Enter an arbitrary Tracking Link Name.

  3. Click on Link Settings and Redirects.

  1. Select the Link Sub-Domain.

  2. Complete the next steps depending on the platform.

  • Check the Enable Android Tracking checkbox.

  • The value of Site drop-down gets populated automatically.

  • Check the Enable iOS tracking checkbox.

  • Check the Enable Probabilistic Attribution checkbox.

  • The value of Site gets populated automatically.

  • 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.

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

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.

  1. Click Generate. A new item, Link Summary, will appear.

  2. Click on Link Summary to expand it. Copy the links and send them to Digital Turbine.

Enable Cost Tracking

  1. Go to Settings→Data Connectors.

  1. Click on +Add Data Connector.

  1. Search and select Digital Turbine Media.

  2. 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.

  1. 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 scheduled to be delivered (after midnight UTC daily), contact Digital Turbine.

Last updated