データ取得通知

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

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

取り込みプロセスの監視を支援するために、Experience Platform では、プロセスの各ステップで公開される一連のイベントを登録し、取り込んだデータのステータスと発生する可能性のあるエラーを通知できるようにしています。

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

データ取得通知を受け取るには、Adobe Developer Console を使用して、Experience Platform統合に Webhook を登録する必要があります。

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

IMPORTANT
購読プロセス中に、必ず Platform 通知 をイベントプロバイダーとして選択し、プロンプトが表示されたら データ取り込み通知 イベント購読を選択します。

データ取得通知を受信

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
成功
データが ID グラフに正常に読み込まれました。
ig_load_failure
Identity Service
失敗
データを ID グラフに読み込めませんでした。
NOTE
すべてのデータ取得通知に対して提供されるイベントトピックは 1 つだけです。 異なるステータスを区別するために、イベントコードを使用できます。
recommendation-more-help
2ee14710-6ba4-4feb-9f79-0aad73102a9a