[有限发布版]{class="badge informative"}

使用 Adobe Experience Platform 数据进行个性化设置 aep-data

在此页面上:​了解如何在个性化编辑器中使用datasetLookup帮助程序函数从Adobe Experience Platform记录数据集中检索字段并将内容个性化。

AVAILABILITY
此功能目前以有限可用版本的形式提供给所有客户。
目前,“datasetLookup”帮助程序函数可用于有限客户集的表达式片段中。 要获得访问权限,请与 Adobe 代表联系。

Journey Optimizer允许您在个性化编辑器中利用Adobe Experience Platform记录数据集的数据来个性化您的内容。 在开始之前,必须首先为查找启用查找个性化所需的数据集。 此部分中有详细信息: 使用Adobe Experience Platform数据

为数据集启用了查找个性化后,您可以使用其数据将您的内容个性化到Journey Optimizer中。

  1. 打开个性化编辑器,您可以在每个上下文中定义个性化设置(如消息)时使用该编辑器。 了解如何使用个性化编辑器

  2. 导航到帮助程序函数列表,并将​ datasetLookup ​帮助程序函数添加到代码窗格。

  3. 此函数提供了一个预定义语法,允许您从Adobe Experience Platform数据集调用字段。 语法如下:

    code language-none
    {{datasetLookup datasetId="datasetId" id="key" result="store" required=false}}
    
    • datasetId​是您正在处理的数据集的ID。

    • id​是源列的ID,它应该与查找数据集的主标识联接。

      note
      NOTE
      为此字段输入的值可以是字段ID (profile.packages.packageSKU)、在历程事件中传递的字段(context.journey.events.event_ID.productSKU)或静态值(sku007653)。 无论如何,系统都将使用值,并在数据集中查找,以检查它是否与键匹配。
      如果为键使用文本字符串值,请将文本放在引号中。 例如: {{datasetLookup datasetId="datasetId" id="SKU1234" result="store" required=false}}。 如果将属性值用作动态键,请删除引号。 例如: {{datasetLookup datasetId="datasetId" id=category.product.SKU result="SKU" required=false}}
    • 结果​是一个任意名称,您需要提供它以引用要从数据集中检索的所有字段值。 此值将在您的代码中用于调用每个字段。

    • required=false:如果required设置为TRUE,则仅当找到匹配的键时,才会传递消息。 如果设置为false,则不需要匹配的密钥,并且消息仍可以投放。 请注意,如果设置为false,建议您在消息内容中考虑回退值或默认值。

    accordion
    在何处检索数据集ID?

    可在Adobe Experience Platform用户界面中检索数据集ID。 请参阅Adobe Experience Platform文档以了解如何使用数据集。

  4. 调整语法以符合您的需求。 在本例中,我们要检索与乘客航班相关的数据。 语法如下:

    code language-none
    {{datasetLookup datasetId="1234567890abcdtId" id=profile.upcomingFlightId result="flight"}}
    
    • 我们正在处理ID为“1234567890abcdtId”的数据集,
    • 我们要用于与查找数据集进行联结的字段是​profile.exputingFlightId
    • 我们希望在“flight”引用下包含所有字段值。
  5. 配置要在Adobe Experience Platform数据集中调用的语法后,您可以指定要检索的字段。 语法如下:

    code language-none
    {{result.fieldId}}
    
    note
    NOTE
    在引用数据集字段时,请确保与架构中定义的完整字段路径匹配。
    可使用辅助函数提取的字段数没有硬性限制。 但是,为获得最佳性能,建议将字段数保持在50以下以避免影响吞吐量。
    • result​是您已分配给​ datasetLookup ​帮助程序函数中的​ result ​参数的值。 在本例中,为“flight”。

    • fieldID​是要检索的字段的ID。 在浏览与数据集相关的记录架构时,此ID在Adobe Experience Platform用户界面中可见:

      accordion
      在何处检索字段ID?

      在Adobe Experience Platform用户界面中预览数据集时,可以检索字段ID。 在Adobe Experience Platform文档中了解如何预览数据集。

    在本例中,我们希望使用与乘客登机时间和登机口相关的信息。 因此,我们添加了这两行:

    • {{flight._myorg.booking.boardingTime}}
    • {{flight._myorg.booking.gate}}
  6. 现在,您的代码已准备就绪,您可以照常完成内容,然后使用任一模拟方法进行测试:单击​ 模拟内容 ​以通过样本输入数据或AI自动生成来测试内容变体,或单击​模拟内容,然后从下拉列表中选择​ 模拟内容(AEP配置文件) ​以使用测试配置文件进行预览。 了解如何预览和测试内容

