Privacy Service Events を購読
Adobe Experience Platform Privacy Service が提供するメッセージで、設定済みの Webhook に送信されるAdobe I/Oイベントを活用して、効率的なジョブリクエストの自動処理を容易にする Privacy Service Events のがあります。 ジョブが完了したか、またはワークフロー内の特定のマイルストーンに達したかを確認するために Privacy Service API をポーリングする必要性が削減される、または完全になくなります。
現在、プライバシージョブリクエストのライフサイクルに関連する通知には、次の 4 種類があります。
このドキュメントでは、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
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ユーザーガイドを参照してください。