資料接收通知

將資料輸入到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 失敗 資料無法載入到標識圖中。
注意

只為所有資料接收通知提供了一個事件主題。 為了區分不同的狀態,可以使用事件代碼。

本頁內容