Adobe I/O イベント通知の登録

Observability Insights により、Adobe Experience Platform アクティビティに関する Adobe I/O イベント通知を登録できます。 これらのイベントは、アクティビティモニタリングの効率的な自動化を促進するために、設定済みの Webhook に送信されます。

このドキュメントでは、Adobe Experience Platform サービスのAdobe I/O イベント通知を購読する方法について説明します。 使用可能なイベントタイプに関する参照情報も提供され、該当するExperience Platform サービスごとに返されたイベントデータを解釈する方法に関する詳細なドキュメントへのリンクも含まれています。

はじめに

このドキュメントでは、Webhook と、あるアプリケーションから別のアプリケーションに Webhook を接続する方法についての実践的な理解が必要です。 Webhook の概要については、I/O Events ドキュメントを参照してください。

Webhook の作成

I/O Event 通知を受け取るには、イベント登録の詳細の一部として一意の Webhook URL を指定して Webhook を登録する必要があります。

選択したクライアントを使用して、Webhook を設定できます。 このチュートリアルの一部として使用する一時的な Webhook アドレスについては、Webhook.site にアクセスし、提供された一意の URL をコピーします。

最初の検証プロセス中に、I/O Events は GET リクエストで challenge のクエリパラメーターを Webhook に送信します。 このパラメーターの値を応答ペイロードで返すように Webhook を設定する必要があります。 Webhook.site を使用している場合は、右上隅の Edit を選択し、Response body の下に「$request.query.challenge$」と入力してから「Save」を選択します。

Adobe Developer Console で新規プロジェクトを作成します

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

イベントの登録

新しいプロジェクトを作成したら、そのプロジェクトの概要画面に移動します。 ここから、「イベントを追加」を選択します。

プロジェクトにイベントプロバイダーを追加できるダイアログが表示されます。

イベントプロバイダーを選択したら、次へ​を選択します。

次の画面に、登録するイベントタイプのリストが表示されます。 購読するイベントを選択し、次へ​を選択します。

次の画面では、JSON Webトークン（JWT）の作成を求められます。 キーペアを自動的に生成するか、ターミナルで生成された独自の公開キーをアップロードするかを選択できます。

このチュートリアルでは、最初のオプションに従います。 「キーペアを生成」のオプションボックスを選択し、右下隅の「キーペアを生成」ボタンを選択します。

生成されたキーペアは、ブラウザーによって自動的にダウンロードされます。 このファイルは、Developer Console 内には保持されないので、自分で保存する必要があります。

次の画面では、新しく生成されたキーペアの詳細を確認できます。 「次へ」をクリックして続行します。

次の画面で、​ イベント登録の詳細 セクションに、イベント登録の名前と説明を入力します。 ベストプラクティスは、このイベント登録を同じプロジェクト内の他のイベントと区別できるように、識別しやすい一意の名前を作成することです。

​ イベントの受け取り方法 セクションの下にある同じ画面で、オプションでイベントの受け取り方法を設定できます。 Webhook​では、イベントを受信するためのカスタム Webhook アドレスを指定できます。一方、Runtime action​では、Adobe I/O Runtimeを使用して同じことを実行できます。

このチュートリアルでは、Webhook​を選択し、以前に作成したWebhookのURLを指定します。 完了したら、設定済みイベントを保存​を選択して、イベント登録を完了します。

新しく作成されたイベント登録の詳細ページが表示され、設定の編集、受信したイベントの確認、デバッグトレースの実行、新しいイベントプロバイダーの追加をおこなうことができます。

次の手順

このチュートリアルに従い、Experience Platform および／または Privacy Service の I/O Event 通知を受け取る Webhook を登録しました。 使用可能なイベントと各サービスの通知ペイロードの解釈方法について詳しくは、次のドキュメントを参照してください。

Experience Platform と Privacy Service でアクティビティを監視する方法について詳しくは、Observability Insights 概要を参照してください。