SingleTap by Digital Turbine

Overview

Digital Turbine simplifies app advertising, recommendation, delivery and tracking. Maximize revenue, increase user engagement and save cost.

PARTNER CAPABILITIES

1. Complete Ads Prerequisites

DEVELOPER MAY BE REQUIRED

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

• Add Deep Link Routing & Required Redirects

DEVELOPER REQUIRED

The following Ads prerequisites involve app code changes:

• Implement the Branch SDK

2. Enable the Integration

1. Visit the Ads page on the Branch dashboard.

2. Select Partner Management from the sidebar.

3. Search for SingleTap by Digital Turbine.

4. Select SingleTap by Digital Turbine and click Save & Enable.

3. Enable Postbacks

When Branch measures a conversion (install or other event), it determines which ad network or partner is responsible for generating the action, then attributes credit to the proper partner accordingly. Branch notifies the Ad partner of these events via postbacks which are turned on when you enable any Ads integrated partner.

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

Branch’s postback system is highly customizable; you can set up postbacks for specific events, as well as specific subsections of events, filtered by link data, user data or event properties.

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.

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

Note, by resetting your partner settings, this 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

Learn more here on how to reset your ad partner's settings.

4. Verify Integration Setup

5. Create a Branch Link

If you are running paid advertising campaigns, you'll want to create a Branch Ad Link so we can accurately attribute resulting app conversions to the appropriate advertising partner.

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.

Method 1: Quick Link with SingleTap

1. Create a Branch Quick Link

2. Make your Branch Link compatible with SingleTap™.

3. Retrieve your base SingleTap™ link from your SingleTap by Digital Turbine Account Manager.

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

5. Create a Branch Journey.

6. 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 4 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: Journeys with SingleTap

Requirements

This method requires version 2.56.1 of the Branch Web SDK.

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>
   

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