将体验片段导出到 Adobe Target exporting-experience-fragments-to-adobe-target

CAUTION
  • AEM 体验片段将导出到 Adobe Target 的默认工作区。
  • 必须按照与 Adobe Target 集成下的说明将 AEM 与 Adobe Target 集成。

您可以将在 Adobe Experience Manager as a Cloud Service (AEM) 中创建的体验片段导出到 Adobe Target (Target)。然后,可以将其用作 Target 活动中的选件以大规模测试和打造个性化体验。

有三个选项可用于将体验片段导出到 Adobe Target:

  • HTML(默认):支持 Web 和混合内容交付
  • JSON:支持 Headless 内容交付
  • HTML 和 JSON

要准备您的实例以将 AEM 体验片段导出到 Adobe Target,您需要:

之后,您可以:

体验片段可以导出到 Adobe Target 中的默认工作区,也可以导出到 Adobe Target 的用户定义的工作区。

NOTE
Adobe Target 本身没有 Adobe Target 工作区。可以在 Adobe IMS (Identity Management System) 中定义和管理这些工作区,然后使用 Adobe Developer Console 选择它们以便跨解决方案使用。
NOTE
Adobe Target 工作区可用于允许组织(组)的成员仅为该组织创建和管理选件和活动;不向其他用户授予访问权限。例如,全球关注的国家/地区特定的组织。

前提条件 prerequisites

需要执行各种操作:

  1. 您必须将 AEM 与 Adobe Target 集成

  2. 体验片段将从 AEM 创作实例中导出,因此,您需要在创作实例上配置 AEM 链接外部化器,确保体验片段中的任何引用都外部化以进行 Web 交付。

    note note
    NOTE
    对于默认情况下未涵盖的链接重写,可以使用体验片段链接重写器提供程序。利用它,可以为您的实例开发自定义规则。

添加云配置 add-the-cloud-configuration

在导出片段之前,您需要将 Adobe Target 的​ 云配置 ​添加到片段或文件夹。这也使您能够:

  • 指定要用于导出的格式选项
  • 选择 Target 工作区作为目标
  • 选择一个外部化器域以重写体验片段中的引用(可选)

可以在所需的文件夹和/或片段的​ 页面属性 ​中选择所需的选项;规范会根据需要继承。

  1. 导航到​ 体验片段 ​控制台。

  2. 打开相应的文件夹或片段的​ 页面属性

    note note
    NOTE
    如果将云配置添加到体验片段父文件夹,则该配置将由所有子级继承。
    如果将云配置添加到体验片段本身,则该配置将由所有变体继承。
  3. 选择​ 云服务 ​选项卡。

  4. 在​ 云服务配置 ​下,从下拉列表中选择 Adobe Target

    note note
    NOTE
    可以自定义体验片段选件的 JSON 格式。为此,请定义一个客户体验片段组件,然后注明如何在组件“Sling 模型”中导出其属性。
    请参阅核心组件:核心组件 – 体验片段
  5. Adobe Target 下,选择:

    • 相应的配置
    • 所需的格式选项
    • Adobe Target 工作区
    • 如有必要 — 外部化器域
    note caution
    CAUTION
    外部化器域是可选的。
    如果您希望导出的内容指向特定的​ 发布 ​域,可配置 AEM 外部化器。有关更多详细信息,请参阅配置 AEM 链接外部化器
    另请注意,外部化器域仅与发送到 Target 的体验片段的内容相关,与查看选件内容等元数据无关。

    例如,对于文件夹:

    文件夹 – 云服务

  6. 保存并关闭

添加旧配置 add-the-legacy-configuration

IMPORTANT
添加新的旧版配置是一种特殊场景,仅支持导出体验片段。

添加云配置以使用 Adobe Launch 之后,要将 AEM 与 Adobe Target 集成,您还需要使用旧版配置手动与 Adobe Target 集成。

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

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

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

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

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

  1. 通过 AEM 徽标 > 工具 > 云服务 > 旧版云服务 ​导航到​ 旧版云服务
    例如:(http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)

    Adobe Experience Cloud 概述页面随即打开。

  2. Adobe Target 部分中,单击​ 立即配置

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

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

