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製品で、次に対する権限項目プラットフォーム > 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
データストリーム -
「サービスを追加」を選択します。
-
を選択 イベントの転送 as the サービス
-
の下 プロパティ 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 パス](./media_1f1f238d38f101ee7dc35acb73bea09e8352ae29a.png?width=750&format=png&optimize=medium)
-
に移動します イベントの転送 最近作成したプロパティ
-
左側のナビゲーションで「」を選択します データ要素
-
を選択: 新しいデータ要素の作成
-
名前 データ要素
environment.browserDetails.viewportHeight
-
次の下 拡張機能、移動する
CORE
-
次の下 データ要素タイプ を選択
Path
-
ブラウザービューポートの高さを含む XDM オブジェクトパスを入力
arc.event.xdm.environment.browserDetails.viewportHeight
-
「保存」を選択します
-
別のデータ要素の作成
-
名前 0.45511884
ecid
-
次の下 拡張機能、移動する
CORE
-
次の下 データ要素タイプ を選択
Path
-
Experience Cloud ID を含む XDM オブジェクトパスを入力
arc.event.xdm.identityMap.ECID.0.id
-
「保存」を選択します
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
-
アクションの追加
-
次の下 拡張機能 を選択 Adobeクラウドコネクタ
-
次の下 アクションタイプ を選択 取得呼び出しを行う
-
Webhook URL をに貼り付けます URL フィールド
-
次の下 [クエリパラメーター] を選択した場合は、前に作成した両方のデータ要素を追加します。
-
日 キー の列タイプ
viewPortHeight
. 日 値 列、を入力{{environment.browserDetails.viewportHeight}}
データ要素:に入力するか、データ要素セレクターアイコンから選択 -
を選択 +さらに追加 別のクエリパラメーターを追加するには
-
日 キー の列タイプ
ecid
. 「値」列に、{{ecid}}
データ要素 -
を選択 変更を保持
-
ルールは次のようになります
-
「保存」を選択します
ライブラリの作成とビルド
ライブラリを作成し、通常のタグプロパティの場合と同様に、イベント転送の開発環境に対するすべての変更を作成します。
イベント転送ルールの検証
これで、Platform Debugger と Webhook.site を使用してイベント転送プロパティを検証できます。
-
次の手順に従います タグライブラリの切り替え 日 Luma デモサイト を、データストリームのイベント転送プロパティのマッピング先の Web SDK タグプロパティに追加します。
-
ページをリロードする前に、Experience Platformーデバッガーでを開きます ログ 左側のナビゲーションから
-
「」を選択します Edge tab キーを押してから、 接続 platform Edge Networkリクエストを表示するには:
-
ページをリロードします。
-
Platform Edge Networkから WebHook に送信されるサーバーサイドリクエストを可視化する追加のリクエストが表示されます
-
検証の対象となるリクエストは、Edge ネットワークによって送信される完全に構築された URL を示すものです
-
viewPortHeight および ecid クエリ文字列パラメーターに注意してください
-
XDM オブジェクトに表示されるデータと一致します
-
最後に、でデータの一致を検証します。 Webhook.site また、開いている Webhook ウィンドウを表示します
おめでとうございます。イベント転送が設定されました。