Oracle Responsys

概述

图片图片

设计并启动与内容相关的数字营销活动,以覆盖每个消费者。Oracle Responsys 可帮助您管理,个性化和协调所有渠道之间的互动,以在重要的时刻提供及时,有用的消息,而无需编写代码,进行复杂的技术培训或依靠其他专家。

1. 完成 Universal Email 先决条件

📘

可能需要开发者

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

🚧

需要开发人员

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

2.启用集成

要启用集成,您需要:

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

📘

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

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

3. 提供点击追踪域

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

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

Oracle Responsys 集成要求您提供以下内容:

  • 点击追踪域-与 Oracle Responsys 一起用于电子邮件链接的域

🚧

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

请记住

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

👍

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

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

重要的 CNAME 信息

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

4. Validate the Integration

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

Branch 自动验证以下内容:

  • 集成了 iOS SDK(必需)
  • 集成了 Android SDK(必需)
  • 深度链接已设置(必需)
  • 点击追踪域已设置(必需)
  • AASA 文件有效(必需)
  • 已正确设置 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. 生成电子邮件的 Branch Link

您可以通过几种不同的方法来创建与 Universal Email(通用电子邮件)+ Responsys 兼容的 Branch Links。您将需要用这些 URL 替换模板中的 Web URL。要创建 Branch Links,您可以:

  1. 使用 Branch Responsys SDK
  2. 使常规 Branch Link 与电子邮件兼容
  3. 通过 API 创建电子邮件链接,而无需更改电子邮件模板
  4. 将电子邮件中的所有 Web 链接转换为深度链接

Responsys 使用简码 e_rs 表示电子邮件链接—请在下面的指南中使用 e_xx 代替它。

1.使用 Branch Responsys SDK

在此步骤中,我们将上传一个 SDK,该 SDK 可让您轻松在电子邮件中创建深度链接。请记住,这将需要您启用 EMD(电子邮件设计器)的帐户。

📘

观看如何执行此操作

还有一个教程视频 ,介绍了这些步骤。

  1. 与您的 Branch 客户经理一起修改以下代码片段,将 DOMAIN-HERE 替换为您的 Branch 基本域:
<#macro deeplink link_to_be_wrapped><#assign branch_base_url="https://DOMAIN-HERE/3p?%243p=e_rs"><#assign final_link=branch_base_url + "&%24original_url=" + link_to_be_wrapped?url("ISO-8859-1")><a href="${final_link}"><#nested></a></#macro> <#macro tracked_deeplink link_to_be_wrapped><#assign branch_base_url="https://DOMAIN-HERE/3p?%243p=e_rs"><#assign deeplink=branch_base_url + "&%24original_url=" + link_to_be_wrapped?url("ISO-8859-1")></#macro>
  1. 登录到您的 Responsys 帐户。

  2. 在 Responsys 操作后台 (Dashboard)中,打开您的内容 Library。您也可以通过主页上的“快捷方式”屏幕来访问它:

    图片图片

  3. 进入内容管理器后,您将看到存储内容的文件夹列表。在 All Content ,创建一个名为 Branch_SDK 的新文件夹:

    图片图片

  4. 选择 Branch_SDK 文件夹,然后点击 Create Document

    图片图片

  5. 在“创建文档”窗口中:

    • 在“文档名称”字段中输入 branch-sdk

    • Content Box ,删除所有文本。

    • 将您复制的代码段粘贴到 1

    • 点击保存。

      图片图片

现在,您已经成功创建了深度链接脚本。您的文件结构应如下所示:

图片图片

配置您的 Responsys 电子邮件模板

此代码称为 "Branch script" 此脚本会将您的 Web URL 转化为深度链接。

Responsys 集成要求您在两个位置添加电子邮件模板代码。

  1. 在电子邮件模板的顶部
  2. 在超链接之前

复制以下代码段,然后使用“Source”视图将代码片段直接粘贴到要添加深度链接的每个模板 <html> 标签下。

<#include "cms://contentlibrary/Branch_SDK/branch-sdk.htm">

配置 Responsys 链接表

为了使 Branch SDK 在重定向时在电子邮件或 3P 链接中生成 Branch Link,电子邮件模板的链接追踪表应包含以下两个 LINK NAME,其中 ${deeplink}LINK URL

图片图片

