配信登録 Privacy Service Events

Privacy Service Events は、Adobe Experience Platformが提供するメッセージです Privacy Service:設定済みの Webhook に送信されたAdobe I/Oイベントを活用して、効率的なジョブリクエストの自動化を促進します。 ジョブが完了したか、またはワークフロー内の特定のマイルストーンに達したかを確認するために Privacy Service API をポーリングする必要性が削減される、または完全になくなります。

現在、プライバシージョブリクエストのライフサイクルに関連する通知には、次の 4 種類があります。

タイプ
説明
ジョブ完了
すべて Experience Cloud アプリケーションからレポートが返され、ジョブの全体的なステータスまたはグローバルステータスが完了とマークされました。
ジョブエラー
リクエストの処理中に 1 つ以上のアプリケーションがエラーを報告しました。
製品完了
このジョブに関連付けられているアプリケーションの 1 つが、作業を完了しました。
製品エラー
リクエストの処理中に 1 つのアプリケーションがエラーを報告しました。

このドキュメントでは、 Privacy Service 通知と、通知ペイロードの解釈方法を示します。

はじめに

このチュートリアルを開始する前に、次のPrivacy Serviceドキュメントを確認してください。

ウェブフックの登録先 Privacy Service Events

受け取る Privacy Service Eventsを使用している場合、Webhook を Privacy Service 統合とも呼ばれます。

次のチュートリアルに従います。 I/O Event 通知の購読 を参照してください。 必ず Privacy Serviceイベント 上記のイベントにアクセスするには、をイベントプロバイダーとして設定します。

受信 Privacy Service Event 通知

Webhook の登録とプライバシージョブの実行が完了したら、イベント通知の受信を開始できます。 これらのイベントは、Webhook 自体を使用して、または デバッグトレース 」タブを使用します。

次の JSON は、 Privacy Service Event プライバシージョブに関連付けられたアプリケーションの 1 つがその作業を完了したときに webhook に送信される通知ペイロード:

{
  "id":"b472e249-368b-4706-90f3-1d774713f827",
  "event_id":"b116f797-e50b-432e-9c65-189106a34820",
  "specversion":"0.2",
  "type":"com.adobe.platform.gdpr.productcomplete",
  "source":"https://ns.adobe.com/platform/gdpr",
  "time":"Wed Oct 23 18:52:32 GMT 2019",
  "data":{
    "imsOrg":"{ORG_ID}",
    "value":{
      "jobId":"6f0f2b62-88a7-4515-ba05-432d9a7021c5",
      "message":"analytics.access.complete"
    }
  }
}
プロパティ
説明
id
通知用の、システムで生成された一意の ID。
type

送信される通知のタイプ。 data. 有効な値は次のとおりです。

  • com.adobe.platform.gdpr.jobcomplete
  • com.adobe.platform.gdpr.joberror
  • com.adobe.platform.gdpr.productcomplete
  • com.adobe.platform.gdpr.producterror
time
イベントが発生した日時のタイムスタンプ。
data.value

通知をトリガーしたアイテムに関する追加情報が含まれます。

  • jobId:通知をトリガーしたプライバシージョブの ID。
  • message:ジョブの特定のステータスに関するメッセージ。 の場合 productcomplete または producterror 通知。このフィールドは、該当するExperience Cloud・アプリケーションを示します。

次の手順

このドキュメントでは、設定済みの Webhook にPrivacy Serviceイベントを登録する方法と、通知ペイロードの解釈方法について説明しました。 ユーザーインターフェイスを使用してプライバシージョブを追跡する方法については、 Privacy Serviceユーザーガイド.

recommendation-more-help
9cbf7061-a312-49f7-aaf8-a10885d53580