Universal Ads Basics

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

Paid Product

Ads is a premium product priced on Monthly Active Users. Sign up for the Ads product to enable this functionality.

Branch SDK Required

Before enabling the partner integration, please make sure you've implemented the Branch SDK in your application. This is required to ensure deep linking and attribution. We also highly recommend implementing event measurement and passing event metadata to your partner.

Enabling 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 Ad Partner Name and hit Save & Enable.


Providing Account Credentials

Not all integrations require providing account credentials. When prompted to, enter any credentials that may be required, and click Save and Enable in the bottom right hand corner. If you do not know your account credentials for said partner, please ask your ad partner for this information.


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


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 a specific partner's postbacks:

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

Reset Postbacks

Creating an ad link

Once you've enabled an integration it's time to create a tracking link.

  1. First, select an ad format. For App Install or App Engagement campaigns you'll want to select the App Only format. For Search or Display campaigns where the user should go to web if they don't have the app, then you should select Cross-Platform Search or Cross-Platform Display. Product Links are for shopping or dynamic remarketing campaigns.


  2. At this point you need to name your link. Select something that will make it easy to find if you need it later. Your Ad Format and Ad Partner should be selected already, but feel free to choose one if they aren't. It's important that you select the right Ad Partner for analytics later on. Click Configure Options to continue.


  3. This is your chance to add deep link data and analytics tags. Analytics tags are important for later segmentation, so click the Analytics sub tab to add a Channel and Campaign value.


Set Analytics tags

It's easier to slice your data in our analytics platform if you properly assign analytics parameters to your link. Channels generally correspond to ad networks, and Campaigns correspond to marketing initiatives that you're launching. For example: Channel: YouTube, Campaign: Summer 2017 Shoe Discounts

Links Created by Agency Users

When an Agency users saves an ad link/Journey/Quick Link, that ad link/Journey/Quick Link is associated with that Agency via a unique agency_id that is included as a key-value in deep linking setup.

  1. Click Create Link Now, and you have your tracking link! Take this link and give it to your Ad Partner's Account Manager or paste it into the tracking section of your campaign yourself.


Viewing Your Data

The Ads Analytics Page on the Branch dashboard provides an interactive time series graph and table to view the performance of your Ad campaigns:

  • Easily interact with your Analytics data breakdown and compare aspects of your Ad campaigns' performance by using the Compare by button to add a parameter to split the data displayed data by.
  • You can also use the Add Filter + button to refine the data displayed to gain deeper insight into the performance of your Ad campaigns.

The TRENDS table shows the chart and breakdown of last 7 days data on the campaign performance by ad partner.

Example Ads Analytics Graph

The EVENTS table shows summary data on the performance of each Ad campaign.

Example Ads Table

On the top right side of the table you can find a download button to retrieve the chart's content as a CSV file. For more info about Ads Analytics refer here.

Advanced Setup

Please refer to our Advanced Universal Ads guide for advanced options when enabling a Universal Ads partner.

Updated 13 days ago

Universal Ads Basics

Suggested Edits are limited on API Reference Pages

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