This guide will walk you through how to integrate your email service provider with Branch. If you have not completed the getting started steps, please follow this documentation first.
Configure your ESP¶
To open the app directly on iOS 9.2+, you must configure your email integration and your app to support Universal Links in emails.
Tell us your click tracking domain¶
Setting up a dedicated click tracking domain requires adding additional CNAME records to your DNS settings with your hosting provider
After you've updated your DNS records, you still need to reach out to Klaviyo support in order for us to validate and activate your records. Please contact us if you are updating your records.
Configure your app for your click tracking domain¶
In this prompt, enter the email of someone on your team who is qualified to modify your iOS app, and then click Send. They will complete the technical setup steps below.
The following app changes ensure that your email integration supports Universal Links. You will need access to your app code to make these changes.
How does it work?
Apple recognizes the click tracking domain as a Universal Link, and opens the app immediately without the browser opening. Once the app has opened, Branch will collect the referring URL that opened the app (at this time, it will be the click tracking url). Inside the app, Branch will robotically “click” the link, registering the click with the ESP, and returning the Branch link information to the Branch SDK inside the app. This information is then used to deep link the user to the correct in-app content. See the Support section for more information.
Set up your click tracking domain¶
Create a CNAME for your click tracking domain and point it to
thirdparty.bnc.lt. Once the CNAME record is added, please allow up to an hour for Branch to generate SSL and AASA files for your click tracking domain.
Add your click tracking domain to your Associated Domains¶
To enable Universal Links on your click tracking domain, you'll need to add the click tracking domain to your Associated Domains entitlement.
- In Xcode, go to the
Capabilitiestab of your project file.
Scroll down and enable
Associated Domainsif it is not already enabled.
Copy your click tracking domain from the email you received from Branch, or retrieve it from your ESP's settings.
Domainssection, click the
+icon and add your click tracking domain. For example, if your click tracking domain is
email.example.com, add an entry for
Having trouble or new to Universal Links?
Follow these instructions for more details on enabling Universal Links in the Branch dashboard and in Xcode.
Validate and test¶
The last step of the Deep Linked Email setup flow validates whether you have completed all necessary steps and whether an engineer on your team has completed the technical setup steps. You will also see recommendations for how to improve your email integration.
Once you’ve completed the one time setup steps, it’s time to send your first email.
This guide will identify which web links you'd like to open the app and deep link, as well as convert them to Branch links.
Flag your deep links¶
For the email links that you would like to deep link to content, add
universal="true" to the URL in the HTML. For example:
<a href="links.example.com" universal="true">Link to your app!</a>
This will ensure that your links are converted to Branch links that will open the app on iOS and Android, with full tracking and attribution.
If there is no
universal tag, links will remain web-only and will drive users to the web page. This allows links without in-app content, such as unsubscribe links or password reset links, to not open the app.
Curious about how email works and more FAQ? Visit our general email support page.