Privacy Service Events を購読

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

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

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

このドキュメントでは、Privacy Service 通知のイベント登録を設定する手順と、通知ペイロードを解釈する方法について説明します。

はじめに

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

Privacy Service Events への Webhook の登録

Privacy Service Events を受け取るには、Adobe Developer Consoleを使用して、Privacy Service 統合に Webhook を登録する必要があります。

これを実現する方法の手順について詳しくは、I/O イベント ​ 通知のサブスクライブに関するチュートリアルに従ってください。 上記のイベントにアクセスするには、イベントプロバイダーとして 0}Privacy Serviceイベント } を選択してください。

Privacy Service Event 通知を受信

Webhook を正常に登録し、プライバシージョブが実行されたら、イベント通知の受信を開始できます。 これらのイベントは、Webhook 自体を使用するか、Adobe Developer Consoleでプロジェクトのイベント登録の概要にある「デバッグトレース」タブを選択すると表示できます。

次の JSON は、プライバシージョブに関連付けられたいずれかのアプリケーションが作業を完了した際に Webhook に送信される Privacy Service Event 通知ペイロードの例を示しています。

{
  "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