短信-共鸣

概述

Vibes

本指南将引导您逐步了解如何使用Branch Universal电子邮件为 共鸣 设置您的短信活动,以自动将您的短信链接转换为多平台深度链接接

基本集成包括四个部分:

  1. 配置您的短信提供商
  2. 激活集成和设置链接行为
  3. 配置您的移动应用
  4. 更新短信中的链接

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

当没有应用程序的用户点击链接时,它将将该用户路由到原始Web URL(包括桌面上的URL)。当用户点击您的应用程序的链接时,它将引导该用户进入相关的应用程序内内容,而与平台或电子邮件客户端无关。

设置

先决条件

本指南要求您已经将将Branch SDK 集成到您的应用中。

要直接在iOS 9.2+上打开应用程序,您必须配置SMS集成并且您的应用程序支持电子邮件中的 Universal Links

随时联系您的分支机构客户经理或 [受电子邮件保护] 以获得设置步骤的帮助。

配置您的短信提供商

设置自定义点击跟踪域

  1. 在您的Vibes帐户中添加并验证自定义点击跟踪域。

添加自定义点击跟踪域

如果您在设置自定义点击跟踪域方面需要帮助,请咨询您的客户经理或在Vibes寻求支持。

设置点击跟踪域

添加并验证点击跟踪域后,您必须为其更新DNS CNAME并将其指向thirdparty.bnc.lt 。添加CNAME记录后,Branch机构最多需要一个小时才能为您的点击跟踪域生成SSL和AASA文件。

激活整合

选择您的短信服务提供商

导航到“Branch”仪表板的“ 通用电子邮件部分。选择Vibes 并点击Enable

设置电子邮件链接行为

Branch将您在SMS中放入的Web URL转换为Branch深度链接接,为安装了该应用程序中相同内容的用户打开该应用程序。

图像

