短信—Vibes—OLD

概述

VibesVibes

本指南将引导您逐步了解如何使用 Branch Universal Email 通过 Vibes 设置您的短信 campaign,以将您的短信链接自动转化为多平台深度链接

基本集成包括四个部分:

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

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

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

设置

先决条件

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

要直接在 iOS 9.2+上打开应用程序,您必须配置短信集成和应用程序以支持电子邮件中的 Universal Link

随时联系 Branch 的客户经理或[电子邮件 受保护] 以获取有关设置步骤的帮助。

配置您的短信提供商

设置自定义点击追踪域

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

👍

添加自定义点击追踪域

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

设置点击追踪域

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

激活集成

选择您的短信服务提供商

前往 Branch 操作后台 (Dashboard) 的 Universal Email 部分。选择 Vibes 并点击 Enable

设置电子邮件链接行为

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

图片图片

要执行此操作,必须要将您的 web URL 内容(例如,一个有棕色便鞋的页面https://shop.com/shoes/brown-loafers )映射到一个有效的深度链接,该链接会将用户带到应用程序中的棕色便鞋。Universal Email 设置流程将尝试自动为您检测此映射。

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

图片图片

默认情况下,短信深度链接会将没有您的应用程序的用户重定向至网页的相同内容。

图片图片

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

图片图片

检查您的深度链接设置

如果您选择建立与应用程序中特定内容的深度链接,则可以跳过此步骤。

图片图片

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

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

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

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

如果无法成功检测映射到网页内容的应用程序深度链接方案,则可以手动配置设置,或者联系 Branch 客户经理或支持中心。

图片图片

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

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

  1. 推荐: Hosted deep link data: 您可以使用看起来像<meta name="branch:deeplink:my_key" content="my_value" /> 的元标记将深度链接数据托管在您的网站上,其中my_keymy_value 将成为深度链接数据中的 key 值对。对于每个 web URL,Branch 将查找这些标签,并将深度链接数据(如能找到)嵌入到深度链接中。请注意,Branch 还接受 App Link 标签进行深度链接。
  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 并将其放入深度链接数据中。

📘

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

在您的网站上托管深度链接数据使将来使用 Branch 产品变得更加容易。

短信的深度链接设置

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

链接行为

设置链接数据结果
Open the app homepage未配置任何设置来生成电子邮件的深度链接数据;电子邮件链接将路由到应用程序主页。
Open to specific app content根据以下一项或多项设置,深度链接到特定的应用程序内容。
将 URL 上的查询参数转化为 Branch Link 数据URL: https://shop.com/shoes/brown-loafers&product_id=123456product_id: 123456
将 web URL 转化为 Branch Link 数据:
key__的完整 URL
URL: https://shop.com/shoes/brown-loafers
Key: $canonical_url
$canonical_url: https://shop.com/shoes/brown-loafers
将 web URL 转化为 Branch Link 数据:
key__的完整 URL
URL: https://shop.com/shoes/brown-loafers
Key: $deeplink_path
$deeplink_path: shoes/brown-loafers
从网站检索托管的深度链接数据并将其转化为 Branch Link 数据URL: https://shop.com/shoes/brown-loafers
Meta Tags: <meta name="branch:deeplink:product_id" content="123456" />
product_id: 123456
剥离协议(http:// 或 https://):
从 $deeplink_path
从 $ios_deeplink_path
从 $android_deeplink_path
注意:通常与其他设置之一一起使用。
URL: https://shop.com/shoes/brown-loafers
Other Settings: 将 web URL 转化为 Branch Link 数据:key 的完整 URL $deeplink_path
$deeplink_path: shop.com/shoes/brown-loafers
将 URL 上的查询参数转化为从参数__到 key__的 Branch Link 数据
注意:不可在用户界面中配置。
URL: https://shop.com/shoes/brown-loafers&product_id=123456&utm_content=shoes
Parameter: utm_content
Key: category
category: shoes

没有应用程序的用户的链接行为

设置描述
打开特定的网页内容路由到电子邮件中指定的原始 URL。
打开默认重定向路由到 Link Settings 指定的默认值。

告诉我们您的点击追踪域

您可以从 Vibes 帐户中获取点击追踪域。如果您尚未添加自定义点击追踪域,请遵循此处的说明。

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

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

图片图片

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

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

验证和测试

图片图片

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

完成后,将生成特定于该域的 AASA 文件和 SSL 证书(Universal Link 所需)。

只有当您的链接包含在点击追踪域时,转化为 Branch Link 才会有效。要测试链接而不进行包装,请在电子邮件加载验证步骤生成一个测试链接,也可以通过点击电子邮件页面上的 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 domain。

配置您的移动应用

技术设置

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

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

📘

它是如何工作的?

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

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

要在点击追踪域启用 Universal Link,您需要有将点击追踪域添加到您的关联域的权限。

  1. 在 Xcode 中,转到项目文件的Capabilities 选项卡。

  2. 向下滚动并启用Associated Domains (如果尚未启用)。

    图片图片

  3. Branch 收到的邮件中复制点击追踪域,或从 ESP 设置中获取。

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

    图片图片

📘

遇到问题或对 Universal Link 不熟悉?

请遵循这些说明以获取有关在 Branch 操作后台 (Dashboard) 和 Xcode 中启用 Universal Link 的更多详细信息。

处理 web-only 内容的链接

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

您应该在深度链接处理程序代码块内添加此代码片段。注意这使用查询参数$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. 保存文件。

👍

多个自定义域

If you have an unusual situation with multiple custom link domains, you may also configure branch_universal_link_domains as an array of strings. 图片图片

配置您的 ESP

设置自定义点击追踪域

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

    图片图片

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

👍

添加自定义点击追踪域

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

设置点击追踪域

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

🚧

SSL 变更

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

使用 Universal Email

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

本指南将确定您希望打开的应用程序和深度链接以及将它们转化为 Branch Link 的网页链接。

标记您的深度链接

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

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

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

标记 web-only 链接

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

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

🚧

处理 web-only 内容的链接

确保您已完成技术设置步骤以处理应用中的 web-only 链接。

支持中心

您对电子邮件的工作方式以及更多常见问题感兴趣吗? 请访问我们的 Universal Email 概述页面

5个月前更新


短信—Vibes—OLD


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

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