您现在可以选择新配置以进行编辑。

  1. 此时将打开编辑对话框。

    config-target-settings-dialog

  2. Adobe Target 设置 ​对话框中,提供以下属性的值。

    • 身份验证:默认值为 IMS(已弃用用户凭据)

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

    • 租户 ID:租户 ID

    • IMS 配置:从下拉列表中选择所需的配置

    • API 类型:默认值为 REST(已弃用 XML)

    • A4T Analytics Cloud 配置:选择用于 Target 活动目标和量度的 Analytics Cloud 配置。如果您在定位内容时使用 Adobe Analytics 作为报告源,则需要此项。

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

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

    • 客户端库: ​默认值为 AT.js(已弃用 mbox.js)

      note note
      NOTE
      Target 库文件 AT.JS 是 Adobe Target 的新实施库,专为典型的 Web 实施和单页应用程序而设计。
      mbox.js 已被弃用,将在稍后阶段删除。
      Adobe 建议您使用 AT.js 而不是 mbox.js 作为客户端库。
      AT.js 对 mbox.js 库进行了多项改进:
      • 缩短了 Web 实现的页面加载时间
      • 提高了安全性
      • 改善了针对单页应用程序的实施选项
      • AT.js 包含 target.js 具有的组件,因此不再调用 target.js
      您可以在​ 客户端库 ​下拉菜单中选择 AT.js 或 mbox.js。
    • 使用标记管理系统交付客户端库 – 选择此选项可使用 Adobe Launch 或其他标记管理系统(或 DTM,它已被弃用)中的客户端库。

    • 自定义 AT.js:浏览以上传您的自定义 AT.js。留空可使用默认库。

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

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

配置 Target 云配置后,可以添加 Target 框架。该框架标识从可用的 ContextHub 组件发送到 Adobe Target 的默认参数。Target 使用参数来确定适用于当前上下文的分段。

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

  1. 在 Target 配置页面上,单击“可用配置”旁边的 +(加号)。

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

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

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

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

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

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

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

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

将体验片段导出到 Adobe Target exporting-an-experience-fragment-to-adobe-target

CAUTION
对于媒体资源(例如图像),仅将引用导出到 Target。资源本身仍存储在 AEM Assets 中,并且从 AEM 发布实例进行交付。
因此,在导出到Target之前,必须发布包含所有相关资产的体验片段。

要将体验片段从 AEM 导出到 Target(在指定云配置之后),请执行以下操作:

  1. 导航到体验片段控制台。

  2. 选择要导出到 Target 的体验片段。

    note note
    NOTE
    它必须是体验片段 Web 变体。
  3. 选择​ 导出到Adobe Target

    note note
    NOTE
    如果已导出体验片段,请选择​ 在 Adobe Target 中更新
  4. 根据需要选择​ 导出而不发布 ​或​ Publish

    note note
    NOTE
    选择​ 发布 ​将立即发布体验片段并将它发送到 Target。
  5. 在确认对话框中选择​ 确定

    您的体验片段现在应在 Target 中。

    note note
    NOTE
    可以在控制台的​ 列表视图 ​和​ 属性 ​中查看导出的各种详细信息
    note note
    NOTE
    在 Adobe Target 中查看体验片段时,看到的​ 上次修改 ​日期是上次在 AEM 中修改片段的日期,而不是上次将片段导出到 Adobe Target 的日期。
NOTE
或者,您可以使用页面信息菜单中的类似命令从页面编辑器执行导出。

在 Adobe Target 中使用体验片段 using-your-experience-fragments-in-adobe-target

执行上述任务后,体验片段将显示在 Target 的“选件”页面上。请查看特定 Target 文档以了解可以实现的目标。

NOTE
在 Adobe Target 中查看体验片段时,看到的​ 上次修改 ​日期是上次在 AEM 中修改片段的日期,而不是上次将片段导出到 Adobe Target 的日期。

删除已导出到 Adobe Target 的体验片段 deleting-an-experience-fragment-already-exported-to-adobe-target

如果已在 Target 的选件中使用已导出到 Target 的某个体验片段,则删除该体验片段可能会导致出现问题。由于 AEM 正在交付片段内容,因此,删除片段会导致选件不可用。

避免此类情况:

  • 如果体验片段当前未在活动中使用,AEM 将允许用户删除片段而不显示警告消息。

  • 如果 Target 中的活动当前正在使用体验片段,则会出现一条错误消息,警告 AEM 用户删除该片段可能给活动带来的后果。

    AEM 中的错误消息不会禁止用户(强制)删除体验片段。如果删除体验片段:

    • 带有 AEM 体验片段的 Target 选件可能会显示意外行为

      • 该选件可能仍会呈现,因为体验片段 HTML 已推送到 Target
      • 如果也从 AEM 中删除了引用的资源,则体验片段中的任何引用都无法正常工作。
    • 当然,由于体验片段在 AEM 中不再存在,因此无法对体验片段进行任何进一步的修改。

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab