Adobe Experience Platform でデータを取得するプロセスは、複数の手順で構成されます。Platformに取り込む必要のあるデータファイルを特定すると、取り込みプロセスが開始され、データが正常に取り込まれるか、または失敗するまで各ステップが連続して行われます。 取得処理は、Adobe データ取得 API を使用するか、Experience Platform のユーザーインターフェイスを使用して開始することができます。Experience Platform
Platformに読み込まれたデータは、目的のデータストア、Data Lakeデータストア、またはReal-time Customer Profileデータストアに到達するために複数の手順を経る必要があります。 各手順では、データの処理やデータの検証が行われ、データが次の手順に渡される前にデータが保存されます。取得されるデータの量によっては、この処理に時間がかかる場合があり、検証、セマンティクスまたは処理エラーが原因でプロセスが失敗する可能性が常にあります。失敗した場合は、データの問題を修正し、修正したデータファイルを使用して取得プロセス全体を再開する必要があります。
Experience Platformは、取り込みプロセスの監視を支援するため、プロセスの各ステップで公開された一連のイベントを登録し、取り込まれたデータの状態と発生する可能性のあるエラーを通知する。
データインジェスト通知を受け取るには、Adobe開発者コンソールを使用して、WebフックをExperience Platform統合に登録する必要があります。
これを行う方法の詳細な手順については、 Adobe I/O Event 通知のサブスクライブのチュートリアルに従ってください。
購読プロセス中に、イベントプロバイダーとしてプラットフォーム通知を選択し、プロンプトが表示されたらデータ取り込み通知イベント購読を選択します。
Webフックの登録が完了し、新しいデータが取り込まれると、イベント通知の受信開始を設定できます。 これらのイベントは、Webフック自体を使用して表示するか、Adobe開発者コンソールでプロジェクトのイベント登録の概要にある[Debug Tracing]タブを選択して表示できます。
以下のJSONは、バッチインジェストイベントが失敗した場合にWebフックに送信される通知ペイロードの例です。
{
"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"
}
}
}
}
プロパティ | 説明 |
---|---|
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 つのイベントトピックのみが提供されます。異なるステータスを区別するために、イベントコードを使用できます。