在此页面上:了解如何在个性化编辑器中使用datasetLookup帮助程序函数从Adobe Experience Platform记录数据集中检索字段并将内容个性化。
Journey Optimizer允许您在个性化编辑器中利用Adobe Experience Platform记录数据集的数据来个性化您的内容。 在开始之前,必须首先为查找启用查找个性化所需的数据集。 此部分中有详细信息: 使用Adobe Experience Platform数据。
为数据集启用了查找个性化后,您可以使用其数据将您的内容个性化到Journey Optimizer中。
-
打开个性化编辑器,您可以在每个上下文中定义个性化设置(如消息)时使用该编辑器。 了解如何使用个性化编辑器
-
导航到帮助程序函数列表,并将 datasetLookup 帮助程序函数添加到代码窗格。
-
此函数提供了一个预定义语法,允许您从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文档以了解如何使用数据集。
-
-
调整语法以符合您的需求。 在本例中,我们要检索与乘客航班相关的数据。 语法如下:
code language-none {{datasetLookup datasetId="1234567890abcdtId" id=profile.upcomingFlightId result="flight"}}- 我们正在处理ID为“1234567890abcdtId”的数据集,
- 我们要用于与查找数据集进行联结的字段是profile.exputingFlightId,
- 我们希望在“flight”引用下包含所有字段值。
-
配置要在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}}
-
-
现在,您的代码已准备就绪,您可以照常完成内容,然后使用任一模拟方法进行测试:单击 模拟内容 以通过样本输入数据或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配置文件)” 以使用测试配置文件预览。