Deep Linking to In-App Content
What is Deep Linking?
Deep linking is a way of launching a native app and providing additional information telling it to do some specific action or show specific content.
There are three parts to this:
- Identify which app to launch
- Instruct the app which action to perform
- Provide the action with any additional data it will need
Deep links are custom URIs that link to a specific part of the app and contain all of the above parts. The key is defining a custom scheme.
http: is the scheme with which almost everyone is familiar but schemes can begin with any word. A scheme must start with a letter, but can then contain letters, numbers, plus-signs, minus-signs or dots. Practically speaking, there is no central registry to prevent conflicts, so it is a best practice to include your domain name in the scheme. For example,
twitter:// is the iOS URI to launch Twitter’s mobile app.
Everything after the colon within a deep link is free-form text. It’s up to you to define its structure and interpretation, however, a common convention is to model it after
http: URLs, including a leading
// and query parameters (e.g.
?foo=1&bar=2). For the Twitter example,
twitter://user?screen_name=[id] would be utilized to launch a specific profile in the app.
These deep links are a powerful tool when used in tandem with the Braze News Feed. Providing deep links as the URI within News Feed items allows you to use the News Feed as an individualized navigation tool to direct users to content inside in your app. They can also be used to direct users from push notifications and in-app messages to relevant app sections and content.
UTM Tags and Campaign Attribution
What is a UTM Tag?
UTM (Urchin Traffic Manager) tags allow you to include campaign attribution details directly within links. UTM tags are used by Google Analytics to collect campaign attribution data, and can be used to track the following properties:
utm_source: the identifier for the source of the traffic (e.g.
utm_medium: the campaign medium (e.g.
utm_campaign: the identifier for the campaign (e.g.
utm_term: identifier for a paid search term that brought the user to your app or website (e.g.
utm_content: an identifier for the specific link/content that the user clicked on (e.g.
UTM tags can be embedded into both regular HTTP (web) links and deep links and tracked using Google Analytics.
Using UTM Tags with Braze
If you want to use UTM tags with regular HTTP (web) links—for example, to do campaign attribution for your email campaigns—and your organization already uses Google Analytics, you can simply use Google’s URL builder to generate UTM links. These links can be readily embedded into Braze campaign copy just like any other link.
In order to use UTM tags in deep links to your app, your app must have the relevant Google Analytics SDK integrated and correctly configured to handle deep links. Check with your developers if you’re unsure about this.
Once the Analytics SDK is integrated and configured, UTM tags can be used with deep links in Braze campaigns. To set up UTM tags for your campaign, simply include the necessary UTM tags in the destination URL or deep links. The examples below show how to use UTM tags in push notifications, News Feed cards and in-app messages.
Attributing Push Opens with UTM Tags
To include UTM tags in your deep links for push notifications, simply set the on click behavior of the push message to be a deep link, write the deep link address and include the desired UTM tags in the following fashion:
Attributing News Feed Clicks with UTM Tags
News Feed items deep linking into your app can be configured to use UTM tags as well. Note that you can use
utm_content to separate between deep links on different OSes.
Attributing In-App Message Clicks with UTM Tags
Similarly to push notifications and News Feed cards, you can include UTM tags in the deep links included within your in-app messages.