使用Adobe Experience Platform数据进行个性化(Beta) aep-data
Journey Optimizer允许您在个性化编辑器中利用Adobe Experience Platform中的数据来个性化您的内容。 为此,必须首先通过API调用启用查找个性化所需的数据集,如下所述。 完成后,您可以使用他们的数据将您的内容个性化到Journey Optimizer中。
Beta限制和准则 guidelines
在开始之前,请查看以下限制和准则:
数据集启用 enablement
- 数据集大小 在生产数据集上限制为5 GB,在开发沙盒数据集中限制为1 GB
- 在任何时候,每个组织最多可以启用50个数据集 以进行查找。
- 记录数 在生产数据集中限制为5M,在开发沙盒数据集中限制为1M。
- 数据使用标签和强制执行 目前未对启用查找的数据集强制执行。
- 启用查找并用于个性化设置的数据集不受删除保护。 至于将哪些数据集用于个性化,将由您自行跟踪,以确保不会删除或删除这些数据集。
使用Adobe Experience Platform数据的Personalization perso
- 支持的渠道:目前,此功能仅适用于电子邮件、短信、推送和直邮渠道。
- 数据使用标签和强制执行 目前未对启用查找的数据集强制执行。
- 表达式片段:此时不能将数据集查找个性化置于表达式片段中。
启用数据集进行数据查找 enable
为了利用来自数据集的数据进行个性化,您需要使用API调用检索其状态并启用查找服务。
先决条件 prerequisites-enable
-
按照本文档中详述的说明配置环境以发送API命令。
-
开发人员项目必须将Adobe Journey Optimizer和Adobe Experience Platform API添加到其项目中。
-
作为您的角色的一部分,您必须具有管理数据集权限。
-
数据集所基于的架构必须包含可用作查找键的 主标识。
API调用结构 call
curl -s -XPATCH "https://platform.adobe.io/data/core/entity/lookup/dataSets/${DATASET_ID}/${ACTION}" \ -H "Authorization: Bearer ${ACCESS_TOKEN}" \ -H "x-api-key: ${API_KEY}" \ -H "x-gw-ims-org-id: ${IMS_ORG}" \ -H "x-sandbox-name: ${SANDBOX_NAME}"
其中:
- URL 是
https://platform.adobe.io/data/core/entity/lookup/dataSets/${DATASET_ID}/${ACTION}
- 数据集ID 是您希望启用的数据集。
- 操作 被启用或禁用。
- 可以从开发人员控制台检索 访问令牌。
- 可从开发人员控制台检索 API密钥。
- IMS组织ID 是您的Adobe IMS组织。
- 沙盒名称 是数据集所在的沙盒名称(即prod、dev等)。
利用数据集进行个性化 leverage
使用API调用为数据集启用查找个性化后,您可以使用其数据将您的内容个性化到Journey Optimizer中。
-
打开个性化编辑器,您可以在每个上下文中定义个性化设置(如消息)时使用该编辑器。 了解如何使用个性化编辑器
-
导航到帮助程序函数列表,并将 datasetLookup 帮助程序函数添加到代码窗格。
-
此函数提供了一个预定义语法,允许您从Adobe Experience Platform数据集调用字段。 语法如下:
code language-none {{datasetLookup datasetId="datasetId" id="key" result="store" required=false}}
-
datasetId 是您正在处理的数据集的ID。
-
id 是源列的ID,它应该与查找数据集的主标识联接。
note 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 NOTE 在引用数据集字段时,请确保与架构中定义的完整字段路径匹配。 -
result 是您分配给 MultiEntity 帮助程序函数中的 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}}
-
-
现在,您的代码已准备就绪,您可以照常完成内容,并使用 模拟内容 按钮进行测试以检查个性化。 了解如何预览和测试内容