Universal Email 集成指南

Universal Email(通用电子邮件)可让您自动将电子邮件链接转换为多平台的深度链接,这些链接可将用户直接带到移动设备上应用中的内容,同时仍为没有该应用的台式机和移动用户保持相同的网页端体验。

本指南适用于所有 Branch Universal Email 合作伙伴。请按照以下步骤将您的 ESP 与 Branch 进行集成。如果您的 ESP 需要其他说明,您将被直接转到专门的指南。

1. 完成 Universal Email 先决条件

📘

可能需要开发者

以下 Universal Email 先决条件包括提供 URI scheme 和其他可能需要开发人员的部分:

🚧

需要开发人员

以下 Universal Email 先决条件涉及应用代码更改:

2.启用集成

要启用集成,您需要:

  1. 在左侧导航中,点击电子邮件
  2. 在电子邮件概述页面上,点击顶部的 Manager 选项卡。
  3. 找到您的 ESP,然后点击启用

📘

Branch 会自动检测您在上述 Branch 帐户的初始设置过程中已经提供的所有全局链接设置。

如果尚未设置全局链接设置和重定向首选项 ,您将被提示对其进行设置。

3. 提供点击追踪域

通过点击追踪域,您可以追踪打开电子邮件和点击链接的参与度。

如果您不确定点击追踪域(CTD)是什么,请查看一封你最近发送的电子邮件。如果将鼠标悬停在链接上或右键点击/复制链接地址,您将看到电子邮件中链接域与 HTML 中的 URL 不匹配。此域是您的 ESP 所使用的点击追踪域,为您提供点击报告。

或者,使用下面的按钮找到有关如何查找点击追踪域的 ESP 文档。如果没有文档,我们将提供有关如何联系 ESP 支持团队的链接。

🚧

在 Branch 操作后台 (Dashboard) 添加点击追踪域时,请删除 http://https://

adestra adobe campaign classic adobe campaign standard airship amazon simple email service betaout bluecore blueshift braze + mailjet braze + sendgrid braze + sparkpost campaign monitor cheetah digital marketing suite clevertap + amazon ses clevertap + mailgun clevertap + mandrill clevertap + sendgrid cmercury cordial customer.io emarsys epsilon expertsender hootsuite IBM watson campaign automation iterable v1 iterable v2 kahuna klaviyo leanplum mailgun mailjet mailUp mandrill marketo message gears moengage oracle bronto oracle eloqua oracle responsys pepipost postup rapid mail sailthru v1 sailthru v2 salesforce open web default salesforce open app default salesforce v2 legacy salesforce v3 legacy selligent marketing cloud selligent message studio sender sendgrid smartech socialflow sparkpost vero whatcounts yes marketing yiye technology zeta

请记住

  • 您可以根据需要启用与多个 CTD 的集成,但是不能将同一 CTD 添加到多个 Branch 操作后台 (Dashboard) 或 ESP 集成中。

  • 在一些 ESP 集成中,您会被要求添加一个 ESP 使用的"数据域"来收集点击数据。

    • 选择的 ESP 将决定是否显示此字段。如果未显示该字段,则不需要添加它。
    • 与 ESP 的客户经理确认数据域。
  • 在一些 ESP 集成中,您还需要通过提供 ESP 的联系电子邮件,将由 Branch 生成的 AASA 文件发送给它们。

    • 选择的 ESP 将决定是否显示此字段。如果未显示该字段,则不需要添加它。

👍

在点击下一步并继续进行验证与测试部分之前,请完成通过集成验证所需的以下部分。

4. 将 DNS CNAME 指向 Branch

大多数 ESP 集成都需要更新 CTD 的 DNS 记录,以包括指向 Branch thirdparty.bnc.lt 域的 CNAME(别名)记录。

请按照主机商的说明来配置 DNS CNAME。以下是一些常见的主机商指令,以供参考:

重要的 CNAME 信息

  • 添加 CNAME 之前,必须启用 Branch 操作后台 (Dashboard) 并反映 CTD。
  • 如果 CTD 已经有 SSL 设置,请确认您的安全凭据是否允许第三方代表域提交 CSR。如果不是,请与 Branch 的支持团队联系,以协调向 Branch 手动提供 SSL 证书。
  • 添加 CNAME 之后,Branch 会为您的点击追踪域自动生成 SSL 证书和 AASA 文件。更改 CNAME 之后,最多可能需要一个小时才能解决 SSL 错误。在这段时间内,点击追踪域上的链接重定向将重定向至帐户的常规配置部分中提供的默认 URL
  • 如果您要对具有活动电子邮件点击流量的实时域进行此更改,请将 CNAME 更改安排在点击流量较低的非工作时间内进行。

5. 验证集成

生成 SSL 证书和 AASA 文件(仅 iOS)之后,您可以继续查看验证测试,修复所有问题,然后测试集成。

Branch 自动验证以下内容:

  • 集成了 iOS SDK(必需)
  • 集成了 Android SDK(必需)
  • 深度链接已设置(必需)
  • 点击追踪域已设置(必需)
  • AASA 文件有效(必需)—使用我们的 AASA 文件验证器:https://branch.io/resources/aasa-validator/
  • 已正确设置 SSL(必需)
  • CNAME 指向 thirdparty.bnc.lt(视情况而定)
  • 已设置 Universal Linking(必需)
  • 托管的深度链接数据(可选)
  • 正在追踪应用事件(可选)
  • Android App Link(可选)

🚧

常见验证问题

CNAME 不指向 Branch

将您的 DNS CNAME 指向 Branch 是集成过程中关键的一步。不幸的是,这也是最让人头痛的步骤。

请确保执行以下操作:

  1. 登录到 DNS 提供商的控制台,并按照此处所述添加 CNAME 记录。
  2. 添加 CNAME 记录后至少等待60分钟,以便它有时间进行传播,且 Branch 可以创建生成的 SSL 证书和 AASA 文件(仅适用于 iOS 应用)。

无法正确设置 SSL

如果您在 SSL 证书验证方面遇到问题,那么原因通常是您的点击追踪域已经设置了 SSL,并且存在一些限制,使第三方无法代表您提交证书签名请求。

AASA 文件无效

幸运的是,最容易解决的错误恰恰是该错误的主要原因,它的问题取决于正确设置 SSL。通过解决 SSL 错误,AASA 文件错误应同时解决。

6. 测试集成

验证过程完成后,您可以通过生成测试链接来测试集成。 Branch 生成的测试链接是唯一的,因为它已经被转化为 Branch Link,并允许您进行测试而无需在 ESP 中创建电子邮件模板。实际上,一旦用户点击您的常规电子邮件模板链接,此转化就会在幕后进行。

要生成测试链接,您需要:

  1. 验证和测试部分中,输入您的网站上的 URL。
  2. 点击获取测试链接
  3. 生成测试链接后,您可以通过以下方式分享它:
  4. 复制到剪贴板
  5. 短信
  6. 邮箱

生成测试链接后,请点击移动设备上的链接;不要忘记确认您的移动设备已经安装了该应用!

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>
  • 将用户链接到 web-only 内容

    • 作为 URL 查询参数添加到链接中:
      <a href="links.example.com?$web_only=true" >Link to your app!</a>

4个月前更新



Universal Email 集成指南


Universal Email(通用电子邮件)可让您自动将电子邮件链接转换为多平台的深度链接,这些链接可将用户直接带到移动设备上应用中的内容,同时仍为没有该应用的台式机和移动用户保持相同的网页端体验。

建议的编辑仅限于 API 参考页

您只能建议对 Markdown 正文内容进行修改,而不能建议对 API 说明进行修改。