資料擷取通知
將資料內嵌至Adobe Experience Platform的程式由多個步驟組成。 識別需要內嵌到中的資料檔案後 Platform,擷取程式隨即開始,每個步驟會連續進行,直到資料成功擷取或失敗為止。 內嵌程式可透過以下方式啟動: Adobe Experience Platform批次擷取API 或使用 Experience Platform 使用者介面。
資料載入到 Platform 必須執行多個步驟才能到達其目的地: Data Lake 或 Real-Time Customer Profile 資料存放區。 每個步驟都涉及處理資料、驗證資料,然後儲存資料,再將其傳遞至下一個步驟。 根據所擷取的資料量,這會成為一個耗時的程式,而且該程式總是有可能因驗證、語意或處理錯誤而失敗。 如果失敗,則需要修正資料問題,然後必須使用修正的資料檔案重新啟動整個擷取程式。
若要協助監控擷取程式, Experience Platform 可讓您訂閱流程每個步驟所發佈的一組事件,通知您所擷取資料的狀態和任何可能的失敗。
註冊webhook以取得資料擷取通知
若要接收資料擷取通知,您必須使用 Adobe Developer主控台 將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