データ取得通知

Adobe Experience Platform でデータを取得するプロセスは、複数の手順で構成されます。Platform に取り込む必要のあるデータファイルを特定したら、取り込みプロセスが開始され、データが正常に取り込まれるか、取り込まれないまで各手順が連続して実行されます。 取得処理は、Adobe データ取得 API を使用するか、Experience Platform のユーザーインターフェイスを使用して開始することができます。Experience Platform

Platform に読み込まれるデータは、宛先、Data Lake または Real-time Customer Profile データストアに到達するために、複数の手順を実行する必要があります。 各手順では、データの処理やデータの検証が行われ、データが次の手順に渡される前にデータが保存されます。取得されるデータの量によっては、この処理に時間がかかる場合があり、検証、セマンティクスまたは処理エラーが原因でプロセスが失敗する可能性が常にあります。失敗した場合は、データの問題を修正し、修正したデータファイルを使用して取得プロセス全体を再開する必要があります。

取り込みプロセスの監視に役立つように、Experience Platform を使用して、プロセスの各手順で公開された一連のイベントをサブスクライブし、取り込んだデータのステータスと発生する可能性のあるエラーを通知できます。

データ取得通知用の Webhook の登録

データ取得通知を受け取るには、Adobe開発者コンソール を使用して、Webhook をExperience Platform統合に登録する必要があります。

これをおこなう方法の詳細な手順については、 Adobe I/O Event 通知 の購読に関するチュートリアルを参照してください。

データ取得通知の受信

Webhook の登録が完了し、新しいデータが取り込まれたら、イベント通知の受信を開始できます。 これらのイベントは、Webhook 自体を使用するか、Adobe開発者コンソールでプロジェクトのイベント登録の概要の「デバッグトレース」タブを選択して表示できます。

次の JSON は、バッチ取得イベントが失敗した場合に Webhook に送信される通知ペイロードの例です。

{
  "event_id": "93a5b11a-b0e6-4b29-ad82-81b1499cb4f2",
  "event": {
    "xdm:ingestionId": "01EGK8H8HF9JGFKNDCABHGA24G",
    "xdm:customerIngestionId": "01EGK8H8HF9JGFKNDCABHGA24G",
    "xdm:imsOrg": "{IMS_ORG}",
    "xdm:completed": 1598374341560,
    "xdm:datasetId": "5e55b556c2ae4418a8446037",
    "xdm:eventCode": "ing_load_failure",
    "xdm:sandboxName": "prod",
    "sentTime": "1598374341595",
    "processStartTime": 1598374342614,
    "transformedTime": 1598374342621,
    "header": {
      "_adobeio": {
        "imsOrgId": "{IMS_ORG}",
        "providerMetadata": "aep_observability_catalog_events",
        "eventCode": "platform_event"
      }
    }
  }
}

イベント通知の完全なスキーマを表示するには、 パブリック GitHub リポジトリ を参照してください。

次の手順

プロジェクトに Platform 通知を登録すると、プロジェクトの概要 で受信したイベントを確認できます。 イベントのトレース方法の詳細については、Adobe I/Oイベント のトレースガイドを参照してください。

付録

次の節では、データ取得通知ペイロードの解釈に関する追加情報について説明します。

使用可能なステータス通知イベント

次の表に、サブスクライブできる、使用可能なデータ取得ステータス通知を示します。