通用电子邮件集成指南

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

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

1.完成通用电子邮件先决条件

可能需要开发者

以下通用电子邮件先决条件包括提供URI方案和其他可能需要开发人员的组件:

2.启用集成

要启用集成:

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

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

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

3.提供点击跟踪域

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

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

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

在分支仪表板中添加点击跟踪域时,请删除http://https://

adestra adobe campaign classic adobe campaign standard airship amazon simple email service betaout bluecore blueshift 铜焊+ mailjet 钎焊+ sendgrid 铜焊+火花柱 campaign monitor cheetah digital marketing suite cheetah mail cmercury cordial customer.io emarsys epsilon 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打开网页默认设置 Salesforce打开的应用默认 salesforce v2旧版 salesforce v3旧版 selligent marketing cloud selligent message studio sender sendgrid smartech socialflow sparkpost vero whatcounts yes marketing zeta

记住

  • 您可以根据需要启用与多个CTD的集成,但是不能将同一CTD添加到多个Branch仪表板或ESP集成中。

  • 在某些ESP集成中,还要求您添加"数据域" ,ESP用来收集点击数据。

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

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

在单击 NEXT 并继续进行 Validate & Test 部分之前,请完成通过集成验证所需的以下部分。

4.将DNS CNAME指向分支

不要为以下ESP完成此步骤

以下ESP要求CNAME指向它们而不是分支。对于下面的静电除尘器,确保您不点的DNS CNAME到店和跳过此步骤。

  • Oracle Responsys
  • Salesforce Open Web Default
  • Salesforce Open App Default
  • Salesforce旧版v2
  • Salesforce旧版v3

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

对于以下ESP,此端点发生更改:

  • 的Epsilon - epsilon.thirdparty.bnc.lt

请按照您的网络托管提供商的说明来配置DNS CNAME。以下是一些常见的提供程序说明,以供参考:

重要的CNAME信息

  • 必须启用Branch仪表板&反映CTD 添加CNAME之前。
  • 如果CTD已经具有SSL设置,请确认您的安全凭据是否允许第三者代表域提交CSR。如果不是,请联系 [电子邮件保护] 或您的分支机构客户经理,以协调向分支机构手动提供SSL证书。
  • 添加CNAME后,Branch会自动为您的点击跟踪域生成SSL证书和AASA文件。更改CNAME后,最多可能需要一个小时才能解决SSL错误。在此期间,点击跟踪域上的链接重定向将重定向到您在帐户的常规配置部分中提供的默认URL
  • 如果您要对具有活动电子邮件点击流量的实时域进行此更改,请安排CNAME更改在点击流量较低的非工作时间进行。

5.验证集成

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

分支自动验证以下内容:

  • 集成了iOS SDK(必填)
  • 集成了Android SDK(必填)
  • 深度链接已设置(必填)
  • 点击跟踪域已设置(必填)
  • AASA文件有效(必填)
  • 已正确设置SSL(必填)
  • CNAME指向thirdparty.bnc.lt(视情况而定)
  • 已设置通用链接(必填)
  • 托管的深层链接数据(可选)
  • 正在跟踪应用事件(可选)
  • Android应用链接(可选)

常见验证问题

CNAME不指向分支

将您的DNS CNAME指向Branch是集成过程中至关重要的一步。不幸的是,这也是引起最多头痛的步骤。

请确保执行以下操作:

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

注意:对于CNAME必须保持指向ESP的集成,将始终显示此警告。如果在验证以下ESP集成时看到此警告,则可以忽略并继续验证。

  • Oracle Responsys
  • Salesforce Open Web Default
  • Salesforce Open App Default
  • Salesforce旧版v2
  • Salesforce旧版v3

无法正确设置SSL

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

AASA文件无效

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

6.测试集成

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

生成测试链接:

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

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

7.开始发送带有标记链接的电子邮件

恭喜,您已成功建立与ESP的集成!在开始设置电子邮件活动之前,您需要确定希望用户体验的流量并相应地标记电子邮件链接。

大多数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查询参数添加到链接中:
      <a href="links.example.com?$web_only=true" >Link to your app!</a>

更新19 天前


通用电子邮件集成指南


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

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

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