Web SDKを使用したAdobe Client Data Layer データの送信
Adobe Client Data Layer (ACDL)は、ページ上のデータとイベントを収集しますが、どこにも送信しません。 Adobe Experience Platform Edge Networkに送るには、次のいずれかの方法でACDL イベントをWeb SDKに接続します。
- JavaScript ライブラリ:独自のコードがACDL イベントをリッスンし、Web SDK
sendEventコマンドを呼び出します。 - タグ拡張機能: タグ ルールでは、ACDL拡張機能を使用してACDL イベントをトリガーし、Web SDK拡張機能を使用してデータを送信します。
このページの各セクションには、両方のアプローチが示されています。
前提条件 prerequisites
サイトコードは、送信したいデータとイベントをプッシュします。 このページの例では、ページビューごとに次のプッシュを使用します。
window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push({
event: "page view",
page: { title: "Home", language: "en" }
});
アプローチに応じて、次の情報も必要です。
- ACDLはあなたのページにインストールされています。
- Web SDK 基本コードとライブラリ がインストールされ、Web SDKは データストリーム で🔗構成されています。
Web SDKのベースコードキューでは、ライブラリが読み込まれるまでコマンドが実行され、ACDLでは、ライブラリが読み込まれるまでアイテムが実行されます。 これらのキューにより、最初に読み込まれるライブラリに関係なく、このページのコードをWeb SDKのベースコードの後の任意の場所に追加できます。
- ACDL拡張機能は、タグプロパティに インストール および設定されています。
- Web SDK拡張機能は インストール済みで、 データストリーム で構成されています。
データのマッピング方法の選択 mapping
Web SDKは、2つのオブジェクトにデータを送信します。 次のいずれか、または両方を選択します。
値の取得元を選択 value-sources
ACDL イベントがコードまたはルールをトリガーする場合、次の2つの場所からデータレイヤー値を読み取ることができます。
event.page.title。eventはリスナーの引数です%event.message.page.title%adobeDataLayer.getState("page.title")page.titleを持つ データレイヤーの計算状態 データ要素買い物かごに商品を追加するなど、イベント自体を表す値にプッシュオブジェクトを使用します。 ユーザーの詳細など、以前にプッシュされた値に対して計算状態を使用します。 コードまたはルールが実行されると、計算状態には、それをトリガーしたプッシュのデータが既に含まれています。 リスナーが受け取る内容および ルールでプッシュされたデータを使用を参照してください。
XDM データの送信 xdm
次の例では、プッシュされたオブジェクトからページタイトルを含むページビューを送信します。
イベントをリッスンし、sendEventに電話します:
| code language-js |
|---|
|
すべてのリスナーオプションについては、addEventListener()を参照してください。
-
Web SDK拡張機能を使用してVariable データ要素を作成します。 XDMを選択し、サンドボックスとスキーマを選択します。 この例では、データ要素に
XDM variableという名前を付けます。 -
ルールを作成し、イベントを追加します。
- 拡張機能: Adobe Client Data Layer
- イベントタイプ: データレイヤープッシュ
- 上のトリガー: 特定の名前付きイベント、イベント名
page view - 時間範囲: すべて
-
XDM オブジェクトに入力するアクションを追加します。
- 拡張機能:Adobe Experience Platform Web SDK
- アクションの種類: 変数を更新
- データ要素:
XDM variable web.webPageDetails.nameを%event.message.page.title%に設定し、web.webPageDetails.pageViews.valueを1に設定します。
-
イベントを送信するアクションを追加します。
- 拡張機能:Adobe Experience Platform Web SDK
- アクションの種類: イベントの送信
- タイプ:
web.webpagedetails.pageViews - XDM:
%XDM variable%
-
ルールを保存してライブラリに追加し、ライブラリを構築します。
すべてのイベントオプションについては、 データレイヤープッシュ を参照してください。
サイトがpage view イベントをプッシュするたびに、コードまたはルールによってページビューがEdge Networkに送信されます。
同様の方法でインタラクションを送信します。 例えば、{ event: "cart add", eventInfo: { sku: "HT105" } }などのプッシュの場合、cart addでリッスンまたはトリガーし、eventInfoから商品を読み取ります。 コマースのインタラクションを説明するXDM フィールドについては、 コマース、製品、注文情報の収集を参照してください。
データストリーム内のマッピング用にデータレイヤーを送信 data
コードまたはルールではなくデータストリームでマッピングするには、data オブジェクトにデータレイヤー値を送信し、イベントが正しく分類されるようにXDM eventTypeを含めます。
| code language-js |
|---|
|
ACDL リスナー内では、thisはデータレイヤーを参照するため、this.getState()は計算状態を返します。 その一部のみを送信するには、this.getState("page")などのパスを渡します。
-
ACDL拡張機能を使用して、データレイヤー計算状態 データ要素を作成します。 計算状態全体を選択するか、特定のパスを選択して、送信するデータのパスを入力します。 この例では、データ要素に
ACDL stateという名前を付けます。 -
XDM データの送信と同じデータレイヤープッシュ イベントを使用してルールを作成します。
-
Web SDK拡張機能からSend event アクションを追加します。
- タイプ:
web.webpagedetails.pageViews - データ:
%ACDL state%
- タイプ:
-
ルールを保存してライブラリに追加し、ライブラリを構築します。
次に、データストリームで、XDM スキーマに送信するフィールドをマッピングします。 データ収集の データ準備を参照してください。 マッピングせず、設定されたサービス読み取りがないデータは保存されません。 計算された状態全体を送信すると、各リクエストのサイズも増加するので、大きなデータレイヤーを持つページでは、マッピングした部分のみを送信します。
シングルページアプリケーション spa
単一ページアプリケーションでは、訪問者が多くの仮想ページを表示している間、ページは開いたままになり、データレイヤー履歴は拡大し続けます。 仮想ページビューごとにpage view イベントをプッシュし、送信後に履歴をクリアします。 履歴を消去しても、計算状態が変更されたり、リスナーやルールが削除されたりすることはありません。
ページビューリスナーの最後にある履歴を消去します。
| code language-js |
|---|
|
「履歴を消去する」を参照してください。
タイミングと重複 timing
各イベントが正確に1回送信されるように、次の方法に従います。
allスコープを使用します。 これは、両方のアプローチのデフォルトです。JavaScriptのscopeオプションと、タグの タイムスコープ 設定です。 リスナーまたはルールがリッスンを開始する前にプッシュされたイベント(スクリプトまたはタグライブラリが読み込まれる前にプッシュされたページビューなど)が送信されます。 実装の別の部分が既に以前のイベントを送信している場合にのみ、futureを使用します。 スコープ を参照してください。- 各イベントを1か所から送信します。 独自のコードとタグルールの両方が同じデータレイヤーイベントを送信すると、Adobeはそれを2回受信します。
- JavaScript ライブラリ:名前付き関数を使用し、各リスナーを1回追加します。 ACDLは、同じイベントに対して同じ関数の2番目の登録を無視します。 ただし、実行されるコードが毎回新しい匿名関数を繰り返し渡す場合、ACDLは毎回新しいリスナーを追加し、各イベントは複数回送信されます。
- タグ拡張機能:特定のイベント名に関するトリガー。 すべてのデータ変更のトリガーがデータプッシュごとに実行されるルールです。このルールでは、予想を上回る多くのイベントが発生する可能性があります。
関連ページ related
sendEventコマンドとSend event アクション:イベントを送信するためのすべてのWeb SDK オプション。addEventListener()および データレイヤーのプッシュ : ACDL イベントをリッスンするためのすべてのオプション。