Adobe Experience Platform でデータを取得するプロセスは、複数の手順で構成されます。取り込む必要のあるデータファイルを特定したら、 Platformを指定した場合、取り込みプロセスが開始され、データが正常に取り込まれるか失敗するまで各手順が連続して実行されます。 取り込みプロセスは、 Adobe Experience Platform Batch Ingestion API または Experience Platform ユーザーインターフェイス。
に読み込まれたデータ Platform 目的の場所に到達するには、複数の手順を実行する必要があります。 Data Lake または Real-Time Customer Profile データストア。 各手順では、データの処理やデータの検証が行われ、データが次の手順に渡される前にデータが保存されます。取得されるデータの量によっては、この処理に時間がかかる場合があり、検証、セマンティクスまたは処理エラーが原因でプロセスが失敗する可能性が常にあります。失敗した場合は、データの問題を修正し、修正したデータファイルを使用して取得プロセス全体を再開する必要があります。
取り込みプロセスの監視に役立つように、 Experience Platform を使用すると、プロセスの各手順で公開された一連のイベントを購読し、取り込んだデータのステータスと考えられるエラーを通知できます。
データ取得通知を受け取るには、 Adobe Developer Console をクリックして、webhook をExperience Platform統合に登録します。
次のチュートリアルに従います。 購読者 Adobe I/O Event 通知 を参照してください。
購読プロセス中に、必ず プラットフォーム通知 をイベントプロバイダーとして選択し、 データ取り込み通知 要求された場合はイベント購読。
Webhook の登録が完了し、新しいデータが取り込まれたら、イベント通知の受信を開始できます。 これらのイベントは、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 | 成功 | バッチが 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 グラフに読み込めませんでした。 |
すべてのデータ取得通知に対して 1 つのイベントトピックのみが提供されます。異なるステータスを区別するために、イベントコードを使用できます。