Show Menu
トピック×

データ取得通知

Adobe Experience Platform でデータを取得するプロセスは、複数の手順で構成されます。Once you identify data files that need to be ingested into Platform, the ingestion process begins and each step occurs consecutively until the data is either successfully ingested or fails. 取得処理は、 Adobe データ取得 API を使用するか、Experience Platform のユーザーインターフェイスを使用して開始することができます。Experience Platform
Data loaded into Platform must go through multiple steps in order to reach its destination, the Data Lake or the Real-time Customer Profile data store. 各手順では、データの処理やデータの検証が行われ、データが次の手順に渡される前にデータが保存されます。取得されるデータの量によっては、この処理に時間がかかる場合があり、検証、セマンティクスまたは処理エラーが原因でプロセスが失敗する可能性が常にあります。失敗した場合は、データの問題を修正し、修正したデータファイルを使用して取得プロセス全体を再開する必要があります。
To assist in monitoring the ingestion process, Experience Platform makes it possible to subscribe to a set of events that are published by each step of the process, notifying you to the status of the ingested data and any possible failures.

データインジェスト通知用のWebフックの登録

データインジェスト通知を受け取るには、 Adobeデベロッパーコンソール (DDC)を使用してWebフックをExperience Platform統合に登録する必要があります。
購読プロセス中に、イベントプロバイダーとして プラットフォーム通知 (Platform notifications )を選択し、プロンプトが表示されたら Data ingestion notificationイベント購読を選択します。

データ取り込み通知の受信

Webフックの登録が完了し、新しいデータが取り込まれると、イベント通知の受信開始を設定できます。 これらのイベントは、Webフック自体を使用して表示するか、Adobe開発者コンソールでプロジェクトのイベント登録の概要にある # タブを選択して表示できます。
以下の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 通知を登録すると、 プロジェクトの概要からイベントを受け取った表示を表示できます。 Refer to the guide on tracing Adobe I/O Events for detailed instructions on how to trace your events.

付録

次の節では、データインジェスト通知ペイロードの解釈に関する追加情報を説明します。

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

次の表に、サブスクライブ可能なデータインジェストステータス通知をリストします。
イベントコード
プラットフォームサービス
ステータス
イベントの説明
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 つのイベントトピックのみが提供されます。異なるステータスを区別するために、イベントコードを使用できます。