有关不使用标签管理器(Adobe Launch或Dynamic Tag Manager)实现Adobe Target的信息。
Adobe Launch 是实施 Target 和 at.js 库的首选方法。以下信息不适用于使用 Adobe Launch 实施 Target 的情况。
要访问实施页,请单击管理 > 实施。
您可以在此页面上指定以下设置:
您可以覆盖 at.js 库中的设置,而不是在 Target Standard/Premium UI 中或通过使用 REST API 来配置设置。有关更多信息,请参阅 targetGlobalSettings()。
您可以视图以下帐户详细信息。 无法更改这些设置。
设置 | 描述 |
---|---|
客户代码 | 客户端代码是指特定于客户端的字符序列,使用 Target API 时通常需要使用此设置。 |
IMS 组织 ID | 此 ID 可将您的实施绑定到您的 Adobe Experience Cloud 帐户。 |
可以在“实施方法”面板中配置以下设置:
这些设置将应用于所有Target .js库。 在实施方法部分执行更改后,您需要下载库并在实施中更新它。
设置 | 描述 |
---|---|
启用页面加载(自动创建全局mbox) | 选择是否要将全局 mbox 调用嵌入到 at.js 文件中,以使其在每次加载页面时自动触发。 |
全局 mbox | 为全局 mbox 选择一个名称。默认情况下,此名称为 target-global-mbox。 使用 at.js 的 mbox 名称中可以使用特殊字符,包括与号 (&)。 |
超时(秒) | 如果 Target 未在定义的时间段内做出响应并显示相应内容,则服务器调用会超时,此时会显示默认内容。在访客会话期间会继续尝试发起其他调用。默认时间为 5 秒。 at.js 库使用的是 XMLHttpRequest 中的超时设置。超时从请求被触发时开始,直到 Target 收到来自服务器的响应时结束。有关更多信息,请参阅 Mozilla 开发人员网络上的 XMLHttpRequest.timeout。如果在指定的超时内未收到响应,则会显示默认内容,且访客可能会被计为活动的参加者,因为所有数据收集都是在 Target 边缘网络中进行的。如果 Target 边缘网络收到了请求,则访客会被计为参加者。 配置超时设置时,请考虑以下事项:
注意:visitorApiTimeout 设置可确保 Target 等待访客 API 响应的时间不会太长。此设置和此处介绍的 at.js 中的“超时”设置不会相互影响。 |
配置文件生命周期 | 此设置可决定访客配置文件的存储时长。默认情况下,配置文件会存储两周时间。最多可将此时间延长到 90 天。 要更改“配置文件生命周期”设置,请联系客户关怀团队。 |
目标团队支持at.js 1。x 与 at.js 2.x 之间的映射。请升级到at.js的任一主要版本的最新更新,以确保您运行的是受支持的版本。
要下载所需的at.js版本,请单击相应的下载按钮。
要编辑at.js设置,请单击所需at.js版本旁的编辑。
在更改这些默认设置之前,请咨询客户关怀,以便不影响当前实施。
除上述设置外,还提供以下特定at.js设置:
设置 | 描述 |
---|---|
自定义库标题 | 将任何自定义 JavaScript 添加到库顶部。 |
自定义库页脚 | 将任何自定义 JavaScript 添加到库底部。 |
可为通过 API 进行的批量更新启用或禁用身份验证,并生成配置文件身份验证令牌。
有关详细信息,请参阅用户档案API设置。
生成授权令牌以使用高级Target调试工具。 单击生成新身份验证令牌。
这些设置允许您根据适用的数据隐私法使用Target。
从“模糊访客IP地址”下拉列表中选择所需的设置:
有关更多信息,请参阅隐私。
at.js版本0.9.3及更早版本中提供了“旧版浏览器支持”选项。 at.js 版本 0.9.4 中已删除此选项。要获取 at.js 支持的浏览器列表,请参阅受支持的浏览器。
旧版浏览器是指早期推出的不完全支持 CORS(跨域资源共享)的浏览器。这些浏览器包括:Internet Explorer 版本 11 之前的浏览器,以及 Safari 版本 6 及更低版本。如果禁用了“旧版浏览器支持”,目标不会在这些浏览器上的报告中提供内容或计算访客数。 如果启用了此选项,则建议跨旧版浏览器进行质量保证,以确保良好的客户体验。
使用Target接口或下载API下载库的说明。
Adobe Launch 是实施 Target 和 at.js 库的首选方法。以下信息不适用于使用 Adobe Launch 实施 Target 的情况。
目标团队支持at.js 1。x 与 at.js 2.x 之间的映射。请升级到at.js的任一主要版本的最新更新,以确保您运行的是受支持的版本。 有关每个版本中功能的更多信息,请参阅 at.js 版本详细信息。
要从 Target 界面下载 at.js,请执行以下操作:
要使用 API 下载 at.js,请执行以下操作:
获取您的客户端代码。
您的客户端代码位于Target接口的管理 > 实施页面的顶部。
获取您的管理员编号。
加载以下 URL:
https://admin.testandtarget.omniture.com/rest/v1/endpoint/<varname>client code</varname>
将步骤1中的client code
替换为客户端代码。
加载此 URL 后,应该会出现类似于以下示例的结果:
{
"api": "https://admin6.testandtarget.omniture.com/admin/rest/v1"
}
在此示例中,“6”表示管理员编号。
下载 at.js。
加载具有以下结构的 URL:
https://admin<varname>admin number</varname>.testandtarget.omniture.com/admin/rest/v1/libraries/atjs/download?client=<varname>client code</varname>&version=<version number>
admin number
替换为您的管理员编号。client code
替换为客户端代码。version number
替换为所需的at.js版本号(例如,2.2)。Target 团队仅维护两个版本的 at.js:当前版本和当前版本的上一个版本。请根据需要升级 at.js,以确保您运行的是受支持的版本。有关每个版本中功能的更多信息,请参阅 at.js 版本详细信息。
加载此 URL 后,便会开始下载您的自定义 at.js 文件。
at.js 应该在您网站每个页面的 <head>
元素中实施。
不使用标签管理(例如 Adobe Launch 或动态标签管理)的典型 Target 实施如下所示:
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<title>Title of the Page</title>
<!--Preconnect and DNS-Prefetch to improve page load time-->
<link rel="preconnect" href="//<client code>.tt.omtrdc.net">
<link rel="dns-prefetch" href="//<client code>.tt.omtrdc.net">
<!--/Preconnect and DNS-Prefetch-->
<!--Data Layer to enable rich data collection and targeting-->
<script>
var digitalData = {
"page": {
"pageInfo": {
"pageName": "Home"
}
}
};
</script>
<!--/Data Layer-->
<!-- targetPageParams(), targetPageParamsAll(), Data Providers or targetGlobalSettings() functions to enrich the visitor profile or modify the library settings-->
<script>
targetPageParams = function() {
return {
"a": 1,
"b": 2,
"pageName": digitalData.page.pageInfo.pageName,
"profile": {
"age": 26,
"country": {
"city": "San Francisco"
}
}
};
};
</script>
<!--/targetPageParams()-->
<!--jQuery or other helper libraries should be implemented before at.js if you would like to use their methods in Target-->
<script src="jquery-3.3.1.min.js"></script>
<!--/jQuery-->
<!--Target's JavaScript SDK, at.js-->
<script src="at.js"></script>
<!--/at.js-->
</head>
<body>
The default content of the page
</body>
</html>
请注意以下重要说明:
<!doctype html>
)。不受支持或较旧的 doctypes 可能会导致 Target 无法提出请求。<client code>
,您可以从管理 > **实施页获得该客户端代码。<head>
中定义尽可能多的数据层。此位置允许您在 Target 中利用此信息进行最大程度的个性化。targetPageParams()
、targetPageParamsAll()
、数据提供程序和 targetGlobalSettings()
)应在 at.js 加载之前,数据层加载之后进行定义。或者,可以将这些函数保存在“编辑 at.js 设置”页面的“库标头”部分中,并另存为 at.js 库的一部分。有关这些函数的更多信息,请参阅 at.js 函数。<head>
中。订单确认 mbox 将记录您网站上订单的详细信息,并能够基于收入和订单生成报表。订单确认 mbox 还可驱动推荐算法,例如“购买了产品 x,也购买了产品 y 的人”。
如果用户在您的网站上进行购买,那么即使您使用了 Analytics for Target (A4T) 进行报告,我们也仍然建议您实施订单确认 mbox。
在订单详细信息页面,按照以下模式插入 mbox 脚本。
使用您目录中的动态或静态值替换大写的文字。
使用逗号分隔多个产品 ID。
提示:您也可以在任意 mbox(必须命名为 orderConfirmPage
)中传递订单信息。还可以在同一营销活动之内的多个 mbox 中传递订单信息。
<script type="text/javascript">
adobe.target.trackEvent({
"mbox": "orderConfirmPage",
"params":{
"orderId": "ORDER ID FROM YOUR ORDER PAGE",
"orderTotal": "ORDER TOTAL FROM YOUR ORDER PAGE",
"productPurchasedId": "PRODUCT ID FROM YOUR ORDER PAGE, PRODUCT ID2, PRODUCT ID3"
}
});
</script>
订单确认 mbox 使用以下参数:
参数 | 描述 |
---|---|
orderId | 针对转化计数标识订单的唯一值。orderId 必须唯一。报表中会忽略重复订单。 |
orderTotal | 所购产品的币值。 不要传递货币符号。使用小数点(而非逗号)表示小数值。 |
productPurchasedId(可选) | 订单中所购产品的产品 ID(逗号分隔)列表。 这些产品 ID 显示在审计报表中,以支持其他报表分析。 |