要创建追踪链接,请确保将 ‘Track Link’ 设置为 ON 。追踪链接将在 Responsys Click Tracking Domain 下生成,然后重定向到 Branch 3p 链接(该链接作为基本 URL 添加到 Branch_SDK.htm 文件中。

创建深度链接接

无论您在电子邮件模板中使用 <a> 标签的任何地方,都用 <@deeplink> 标记替换这些标签,或者为要深度链接的 Web URL 添加 <@tracked_deeplink />

禁用链接追踪后的外观如下。

之前:
<a href="https://branch.io">Example link</a>

之后:
<@deeplink "https://branch.io">Example link</@deeplink>
{%endexample%}

启用链接追踪后,您仍然可以在电子邮件中使用 Branch Link。

之前:
<a href="https://branch.io/product/1234">Example link</a>

之后:
<@tracked_deeplink "https://branch.io/product/1234" /> <a href="${clickthrough('TEST_TRACKED_DEEPLINK' , 'deeplink=' + deeplink)}">Example link</a>

后一个示例从链接表中提取。

图片图片

2. 使常规 Branch Link 与电子邮件兼容

请确保在电子邮件中使用的所有链接的深度链接数据中添加 "$3p":"e_xx" ,以确保 Universal Link 和点击追踪能够按预期工作。

3. 通过 API 创建电子邮件链接,而无需更改电子邮件模板

要通过 API 创建电子邮件链接,请参考如何通过 API 创建链接的说明,但在调用中包含以下 key 值对:

  1. "$3p":"e_xx" 这是 Universal Link 和点击追踪功能所必需的。
  2. "$original_url":"{{your web url URI encoded}}" 对于每个内容,请包含内容 web URL 的 URI 编码版本。您也可以在该 web URL 中添加深度链接数据作为查询参数。这样可以确保准确的内容分析报告。
    例如: "$original_url":"https%3A%2F%2Fshop.com%2Fshoes%2Fbrown-shoes%3Fmy_key%3Dmy_value%26campaign%3Dshoe_discounts"

4.将电子邮件中的所有网络链接转换为深层链接

我们提供了一种轻松将 web link 转化为 Branch Link 的方法。该示例采用 html email(作为 string)并将脚本应用于它。

这是脚本:

var crypto = require('crypto');
module.exports = function(original_url, branch_base_url) {
    if (!original_url) { return new Error('Missing original_url'); }
    if (typeof original_url != 'string') { return new Error('Invalid original_url'); }
    if (!branch_base_url) { return new Error('Missing branch_base_url, should be similar to https://bnc.lt/abcd/3p?%243p=e_xx'); }
    if (typeof branch_base_url != 'string') { return new Error('Invalid branch_base_url'); }

    return branch_base_url + '&%24original_url=' + encodeURIComponent(original_url);
};

这是链接前后的外观(后者是 Branch 深度链接)。

  1. 之前: http://example.com/?foo=bar
  2. 之后: https://vza3.app.link/3p?%243p=e_xx&%24original_url=http%3A%2F%2Fexample.com%2F%3Ffoo%3Dbar

注意这些是简化的示例,不是实际的演示链接。

处理 web-only 内容的链接

在某些情况下,您可能会在 Web 上找到不在应用中的内容—例如,临时的母亲节促销或取消订阅键。如果使用 Responsys 链接表功能,则可以指定仅在 Web 上打开的链接。还有在链接三个表 URL 字段创建一个新的链接时: LINK_URLIOS_LINK_URL ,和 ANDROID_LINK_URL 。如果您仅在 LINK_URL 字段中输入链接,则最终 click-wrapped URL 路径将以 /pub/cc 开头。但是,如果您还在 IOS_LINK_URL 输入相同的链接,则最终点 click-wrapped URL 路径将以 pub/acc 开头。您应该将 AASA 文件设置为仅将路径 /pub/acc* 列入白名单,以免仅通过网络链接启动应用。

图片图片

图片图片

附加信息

Styling

如果您在 <a> 标签中包含样式标签,则需要将这些标签分离到 <@deeplink> 标签内的单独 div 中。如果您将追踪链接与 <a> 标签一起使用,则这些标签会正常工作。

Style 标签中的样式标签如下:

之前:

<a href="https://branch.io/" style="color:#000001; text-decoration:none;">Branch Website</a>

之后:

<@deeplink "https://branch.io/"><div style="color:#000001; text-decoration:none;">Branch Website</div></@deeplink>

启动失败错误

如果模板中未包含 <#import > 片段,则会看到此错误。

Launch Failed: Launch failed: Template /contentlibrary/branch test campaign/My Default Template.htm caused an execution error: on line 183, column 92 in cms://contentlibrary/branch test campaign/Content.htm: deeplink is not a user-defined directive. It is a freemarker.template.SimpleScalar

使用配置文件扩展表中的动态数据

<@deeplink ><@tracked_deeplink /> 标签甚至可以通过 RPL 注入动态链接。

<@deeplink "${latestProduct.url}">${latestProduct.name}</@deeplink>

Dynamic Query Parameters

Certain links in the Responsys Link Table use dynamic variables as query parameters.
Ex. ....com/?key=${VALUE}
In some cases, the value parameter will require additional URI encoding in order for the final URL to be a valid link.