將資料擷取至Adobe Experience Platform的程式由多個步驟組成。 識別需要擷取至的資料檔案後 Platform,擷取程式會開始,且每個步驟會連續進行,直到資料成功擷取或失敗為止。 擷取程式可使用 Adobe Experience Platform資料擷取API 或使用 Experience Platform 使用者介面。
資料載入 Platform 必須執行多個步驟才能到達目的地, Data Lake 或 Real-Time Customer Profile 資料儲存。 每個步驟都包括處理資料、驗證資料,然後儲存資料再傳遞至下一個步驟。 視擷取的資料量而定,這可能會成為耗時的程式,且程式總有可能因驗證、語意或處理錯誤而失敗。 發生失敗時,需要修正資料問題,然後必須使用修正的資料檔案重新啟動整個擷取程式。
若要協助監控擷取程式, Experience Platform 使得訂閱由流程的每個步驟發佈的一組事件,通知您所擷取資料的狀態以及任何可能的失敗。
若要接收資料擷取通知,您必須使用 Adobe Developer Console 將網頁連結註冊至您的Experience Platform整合。
請依照 訂閱 Adobe I/O Event 通知 以取得完成此作業的詳細步驟。
在訂閱程式期間,請確定您選取 平台通知 作為事件提供者,並選取 資料擷取通知 事件訂閱(在出現提示時)。
一旦您成功註冊網頁連結且已內嵌新資料後,即可開始接收事件通知。 這些事件可使用網頁連結本身,或選取 調試跟蹤 頁簽(在Adobe Developer Console中)。
下列JSON是通知裝載的範例,若批次擷取事件失敗,會將其傳送至您的網頁掛接:
{
"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 | 失敗 | 無法將資料載入到標識圖中。 |
只為所有資料擷取通知提供一個事件主題。 為了區分不同的狀態,可使用事件代碼。