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または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は、イベント転送プロパティを作成するときに提供されます。 -
「保存」を選択します。
公開フローを通じて変更を昇格する準備ができたら、ステージングおよび実稼動データストリームに対して、これらの手順を繰り返します。
Adobe Experience 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のName -
拡張機能の下で、
COREから離れます -
データ要素タイプで、
Pathを選択します -
ブラウザービューポートの高さ
arc.event.xdm.environment.browserDetails.viewportHeightを含むXDM オブジェクトパスを入力します -
保存を選択
-
別のデータ要素を作成
-
名前 it
ecid -
拡張機能の下で、
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 Cloud Connector拡張機能をインストールします。
-
左側のナビゲーションで 拡張機能 を選択します
-
「カタログ」タブを選択します
-
Adobe Cloud Connectorを検索し、Installを選択します
拡張機能の設定は必要ありません。 この拡張機能を使用すると、Adobe以外のソリューションにデータを転送できるようになりました。
イベント転送ルールの作成
タグプロパティでのルールの設定とイベント転送プロパティでのルールの設定には、主に次のような違いがあります。
-
イベント および条件:
- タグ：すべてのルールは、ルールで指定する必要があるイベント（例：
Library Loaded - Page Top）によってトリガーされます。 条件はオプションです。 - イベント転送: Platform Edge Networkに送信されるすべてのイベントが、データを転送するトリガーであると仮定されます。 したがって、イベント転送ルールで選択する必要がある イベント はありません。 イベント転送ルールをトリガーするイベントを管理するには、条件を設定する必要があります。
- タグ：すべてのルールは、ルールで指定する必要があるイベント（例：
-
データ要素のトークン化:
-
タグ: ルールで使用する場合、データ要素名の先頭と末尾に
%が付いたデータ要素名がトークン化されます。 例：%viewportHeight%。 -
イベント転送: ルールで使用する場合、データ要素名は先頭に
{{、末尾に}}とトークン化されます。 例：{{viewportHeight}}。
-
-
ルール アクションのシーケンス:
- イベント転送ルールの「アクション」セクションは、常に順次実行されます。 ルールを保存するときは、アクションの順序が正しいことを確認してください。 この実行シーケンスは、タグの場合のように非同期で実行することはできません。
Webhookにデータを転送するルールを設定するには、まず個人のWebhookを取得する必要があります。
-
Webhook.siteに移動
-
固有のURLを見つけます。これをイベント転送ルールのURL リクエストとして使用します
-
「クリップボードにコピー」を選択
-
Webhookによってキャプチャされているイベント転送データをリアルタイムで検証できるため、このウィンドウを開いたままにしておきます
-
左側のナビゲーションからデータ収集 > イベント転送 > ルールに戻ります
-
新しいルールを作成を選択
-
名前を
all events - ad cloud connector - webhook -
アクションの追加
-
拡張機能で、Adobe Cloud Connectorを選択します
-
アクションタイプで、呼び出しの取得を選択します
-
URL フィールドにWebhook URLを貼り付けます
-
[クエリパラメーター]の下に、以前に作成した両方のデータ要素を追加します。
-
viewPortHeightの Key 列タイプで。 値列で、{{environment.browserDetails.viewportHeight}}データ要素を入力するか、データ要素セレクターアイコンから選択して入力します -
「+ Add Another」を選択して、別のクエリパラメーターを追加します
-
ecidの Key 列タイプで。 「値」列に、{{ecid}}データ要素を入力します -
変更を保持を選択
-
ルールは次のようになります
-
保存を選択
ライブラリの作成と構築
タグプロパティで通常どおりにライブラリを作成し、イベント転送開発環境へのあらゆる変更を構築します。
イベント転送ルールの検証
これで、Platform DebuggerとWebhook.siteを使用してイベント転送プロパティを検証できます。
-
手順に従って、Luma デモ web サイト のタグライブラリ 🔗を、データストリームでイベント転送プロパティをマッピングしたWeb SDK タグプロパティに切り替えます。
-
ページをリロードする前に、Experience Platform Debuggerで左側のナビゲーションから ログ を開きます
-
「Edge」タブを選択し、Connectを選択してPlatform Edge Network リクエストを表示します
-
ページを再読み込み
-
Platform Edge NetworkからWebHookに送信されるサーバーサイドリクエストを可視化する追加リクエストが表示されます
-
検証にフォーカスするリクエストは、Edge ネットワークから送信される完全に構築されたURLを示すリクエストです
-
viewPortHeight クエリ文字列パラメーターとecid クエリ文字列パラメーターに注意してください
-
XDM オブジェクトに表示されるデータと一致し
-
最後に、開いているWebhook ウィンドウを表示して、Webhook.siteでデータの一致を検証します
おめでとうございます。 イベント転送が設定されました。