Platform Web SDK データを使用したイベント転送の設定
Adobe Experience Platform Web SDK データでイベント転送を使用する方法について説明します。
イベント転送は、データ収集で使用できる新しいタイプのプロパティです。 イベント転送を使用すると、従来のクライアントサイドブラウザーではなく、Adobe Experience Platform Edge NetworkからサードパーティのAdobe以外のベンダーにデータを直接送信できます。 イベント転送の利点について詳しくは、 イベント転送の概要を参照してください。
Adobe Experience Platformでイベント転送を使用するには、まず次の 3 つのオプションの 1 つ以上を使用して、データをAdobe Experience Platform Edge Networkに送信する必要があります。
このチュートリアルの前のレッスンを完了したら、Web SDK を使用して Platform Edge Networkにデータを送信する必要があります。 データが Platform Edge Networkになったら、イベント転送を有効にし、イベント転送プロパティを使用して、Adobe以外のソリューションにデータを送信できます。
学習目標
このレッスンでは、次の内容を学習します。
- イベント転送プロパティの作成
- イベント転送プロパティを Platform Web SDK データストリームにリンクする
- タグプロパティのデータ要素とルール、およびイベント転送のプロパティデータ要素とルールの違いについて
- イベント転送データ要素の作成
- イベント転送ルールの設定
- イベント転送プロパティが正常にデータを送信できたことを検証します
前提条件
-
イベント転送を含むソフトウェアライセンス。 イベント転送は、データ収集の有料機能です。 詳しくは、Adobeアカウントチームにお問い合わせください。
-
Experience Cloud組織でイベント転送が有効になっている。
-
イベント転送のユーザー権限。 （Admin Console のAdobe Experience Platform Launch製品で、{Platforms > Edge およびすべての プロパティ権限 の権限項目 。 付与されると、データ収集インターフェイスの左側のナビゲーションに イベント転送 が表示されます。
-
Adobe Experience Platform Web SDK または Mobile SDK は、Edge Networkにデータを送信するように設定されています。 このチュートリアルの次のレッスンを完了している必要があります。
イベント転送プロパティの作成
まず、イベント転送プロパティを作成します。
-
データ収集インターフェイスを開きます。
-
左側のナビゲーションから イベント転送 を選択します
-
「新しいプロパティ」を選択します。
-
プロパティに名前を付けます。 この場合、
Server-Side - Web SDK Course -
「保存」を選択します。
データストリームの設定
イベント転送で Platform Edge Networkに送信するデータを使用するには、新しく作成したイベント転送プロパティを、Adobeソリューションにデータを送信するために使用されるのと同じデータストリームにリンクする必要があります。
データストリームで Target を設定するには：
-
データ収集インターフェイスに移動
-
左側のナビゲーションで「データストリーム」を選択します
-
以前に作成した
Luma Web SDK: Development Environmentデータストリームを選択します
-
「サービスを追加」を選択します。
-
サービス として「イベント転送」を選択します
-
プロパティ ID ドロップダウンで、イベント転送プロパティに付けた名前（この場合は
Server-Side - Web SDK Course）を選択します -
環境 ID ドロップダウンで、イベント転送環境のリンク先のタグ環境（この場合は
Development）を選択しますnote tip TIP Adobe組織外のイベント転送環境にデータを送信するには、「ID を手動で入力」を選択して、ID を貼り付けます。 この ID は、イベント転送プロパティの作成時に提供されます。 -
「保存」を選択します。
公開フローを通じて変更を昇格させる準備が整ったら、ステージングと実稼動のデータストリームに対してこれらの手順を繰り返します。
Platform Edge NetworkからAdobe以外のソリューションにデータを転送
この演習では、イベント転送データ要素を設定し、イベント転送ルールを設定し、Webhook.site と呼ばれるサードパーティのツールを使用して検証する方法について説明します。
イベント転送データ要素の作成
Platform Web SDK タグ拡張機能を使用して以前に設定した XDM オブジェクトは、イベント転送プロパティのデータ要素のデータソースになります。 イベント転送用のデータソースとして、タグプロパティに既に設定したのと同じデータを使用します。
arc.event のプレフィックスを含める必要があります。arcは、Adobe Response Context の略語です。- 例：
arc.event.xdm.web.webPageDetails.URL
この演習では、ブラウザービューポートの高さとExperience Cloud ID を、XDM オブジェクトから Webhook に転送します。 XDM フィールドパスは、「XDM スキーマの設定 のレッスンで作成した XDM スキーマにって決定されます。
/ee リクエストをフィルタリングし、ビーコン ペイロード を開き、探している変数にドリルダウンして、XDM オブジェクトパスを見つけることもできます。 次に、マウスで右クリックして「プロパティパスをコピー」を選択します。 ブラウザ ビューポートの高さの例を次に示します。
-
最近作成した イベント転送 プロパティに移動します
-
左側のナビゲーションで「データ要素」を選択します。
-
選択して 新しいデータ要素を作成 します
-
名前 データ要素
environment.browserDetails.viewportHeight -
Extension の下で、
COREのままにします -
データ要素タイプ の下で、
Pathを選択します -
ブラウザービューポートの高さ
arc.event.xdm.environment.browserDetails.viewportHeightを含む XDM オブジェクトパスを入力 -
「保存」を選択します
-
別のデータ要素の作成
-
名前 it
ecid -
Extension の下で、
COREのままにします -
データ要素タイプ の下で、
Pathを選択します -
Experience Cloud ID
arc.event.xdm.identityMap.ECID.0.idを含む XDM オブジェクトパスを入力 -
「保存」を選択します
note caution CAUTION パスに arc.event.のプレフィックスを必ず含めてください。 また、XDM オブジェクトフィールド名と同じ大文字と小文字を使用してください。ECID 名前空間はすべて大文字にする必要があります。note tip TIP 独自の web サイトで作業する場合、web ブラウザーのネットワークツールで XDM オブジェクトパスを見つけ、 /eeリクエストをフィルタリングし、ビーコン ペイロード を開いて、探している変数にドリルダウンできます。 次に、マウスで右クリックして「プロパティパスをコピー」を選択します。 ブラウザ ビューポートの高さの例を次に示します。
Adobe Cloud Connector 拡張機能のインストール
サードパーティの場所にデータを送信するには、まず Adobeクラウドコネクタ 拡張機能をインストールします。
-
左側のナビゲーションの 拡張機能 を選択します
-
「カタログ」タブを選択します
-
Adobeクラウドコネクタ を検索し、「インストール」を選択します
拡張機能の設定は必要ありません。 この拡張機能を使用すると、Adobe以外のソリューションにデータを転送できるようになりました。
イベント転送ルールの作成
タグプロパティでルールを設定する場合と、イベント転送プロパティでルールを設定する場合では、主に次の点が異なります。
-
イベント および 条件:
- タグ：すべてのルールは、ルールで指定する必要があるイベント（例：
Library Loaded - Page Top）によってトリガーされます。 条件はオプションです。 - イベント転送:Platform Edge Networkに送信されるすべてのイベントが、データを転送するトリガーであると想定されます。 したがって、イベント転送ルールで選択する必要がある イベント はありません。 イベント転送ルールをトリガーとするイベントを管理するには、条件を設定する必要があります。
- タグ：すべてのルールは、ルールで指定する必要があるイベント（例：
-
データ要素のトークン化:
-
タグ：ルールで使用される場合、データ要素名の先頭と末尾に
%を付けて、データ要素名をトークン化します。 例：%viewportHeight%。 -
イベント転送：ルールで使用する場合、データ要素名の先頭に
{{、末尾に}}を付けてデータ要素名をトークン化します。 例：{{viewportHeight}}。
-
-
一連のルールアクション:
- イベント転送ルールのアクション セクションは常に順番に実行されます。 ルールを保存する際は、アクションの順序が正しいことを確認してください。 この実行シーケンスは、タグの場合のように非同期で実行することはできません。
Webhook にデータを転送するルールを設定するには、まず個人用 Webhook を取得する必要があります。
-
Webhook.site に移動します
-
一意の URL を検索します。これをイベント転送ルールの URL リクエストとして使用します
-
クリップボードにコピー を選択
-
Webhook でキャプチャされたイベント転送データをリアルタイムで検証できるので、このウィンドウは開いたままにしておきます
-
左側のナビゲーションから データ収集/イベント転送/ルール に戻ります
-
「新規ルールの作成」を選択します
-
all events - ad cloud connector - webhookという名前を付けます -
アクションの追加
-
Extension で、Adobeクラウドコネクタ を選択します
-
アクションタイプ の下で、「Make Fetch Call」を選択します。
-
Webhook URL を「URL」フィールドに貼り付けます
-
[クエリパラメーター] の下で、前に作成した両方のデータ要素を追加します。
-
viewPortHeightの キー 列タイプ。 値 列で、データ要素セレクターアイコンに入力するか選択して、{{environment.browserDetails.viewportHeight}}データ要素を入力します -
「+さらに追加」を選択して、別のクエリパラメーターを追加します
-
ecidの キー 列タイプ。 「値」列で、{{ecid}}データ要素を入力します -
「変更を保持」を選択します
-
ルールは次のようになります
-
「保存」を選択します
ライブラリの作成とビルド
ライブラリを作成し、通常のタグプロパティの場合と同様に、イベント転送の開発環境に対するすべての変更を作成します。
イベント転送ルールの検証
これで、Platform Debugger と Webhook.site を使用してイベント転送プロパティを検証できます。
-
Luma デモサイトで、データストリームのイベント転送プロパティのマッピング先の Web SDK タグプロパティに タグライブラリの切り替えの手順に従います。
-
ページをリロードする前に、Experience Platformーデバッガーで左側のナビゲーションから ログ を開きます
-
「Edge」タブを選択し、「接続 を選択して、Platform Edge Networkリクエストを表示します
-
ページをリロードします。
-
Platform Edge Networkから WebHook に送信されるサーバーサイドリクエストを可視化する追加のリクエストが表示されます
-
検証の対象となるリクエストは、完全に構築された URL がEdge Network から送信されることを示すものです
-
viewPortHeight および ecid クエリ文字列パラメーターに注意してください
-
XDM オブジェクトに表示されるデータと一致します
-
最後に、開いている Webhook ウィンドウを表示して、Webhook.site でもデータの一致を検証します
おめでとうございます。イベント転送が設定されました。