使用动态片段 dynamic-fragments

在此页面上：​了解如何在Adobe Journey Optimizer中使用动态片段解析，根据在发送时传递的配置文件属性、数据集查找或上下文数据，选择在运行时插入到消息中的已发布片段。

Adobe Journey Optimizer在运行时支持​动态片段解析，允许您根据在发送时传递的配置文件属性、数据集查找或上下文数据选择将哪个已发布的片段插入到消息中。 这样可以在不复制营销活动或历程逻辑的情况下实现高度个性化的内容。

概述 overview

在设计时嵌入消息中的静态片段 — 每个收件人都使用相同的片段。 动态片段​在运行时为每个收件人解析片段ID，这意味着不同的配置文件可以在同一营销活动或历程中接收完全不同的内容块。

动态片段ID可以来自三个源：

先决条件 prerequisites

在使用动态片段之前，请确保已具备以下条件：

步骤1：创建和发布片段 create-fragment

在动态引用片段之前，必须在Journey Optimizer中发布该片段。

步骤2：使用动态片段引用创作消息 author-message

在个性化编辑器中，使用以下语法插入动态片段占位符：

{{fragment id=dynamic_fragment_id}}

标识符dynamic_fragment_id是变量名称。 必须在进行片段查找之前解析其值。 您可以使用数据集查找表达式、配置文件属性或上下文数据解决此问题。

从数据集查找中解析 resolve-from-dataset

如果片段ID存储在AEP数据集中（例如，样式到片段映射表），请使用datasetLookup帮助程序函数进行解析：

{{
  {datasetLookup datasetId="<your-dataset-id>" key=profile.style attribute="fragmentId"}
}}

{{fragment id=dynamic_fragment_id}}

在此示例中，数据集包含由样式值（如style1）键入的行。 对于给定的配置文件，查找将检索相应的fragmentId列值并将其分配给dynamic_fragment_id，然后使用该值解析片段。

从上下文数据解析 resolve-from-context

如果片段ID在发送时作为API请求上下文的一部分提供，请使用context命名空间引用它：

{{fragment id=context.audiencePayload.fragmentId}}

路径context.audiencePayload是所有属性的必需前缀，这些属性来自CSV受众文件或通过API请求上下文传递。 CSV中的列名称（例如，fragmentId）在前缀之后。

从配置文件属性中解析 resolve-from-profile

如果片段ID作为配置文件属性存储在Adobe Experience Platform中，请直接引用它：

{{fragment id=profile.mi.fragmentId}}

步骤3：为查找方法配置数据集 configure-dataset

如果您使用数据集查找方法，请更新您的数据集架构和数据以携带片段ID。

示例数据集结构：

步骤4：在发送时传递上下文数据 pass-context-data

如果您要从上下文数据解析片段ID（例如，从CSV受众推荐文件），请在API请求中用所需的上下文前缀传递片段ID。

使用营销活动验证API时，请在context对象中包含片段ID：

{
  "recipients": [
    {
      "userId": "<profile-email>",
      "namespace": "email"
    }
  ],
  "inChannelData": {
    "channel": "email",
    "emailAddresses": ["<delivery-address>"]
  },
  "context": {
    "audiencePayload": {
      "fragmentId": "<published-fragment-id>",
      "systemSource": "<optional-system-value>"
    }
  }
}

需要前缀context.audiencePayload。 运行实时营销活动时，嵌套在此键下的属性直接映射到CSV受众文件中的列。

步骤5：验证和验证 proof-validate

在激活营销活动之前，请使用营销活动验证API来验证动态片段是否正确解析，以及呈现的电子邮件输出是否与预期一致。

有关Campaign API的更多信息，请参阅Journey Optimizer API文档。

护栏和限制 guardrails

以下限制适用于使用动态片段的情况：

此部分中有更多适用于片段的护栏。

错误处理 error-handling

如果动态片段在运行时无法解析，则会为受影响的配置文件生成排除事件。 目前，所有片段渲染失败都归类为单个一揽子错误类型。

要调试片段解析失败，请执行以下操作：