在历程中使用 Adobe Experience Platform 数据 datalookup

基于产品类别的筛选

情景:Send​为家庭产品消费超过40美元的用户提供优惠券。

历程流：

1. 购买事件：从用户的购物车中捕获SKU。

2. 数据集查找活动：

   • 数据集： products-dataset （SKU作为主键）。
   • 查找键： list(@event{purchase_event.products.sku})。
   • 要返回的字段： ["SKU", "category", "price"]。

3. 条件活动：

   • 过滤类别为“家庭”的SKU。

     code language-none
     @event{purchase_event.products.all( in(currentEventField.sku, @datasetlookup{MyDatasetLookupActivity1.entities.all(currentDatasetLookupField.category == 'household').sku} ) )}

   或者

   • 汇总家庭产品总支出，并将其与40美元的门槛值进行比较。

     code language-none
     sum(@event{purchase_event.products.all( in(currentEventField.sku, @datasetlookup{MyDatasetLookUpActivity1.entities.all(currentDatasetLookupField.category == 'household').sku} ) )}.price}, ',', true ) > 40

4. Personalization编辑器：

   使用扩充的数据使电子邮件内容个性化：

   code language-none
   {% let householdTotal = 0 %} {{#each journey.datasetlookup.3709000.entities as |product|}} {%#if get(product, "category") = "household"%} {% let householdTotal = householdTotal + product.price %}{%/if%} {{/each}} "Hi, thanks for spending " + {%= householdTotal %} + " on household products. Here is your reward!"

使用外部忠诚度数据的Personalization

方案：识别用户档案的哪个电子邮件帐户具有白金会员状态。 在这种情况下，忠诚度帐户与电子邮件ID关联，忠诚度数据在标准配置文件查找存储中不可用。

历程流：

1. 配置文件事件触发器：从配置文件或事件上下文中捕获电子邮件ID。

2. 数据集查找活动：

   • 数据集： loyalty-member-dataset （通过电子邮件作为主键）。
   • 查找键： @profile.email。
   • 要返回的字段： ["email", "loyaltyTier"]。

3. 条件活动：

   根据忠诚度级别分支历程：

   code language-none
   @datasetLookup{MyDatasetLookUpActivity1.entity.loyaltyMember.loyaltyTier} == 'Platinum'

4. Personalization编辑器：

   使用扩充的忠诚度级别数据来个性化出站通信：

   code language-none
   {{context.journey.datasetLookup.1482319411.entity.loyaltyMember.loyaltyTier}}

AI知识参考

本节包含结构化知识，用于支持与本主题相关的解释、检索和问答。

要全面了解相关信息，应将此信息与本页上的文档相结合。 这两个源都不是独立的；页面描述了功能，而本节提供了其他上下文来帮助消除术语、意图、适用性和约束条件的歧义。

• TL；DR：​本页说明如何配置数据集查找活动，以便在历程运行时动态检索AEP记录数据集数据，以实现实时个性化和条件逻辑。

意图：

• 向历程添加数据集查找活动，以在运行时获取外部AEP记录数据
• 选择要在查找期间检索的特定数据集字段（叶节点/基元值）
• 在高级模式下定义查找键以连接历程上下文和数据集记录
• 在历程表达式编辑器或个性化编辑器中使用扩充的数据集数据
• 解决由于对查找键使用简单模式导致的“未找到数据集查找”错误

术语表：

• 数据集查找活动：使用连接键​ （产品特定） ​在运行时从AEP记录数据集检索数据的历程编排活动
• 叶节点：架构层次结构最低级别的字段，它包含基本值（字符串、数字、布尔值、日期）（产品特定）
• 查找键：用于将历程上下文数据与选定数据集​ （产品特定） ​中的记录匹配的联接表达式（字符串或字符串列表）
• 扩充数据：由数据集查找活动检索并暂时存储在历程上下文中以用于下游活动​ （产品特定） ​的数据

护栏：

• 每个历程最多包含10个数据集查找活动。
• 每个查找活动最多选择20个字段。
• 查找键数组中最多50个键。
• 扩充数据大小限制为10KB。
• 必须先在Adobe Experience Platform中启用该数据集以供查找，然后才能将其显示在活动配置中。
• 只能选择叶节点（基元值）；不能选择数组和映射。
• 仅支持字符串或字符串列表作为查找键。
• 查找键必须在高级模式下定义；使用简单模式会导致活动输出作为下游的上下文属性不可用。
• 扩充的数据是瞬态的，仅在历程运行时间和叫客活动个性化期间可用。
• 为获得最佳性能，每个历程限制为5个查找活动（推荐）；系统强制的硬限制为每个历程10个活动。 此外，还建议每个查找最多包含20个属性。

术语：

• 规范名称：数据集查找活动 — 缩写：n/a — 变体：AEP数据查找，数据扩充活动
• 同义词： “lookup key” = “joining key”
• 请勿混淆：“数据集查找活动”≠“体验事件查找” — 数据集查找可检索记录数据集数据，而不是时间序列体验事件

常见问题解答：

• 问：为什么我的数据集没有显示在数据集字段下拉列表中？ — 必须在Adobe Experience Platform中启用数据集以进行查找。 按照必读一节中的说明启用它。
• 问：为什么@datasetLookup{}在条件中返回“未找到数据集查找”错误？ — 查找键是使用简单模式而不是高级模式定义的。 在高级模式下重新定义它并重新发布历程。
• 问：我是否可以从数据集中检索数组或映射字段？ — 否，只能选择原始叶节点字段（字符串、数字、布尔值、日期）。
• 问：如何在电子邮件中访问扩充数据？ — 使用语法为{{context.journey.datasetLookup.<activityId>.entities}}的个性化编辑器。
• 问：历程结束后是否保留扩充数据？ — 否，扩充数据是瞬态数据，且仅在历程运行时会话期间可用。