資料擷取通知

將資料內嵌至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 通知的教學課程。

IMPORTANT
在訂閱程式期間,請確定您選取​ 平台通知 ​作為事件提供者,並在出現提示時選取​ 資料擷取通知 ​事件訂閱。

接收資料擷取通知

成功註冊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
系統產生的通知唯一ID。
event
包含觸發通知之事件詳細資料的物件。
event.xdm:datasetId
要套用擷取事件的資料集ID。
event.xdm:eventCode
狀態代碼,指出針對資料集觸發的事件型別。 如需特定值及其定義,請參閱附錄

若要檢視事件通知的完整結構描述,請參閱公用GitHub存放庫

後續步驟

一旦您將Platform個通知註冊到專案中,您就可以從專案概述檢視收到的事件。 請參閱追蹤Adobe I/O事件的指南,以取得如何追蹤事件的詳細說明。

附錄

下節包含有關解譯資料擷取通知裝載的其他資訊。

可用的狀態通知事件 event-codes

下表列出您可以訂閱的可用資料擷取狀態通知。

事件代碼
平台服務
狀態
事件說明
ing_load_success
Data Ingestion
成功
已成功將批次擷取到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
失敗
資料無法載入身分圖表中。
NOTE
所有資料擷取通知僅提供一個事件主題。 為了區分不同的狀態,可以使用事件程式碼。
recommendation-more-help
2ee14710-6ba4-4feb-9f79-0aad73102a9a