Adobe I/Oイベント通知のサブスクライブ

Observability Insights Adobe Experience Platformアクティビティに関するAdobe I/Oイベント通知を購読できます。これらのイベントは、アクティビティ監視の効率的な自動化を容易にするために、設定済みのWebフックに送信されます。

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

はじめに

このドキュメントでは、Webフックに関する実際の理解と、あるアプリケーションから別のアプリケーションへのWebフックの接続方法を理解する必要があります。 Webhookの紹介については、I/O Events ドキュメントを参照してください。

Webフックの作成

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

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

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

Adobeデベロッパーコンソールでの新しいプロジェクトの作成

Adobeデベロッパーコンソールに移動し、Adobe IDでサインインします。 次に、Adobe開発者コンソールドキュメントの空のプロジェクトの作成に関するチュートリアルに説明されている手順に従います。

イベントの購読

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

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

  • Experience Platform通知をサブスクライブする場合は、「プラットフォーム通知」を選択します
  • Adobe Experience PlatformPrivacy Service通知をサブスクライブする場合は、Privacy Serviceイベント​を選択します

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

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

メモ

使用しているサービスを購読するイベントが不明な場合は、次のサービス固有の通知ドキュメントを参照してください。

次の画面では、JSON Web Token(JWT)の作成を求めるプロンプトが表示されます。 自動的にキーペアを生成するか、端末で生成した独自の公開鍵をアップロードするかを選択できます。

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

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

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

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

イベントの受け取り方セクションの下の同じ画面で、必要に応じてイベントの受け取り方を設定できます。 ​Webhookでは、イベントを受け取るカスタムWebフックアドレスを指定できますが、 Runtime actionでは、 Adobe I/O Runtimeを使用して同じことを行えます

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

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

次の手順

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

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

このページ

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now