將資料輸入到Adobe Experience Platform的過程由多個步驟組成。 一旦確定需要接收到的資料檔案 Platform,攝取過程開始,每個步驟都連續進行,直到資料成功攝取或失敗。 可使用 Adobe Experience Platform資料接收API 或使用 Experience Platform 用戶介面。
資料載入到 Platform 必須經過多個步驟才能到達目的地, Data Lake 或 Real-time Customer Profile 資料儲存。 每個步驟都包括處理資料、驗證資料,然後在將資料傳遞到下一步之前儲存資料。 根據所攝取的資料量,這可能會成為一個耗時的過程,並且始終存在由於驗證、語義或處理錯誤而導致該過程失敗的可能性。 在發生故障時,需要修復資料問題,然後必須使用更正的資料檔案重新啟動整個接收過程。
為了協助監測攝入過程, Experience Platform 使您能夠訂閱由流程的每個步驟發佈的一組事件,並通知您所接收資料的狀態和任何可能的故障。
要接收資料接收通知,您必須使用 Adobe開發人員控制台 將webhook註冊到Experience Platform整合。
按照本教程 訂閱 Adobe I/O Event 通知 詳細的步驟。
在訂閱過程中,確保選擇 平台通知 作為事件提供程式,並選擇 資料接收通知 事件訂閱(出現提示時)。
成功註冊網路掛接並接收新資料後,您就可以開始接收事件通知。 可以使用webhook本身或通過選擇 調試跟蹤 頁籤。
以下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 | 成功 | 已成功將批攝取到 Profile 資料儲存。 |
ps_load_failure |
Real-time Customer Profile | 失敗 | 未能將批攝取到 Profile 資料儲存。 |
ig_load_success |
Identity Service | 成功 | 已成功將資料載入到標識圖中。 |
ig_load_failure |
Identity Service | 失敗 | 資料無法載入到標識圖中。 |
只為所有資料接收通知提供了一個事件主題。 為了區分不同的狀態,可以使用事件代碼。