Deep Linking overview

Deep Linking provides application marketers the ability to bring users directly into a specific location within the application along with a small amount of data. You could go to a specific tutorial, show a specific offer, or provide a custom message to the user.

To use deep linking, set one or more key-value (name = data) pair in the Kahuna platform when creating a push notification.

In the new campaign creator, add deep linking data in the ‘Push’ section.

This key-value pair is then added to a dictionary that is accessible by your application when a push is clicked.

You will need to program your application to interpret this data in order to direct users to the correct landing page or have certain behavior. You should also make sure that your application takes no action if it does not recognize the key-value pairs provided. This will ensure that you can add new key-value pairs in future versions without breaking older version. Older versions will still get the push but will not be able to provide the same deep linking.

If your app does not understand the key value pair entered, no deep linking will occur. Users will simply be redirected to the location in your application that you direct them by default. This will frequently be the home page of your application. Therefore, marketers and developers must align in the key-value pairs that will be used when integrating and utilizing deep linking.

Best Practice: Use as few characters in your key-value pairs as possible. Each key-value pair will use 6 characters of overhead in addition to the characters in the key and value. Each message is limited to roughly 150 characters. If you have common strings, for example, you could send the part that is different for each call and have the application build that string. Some applications reconstruct internal URLs using this method.

Deep Linking in Emails

Kahuna uses SendGrid (or Mailgun, for some customers) to send emails. In order for Deep Links with to work within email, these ESPs require an HTML attribute (universal=true or deeplink=true, respectively). Kahuna will automatically place the appropriate attribute on your URL links if you modify your URLs slightly. You should:

1) Configure SendGrid to use your custom Branch domain as your Link Rewriting Domain.

2) Add ?kahuna_branch_deep_link=true (or &kahuna_branch_deep_link=true) to the end of the URL. When Kahuna delivers the email, the querystring parameter will be removed and the necessary attribute will be added to the HTML.

For more information contact


Was this article helpful?
0 out of 2 found this helpful
Have more questions? Submit a request