文档AEM 6.5用户指南

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

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • 管理员

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

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

将AEM与Adobe Target集成的选择加入向导会自动创建名为“已设置目标配置”的Target云配置。 该向导还会为名为“已设置的Target框架”的云配置创建一个Target框架。 您可以修改云配置和框架的属性（如有必要）。

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

要找到云配置和框架，请通过​ Cloud Service > 部署 > 云 ​导航到​ 工具。 (http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)
在Adobe 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。

已设置的目标框架属性 provisioned-target-framework-properties

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

已设置目标框架

您可以配置框架以向Target发送其他上下文信息，如添加Target框架中所述。

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

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

NOTE
用户凭据身份验证（旧版）不适用于A4T（适用于Target和Analytics）。 因此，客户应使用IMS身份验证而不是User-Credential身份验证。

为此，您可以指定将您的Adobe Target云配置连接到的A4T云配置：

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

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

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

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

    note note
    NOTE
    只有为A4T启用的Analytics配置可用。
    使用AEM配置A4T时，您可能会看到缺少条目的配置引用。 要能够选择分析框架，请执行以下操作：
    1. 导航到​ 工具 > 常规 > CRXDE Lite。
    2. 导航到A4T Analytics配置对话框（见下文）
    3. 将属性​ disable ​设置为​ false。
    4. 单击​ 全部保存。

A4T分析配置对话框 a4t-analytics-config-dialog

/libs/cq/analytics/components/testandtargetpage/dialog/items/tabs/items/tab1_general/items/a4tAnalyticsConfig

AdobeTargetSettings

单击​ 确定。 使用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. 通过​ AEM徽标 > Cloud Service > Cloud Service > 旧版Cloud Service ​导航到​ 工具。 (http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)

    将打开​ Cloud Service ​概述页面。

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

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

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

    此时将打开编辑对话框。

    AdobeTargetSettings

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

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

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

    • 电子邮件： 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组件发送到Adobe Target的默认参数。 Target 使用参数来确定适用于当前上下文的分段。

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

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

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

    创建框架对话框

    这将打开框架页面。Sidekick提供的组件表示来自可以映射的Client Context或ContextHub的信息。

    框架 的组件

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

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

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

    配置文件数据

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

    共享

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

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

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

将您的AEM活动与Target云配置相关联，以便您可以镜像Adobe Target中的活动。

NOTE
可用的活动类型由以下因素决定：

  • 如果在AEM端用于连接到Adobe Target的Adobe Target租户(clientcode)上启用了​ xt_only ​选项，则您可以在AEM中创建​ only XT活动。

  • 如果​ xt_only ​选项在Adobe Target租户(clientcode)上为​ not ​启用，则您可以在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。

    添加配置

  6. 在​ 配置引用 ​下选择所需的框架。

    note note
    NOTE
    请确保您选择了所创建的特定​ 框架，而不是创建该框架时所用的Target云配置。

  7. 单击​ 完成。

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

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

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

要排除连接到Target时出现的问题，可以执行以下任务：

  • 确保您提供的用户凭据正确。
  • 确保AEM实例可以连接到Target服务器。 例如，请确保防火墙规则未阻止出站AEM连接，或者已将AEM配置为使用必要的代理。
  • 在AEM错误日志中查找有用的消息。 error.log文件位于安装AEM的​ crx-quickstart/logs ​目录中。
  • 在Adobe Target中编辑活动时，URL指向本地主机。 通过将AEM外部化器设置为正确的URL来解决此理解。
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2