Digital Turbine

Branch Certified Partner

Overview

Digital-Turbine

This guide will walk you through how to setup your campaigns with Digital Turbine using Branch Universal Ads and track ad conversions across every device, platform, and channel.

1. Complete Universal Ads Prerequisites

DEVELOPER MAY BE REQUIRED

The following Universal Ads prerequisite includes providing URI schemes and other components that may require a developer:

DEVELOPER REQUIRED

The following Universal Ads prerequisites involve app code changes:

2. Enable the Integration

  1. Visit the Ads page on the Branch dashboard.
  2. Select Partner Management from the sidebar.
  3. Search for your Universal Ads Partner.
  4. Select Digital Turbine and hit Save & Enable.

3. Enable Postbacks

Basic postbacks will automatically be activated for events like Install and Purchase when you enable your ad partner.

You can then add additional postbacks, for example, if you wanted to add postbacks for custom events that are specific to your app like Account Created.

You can also edit postbacks if there's additional data you really need to pass along to your ad partner.

3a. Resetting Postbacks

There may be times when you need to reset a partner's settings; i.e. when a partner updates their postback templates or when perhaps you've made a mistake during partner setup. Resetting a partner's settings allows you to re-enable the partner integration with the correct information to accurately measure and attribute conversion.

Disables Ad Partner

Resetting partner settings will:

  • Disable the ad partner.
  • Clear out all of your saved credentials and postbacks that are already setup.
  • Return the ad partner to its basic configuration.

To reset Digital Turbine's postbacks:

  1. Click on the Account Settings tab.
  2. Click the Reset All Settings button in the right-hand corner.

Journeys with SingleTap™

This guide will walk you through how to set up Branch links that can be used in SingleTap™ Journeys with Digital Turbine and track resulting conversions.

Device Requirements

  • Android 6.0 (API 23) or above
  • Digital Turbine Client running v5.7 or above

Method 1: Using a Static Branch Link

  1. Create a Branch Quick Link.
  2. Make your Branch Link compatible with SingleTap™.
    1. Retrieve your base SingleTap™ link from your Digital Turbine Account Manager.
    2. Add &dvURL= followed by your URL encoded Branch link to the end of your Digital Turbine URL.
https://delivers.dtignite.com/v2/delivers/clickAd.jsp?siteId=11365&campaignId=28394
https://skdm3.app.link/pzBYIfsilZ
https://delivers.dtignite.com/v2/delivers/clickAd.jsp?siteId=11365&campaignId=28394&dvURL=https%3A%2F%2Fskdm3.app.link%2FpzBYIfsilZ
  1. Create a Branch Journey.
  2. When customizing your Journey’s appearance:
    1. Select the “Open” CTA on your Journey.
    2. In the “Deep Link Data” section, add an entry with the key $journeys_cta and the value as your SingleTap url from step 2 above.

To avoid split analytics data:

  • The ~campaign value for your quick link should match the name of your Journey.
  • The ~channel value for your quick link and your Journey should match.
  • The ~feature value for your quick link should be set to journeys.
  • A parameter should be added to your quick link in the “Deep Linking” section with the key $3p and the value a_digital_turbine.

Method 2: Using a Dynamic Branch Link

  1. Add the following snippet to any mobile web page where you’d like to show a SingleTap enabled Journey.
<script>
  (function(b,r,a,n,c,h,_,s,d,k){if(!b[n]||!b[n]._q){for(;s<_.length;)c(h,_[s++]);d=r.createElement(a);d.async=1;d.src="https://cdn.branch.io/branch-latest.min.js";k=r.getElementsByTagName(a)[0];k.parentNode.insertBefore(d,k);b[n]=h}})(window,document,"script","branch",function(b,r){b[r]=function(){b._q.push([r,arguments])}},{_q:[],_v:1},"addListener applyCode autoAppIndex banner closeBanner closeJourney creditHistory credits data deepview deepviewCta first getCode init link logout redeem referrals removeListener sendSMS setBranchViewData setIdentity track validateCode trackCommerceEvent".split(" "), 0);
  var options = { no_journeys: true };
  branch.init('BRANCH_LIVE_KEY_GOES_HERE', options);

  if (navigator.userAgent.match(/Android/i))
  {
    branch.link({
    campaign: 'My Journey Name',
    channel: 'mobile_web',
    feature: 'journeys',
    data: {
        '$3p': 'a_digital_turbine'
      }
    }, function(err, link) {
        var singleTapLink = 'https://delivers.dtignite.com/example?&dvURL=' + encodeURI(link)
        branch.setBranchViewData({
          data: {
              '$journeys_cta': singleTapLink
          }
        });
        branch.track('pageview');
    });
  }
</script>
  1. Replace ‘BRANCH_LIVE_KEY_GOES_HERE’ with your Branch API key, and ‘https://delivers.dtignite.com/example’ with your Digital Turbine SingleTap URL.

Enable Deep Linking

To enable deep linking, add the necessary parameters to the ‘data’ json in the snippet. These parameters will depend on your Branch implementation.

Typical examples would be:

'$canonical_url': window.location
'$deeplink_path': 'property/listing/12345'

To avoid split analytics data:

  • The “campaign” value in the snippet should be set to the name of the Journey that will be displayed on the page.
  • The “channel” value in the snippet should be set to the channel value of the Journey that will be displayed on the page.
  • The “feature” value in the snippet should always be “journeys”.

Updated about a month ago


Digital Turbine


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.