不通过标签管理器实施Target

有关在不使用Adobe Experience Platform中的标记管理器或标记的情况下实现Adobe Target的信息。

NOTE
Adobe Experience Platform中的标记是实现Target和at.js库的首选方法。 使用Adobe Experience Platform中的标记实施Target时,以下信息不适用。

要访问“实现”页面,请单击​管理 > 实现

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

  • 帐户详细信息
  • 实施方法
  • 配置文件API
  • 调试器工具
  • 隐私
NOTE
您可以覆盖at.js库中的设置,而不是在Target Standard/Premium UI中或通过使用REST API来配置它们。 有关更多信息,请参阅 targetGlobalSettings()

帐户详细信息

您可以查看以下帐户详细信息。 无法更改这些设置。

设置
描述
客户端代码
客户端代码是特定于客户端的字符序列,使用Target API时通常需要使用此序列。
IMS组织ID
此ID可将您的实施绑定到Adobe Experience Cloud帐户。
设备上决策

要启用设备上决策,请将切换开关滑动到“开”位置。

通过设备上决策,可在服务器上缓存A/B和体验定位(XT)营销活动,并以近乎零延迟的速度执行内存中决策。 有关详细信息,请参阅设备上决策简介

将所有符合设备端决策条件的活动都包含在项目中

(视情况而定)如果您启用设备上决策,则会显示此选项。

如果您希望所有符合设备上决策条件的实时Target活动自动包含在项目中,请将切换开关滑动到“开”位置。

将此开关保留为关闭状态表示您必须重新创建和激活任何设备上决策活动,才能将其包含在生成的规则工件中。

实施方法

可以在“实施方法”面板中配置以下设置:

全局设置

NOTE
这些设置应用于所有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天。

要更改配置文件生命周期设置,请联系客户关怀团队

主要实现方法

NOTE
Adobe Target同时支持at.js 1.x​和at.js 2.x。 升级到at.js任一主要版本的最新更新,以确保您运行的是受支持的版本。

要下载所需的at.js版本,请单击相应的​ 下载 ​按钮。

要编辑at.js设置,请单击所需的at.js版本旁边的​编辑

WARNING
在更改这些默认设置之前,请咨询客户关怀团队,以免影响当前的实施。

除了上述设置之外,还提供以下特定的at.js设置:

设置
描述
跨域
对于at.js v1.x,通过选择enabled (浏览器同时设置第一方Cookie和第三方Cookie),指定跨域功能是disabled (浏览器在您的域中设置Cookie(仅第一方Cookie))、x only (浏览器在Target的域中设置Cookie)还是同时使用两者。 对于at.js v2.10及更高版本,请指定跨域功能是enabled (浏览器同时设置第一方Cookie和第三方Cookie)还是disabled (浏览器不设置第三方Cookie)。
自定义库标头
将任何自定义 JavaScript 添加到库顶部。
自定义库页脚
将任何自定义 JavaScript 添加到库底部。

配置文件API

可为通过 API 进行的批量更新启用或禁用身份验证,并生成轮廓身份验证令牌。

有关详细信息,请参阅配置文件API设置

调试器工具

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

生成新的身份验证令牌

隐私

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

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

  • 最后一个八位字节模糊处理
  • 整个IP模糊处理

有关更多信息,请参阅隐私

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

下载 at.js

有关使用Target界面或下载API下载库的说明。

NOTE
Adobe Experience Platform是实现Target和at.js库的首选方法。 使用Adobe Experience Platform中的标记实施Target时,以下信息不适用。
Adobe Target同时支持at.js 1.x​和at.js 2.x。 请升级到任一主要版本的at.js的最新更新,以确保您运行的是受支持的版本。 有关每个版本中功能的更多信息,请参阅 at.js 版本详细信息

使用Target界面下载at.js

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

  1. 单击​管理 > 实现
  2. 在“实施方法”部分中,单击所需的at.js版本旁边的​ 下载 ​按钮。

使用Target下载API下载at.js

要使用API下载at.js,请执行以下操作:

  1. 获取您的客户端代码。

    您的客户端代码位于Target界面的​管理 > 实现​页面的顶部。

  2. 获取您的管理员编号。

    加载以下 URL:

    code language-none
    https://admin.testandtarget.omniture.com/rest/v1/endpoint/<varname>client code</varname>
    

    client code替换为步骤1中的客户端代码。

    加载此 URL 后,应该会出现类似于以下示例的结果:

    code language-none
    {
      "api": "https://admin6.testandtarget.omniture.com/admin/rest/v1"
    }
    

    在此示例中,“6”表示管理员编号。

  3. 下载at.js。

    加载具有以下结构的URL。 加载此URL后,便会开始下载自定义的at.js文件。

    code language-none
    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替换为步骤1中的客户端代码。
    • version number替换为所需的at.js版本号(例如,2.2)。
WARNING
Target团队仅维护两个版本的at.js:当前版本和当前版本的上一个版本。 请根据需要升级at.js,以确保您运行的是受支持的版本。 有关每个版本中功能的更多信息,请参阅 at.js 版本详细信息

at.js 实施

at.js 应该在您网站每个页面的 <head> 元素中实施。

Target的典型实现不使用标签管理器,例如Adobe Experience Platform中的标签,如下所示:

<!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 的人”。

NOTE
如果用户在您的网站上进行购买,Adobe建议实施订单确认mbox,即使您将Analytics for Target (A4T)用于报表也是如此。
  1. 在订单详细信息页面,按照以下模式插入 mbox 脚本。

  2. 使用您目录中的动态或静态值替换大写的文字。

    note tip
    TIP
    您也可以在任意mbox中传递订单信息(名称不必是orderConfirmPage)。 还可以在同一营销活动之内的多个 mbox 中传递订单信息。
    code language-none
    <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>
    
NOTE
在订单确认mbox中,使用逗号分隔多个产品ID。

订单确认 mbox 使用以下参数:

参数
描述
orderId

针对转化计数标识订单的唯一值。

orderId 必须是唯一的。 报表中会忽略重复订单。

orderTotal

所购产品的币值。

请勿传递货币符号。 使用小数点(而非逗号)表示小数值。

productPurchasedId(可选)

订单中所购产品的产品 ID(逗号分隔)列表。

这些产品 ID 显示在审计报告中以支持其他报告分析。

recommendation-more-help
target-dev-help-dev