快速参考 quick-reference

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

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

概述

TL;DR

本页介绍如何在Journey Optimizer个性化编辑器中使用datasetLookup辅助函数从Adobe Experience Platform记录数据集检索字段,并将这些字段合并到消息个性化中。

意图

  • 启用AEP记录数据集以进行查找个性化
  • datasetLookup辅助函数添加到个性化表达式
  • 使用数据集ID、联接键、结果别名和所需标志配置函数
  • 使用结果别名引用个性化表达式中检索的数据集字段
  • 使用模拟内容流测试个性化内容
术语表
  • datasetLookup:个性化编辑器中的帮助程序函数,它通过联接指定键从AEP记录数据集中检索字段值。 (产品特定)
  • 记录数据集: Adobe Experience Platform数据集类型,包含可启用查询个性化的记录级别数据。 (产品特定)
  • 查找个性化:在发送时从AEP记录数据集获取字段以个性化消息内容的过程。 (产品特定)
  • 结果参数:在datasetLookup调用中分配的任意别名;用于引用后续表达式中所有检索到的字段值(例如{{result.fieldId}})。
  • 必需的参数datasetLookup中的布尔标志,用于控制邮件投放是否需要在数据集中找到匹配的键。
术语
  • 规范名称: datasetLookup — 变量:数据集查找、数据集查找帮助程序、数据集查找帮助程序函数
  • 同义词: “datasetLookup” = “dataset lookup helper function”
  • 请勿混淆:“datasetId”(AEP数据集的标识符)≠“id”(用于与数据集主标识连接的源列)≠“result”(用于引用检索的字段值的别名)
护栏和限制
  • 功能仅有限可用 — 尚未向所有客户正式提供。
  • 表达式片段中的datasetLookup帮助程序函数仅对有限的一组客户可用;请联系您的Adobe代表以获取访问权限。
  • 必须先为查找个性化明确启用数据集,然后才能将其与datasetLookup一起使用。
  • 将每datasetLookup调用检索到的字段数保持在50以下以避免影响吞吐量(建议限制 — 页面上未说明硬限制)。
常见问题解答

问:datasetLookup辅助函数是什么?

它是个性化编辑器中的辅助函数,可从Adobe Experience Platform记录数据集中检索字段值,从而使您能够将该数据合并到消息个性化中。

问:如果在数据集中找不到required=false和匹配的键,会发生什么情况?

消息仍可投放。 在使用required=false时,建议考虑邮件内容中的回退或默认值。

问:如果找不到required=true和匹配的密钥,会发生什么情况?

只有在数据集中找到匹配的键时,才会投放消息。

问:在哪里可以找到语法所需的数据集ID和字段ID?

可以在数据集下的Adobe Experience Platform UI中检索数据集ID。 在AEP UI中预览数据集和浏览记录架构时,字段ID可见。

问:如何测试使用datasetLookup的内容?

使用“模拟内容”​按钮以使用样本输入数据或AI自动生成进行测试,或从下拉列表中选择​ “模拟内容(AEP配置文件)” ​以使用测试配置文件预览。

recommendation-more-help
journey-optimizer-help