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 is 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 utilize the News Feed as an individualized navigation tool to direct users to content inside in your app. They can also be utilized to direct users from push notifications and in-app messages to relevant app sections and content.

Keep in mind that enabling these deep links requires some additional setup within your app. Please reference our documentation on deep links for iOS and on how to deep link to the News Feed for Android to understand the requirements for implementation.

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. my_app)
  • utm_medium: the campaign medium (e.g. newsfeed)
  • utm_campaign: the identifier for the campaign (e.g. spring_2016_campaign)
  • utm_term: identifier for a paid search term that brought the user to your app or website (e.g. pizza)
  • utm_content: an identifier for the specific link/content that the user clicked on (e.g. toplink or android_iam_button2)

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 e-mail 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:

1
myapp://products/20-gift-card?utm_source=my_app&utm_medium=push&utm_campaign=spring2016giftcards&utm_content=ios_deeplink

UTM Tags in Push Message

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.

UTM Tags in News Feed

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.

UTM Tags in In-App Message

WAS THIS PAGE HELPFUL?