Create Ad Links

Overview

A Branch link is the vehicle that ensures seamless user experiences while also providing you with full attribution and analytics across email, referrals, paid advertising, social, organic search, and desktop-to-mobile.
If you are running paid advertising campaigns, you'll want to create a Branch Ad Link so we can accurately attribute resulting app conversions to the appropriate advertising partner. Branch Ad Links support deferred deep linking, Android App Links, and iOS Universal Links, as well as web and app conversions.

Migrated TUNE Clients only

If you are a migrated TUNE client creating links in your Branch account and do not have the Branch SDK implemented in your app, you must have at least the following versions of the TUNE SDK - Android v6.0.3 & iOS v6.0.4 - for the TUNE SDK to be able to attribute Branch links.

Creating an Ad Link

As all Branch Ad Links are uniquely built to a specific advertising partner, you can only create an Ad link for enabled ad partners. To create a Branch Ad Link:

1. Select Ad Format

  1. From within the Branch dashboard, click the Create button on the upper right-hand corner.
  1. A Create Ad Link modal will appear. Select one of the following ad formats:
    • App Only
      • App Install or Engagement
  2. Cross-Platform Display
    • Create Display Link
    • Create Search Link
  3. Click Continue

Difference Between Format Types

For App Install or App Engagement campaigns you'll want to select the "App Only" format. For Search or Display campaigns where the user should go to web if they don't have the app, then you should select Cross-Platform Search or Cross-Platform Display. Product Links are for shopping or dynamic re-marketing campaigns.

2. Defining Ad Link Domain & Ad Partner

In the Define section, complete the following:

  1. Choose which link domain you want to use (available for ex-TUNE clients only):
    • Branch domain - Create a link using your Branch domain. Note that links created with this domain will use Branch link parameters by default.
    • TUNE domain - Create a link using your TUNE domain. Note that links created with this domain will use TUNE link parameters/macros by default.
  2. Name your link.
  3. Select the ad partner that the link is for.
  4. Click Configure Options when you are done.

3. Configuring Options

In the Configure Options section, please provide the following:

  1. Define your Link Alias - this cannot be changed after you create the ad link.
  2. Provide any of the following if applicable:

Deep linking
The Deep Linking tab allows you to include additional data to your links to be used not only for contextual deep linking, but for passing additional attributes you or your ad partner may require.

To add additional data - i.e. key-value pairs - to your Ad Link:
1. Click +More Data.
2. Input the parameter name in the Key field and its corresponding value or macro in the Value field.
If you wish to Force Open the App, even if it risks showing an error message when the app is not installed, add uri_redirect_mode in the Key field and 2 in the *Value field. By adding this key-value pair, only those who click on this link will have the app forced open regardless. For links created on the TUNE domain, attach your invoke_url key with URL encoded URI scheme value (e.g. invoke_url=branchsters%3A%2F%2F) and set your app-level URI redirect mode to 'Aggressive'.

For a full list of available parameters you can include in your Ad Link, refer to TUNE <> Branch Mapped Fields.


Redirects
The Redirect tab allows you to override your default redirects - as set in Link Settings - and direct users to specific locations if the app is not installs.
Default Redirect - Set at the account level within Link Settings. Typically set to the relevant mobile stores Web URL - Send users to a specific web page if they don’t have to the app to avoid any unexpected flow to the app store

Deepview - Send users to a specific Deepview you may have created under the Web to App > Deepview section. Copy the key and paste it into the text box. Useful if you want to present the user with a preview of the content before taking them directly to the app store. Should not be set for Desktop option.

Note: If you want to always force the app to open, even if it risks showing an error message when the app is not installed, make sure the URI Scheme Deep Link Mode in your *Link Settings
is set to Aggressive. By changing this setting, Branch will force open the app for all users. This is available for links created on both the Branch and TUNE domain.

Analytics Tags
It's easier to slice your data in our analytics platform if you properly assign analytics parameters to your link. Channels generally correspond to ad networks, and Campaigns correspond to marketing initiatives that you're launching. For example: Channel: "YouTube", Campaign: "Summer 2017 Shoe Discounts."

  1. Click Create Link Now when you're done. You'll then be brought to the last phase of creating a link - Validate & Share.

4. Validate & Share

Validate

Once you've created your Ad link, we will automatically validate its settings to make sure your link works as you expect.

If we recognize an issue with your ad link, you will see an error message with what needs to be fixed before sharing your link. Click on the error message to go back and fix the offending setting. Once no issues exist, you should only see green checks next to your links settings.

Share

We provide you with a Branch link for both clicks and impressions. Simply copy and paste the links in the tracking section of your campaign tool or email to your Ad Partner's account manager.

You can also text yourself (or someone else) the link by providing a phone number and clicking Send.

Updated about 4 hours ago

Create Ad Links


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.