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" }
});

アプローチに応じて、次の情報も必要です。

JavaScript library

Web SDKのベースコードキューでは、ライブラリが読み込まれるまでコマンドが実行され、ACDLでは、ライブラリが読み込まれるまでアイテムが実行されます。 これらのキューにより、最初に読み込まれるライブラリに関係なく、このページのコードをWeb SDKのベースコードの後の任意の場所に追加できます。

タグ拡張機能

データのマッピング方法の選択 mapping

Web SDKは、2つのオブジェクトにデータを送信します。 次のいずれか、または両方を選択します。

オブジェクト
マッピングの仕組み
次の場合に使用
xdm
コードまたはタグルール内のデータレイヤー値から、XDM スキーマに一致するオブジェクトを作成します。
ペイロードを完全に制御したい場合、またはデータレイヤーが既にスキーマに似ている場合。
data
データレイヤーの値をそのまま送信します。 データ収集の​ データ準備を使用して、データストリームのXDMにそれらをマッピングします。
ページコードやタグのルールにマッピングロジックを含めたり、複数のサイトが1つの適切に管理されたデータレイヤーを共有したりします。

値の取得元を選択 value-sources

ACDL イベントがコードまたはルールをトリガーする場合、次の2つの場所からデータレイヤー値を読み取ることができます。

ソース
JavaScript library
タグ拡張機能
次を含む
プッシュされたオブジェクト
event.page.title。eventはリスナーの引数です
%event.message.page.title%
イベントをトリガーしたオブジェクトのみが対象です。
計算状態
adobeDataLayer.getState("page.title")
パス page.titleを持つ​ データレイヤーの計算状態 データ要素
ここまでは、あらゆるプッシュ通知のデータを統合しました。

買い物かごに商品を追加するなど、イベント自体を表す値にプッシュオブジェクトを使用します。 ユーザーの詳細など、以前にプッシュされた値に対して計算状態を使用します。 コードまたはルールが実行されると、計算状態には、それをトリガーしたプッシュのデータが既に含まれています。 ​ リスナーが受け取る内容および​ ルールでプッシュされたデータを使用を参照してください。

XDM データの送信 xdm

次の例では、プッシュされたオブジェクトからページタイトルを含むページビューを送信します。

JavaScript library

イベントをリッスンし、sendEventに電話します:

code language-js
window.adobeDataLayer = window.adobeDataLayer || [];

function sendPageView(event) {
  alloy("sendEvent", {
    xdm: {
      eventType: "web.webpagedetails.pageViews",
      web: {
        webPageDetails: {
          name: event.page.title,
          pageViews: { value: 1 }
        }
      }
    }
  });
}

window.adobeDataLayer.push(function(dl) {
  dl.addEventListener("page view", sendPageView);
});

すべてのリスナーオプションについては、addEventListener()を参照してください。

タグ拡張機能
  1. Web SDK拡張機能を使用してVariable データ要素を作成します。 XDM​を選択し、サンドボックスとスキーマを選択します。 この例では、データ要素にXDM variableという名前を付けます。

  2. ルールを作成し、イベントを追加します。

    • 拡張機能: Adobe Client Data Layer
    • イベントタイプ: データレイヤープッシュ
    • 上のトリガー: 特定の名前付きイベント、イベント名page view
    • 時間範囲: すべて
  3. XDM オブジェクトに入力するアクションを追加します。

    • 拡張機能:Adobe Experience Platform Web SDK
    • アクションの種類: 変数を更新
    • データ要素: XDM variable
    • web.webPageDetails.nameを%event.message.page.title%に設定し、web.webPageDetails.pageViews.valueを1に設定します。
  4. イベントを送信するアクションを追加します。

    • 拡張機能:Adobe Experience Platform Web SDK
    • アクションの種類: ​ イベントの送信
    • タイプ:web.webpagedetails.pageViews
    • XDM: %XDM variable%
  5. ルールを保存してライブラリに追加し、ライブラリを構築します。

すべてのイベントオプションについては、​ データレイヤープッシュ ​を参照してください。

サイトがpage view イベントをプッシュするたびに、コードまたはルールによってページビューがEdge Networkに送信されます。