为此,必须有可能将您的Web URL内容(例如,一个带有棕色便鞋的页面https://shop.com/shoes/brown-loafers )映射到一个有效的深度链接接,该链接会将用户带到应用程序中的棕色便鞋。通用电子邮件设置流程将尝试自动为您检测此映射。

如果您不想进行此设置,则可以选择No, just open to app homepage for now

图像

默认情况下,SMS深度链接会将用户而不带您的应用程序重定向到网络上的相同内容。

图像

如果您想将用户发送到App Store或在“链接设置”中指定的其他默认值,则可以选择Open to default redirects

图像

检查您的深度链接接设置

如果您选择而不是来设置与应用程序中特定内容的深层链接,则可以跳过此步骤。

图像

在此步骤中,您将要输入一个与应用程序中特定屏幕相对应的Web URL。换句话说,网页应包含您的应用程序中也存在的内容。如果您不知道您的网站内容是否也存在于应用程序内,请尝试使用网站首页以外的任何URL。一些例子:

  • 产品页面,例如带有棕色便鞋的页面
  • 一篇文章
  • 内容页面,例如视频或图像

选择一个并单击Submit ,将从您的网页中检索可用于深层链接元标记。您将看到一个结果,指示您的Web内容和您的应用程序内容之间的映射。

我们无法'确定您的深度链接接设置

如果无法成功检测到映射到您的Web内容的应用程序深层链接方案,则可以手动配置设置,或者与分支机构客户经理联系或寻求帮助。

图像

我们将帮助您设置以下方法之一:

如果您使用唯一键/值数据作为深度链接接值:

  1. 推荐的: Hosted deep link data: 您可以使用看起来像<meta name="branch:deeplink:my_key" content="my_value" /> 的元标记将深层链接数据托管在您的网站上,其中my_keymy_value 将成为深层链接数据中的键值对。对于每个Web URL,Branch将查找这些标签,并将深层链接数据(如果找到)嵌入到深层链接中。请注意,Branch还接受App Links标签进行深层链接。
  2. As query parameters: 只需将查询参数附加到您的Web URL上,Branch将采用这些参数并将其放入深度链接接数据中。

如果您将Web URL用作深度链接接值:

  1. URL path: 如果将Web URL的路径用作$deeplink_path 值或任何其他深度链接接值,则配置将自动采用URL的路径并将其放入深度链接接数据中。
  2. Full URL: 如果将完整的Web URL用作$deeplink_path 值或任何其他深度链接接值,则配置将采用整个URL并将其放入深度链接接数据中。

托管深度链接接数据,而不仅仅是电子邮件

在您的网站上托管Deep Link数据将使将来使用Branch产品更加容易。

SMS的深度链接接设置

以下是可以配置为与SMS进行深度链接的所有可能的设置。

链接行为

设置 链接数据结果
Open the app homepage 未配置任何设置来生成电子邮件的深度链接接数据;电子邮件链接将路由到应用程序主页。
Open to specific app content 根据以下一项或多项设置,深度链接接到特定的应用程序内容。
Translate query parameters on URLs into Branch link data URL: https://shop.com/shoes/brown-loafers&product_id=123456 product_id: 123456
Translate web URL into Branch link data:
Full URL for key __
URL: https://shop.com/shoes/brown-loafers
Key: $canonical_url
$canonical_url: https://shop.com/shoes/brown-loafers
Translate web URL into Branch link data:
URL path for key __
URL: https://shop.com/shoes/brown-loafers
Key: $deeplink_path
$deeplink_path: shoes/brown-loafers
Retrieve hosted deep link data from website and translate into Branch link data URL: https://shop.com/shoes/brown-loafers
Meta Tags: <meta name="branch:deeplink:product_id" content="123456" />
product_id: 123456
Strip protocol (http:// or https://):
from $deeplink_path
from $ios_deeplink_path
from $android_deeplink_path
Note: Typically used with one of the other settings.
URL: https://shop.com/shoes/brown-loafers
Other Settings: 将Web URL转换为Branch链接数据:密钥的完整URL $deeplink_path
$deeplink_path: shop.com/shoes/brown-loafers
Translate query parameters on URLs into Branch link data from parameter __ to key __
Note: Not configurable in the UI.
URL: https://shop.com/shoes/brown-loafers&product_id=123456&utm_content=shoes
Parameter: utm_content
Key: category
category: shoes

没有您的应用的用户的链接行为

设置 描述
Open to specific web content 路由到电子邮件中指定的原始URL。
Open to default redirects 路由到 Link Settings 指定的默认值。

告诉我们您的点击跟踪域名

您可以从Vibes帐户中获取点击跟踪域。如果您尚未添加自定义点击跟踪域,请按照说明这里

为您的点击跟踪域配置您的应用

您可以将ESP配置发送给您的开发团队

图像

在此提示中,输入您团队中有资格修改iOS应用程序的某人的电子邮件,然后单击Send 。他们将完成以下步骤的技术设置。

点击下一步继续验证和测试集成

验证和测试

图像

通用电子邮件”设置流程的最后一步将验证您是否已完成所有必要步骤,以及团队中的工程师是否已完成集成步骤。您还将看到有关如何改善电子邮件集成的建议。

完成' ,将生成特定于该域的AASA文件和SSL证书(通用链接所需)。

仅当您的链接包含在点击跟踪域中时,转换为Branch链接才有效。要测试链接而不进行包装,请在电子邮件载入的验证步骤上生成一个测试链接,也可以通过点击电子邮件页面上的ESP齿轮图标来访问该链接。

图像

您的幕后链接会发生什么?

这是电子邮件模板中的链接:

http://example.com/?foo=bar

当用户点击您的链接时,Branch处理该链接并将其转换为如下形式:

https://vza3.app.link/3p?%243p=e_xx&%24original_url=http%3A%2F%2Fexample.com%2F%3Ffoo%3Dbar

其中vza3.app.link 是您的Branch域。

配置您的移动应用

技术设置

以下应用程序更改可确保您的电子邮件集成支持 Universal Links 。您将需要访问您的应用代码以进行这些更改。

您应该收到来自Branch机构的电子邮件,其中包含您的ESP '的点击跟踪域。如果没有,您或团队中的某人可能仍需要完成 Universal Email设置流程

它是如何工作的?

Apple将点击跟踪域识别为通用链接,并在不打开浏览器的情况下立即打开该应用程序。打开应用程序后,Branch将收集打开该应用程序的引荐URL(此时将是点击跟踪URL)。在应用程序内,Branch将自动“点击”链接,将点击注册到ESP,然后将Branch链接信息返回到应用程序内的Branch SDK。然后,此信息用于将用户与正确的应用内内容进行深度链接。

将点击跟踪域添加到关联域

要在点击跟踪域名启用通用链接,您' LL需要点击追踪域添加到您的关联域的权利。

  1. 在Xcode中,转到项目文件的Capabilities 选项卡。
  2. 向下滚动并启用Associated Domains 如果尚未启用)。

    图像

  3. 从您从分支收到的电子邮件中复制点击跟踪域,或者从ESP '的设置中检索它。

  4. Domains 部分中,点击+ 图标,然后添加您的点击跟踪域。例如,如果您的点击跟踪域为email.example.com ,则为applinks:email.example.com添加一个条目。

    图像

遇到麻烦或对通用链接不熟悉?

请遵循这些说明以获取有关在Branch仪表板和Xcode中启用通用链接的更多详细信息。

处理仅网络内容的链接

如果您具有仅存在于Web而非应用程序中的内容的链接(例如,应用程序中不为' t的临时营销网页),则此代码段将确保所有未应用深度链接接脚本的链接将在浏览器中打开。

您应该在深度链接处理程序代码块内添加此代码段。请注意,这使用查询参数$web_only=true 。这应与您在电子邮件中输入的Web URL 上的查询参数匹配。

[branch initSessionWithLaunchOptions:launchOptions andRegisterDeepLinkHandler:^(NSDictionary *params, NSError *error) {
  // params are the deep linked params associated with the link that the user clicked before showing up.
  if (params[@"$3p"] && params[@"$web_only"]) {
            NSURL *url = [NSURL URLWithString:params[@"$original_url"]];
            if (url) {
                [application openURL:url]; // check to make sure your existing deep linking logic, if any, is not executed, perhaps by returning early
            }
  } else {
    // it is a deep link
    GDLog(@"branch deep link: %@", [params description]);
    [self handleBranchDeeplink:params];
  }
}];

返回YES继续continueUserActivity

当用户通过通用链接进入您的应用时,我们将检查链接URL是否包含app.link 。如果是这样,则handledByBranch 将返回YES 。如果不是,则handledByBranch 将返回NO 。这使我们可以明确确认传入的链接来自Branch,而无需进行服务器调用。

对于大多数实现而言,这永远不会成为问题,因为您的深度链接接将以任何一种方式正确路由。但是,如果您使用自定义链接域 ,则依靠handledByBranch 为每个传入的Branch生成的通用链接返回YES ,可以按照以下步骤通知Branch SDK:

  1. 在您的Info.plist 文件中,创建一个名为branch_universal_link_domains的新密钥。
  2. 将您的自定义域添加为字符串。 图像
  3. 保存文件。

多个自定义域

如果您有多个自定义链接域的异常情况,也可以将branch_universal_link_domains 配置为字符串数组。 图像

配置您的ESP

设置自定义点击跟踪域

  1. 在您的ActiveCampaign帐户的[Setting -> Domain] 部分中添加并验证自定义点击跟踪域:

    图像

有关如何设置域的更多信息,请访问ActiveCampaign ' s 文档

添加自定义点击跟踪域

如果您需要有关设置自定义点击跟踪域的帮助,请咨询您的客户经理或在ActiveCampaign寻求支持。

设置点击跟踪域

添加并验证点击跟踪域后,您必须为其更新DNS CNAME并将其指向 thirdparty.bnc.lt 。添加CNAME记录后,Branch机构最多需要一个小时才能为您的点击跟踪域生成SSL和AASA文件。

SSL变更

请注意,更改CNAME后,最多可能需要一个小时才能解决SSL错误。在这段时间内,点击跟踪域上的链接重定向将重定向为branch.io 。如果您要对具有来自用户的电子邮件点击流量的实时域进行更改,则最好与Branch机构客户经理安排时间,以在点击流量较低时加快更改速度。

使用通用电子邮件

完成次设置步骤 ,就该发送第一封电子邮件了。

本指南将确定您'想要打开的应用程序和深度链接接以及将它们转换为Branch链接的' Web链接。

标记您的深度链接接

对于要深度链接接到内容的电子邮件链接,请在URL上添加$deep_link=true 作为查询参数,例如:

<a href="links.example.com?$deep_link=true" >Link to your app!</a>

这样可以确保将您的链接转换为可以在iOS和Android上打开应用程序的Branch链接,并具有完整的跟踪和归因。

标记仅网络链接

通过您的电子邮件服务提供商,默认情况下,所有电子邮件链接都将打开该应用程序。为了使您的应用在打开应用后知道电子邮件链接应反弹到网络,请在链接中添加$web_only=true 作为查询参数,例如:

<a href="links.example.com?$web_only=true" >Link to your app!</a>

处理仅网络内容的链接

确保您已完成技术设置步骤以处理您应用中的纯网络链接。

支持中心

对电子邮件的工作方式以及更多常见问题感兴趣吗? 访问我们的通用电子邮件概述页。

3个月前更新

短信-共鸣


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

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