更改高级设置

在 Branch 操作后台的 Link Settings 上，您可以更改高级链接设置：

1. Set Match type to either unique or normal (default)
   a. Recommended: Normal. Selecting Unique means that Branch will only make a deep link through install match if there is a single, unique outstanding footprint. For example, if you and your twin each have an iPhone 5s with the same OS/version, etc., and you each click different links for the same app then open the app up at the same time, we won’t deep link when Unique is selected. You probably don’t want this, as it’s mostly for very special circumstances.
2. 组 Duration to seconds
   a. Duration is how long a click will live in our system before it is consumed by either an app open or a system delete. Modifying this value will change how long we wait to fingerprint a user. If a user is fingerprinted within the set duration, then deep link data will flow into the app. The default expiration is 2 hours (7200 seconds).
3. 组 UTM tags
   a. Recommend disabled. If you enable this, Branch will automatically set channel, feature, campaign, tags and $keywords based on UTM params. This only applies to dynamically created links, not links generated through the Dashboard, API or SDKs.

更改链接域

app.link 域就是 Branch 的默认域。注册操作后台后，将自动为您分配一个 app.link 域，该域具有一个多字符子域（例如： xxxxxx.app.link ）。您可以将链接域更改为自定义 app.link 域、自定义子域或自定义根域。

自定义 app.link 域：

大多数 Branch 客户选择自定义 app.link 域，因为这样可以匹配您的 Branch 子域和您的品牌（例如： yourbrand.app.link ）。

要自定义您的 app.link 域：

1. Review and understand our domain change warning
2. 前往 Branch 操作后台上的 Link Settings 页面。
3. Change your subdomain. If you have any issues updating/changing your subdomain, click here to contact support.

🚧

Customize your app.link Subdomain

It is important to update your app.link subdomain before you begin your Branch app SDK integration; otherwise, you will need to make updates to your app’s associated domains and you may see strange link behavior.

Additionally, make sure the app.link subdomain that you want is available before making any changes to campaigns and app SDK updates.

❗️

Android App Links & Web-Only Limitations

Currently, we cannot support web-only link functionality ($web_only; links that only open the web even if the app is installed) and Android App Links together on custom root domains and subdomains. Android App Links force the app to open even if $web_only=true is specified on custom root domains and subdomains.

使用自定义子域

如果您的企业对您使用的域有严格的限制，并且想要确保您的 Branch 域与其余相关子域相匹配，则可以使用自定义子域（例如：link.yourbrand.com）。

请注意：这需要您将域名的 CNAME 配置为 custom.bnc.lt，并且如果您的 Branch App SDK 已集成，则需要对应用内相关域名进行相应更改。

要使用自定义子域，请按如下操作：

1. Review and understand Domain change warning
2. Review and understand Custom domain warning
3. Review and understand Custom domain debugging
4. 前往 Branch 操作后台上的 Link Settings ，然后将链接域更改为自定义子域。
5. 在自定义子域更新您的CNAME 记录
   1. CNAME = custom.bnc.lt
6. 点击 Confirm on Link settings
7. 如果您通过 AWS 的 Route 53 配置域，请确保您是在 Registered Domains 标签（而不是 Hosted zones 部分）下编辑域名服务器。

使用自定义根域

一些（极少数）公司会为他们的 Branch domain 创建一个完全独立的域，即创建一个自定义根域（例如：yourbrand-link.com）。只有当您的公司未开启 app.link 或自定义子域选项时，才建议这样做。

请注意：这需要您更新域的 NS 记录。

要使用自定义根域，请按如下操作：

1. Review and understand Domain change warning
2. Review and understand Custom domain warning
3. Review and understand Custom domain debugging
4. Change your link domain to your custom root domain on Link settings
5. 更新您的 NS records on your custom root domain
   1. These values are unique per app and can only be found in your Branch dashboard when changing your link settings.
6. 点击 Confirm on Link settings
7. 如果您通过 AWS 的 Route 53 配置域，请确保您是在 Registered Domains 标签（而不是 Hosted zones 部分）下编辑域名服务器。