同様の方法でインタラクションを送信します。 例えば、{ event: "cart add", eventInfo: { sku: "HT105" } }などのプッシュの場合、cart addでリッスンまたはトリガーし、eventInfoから商品を読み取ります。 コマースのインタラクションを説明するXDM フィールドについては、​ コマース、製品、注文情報の収集を参照してください。

データストリーム内のマッピング用にデータレイヤーを送信 data

コードまたはルールではなくデータストリームでマッピングするには、data オブジェクトにデータレイヤー値を送信し、イベントが正しく分類されるようにXDM eventTypeを含めます。

JavaScript library
code language-js
function sendWithDataPrep(event) {
  alloy("sendEvent", {
    xdm: { eventType: "web.webpagedetails.pageViews" },
    data: this.getState()
  });
}

window.adobeDataLayer.push(function(dl) {
  dl.addEventListener("page view", sendWithDataPrep);
});

ACDL リスナー内では、thisはデータレイヤーを参照するため、this.getState()は計算状態を返します。 その一部のみを送信するには、this.getState("page")などのパスを渡します。

タグ拡張機能
  1. ACDL拡張機能を使用して、データレイヤー計算状態 データ要素を作成します。 計算状態全体​を選択するか、特定のパス​を選択して、送信するデータのパスを入力します。 この例では、データ要素にACDL stateという名前を付けます。

  2. XDM データの送信と同じ​データレイヤープッシュ イベントを使用してルールを作成します。

  3. Web SDK拡張機能から​Send event アクションを追加します。

    • タイプ:web.webpagedetails.pageViews
    • データ: %ACDL state%
  4. ルールを保存してライブラリに追加し、ライブラリを構築します。

次に、データストリームで、XDM スキーマに送信するフィールドをマッピングします。 データ収集の​ データ準備を参照してください。 マッピングせず、設定されたサービス読み取りがないデータは保存されません。 計算された状態全体を送信すると、各リクエストのサイズも増加するので、大きなデータレイヤーを持つページでは、マッピングした部分のみを送信します。

シングルページアプリケーション spa

単一ページアプリケーションでは、訪問者が多くの仮想ページを表示している間、ページは開いたままになり、データレイヤー履歴は拡大し続けます。 仮想ページビューごとにpage view イベントをプッシュし、送信後に履歴をクリアします。 履歴を消去しても、計算状態が変更されたり、リスナーやルールが削除されたりすることはありません。

JavaScript library

ページビューリスナーの最後にある履歴を消去します。

code language-js
function sendPageView(event) {
  alloy("sendEvent", { /* ... */ });
  this.length = 0;
}

「履歴を消去する」を参照してください。

タグ拡張機能
ページビュールールの最後のアクションとして、ACDL拡張機能から​ データレイヤー履歴を消去 アクションを追加します。

タイミングと重複 timing

各イベントが正確に1回送信されるように、次の方法に従います。

  • all スコープを使用します。 これは、両方のアプローチのデフォルトです。JavaScriptのscope オプションと、タグの​ タイムスコープ ​設定です。 リスナーまたはルールがリッスンを開始する前にプッシュされたイベント(スクリプトまたはタグライブラリが読み込まれる前にプッシュされたページビューなど)が送信されます。 実装の別の部分が既に以前のイベントを送信している場合にのみ、futureを使用します。 ​ スコープ ​を参照してください。
  • 各イベントを1か所から送信します。 独自のコードとタグルールの両方が同じデータレイヤーイベントを送信すると、Adobeはそれを2回受信します。
  • JavaScript ライブラリ:名前付き関数を使用し、各リスナーを1回追加します。 ACDLは、同じイベントに対して同じ関数の2番目の登録を無視します。 ただし、実行されるコードが毎回新しい匿名関数を繰り返し渡す場合、ACDLは毎回新しいリスナーを追加し、各イベントは複数回送信されます。
  • タグ拡張機能:特定のイベント名に関するトリガー。 すべてのデータ変更​のトリガーがデータプッシュごとに実行されるルールです。このルールでは、予想を上回る多くのイベントが発生する可能性があります。
recommendation-more-help
experience-platform-help-collection