Adobe Target扩展概述

使用本参考可了解有关使用此扩展构建规则时可用的选项的信息。

配置 Adobe Target 扩展

如果尚未安装Adobe Target扩展，请打开您的资产，然后选择 “扩展”>“目录”，将鼠标悬停在Target扩展上，然后选择 安装.

要配置该扩展，请打开 扩展 选项卡，将鼠标悬停在该扩展上，然后选择 配置.

at.js 设置

所有at.js设置（Timeout除外）将自动从Target用户界面的at.js配置中进行检索。 该扩展仅在首次添加时才会从Target用户界面中检索设置，因此如果需要进行其他更新，则应在UI中管理所有设置。

可以使用以下配置选项：

Client Code

客户端代码是Target的帐户标识符。 此选项几乎应始终保留为默认值。

可使用数据元素进行更改。

Organization ID

此 ID 可将您的实施绑定到 Adobe Experience Cloud 帐户。此选项几乎应始终保留为默认值。

可使用数据元素进行更改。

Global Mbox Name

显示全局 Target 请求的名称。默认情况下，此名称为 target-global-mbox，除非您在添加该扩展之前更改了 Target 用户界面中的名称。

可使用数据元素进行更改。

Server Domain

发送 Target 请求的域。此选项几乎应始终保留为默认值。

Cross Domain

确定 Target 在浏览器中设置 Cookie 的位置。

Timeout (ms)

如果在定义的时间段内未收到来自 Target 的响应，则请求会超时并显示默认内容。在访客会话期间会继续尝试发起其他请求。默认值为 3000 毫秒，这可能与 Target 用户界面中配置的超时不同。

有关超时设置的工作方式的更多信息，请参阅 Adobe Target 帮助。

Target 用户界面中可用的其他 at.js 设置

上提供了多个设置 编辑at.js设置 Target UI的页面不属于Target扩展的一部分。 下面列出了建议的解决方法：

Target 扩展操作类型

此部分介绍 Target 扩展中可用的操作类型。

Target 扩展在规则的 Then 部分中提供了以下操作：

Load Target

将此操作添加到适合在上下文中加载Target的标记规则中。 这会将 at.js 库加载到页面中。在大多数实施中，应在您网站的每个页面上加载 Target。

无需进行配置。

Add Mbox Params

向所有 mbox 请求添加参数。必须先使用 Load Target 操作。

Add Global Mbox Params

仅向全局 mbox 请求添加参数。必须先使用 Load Target 操作。

Fire Global Mbox

在页面上触发全局 mbox。必须先使用 Load Target 操作。

指定是否启用可防止闪烁的主体隐藏，以及隐藏主体元素时所使用的样式。

可以使用以下选项：

有关更多信息，请参阅 Target 联机帮助文档。

Adobe Target 基本部署

安装 Target 扩展后，您将需要创建至少一个规则才能正确部署该扩展。您首先需要加载 Target 库 (at.js)，指定要与全局 mbox 一起使用的参数，然后触发全局 mbox。

具有此基本实施的 Target 规则如下所示：

保存此规则后，您需要将其添加到库并进行生成/部署，以便测试该行为。

使用异步部署的 Adobe Target 扩展

标记可以异步部署。 如果您异步加载标记库，且其中包含Target，则也将会异步加载Target。 这是一个完全支持的方案，但有一个额外的注意事项必须加以处理。

在异步部署中，页面可以在Target库完全加载并执行内容交换之前完成默认内容渲染。 这可能会导致所谓的“闪烁”，在这种情况下，会先短暂显示默认内容，然后再将该内容替换为 Target 指定的个性化内容。如果要避免出现这种闪烁情况，我们建议您使用预隐藏代码片段并异步加载标记包来避免任何内容闪烁。

在使用预隐藏代码片段时，请谨记以下事项：

预隐藏代码片段如下所示，该代码片段可以缩小。可配置的选项位于末尾：

;(function(win, doc, style, timeout) {
  var STYLE_ID = 'at-body-style';

  function getParent() {
    return doc.getElementsByTagName('head')[0];
  }

  function addStyle(parent, id, def) {
    if (!parent) {
      return;
    }

    var style = doc.createElement('style');
    style.id = id;
    style.innerHTML = def;
    parent.appendChild(style);
  }

  function removeStyle(parent, id) {
    if (!parent) {
      return;
    }

    var style = doc.getElementById(id);

    if (!style) {
      return;
    }

    parent.removeChild(style);
  }

  addStyle(getParent(), STYLE_ID, style);
  setTimeout(function() {
    removeStyle(getParent(), STYLE_ID);
  }, timeout);
}(window, document, "body {opacity: 0 !important}", 3000));

默认情况下，该代码片段会预先隐藏整个 HTML 主体。在某些情况下，您可能只想预先隐藏某些 HTML 元素，而不是整个页面。您可以通过自定义样式参数来实现这一点。可将其替换为只预先隐藏页面特定区域的内容。

例如，如果您有两个分别采用 ID container-1 和 container-2 进行标识的区域，则可以将样式替换为以下内容：

#container-1, #container-2 {opacity: 0 !important}

而不是默认内容：

body {opacity: 0 !important}

默认情况下，代码片段会在 3000 毫秒或 3 秒后超时。此值可进行自定义。