文档AEM 6.4Administering 指南

手动配置与Adobe Target的集成 manually-configuring-the-integration-with-adobe-target

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 管理员
CAUTION
AEM 6.4已结束扩展支持，本文档将不再更新。 有关更多详细信息，请参阅 技术支助期. 查找支持的版本 此处.

您可以修改在使用向导时执行的选择加入向导配置，也可以不使用向导手动与Adobe Target集成。

修改选择加入向导配置 modifying-the-opt-in-wizard-configurations

的 选择加入向导 the 将AEM与Adobe Target集成 自动创建名为“已配置的Target配置”的Target云配置。 该向导还会为名为已配置的Target框架的云配置创建Target框架。 您可以根据需要修改云配置和框架的属性。

通过配置A4T Adobe Target配置，您还可以将Analytics Cloud配置为在定位内容时使用Adobe Target作为报表源。

要找到云配置和框架，请导航到 Cloud Services 通过 工具 > 部署 > 云. (http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)
在Adobe Target下，单击或点按 显示配置.

已配置的Target配置属性 provisioned-target-configuration-properties

在选择加入向导创建的已配置Target配置云配置中使用以下属性值：

  • 客户端代码： 在选择加入向导中输入。

  • 电子邮件： 在选择加入向导中输入。

  • 密码： 在选择加入向导中输入。

  • API类型： REST

  • 同步来自Adobe Target的区段： 已选择。

  • 客户端库： mbox.js.

  • 使用DTM交付客户端库： 未选择。 如果您 使用DTM 或其他标签管理系统来托管mbox.js或AT.js文件。 Adobe建议您使用DTM而不是AEM来交付库。

  • 自定义mbox.js: 未指定任何内容，以便使用默认的mbox.js文件。 根据需要指定要使用的自定义mbox.js文件。 仅当您选择了mbox.js时，才会显示。

  • 自定义AT.js: 未指定任何内容，以便使用默认的AT.js文件。 根据需要指定要使用的自定义AT.js文件。 仅当您选择了AT.js时，才会显示。

NOTE
在AEM 6.3中，您可以选择Target库文件： AT.JS，这是适用于Adobe Target的新实施库，专为典型的Web实施和单页应用程序而设计。
AT.js 对 mbox.js 库进行了多项改进：
  • 缩短了 Web 实现的页面加载时间
  • 提高了安全性
  • 改善了针对单页应用程序的实施选项
  • AT.js 包含 target.js 具有的组件，因此不再调用 target.js

已配置的Target框架属性 provisioned-target-framework-properties

选择加入向导创建的已配置Target框架已配置为从配置文件数据存储发送上下文数据。 默认情况下，商店的年龄和性别数据项会发送到Target。 您的解决方案可能需要发送其他参数。

chlimage_1-158

您可以配置框架以将其他上下文信息发送到Target，如 添加Target框架.

配置A4T Analytics Cloud配置 configuring-a-t-analytics-cloud-configuration

您可以将Adobe Target配置为在定位内容时使用Adobe Analytics作为报表源。

为此，您需要指定要将Adobe Target云配置与以下项连接的A4T云配置：

  1. 导航到 Cloud Services 通过 AEM徽标 > 工具 > 部署 > Cloud Services.

  2. 在 Adobe Target 部分中，单击​ 立即配置。

  3. 重新连接到Adobe Target配置。

  4. 在 A4T Analytics Cloud配置 下拉菜单中，选择框架。

    note note
    NOTE
    只有为A4T启用的Analytics配置才可用。
    使用AEM配置A4T时，您可能会看到缺少条目的配置引用。 要选择分析框架，请执行以下操作：
    1. 导航到 工具 > 常规 > CRXDE Lite.
    2. 导航到 /libs/cq/analytics/components/testandtargetpage/dialog/items/tabs/items/tab1_general/items/a4tAnalyticsConfig
    3. 设置属性 禁用 to false.
    4. 点按或单击 全部保存.

    chlimage_1-159

    单击​ 确定。使用Adobe Target定位内容时，您能够 选择报表源.

手动与Adobe Target集成 manually-integrating-with-adobe-target

手动与Adobe Target集成，而不是使用选择加入向导。

