将数据摄取到Adobe Experience Platform的过程由多个步骤组成。 确定需要摄取到的数据文件后 Platform,则摄取过程会开始,并且每个步骤都会连续进行,直到成功摄取或失败数据为止。 可以使用 Adobe Experience Platform批量摄取API 或使用 Experience Platform 用户界面。
数据加载到 Platform 必须执行多个步骤才能到达目标, Data Lake 或 Real-Time Customer Profile 数据存储。 每个步骤都包括处理数据、验证数据,然后存储数据,然后再将其传递到下一步。 根据所摄取的数据量,这可能会成为一个耗时的过程,并且该过程始终可能因验证、语义或处理错误而失败。 在失败时,需要修复数据问题,然后必须使用更正的数据文件重新启动整个摄取过程。
为协助监控摄取过程, Experience Platform 使订阅一组在流程的每个步骤中发布的事件,并通知您所摄取数据的状态以及任何可能的失败。
要接收数据摄取通知,您必须使用 Adobe Developer控制台 注册webhook以集成您的Experience Platform。
请阅读本教程 订阅 Adobe I/O Event 通知 以详细了解如何完成此操作。
在订阅过程中,请确保您选择 平台通知 作为事件提供程序,然后选择 数据摄取通知 事件订阅。
成功注册Webhook并摄取新数据后,即可开始接收事件通知。 这些事件可以使用Webhook本身或通过选择 调试跟踪 选项卡(位于Adobe Developer控制台中的项目事件注册概述中)。
以下JSON是通知有效负载的示例,在批量摄取事件失败时,将该有效负载发送到您的Webhook:
{
"event_id": "93a5b11a-b0e6-4b29-ad82-81b1499cb4f2",
"event": {
"xdm:ingestionId": "01EGK8H8HF9JGFKNDCABHGA24G",
"xdm:customerIngestionId": "01EGK8H8HF9JGFKNDCABHGA24G",
"xdm:imsOrg": "{ORG_ID}",
"xdm:completed": 1598374341560,
"xdm:datasetId": "5e55b556c2ae4418a8446037",
"xdm:eventCode": "ing_load_failure",
"xdm:sandboxName": "prod",
"sentTime": "1598374341595",
"processStartTime": 1598374342614,
"transformedTime": 1598374342621,
"header": {
"_adobeio": {
"imsOrgId": "{ORG_ID}",
"providerMetadata": "aep_observability_catalog_events",
"eventCode": "platform_event"
}
}
}
}
属性 | 描述 |
---|---|
event_id |
系统生成的唯一通知ID。 |
event |
一个对象,其中包含触发通知的事件的详细信息。 |
event.xdm:datasetId |
摄取事件所应用到的数据集的ID。 |
event.xdm:eventCode |
状态代码,用于指示为数据集触发的事件类型。 请参阅 附录 的值及其定义。 |
要查看事件通知的完整架构,请参阅 公共GitHub存储库.
注册后 Platform 通知项目时,您可以查看 项目概述. 请参阅 跟踪Adobe I/O事件 以了解有关如何跟踪事件的详细说明。
以下部分包含有关解释数据摄取通知负载的其他信息。
下表列出了可订阅的可用数据摄取状态通知。
事件代码 | 平台服务 | 状态 | 事件描述 |
---|---|---|---|
ing_load_success |
Data Ingestion | success | 已成功将批量摄取到 Data Lake. |
ing_load_failure |
Data Ingestion | 失败 | 无法将批量摄取到 Data Lake. |
ps_load_success |
Real-Time Customer Profile | success | 已成功将批次摄取到 Profile 数据存储。 |
ps_load_failure |
Real-Time Customer Profile | 失败 | 未能将批次摄取到 Profile 数据存储。 |
ig_load_success |
Identity Service | success | 数据已成功加载到身份图中。 |
ig_load_failure |
Identity Service | 失败 | 数据无法加载到身份图中。 |
只为所有数据摄取通知提供了一个事件主题。 为了区分不同的状态,可以使用事件代码。