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

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

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

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

AEM Experience Fragments可以导出到Adobe Target中的默认工作区,也可以导出到Adobe Target的用户定义的工作区。 可使用Adobe Developer Console完成此操作,为此,AEM必须使用IMS🔗与Adobe Target 集成。

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

前提条件 prerequisites

需要执行各种操作:

  1. 您必须使用IMS🔗将AEM与Adobe Target集成。

    note note
    NOTE
    IMS集成现在配置有S2S OAut
    以前使用JWT凭据进行配置,这些凭据现在在Adobe Developer Console中被弃用。
  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模型”中导出其属性。
    请参阅核心组件:
    核心组件 – 体验片段

    Adobe Target 下,选择:

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

    例如,对于文件夹:

    文件夹 – 云服务

  5. 保存并关闭

将体验片段导出到 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
    选择​ Publish ​将立即发布体验片段并将其发送到Target。
  5. 在确认对话框中,单击​ 确定

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

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

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

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

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

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

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

避免此类情况:

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

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

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

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

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

从导出到Target的体验片段中删除ClientLibs removing-clientlibs-from-fragments-exported-target

体验片段包含完整的html标记和所有必要的客户端库(CSS/JS),以便按照体验片段内容作者创建的完全相同的方式呈现片段。 这是精心设计的。

在AEM交付的页面上通过Adobe Target使用体验片段选件时,“目标”页面已包含所有必要的客户端库。 此外,也不需要体验片段选件中的无关html(请参阅注意事项)。

以下是体验片段选件中html的伪示例:

<!DOCTYPE>
<html>
   <head>
      <title>…</title>
      <!-- all the client libraries (css/js) -->
      …
   </head>
   <body>
        <!--/* Actual XF Offer content would appear here... */-->
   </body>
</html>

从较高层面来看,当AEM将体验片段导出到Adobe Target时,它会使用几个额外的Sling选择器来实现这一点。 例如,导出的体验片段的URL可能如下所示(注意nocloudconfigs.atoffer):

  • http://www.your-aem-instance.com/content/experience-fragments/my-offers/my-xf-offer.nocloudconfigs.atoffer.html

nocloudconfigs选择器使用HTL定义,可以通过从以下位置复制它来覆盖它:

  • /libs/cq/experience-fragments/components/xfpage/nocloudconfigs.html

使用Sling重写器atoffer选择器应用了后处理。 任一选项均可用于删除客户端库。

示例 example

出于此目的,让我们说明如何使用nocloudconfigs执行此操作。

NOTE
有关详细信息,请参阅可编辑模板

叠加 overlays

在此特定示例中,包含的叠加将删除客户端库​ ​无关的HTML。 假定您已创建体验片段模板类型。 需要从/libs/cq/experience-fragments/components/xfpage/中复制的文件包括:

  • nocloudconfigs.html
  • head.nocloudconfigs.html
  • body.nocloudconfigs.html

模板类型叠加图 template-type-overlays

在本例中,我们使用如下结构:

模板类型叠加图

这些文件的内容如下:

  • body.nocloudconfigs.html

    body.nocloudconfigs.html

  • head.nocloudconfigs.html

    head.nocloudconfigs.html

  • nocloudconfigs.html

    nocloudconfigs.html

NOTE
要使用data-sly-unwrap删除Body标记,您需要nocloudconfigs.html

注意事项 considerations

如果您需要在Adobe Target中使用“体验片段选件”支持AEM站点和非AEM站点,则必须创建两个体验片段(两种不同的模板类型):

  • 一个带有叠加,用于删除clientlibs/额外的html

  • 没有叠加的元素,因此包含所需的clientlibs

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2