Please reach out to your Branch account manager to enable web-only links on custom domains.

Redirect Allowlist

With Branch, you have the ability to set a specific allowlist of domains that you can allow your Branch Links to redirect to (set to disabled by default). With the Redirect Allowlist, you can limit Branch Link redirection to specific web domains or URI schemes across your Branch platform. List each of the domains you want to limit redirection to. We also support a “*” for wildcard subdomains.

For example, if your allowlist includes “branch.io”, “*.branch.io”, and “myapp://”, your deep links can only redirect to domains like branch.io, dashboard.branch.io, or myapp://.

It is recommended that you include the app store domains that are relevant to the way users download your app. For example: “play.google.com” and “apps.apple.com”

Local Currency

Set the local currency of your Branch Dashboard if it is not USD. By setting your local currency, you can analyze marketing spend (cost) and revenue in your local currency. This also allows direct cost data comparison with ad partners who report their spending in a currency other than USD.

A new field called Local Currency will be available on the Dashboard showing the currency configured in your Universal Ads Analytics.

Note: The currency can only be set once through the Branch Dashboard to avoid some potential issues:
Historical data does not switch to the new local currency but would be labeled as such. As a result, the data prior to the currency change may show as inaccurate.
When changing the currency type, your cost data for the previous 7 days will be updated and may cause inaccuracies.

问题排查

域更改警告

• 用于 Change link domain
• 从app.link 到app.link
  • 您的旧app.link 深度链接将失效
  • 您的旧app.link 深度链接接将前往 File Not Found 网站，而不是打开您的应用。
  • Your new app.link deep links will open your app after you update your code to append the new link domain
  • 如果您的旧app.link 处于活动状态，建议切换到custom link domain instead
• 从app.link 到custom link domain
  • 您的旧app.link 深度链接仍然有效
  • Your new custom link domain deep links will open your app after you update your code to append the new link domain
• 从custom link domain 到custom link domain
  • 您的旧custom link domain 深度链接将失效
  • Your new custom link domain deep links will open your app after you update your code to append the new link domain
• 从旧版 bnc.lt 到 custom link domain 或者 app.link
  • 您的bnc.lt 和custom link domain / app.link 深度链接都可以使用
  • Your new custom link domain / app.link deep links will open your app after you update your code to append the new link domain

📘

使用自定义域更改您的应用配置

添加Intent Filter on Android
添加new key in your apps Info.plist on iOS

自定义域警告

• 用于 Change link domain
• 如果要使用自己的域进行深度链接，则custom link domain 的NS 或者 CNAME 记录需要指向 Branch
• 每当您更改一个域的NS 或者 CNAME 记录时，Branch 将成为该域的权威注册商。这将授予 Branch 对域的控制权，并且您将失去对该custom root domain 或者 custom subdomain的所有访问权限。该网页将变为空白，并且该域的控件将更改为 Branch
• Branch 将使用您的域来路由所有深度链接的流量。Branch 还将托管您的 AASA 文件和 SSL 证书
• If you have content on your custom root domain (e.g. https://example.com/), Branch recommends using an unused custom subdomain instead (e.g. https://link.example.com/)

自定义域调试

• 用于 Change link domain
• 您可以使用dig ns <domain> 或者 dig cname <domain> 测试您的域记录更改
• 我们建议您选择一个固定的域或者子域用于 Branch，切换可能会导致现有链接出现严重的问题
• 如果您通过 AWS 的 Route 53 配置域，请确保您是在Registered Domains 标签而不是Hosted zones section 下编辑域名服务器。
• 您无法使用主站域名来托管 Branch Link
• Do not include www when adding your custom link domain
• 如果您已经为域名设置了 CAA 记录，请将 letsencrypt.org 添加到列表中

最佳实践

For changing the Link Domain for both of your LIVE and TEST Branch apps, the best practice is changing your LIVE app firstly and then adding test into some where in the new domain name for the TEST app.

Notice, the LIVE and TEST apps cannot use the same customized Link Domain. For example, the LIVE app of Branch Monster Factory uses branchster.app.link for its LIVE app and branchster.test-app.link for its TEST app.