Show Menu
トピック×

プライバシーイベントの購読

プライバシーイベントは、Adobe Experience Platform Privacy Serviceが提供するメッセージです。Adobe Experience Platform Privacy Serviceは、設定されたWebフックに送信されるAdobe I/Oイベントを利用して、効率的なジョブリクエストの自動化を促進します。 ジョブが完了したか、ワークフロー内の特定のマイルストーンに達したかを確認するために、プライバシーサービスAPIをポーリングする必要が少なくなるか、不要になります。
現在、プライバシージョブリクエストのライフサイクルに関連する通知には、次の4種類があります。
タイプ
説明
ジョブ完了
すべてのExperience Cloudソリューションが報告を取り戻し、ジョブの全体的なステータスまたはグローバルステータスが完了とマークされました。
ジョブエラー
1つ以上のソリューションが、要求の処理中にエラーを報告しました。
製品完了
このジョブに関連付けられている解決策の1つが、作業を完了しました。
製品エラー
いずれかのソリューションで、要求の処理中にエラーが報告されました。
このドキュメントでは、Adobe I/O内でプライバシーサービス通知の統合を設定する手順を説明します。 プライバシーサービスとその機能の概要については、「 プライバシーサービスの概要 」を参照してください。

はじめに

このチュートリアルでは、 ngrok 、セキュリティで保護されたトンネルを通してローカルサーバをパブリックインターネットに公開するソフトウェア製品を使用します。 このチュートリアルを開始する前に 、ngrokを インストールして、ローカルマシンにWebフックを作成してください。 また、このガイドでは、シンプルな Node.js サーバーを含むGITリポジトリをダウンロードする必要があります。

ローカルサーバーの作成

Node.jsサーバーは、リクエストによってルート( challenge``/ )エンドポイントに送信されたパラメーターを返す必要があります。 これを行うには、次のJavaScriptを使用して index.js ファイルを設定します。
var express = require('express')
var app = express()

app.set('port', (process.env.PORT || 3000))
app.use(express.static(__dirname + '/public'))

app.get('/', function(request, response) {
  response.send(request.originalUrl.split('?challenge=')[1]);
})

app.listen(app.get('port'), function() {
  console.log("Node app is running at localhost:" + app.get('port'))
})

コマンドラインを使用して、Node.jsサーバーのルートディレクトリに移動します。 次に、次のコマンドを入力します。
  1. npm install
  2. npm start
これらのコマンドは、すべての依存関係をインストールし、サーバーを初期化します。 正常に終了した場合は、サーバーがhttp://localhost:3000/で実行されていることを確認できます。

ngrookを使用してWebフックを作成する

新しいコマンドラインウィンドウを開き、以前にngrookをインストールしたディレクトリに移動します。 ここから、次のコマンドを入力します。
./ngrok http -bind-tls=true 3000

成功した場合の出力結果は次のようになります。
次の手順でWebフックを識別するために使用される Forwarding URL( https://212d6cd2.ngrok.io )を控えておいてください。

Adobe Developer Consoleでの新しいプロジェクトの作成

Adobe Developer Console に移動し 、Adobe IDでサインインします。 次に、Adobe Developer Consoleドキュメントで空のプロジェクトの 作成に関するチュートリアルに概要を説明している手順に従い ます。

プロジェクトの追加プライバシーイベント

コンソールで新しいプロジェクトの作成が完了したら、「プ ロジェクト概要 」画面の「 イベント 」をクリックします。
# ダイアログが表示されます。 「 Experience Cloud 」を選択して利用可能なイベントタイプのリストを絞り込み、「 次へ 」をクリックする前に「 プライバシーサービスのイベント 」を選択します。
# ダイアログが表示されます。 対応するチェックボックスをオンにして、受け取るイベントを選択します。 選択したイベントは、左の列の「 購読済みイベント 」の下に表示されます。 終了したら、「 ​次へ​ 」をクリックします。
次の画面では、イベント登録用の公開鍵を入力するように求められます。 自動的にキーペアを生成するか、端末で生成した独自の公開鍵をアップロードするかを選択できます。
このチュートリアルでは、最初のオプションに従います。 「キーペアを 生成」のオプションボックスをクリックし 、右下隅の「キーペアを 生成 」ボタンをクリックします。
キーペアが生成されると、ブラウザーによって自動的にダウンロードされます。 このファイルは開発者コンソールで保持されないので、自分で保存する必要があります。
次の画面では、新しく生成されたキーペアの詳細を確認できます。 「 次へ 」をクリックして次に進みます。
次の画面で、イベント登録の名前と説明を入力します。 ベストプラクティスは、同じプロジェクト内の他のユーザーとこのイベントの登録を区別できるように、一意で、簡単に識別できる名前を作成することです。
同じ画面の下に、イベントの受信方法を設定する2つのオプションが表示されます。 「 Webhook 」を選択し、「 Forwarding Webhook URL _」で前に作成したNgrook Webフックの_URLを指定します。 次に、「設定済みのイベントを​ ​保存」をクリックする前に、希望の配信スタイル(単一またはバッチ)を選択し、イベントの登録を完了します​
プロジェクトの詳細ページが再表示され、左のナビゲーションの イベントの下にプライバシーイベントが表示されます

表示イベントデータ

プロジェクトにプライバシーイベントを登録し、プライバシージョブが処理されると、その登録に関して受信した通知を表示できます。 デベロッパーコンソールの プロジェクト タブで、リストからプロジェクトを選択し、 製品概要 ページを開きます。 画面左側のナビゲーションから「 プライバシーイベント 」を選択します。
登録の詳細 」タブが表示され、登録の詳細表示、設定の編集、Webフックのアクティブ化後に受け取った実際のイベントの表示を行うことができます。
[ デバッグトレース ]タブをクリックして、受信したイベントのリストを表示します。 表示されたイベントをクリックして詳細を表示します。
Payload 」セクションには、上の例で強調表示されているイベントタイプ( com.adobe.platform.gdpr.productcomplete )を含む、選択したイベントに関する詳細が表示されます。

次の手順

必要に応じて、異なるWebフックアドレスに対して新しい統合を追加する場合、上記の手順を繰り返すことができます。