This guide will walk you through how to setup your campaigns with Mobusi using Branch Universal Ads and track ad conversions across every device, platform, and channel.
Integrating the SDKs and tracking in-app events¶
The Branch SDKs for iOS and Android allow you to get up and running quickly.
If you haven't already integrated Branch SDK into your application, please follow our integration guide to integrate Branch SDK into your application:
Limitations with setDebug and seeing data in Branch
When integrating the SDKs, it's often useful to use setDebug to verify that your app is able to communicate with Branch servers, and is receiving deep link data. However, our upstream systems don't register test events sent using setDebug, so events will not appear in Liveview or Analytics, nor will they fire postbacks. You should disable setDebug when looking at Liveview or testing postbacks.
Track conversion events¶
Install and open events are automatically tracked using just the Branch SDK integration. However, to track custom events, such as registration or purchase, you will need to integrate them into your application.
Sending event metadata from your application
Please make sure that you setup and pass event metadata from the application to the ad partner. Follow up with your ad partner to get the list of required parameters.
Please reference the general V2 Event Tracking Guide. This will help ensure that you've integrated the right Branch events with the correct metadata.
Testing your events with Liveview
You can test your integration by going to our Liveview page. Set a filter with the event name to verify that the Branch SDK is recording each event.
Enabling the Integration¶
- Visit the Ads page on the Branch dashboard.
- Select Partner Management from the sidebar.
- Search for your
Universal Ads Partner.
- Select Ad Partner Name and hit
Save & Enable.
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.
Creating an ad link¶
Once you've enabled an integration it's time to create a tracking link.
First, select an ad format. For App Install or App Engagement campaigns you'll want to select the
App Onlyformat. 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 Searchor Cross-Platform Display. Product Linksare for shopping or dynamic remarketing campaigns.
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 Optionsto continue.
This is your chance to add deep link data and analytics tags. Analytics tags are important for later segmentation, so click the
Analyticssub 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.
Channelsgenerally correspond to ad networks, and Campaignscorrespond 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.
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 bybutton 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.
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.
Please refer to our Advanced Universal Ads guide for advanced options when enabling a Universal Ads partner.