数据摄取通知
将数据摄取到Adobe Experience Platform的过程包括多个步骤。 确定需要摄取到Platform中的数据文件后,摄取过程将开始,每个步骤将连续进行,直到数据成功摄取或失败。 可以使用Adobe Experience Platform批量摄取API或使用Experience Platform用户界面启动摄取过程。
加载到Platform的数据必须经过多个步骤才能到达其目标、Data Lake或Real-Time Customer Profile数据存储。 每个步骤都涉及处理数据、验证数据,然后存储数据,然后再将其传递到下一个步骤。 根据摄取的数据量,此过程可能会成为一个耗时的过程,并且始终存在因验证、语义或处理错误而失败的可能性。 如果失败,则需要修复数据问题,然后必须使用更正的数据文件重新启动整个摄取过程。
为了协助监视摄取过程,Experience Platform允许订阅由过程的每个步骤发布的一组事件,通知您摄取数据的状态和任何可能的失败。
注册webhook以获取数据摄取通知
若要接收数据摄取通知,您必须使用Adobe Developer Console将webhook注册到Experience Platform集成。
请阅读有关订阅 Adobe I/O Event 通知的教程,以了解有关如何完成此操作的详细步骤。
接收数据摄取通知
成功注册webhook并摄取新数据后,即可开始接收事件通知。 可以使用webhook本身或通过在Adobe Developer Console中选择项目事件注册概述中的 调试跟踪 选项卡来查看这些事件。
以下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
event
event.xdm:datasetId
event.xdm:eventCode
要查看事件通知的完整架构,请参阅公共GitHub存储库。
后续步骤
向项目注册Platform通知后,您可以从项目概述查看接收的事件。 有关如何跟踪Adobe I/O的详细说明,请参阅跟踪事件指南。
附录
以下部分包含有关解释数据摄取通知有效负载的其他信息。
可用状态通知事件 event-codes
下表列出了您可以订阅的可用数据摄取状态通知。
ing_load_success
ing_load_failure
ps_load_success
ps_load_failure
ig_load_success
ig_load_failure