NOTE
Target 库文件 AT.JS 是 Adobe Target 的新实施库，专为典型的 Web 实施和单页应用程序而设计。Adobe 建议您使用 AT.js 而不是 mbox.js 作为客户端库。
AT.js 对 mbox.js 库进行了多项改进：
  • 缩短了 Web 实现的页面加载时间
  • 提高了安全性
  • 改善了针对单页应用程序的实施选项
  • AT.js 包含 target.js 具有的组件，因此不再调用 target.js
您可以在​ 客户端库 ​下拉菜单中选择 AT.js 或 mbox.js。

创建 Target 云配置 creating-a-target-cloud-configuration

要启用 AEM 以便与 Adobe Target 交互，请创建 Target 云配置。要创建配置，您需要提供 Adobe Target 客户端代码和用户凭据。

您只需创建一次 Target 云配置，因为您可以将该配置与多个 AEM 活动关联。如果您有多个 Adobe Target 客户端代码，请为每个客户端代码创建一个配置。

您可以配置云配置以从 Adobe Target 同步片段。如果启用同步，则保存云配置后，将立即在后台从 Target 导入分段。

使用以下过程可在 AEM 中创建 Target 云配置：

  1. 导航到 Cloud Services 通过 AEM徽标 > 工具 > 部署 > Cloud Services. (http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)

    的 Adobe Marketing Cloud 将打开“概述”页面。

  2. 在 Adobe Target 部分中，单击​ 立即配置。

  3. 在​ 创建配置 ​对话框中：

    1. 为配置提供​ 标题。
    2. 选择 Adobe Target 配置 ​模板。
    3. 单击​ 创建。

    此时将打开编辑对话框。

    chlimage_1-160

    note note
    NOTE
    使用AEM配置A4T时，您可能会看到缺少条目的配置引用。 要选择分析框架，请执行以下操作：
    1. 导航到 工具 > 常规 > CRXDE Lite.
    2. 导航到 /libs/cq/analytics/components/testandtargetpage/dialog/items/tabs/items/tab1_general/items/a4tAnalyticsConfig
    3. 设置属性 禁用 to false.
    4. 点按或单击 全部保存.

  4. 在对话框中，提供这些属性的值。

    • 客户端代码：Target 帐户的客户端代码

    • 电子邮件:Target帐户电子邮件。

    • 密码:目标帐户密码。

    • API类型:REST或XML

    • A4T Analytics Cloud 配置：选择用于 Target 活动目标和量度的 Analytics Cloud 配置。如果您在定位内容时使用 Adobe Analytics 作为报告源，则需要此项。如果您看不到云配置，请参阅 配置A4T Analytics Cloud配置.

    • 使用准确定位： ​默认情况下，此复选框处于选中状态。如果选中，云服务配置将等到上下文加载完后，再加载内容。请参阅以下注释。

    • 从 Adobe Target 同步分段： ​选择此选项可下载 Target 中定义的分段，以便在 AEM 中使用它们。当“API 类型”属性为 REST 时，您必须选择此选项，因为内联分段不受支持，并且您始终需要从 Target 使用分段。（请注意，AEM 术语“分段”等同于 Target“受众”。）

    • 客户端库： 选择您希望使用mbox.js还是AT.js客户端库。

    • 使用DTM交付客户端库 — 选择此选项可从DTM或其他标签管理系统中使用AT.js或mbox.js。 您必须 配置DTM集成 ，以使用此选项。 Adobe建议您使用DTM而不是AEM来交付库。

    • 自定义mbox.js:如果您选中DTM框或使用默认的mbox.js，请将留空。 或者，上传您的自定义mbox.js。 仅当您选择了mbox.js时，才会显示。

    • 自定义AT.js:如果您选中DTM框或使用默认AT.js，请将留空。 或者，上传您的自定义AT.js。 仅当您选择了AT.js时，才会显示。

    note note
    NOTE
    默认情况下，当您选择加入 Adobe Target 配置向导时，将启用“准确定位”。
    准确定位意味着，云服务配置将等到上下文加载完后，再加载内容。因此，就性能而言，准确定位可能会导致加载内容前有几毫秒的延迟。
    对于创作实例，“准确定位”始终处于启用状态。但在发布实例上，您可以通过清除云服务配置中“准确定位”旁边的复选标记来选择全局关闭准确定位 (http://localhost:4502/etc/cloudservices.html)。无论您在云服务配置中的设置如何，您都可以为各个组件打开和关闭“准确定位”。
    如果您​ 已经 ​创建目标组件并更改此设置，则您的更改不会影响这些组件。您必须直接对这些组件进行任何更改。

  5. 单击​ 连接到 Target 可初始化与 Target 的连接。如果连接成功，则会显示“连接成功”消息。 单击消息上的​ 确定，然后单击对话框上的​ 确定。

    如果无法连接到 Target，请参阅疑难解答部分。

添加 Target 框架 adding-a-target-framework

配置 Target 云配置后，可以添加 Target 框架。该框架可识别从可用 Client Context 或 ContextHub 组件。 Target 使用参数来确定适用于当前上下文的分段。

您可以为单个 Target 配置创建多个框架。在需要针对网站的不同部分向 Target 发送一组不同的参数时，多个框架会很有用。为需要发送的每组参数创建一个框架。将网站的每个部分与适当的框架关联。请注意，网页一次只能使用一个框架。

  1. 在Target配置页面上，单击 + 可用框架旁边的（加号）。

  2. 在“创建框架”对话框中，指定​ 标题，选择 Adobe Target 框架，然后单击​ 创建。

    chlimage_1-161

    这将打开框架页面。Sidekick提供表示 Client Context 或 ContextHub 你可以映射的。

    chlimage_1-162

  3. 将表示要用于映射的数据的客户端上下文组件拖动到放置目标。或者，将 ContextHub 存储 ​组件拖动到框架。

    note note
    NOTE
    映射时，参数通过简单字符串传递给 mbox。无法从 ContextHub 映射数组。

    例如，要使用有关站点访客的​ 配置文件数据 ​来控制 Target 活动，请将​ 配置文件数据 ​组件拖动到页面。可用于映射到 Target 参数的配置文件数据变量随即显示。

    chlimage_1-163

  4. 通过选中相应列中的​ 共享 ​复选框，选择要对 Adobe Target 系统可见的变量。

    chlimage_1-164

    note note
    NOTE
    同步参数是唯一方式 – 从 AEM 到 Adobe Target。

此时将创建您的框架。要将框架复制到发布实例，请使用 sidekick 中的​ 激活框架 ​选项。

将活动与Target云配置关联 associating-activities-with-the-target-cloud-configuration

关联您的 AEM活动 配置，以便能够镜像 Adobe Target.

NOTE
可用的活动类型由以下因素决定：
  • 如果 xt_only 选项，则可以在AEM端用于连接到Adobe Target的Adobe Target租户(clientcode)上创建 仅 AEM中的XT活动。
  • 如果 xt_only 选项 not 在Adobe Target租户(clientcode)上启用，然后您可以创建 both AEM中的XT和A/B活动。
其他注释： xt_only 选项是对特定Target租户(clientcode)应用的设置，只能在Adobe Target中直接修改。 您无法在 AEM 中启用或禁用此选项。

将Target框架与您的站点关联 associating-the-target-framework-with-your-site

在AEM中创建Target框架后，将网页与框架关联。 页面上的目标组件会将框架定义的数据发送到Adobe Target以进行跟踪。 (请参阅 内容定位.)

将页面与框架关联后，子页面将继承该关联。

  1. 在 站点 控制台中，导航到要配置的站点。

  2. 使用 快速操作 或 选择模式，选择 查看属性。

  3. 选择​ 云服务 ​选项卡。

  4. 点按/单击​ 编辑。

  5. 点按/单击 添加配置 在 Cloud Service配置 选择 Adobe Target.

    chlimage_1-165

  6. 选择所需的框架 配置参考.

    note note
    NOTE
    确保选择 框架 而不是创建该云配置的Target云配置中的任何值。

  7. 点按/单击 完成.

  8. 激活网站的根页面以将其复制到发布服务器。 (请参阅 如何发布页面.)

    note note
    NOTE
    如果尚未激活您附加到页面的框架，则会打开一个向导，通过该向导也可以发布页面。

Target连接问题疑难解答 troubleshooting-target-connection-problems

执行以下任务，以解决连接到Target时出现的问题：

  • 确保您提供的用户凭据正确无误。
  • 确保AEM实例可以连接到Target服务器。 例如，确保防火墙规则不会阻止出站AEM连接，或者将AEM配置为使用必要的代理。
  • 在AEM错误日志中查找有用的消息。 error.log文件位于 crx-quickstart/logs 安装AEM的目录。
  • 在Adobe Target中编辑活动时，URL将指向localhost。 通过将AEM外部器设置为正确的URL来解决此问题。
recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8