Universal Email 集成指南
Universal Email(通用电子邮件)可让您自动将电子邮件链接转换为多平台的深度链接,这些链接可将用户直接带到移动设备上应用中的内容,同时仍为没有该应用的台式机和移动用户保持相同的网页端体验。
本指南适用于所有 Branch Universal Email 合作伙伴。请按照以下步骤将您的 ESP 与 Branch 进行集成。如果您的 ESP 需要其他说明,您将被直接转到专门的指南。
1. 完成 Universal Email 先决条件
可能需要开发者
以下 Universal Email 先决条件包括提供 URI scheme 和其他可能需要开发人员的部分:
需要开发人员
以下 Universal Email 先决条件涉及应用代码更改:
2.启用集成
要启用集成,您需要:
- 在左侧导航中,点击电子邮件 。
- 在电子邮件概述页面上,点击顶部的 Manager 选项卡。
- 找到您的 ESP,然后点击启用 。
Branch 会自动检测您在上述 Branch 帐户的初始设置过程中已经提供的所有全局链接设置。
If you have not set up your global link settings and redirect preferences, you will be prompted to do so at this time.
3. 提供点击追踪域
通过点击追踪域,您可以追踪打开电子邮件和点击链接的参与度。
如果您不确定点击追踪域(CTD)是什么,请查看一封你最近发送的电子邮件。如果将鼠标悬停在链接上或右键点击/复制链接地址,您将看到电子邮件中链接域与 HTML 中的 URL 不匹配。此域是您的 ESP 所使用的点击追踪域,为您提供点击报告。
或者,使用下面的按钮找到有关如何查找点击追踪域的 ESP 文档。如果没有文档,我们将提供有关如何联系 ESP 支持团队的链接。
Remove
http://
orhttps://
when adding your click tracking domain in the Branch dashboard

请记住
-
您可以根据需要启用与多个 CTD 的集成,但是不能将同一 CTD 添加到多个 Branch 操作后台 (Dashboard) 或 ESP 集成中。
-
在一些 ESP 集成中,您会被要求添加一个 ESP 使用的"数据域"来收集点击数据。
- 选择的 ESP 将决定是否显示此字段。如果未显示该字段,则不需要添加它。
- 与 ESP 的客户经理确认数据域。
-
在一些 ESP 集成中,您还需要通过提供 ESP 的联系电子邮件,将由 Branch 生成的 AASA 文件发送给它们。
- 选择的 ESP 将决定是否显示此字段。如果未显示该字段,则不需要添加它。
在点击下一步并继续进行验证与测试部分之前,请完成通过集成验证所需的以下部分。
4. 将 DNS CNAME 指向 Branch
The majority of ESP integrations require updating the DNS record for your CTD to include a CNAME (alias) record that points to Branch’s thirdparty.bnc.lt
domain.
请按照主机商的说明来配置 DNS CNAME。以下是一些常见的主机商指令,以供参考:
重要的 CNAME 信息
- The Branch dashboard must be enabled & reflect the CTD AFTER you add the CNAME.
- 如果 CTD 已经有 SSL 设置,请确认您的安全凭据是否允许第三方代表域提交 CSR。如果不是,请与 Branch 的支持团队联系,以协调向 Branch 手动提供 SSL 证书。
- 添加 CNAME 之后,Branch 会为您的点击追踪域自动生成 SSL 证书和 AASA 文件。更改 CNAME 之后,最多可能需要一个小时才能解决 SSL 错误。在这段时间内,点击追踪域上的链接重定向将重定向至帐户的常规配置部分中提供的默认 URL 。
- 如果您要对具有活动电子邮件点击流量的实时域进行此更改,请将 CNAME 更改安排在点击流量较低的非工作时间内进行。
5. 验证集成
生成 SSL 证书和 AASA 文件(仅 iOS)之后,您可以继续查看验证测试,修复所有问题,然后测试集成。
Branch 自动验证以下内容:
- 集成了 iOS SDK(必需)
- 集成了 Android SDK(必需)
- 深度链接已设置(必需)
- 点击追踪域已设置(必需)
- AASA file is valid (required) - Use our AASA File Validator: https://branch.io/resources/aasa-validator/
- 已正确设置 SSL(必需)
- CNAME 指向 thirdparty.bnc.lt(视情况而定)
- 已设置 Universal Linking(必需)
- 托管的深度链接数据(可选)
- 正在追踪应用事件(可选)
- Android App Link(可选)
常见验证问题
CNAME 不指向 Branch
将您的 DNS CNAME 指向 Branch 是集成过程中关键的一步。不幸的是,这也是最让人头痛的步骤。
请确保执行以下操作:
- Log into your DNS provider’s console and add the CNAME record as described here.
- 添加 CNAME 记录后至少等待60分钟,以便它有时间进行传播,且 Branch 可以创建生成的 SSL 证书和 AASA 文件(仅适用于 iOS 应用)。
无法正确设置 SSL
如果您在 SSL 证书验证方面遇到问题,那么原因通常是您的点击追踪域已经设置了 SSL,并且存在一些限制,使第三方无法代表您提交证书签名请求。
AASA 文件无效
幸运的是,最容易解决的错误恰恰是该错误的主要原因,它的问题取决于正确设置 SSL。通过解决 SSL 错误,AASA 文件错误应同时解决。
6. 测试集成
验证过程完成后,您可以通过生成测试链接来测试集成。 Branch 生成的测试链接是唯一的,因为它已经被转化为 Branch Link,并允许您进行测试而无需在 ESP 中创建电子邮件模板。实际上,一旦用户点击您的常规电子邮件模板链接,此转化就会在幕后进行。
要生成测试链接,您需要:
- 在验证和测试部分中,输入您的网站上的 URL。
- 点击获取测试链接 。
- 生成测试链接后,您可以通过以下方式分享它:
- 复制到剪贴板
- 短信
- 邮箱
生成测试链接后,请点击移动设备上的链接;不要忘记确认您的移动设备已经安装了该应用!
7. 开始发送带有标记链接的电子邮件
恭喜,您已成功建立与 ESP 的集成!在开始设置电子邮件 campaign 之前,您需要确定希望用户体验的流量并相应地标记电子邮件链接。
大多数 ESP 支持以下用户流:
-
将用户深度链接到应用内内容
- 作为 URL 查询参数添加到链接中:
<a href="links.example.com?$deep_link=true" >Link to your app!</a>
- 添加到 HTML:
<a href="http://example.com" deeplink="true">Link to your app!</a>
- 作为 URL 查询参数添加到链接中:
-
将用户链接到 web-only 内容
- 作为 URL 查询参数添加到链接中:
<a href="links.example.com?$web_only=true" >Link to your app!</a>
- 作为 URL 查询参数添加到链接中:
ESP 名称 | ESP 必需的链接标记 |
---|---|
![]() |
|
![]() |
请参阅《 Adobe Campaign 专用经典指南》 |
![]() |
请参阅《 Adobe Campaign 专用标准指南》 |
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
请参阅 Clevertap + Amazon SES 专用指南 |
![]() |
请参阅 Clevertap + Mailgun 专用指南 |
![]() |
请参阅 Clevertap + Mandrill 专用指南 |
![]() |
请参阅 Clevertap + Sendgrid 专用指南 |
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
请参阅《Oracle Responsys 专用指南》 |
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
请参阅《Salesforce Open Web 专用默认指南》 |
![]() |
See Dedicated Salesforce Open App Default Guide |
![]() |
请参阅《Salesforce Legacy v2 专用指南》 |
![]() |
请参阅《Salesforce Legacy v3 专用指南》 |
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
Updated 3 days ago