使用Adobe Experience Platform数据进行个性化(Beta) aep-data

AVAILABILITY
此功能目前作为公共测试版向所有客户提供。
为了使用此功能,您必须首先接受贵组织的测试版条款,在个性化编辑器中添加新的“datasetLookup”帮助程序函数时会显示这些条款。

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中。

  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
      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
    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}}
  6. 现在,您的代码已准备就绪,您可以照常完成内容,并使用​ 模拟内容 ​按钮进行测试以检查个性化。 了解如何预览和测试内容

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76