Privacy Service Eventsを購入

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

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

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

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

はじめに

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

Privacy Service EventsへのWebhookの登録

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

この達成方法の詳細な手順については、「I/O Event通知の購読」のチュートリアルに従ってください。 上記のイベントにアクセスするには、イベントプロバイダーとして​ Privacy Service Events ​を選択してください。

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 アプリケーションを示します。

次の手順

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

recommendation-more-help
experience-platform-help-privacy-service