UTM tagging is the a very common way for marketers to track web users and has become the standard tagging mechanism for Google Analytics. While Branch links do track analytics and attribution across web and app, we also support you adding your own tracking parameters to Branch links. There are a couple ways to do this:
Appending your analytics tags to Branch links as query params
You can simply add your analytics tags on the end of the Branch link like so:
When the user is redirected to web content, Branch will automatically apply the tags onto the end of the web url so that your web tracking is not disturbed. For the example link, the user is redirected to:
When the user is redirected to the app, Branch will automatically add these UTM parameters to the link data that is passed to your app in the payload.
The app should be set up to handle the analytics tags.
Here is an example of what that payload would look like for the example link:
Tips and Tricks
If you ever want to test where a user would get redirected by a Branch link without actually clicking on the link, you can use a redirect test like http://redirectdetective.com.
For the link in the example, you would enter this url in the input field on the redirect inspector: https://branch.app.link/mobilegrowthhandbook17?utm_campaign=campaign&utm_source=source
This would yield a result like this:
Adding your analytics tags to Branch links as deep link data
You can manually add you analytics tags to Branch deep link data as key-value pairs
Important note: You will only be able to access these tags if you are using Branch’s web and/or app SDKs. The tags will not be included on the end of the redirect URL
The analytics tags can be added to the deep link data no matter how you are creating your Branch links. An example from the dashboard’s quick links creation flow:
Once added to the deep link data, the Branch SDKs on web and app will receive it in the link payload whenever that link refers a session. Sample link payload:
Once you’ve retrieved the tags with the SDK, you can handle this with the code on your website or app.
Tips and Tricks
If you ever want to see where the deep link data defined for a Branch link, simply add “debug=1” as a query parameter on the end of the url and Branch will take you to the link debugger page for that specific link.
On the link debugger page you will be able to see all of the data, analytics tags and redirects configured for that link.
For the link in the example, you would enter this url in the address bar: https://branch.app.link/mobilegrowthhandbook17?utm_campaign=campaign&utm_source=source&debug=1
Automatically map UTM parameters to Branch analytics tags
By default, Branch will automatically map any appended UTM parameters to Branch analytics tags if there are no Branch analytics tags set.
If you would like UTM parameters to always override Branch analytics tags, simply enable it in on the link settings page of the Branch dashboard (link) under ‘Advanced Settings’.
The mappings are as follows:
Note: This only applies to dynamically created links, not links generated through the Dashboard, API or SDKs.
Did you find it helpful?Send feedback