使用 Adobe Experience Platform 数据 aep-data

通过Journey Optimizer,您可以利用来自Adobe Experience Platform数据的个性化、决策和Journey Orchestration功能。 要实现此目的,必须首先按照如下所述为查找服务启用查找个性化所需的基于记录的数据集。

必读

护栏和准则 guidelines

在开始之前,请查看以下限制和准则:

  • 数据集中没有PII — 启用查找的数据集不应包含任何个人身份信息(PII)。

    • 删除风险 — 未保护个性化中使用的数据集不被删除。 您必须跟踪正在使用哪些数据集,以确保未将其删除。
  • 架构类型 — 数据集必须与配置文件或事件类型的​ NOT ​架构关联。

  • 保持查找切换打开 — 避免反复打开和关闭数据集。 这样做可能会导致意外的索引行为。 最佳实践是,在您计划使用数据集进行查找期间,一直启用该数据集。

  • 批量数据删除 — 从数据集中删除批量数据将完全从查找服务中删除所有匹配的键。 例如:

    批次1: Sku1、Sku2、Sku3
    批次2:Sku1、Sku2、Sku3、Sku4、Sku5、Sku6
    批次3:Sku7、Sku8、Sku9、Sku10

    如果您删除​ 批次1,则Sku1、Sku2和Sku3将从查找存储中删除。 生成的查找数据将包含:Sku4、Sku5、Sku6、Sku7、Sku8、Sku9、Sku10。

查找服务的权利

功能组件
限制
注释
已启用查找数据集
每个组织最多10个
可配置为在任意给定时间进行查找的最大数据集数。 此限制适用于客户实例内生产和开发沙盒中的查找数据集的总组合数。
数据集记录计数
每个数据集最多200万条记录
单个数据集中允许的最大记录数,计算为该数据集内所有批次的总数。
记录大小
每条记录高达2 KB
支持的默认最大记录大小。
数据集大小
高达4 GB
单个数据集的最大大小,而不是沙盒中所有数据集的组合大小。 记录数和数据集大小限制是独立的护栏 — 必须同时满足这两个条件。
数据集频率更新
每个数据集每天最多可进行5次更新
每天单个数据集允许的最大更新操作频率。
NOTE
如果除了上面列出的护栏之外还需要其他卷,请联系您的Adobe代表。

启用数据集进行数据查找 enable

要将数据集中的数据用于个性化,您需要启用数据集以进行查找。

先决条件 prerequisites-enable

与要启用查找的数据集关联的架构必须是记录类型。 架构不应属于配置文件或事件类。

示例

架构必须定义主标识。

示例

如果尚未定义自定义命名空间,请确保该身份是非人员标识符。

示例

在数据集管理界面中启用数据集以进行查找

在数据集管理用户界面中,使用切换开关启用数据集以供查找。

NOTE
建议不要为配置文件启用该数据集,因为这样可能会导致配置文件丰富度增加,并且无需执行查找。

API方法

按照本文档中详述的说明配置环境以发送API命令。

先决条件

  • 开发人员项目必须将Adobe Journey Optimizer和Adobe Experience Platform API添加到其项目中。

  • 作为您的角色的一部分,您必须具有管理数据集权限。

  • 数据集所基于的架构必须包含一个可充当查找键的主标识。

API调用结构

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组织。
  • 沙盒名称是数据集所在的沙盒名称(即prod、dev等)。
NOTE
如果在尝试通过API调用启用数据集时遇到以下错误,请尝试从开发人员控制台项目中移除Adobe Journey Optimizer API,然后重新添加它们:
"error_code": "403003",
"message": "Api Key is invalid"

数据集监控

启用数据集进行查找后,您可以通过转到​ 监视 ​菜单并选择​ Journey Optimizer ​选项卡来查看摄取到查找服务的状态。

此流程指示器有助于了解查找服务中何时提供了新批次的数据。

后续步骤

在使用API调用启用数据集查找后,您可以将数据用于Journey Optimizer个性化和决策功能。 有关详细信息,请参阅以下部分:

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