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

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

このドキュメントでは、Adobe Experience Platform サービスのAdobe I/Oイベント通知を登録する手順について説明します。 利用可能なイベントタイプに関する参照情報も、該当する各 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 アクション ​では、Adobe I/O Runtime を使用して同じ処理を実行できます。

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

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

次の手順

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

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