Experience League

Experience Cloud

Document Cloud

不通过标签管理器实施 Target

有关不使用标签管理器（Adobe Launch或Dynamic Tag Manager）实现Adobe Target的信息。

注意

Adobe Launch 是实施 Target 和 at.js 库的首选方法。以下信息不适用于使用 Adobe Launch 实施 Target 的情况。

要访问实施页，请单击管理 > 实施。

您可以在此页面上指定以下设置：

帐户详细信息
实现方法
用户档案API
调试器工具
隐私

注意

您可以覆盖 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 边缘网络收到了请求，则访客会被计为参加者。配置超时设置时，请考虑以下事项：如果超时值过低，则用户大部分时间可能都会看到默认内容，即使访客可被计为活动参加者也是如此。如果超时值过高，则在延长的时间段内，访客可能会在您的网页上看到空白区域，如果您使用了主体隐藏技术，则可能还会看到空白页面。要更好地了解 mbox 响应时间，请查看浏览器“开发人员工具”中的“网络”选项卡。您还可以使用第三方 Web 性能监测工具，例如 Catchpoint。注意：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 进行的批量更新启用或禁用身份验证，并生成配置文件身份验证令牌。

有关详细信息，请参阅用户档案API设置。

调试器工具

生成授权令牌以使用高级Target调试工具。单击生成新身份验证令牌。

生成新的身份验证令牌

隐私

这些设置允许您根据适用的数据隐私法使用Target。

从“模糊访客IP地址”下拉列表中选择所需的设置：

最后八位字节模糊化
整个IP模糊化
None

有关更多信息，请参阅隐私。

注意

at.js版本0.9.3及更早版本中提供了“旧版浏览器支持”选项。 at.js 版本 0.9.4 中已删除此选项。要获取 at.js 支持的浏览器列表，请参阅受支持的浏览器。
旧版浏览器是指早期推出的不完全支持 CORS（跨域资源共享）的浏览器。这些浏览器包括：Internet Explorer 版本 11 之前的浏览器，以及 Safari 版本 6 及更低版本。如果禁用了“旧版浏览器支持”,目标不会在这些浏览器上的报告中提供内容或计算访客数。如果启用了此选项，则建议跨旧版浏览器进行质量保证，以确保良好的客户体验。

下载 at.js

使用Target接口或下载API下载库的说明。

注意

Adobe Launch 是实施 Target 和 at.js 库的首选方法。以下信息不适用于使用 Adobe Launch 实施 Target 的情况。
目标团队支持at.js 1。x 与 at.js 2.x 之间的映射。请升级到at.js的任一主要版本的最新更新，以确保您运行的是受支持的版本。有关每个版本中功能的更多信息，请参阅 at.js 版本详细信息。

使用目标接口下载at.js

要从 Target 界面下载 at.js，请执行以下操作：

单击管理 > 实施。
从实现方法部分，单击所需at.js版本旁的下载按钮。

使用目标下载API下载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替换为您的管理员编号。
- 将步骤1中的client code替换为客户端代码。
- 将version number替换为所需的at.js版本号（例如，2.2）。
重要

Target 团队仅维护两个版本的 at.js：当前版本和当前版本的上一个版本。请根据需要升级 at.js，以确保您运行的是受支持的版本。有关每个版本中功能的更多信息，请参阅 at.js 版本详细信息。

加载此 URL 后，便会开始下载您的自定义 at.js 文件。

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>

请注意以下重要说明：

应使用 HTML5 Doctype（例如 <!doctype html>）。不受支持或较旧的 doctypes 可能会导致 Target 无法提出请求。
“预连接”和“预提取”选项可帮助提升网页加载速度。如果使用这些配置，请确保用您自己的客户端代码替换<client code>，您可以从管理 > **实施页获得该客户端代码。
如果您拥有数据层，那么在 at.js 加载之前，最好在页面的 <head> 中定义尽可能多的数据层。此位置允许您在 Target 中利用此信息进行最大程度的个性化。
特殊 Target 函数（例如 targetPageParams()、targetPageParamsAll()、数据提供程序和 targetGlobalSettings()）应在 at.js 加载之前，数据层加载之后进行定义。或者，可以将这些函数保存在“编辑 at.js 设置”页面的“库标头”部分中，并另存为 at.js 库的一部分。有关这些函数的更多信息，请参阅 at.js 函数。
如果您使用 JavaScript 帮助程序库（例如 jQuery），则请在使用 Target 之前包含它们，以便在构建 Target 体验时可以利用它们的语法和方法。
将 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 显示在审计报表中，以支持其他报表分析。

adobe.com 上的资源

在此页面上

查看下一个：

A virtual event April 27-28.

Expand your skills and get inspired.

隐私（已更新）

使用条款