コンテンツにスキップ

データレイヤー互換モード

Cloudflare Zarazは、イベントやその他のパラメータを追跡するためにタグ管理ソフトウェアで見られるdataLayer機能との後方互換性を提供します。これにより、現在の実装を維持しつつ、Cloudflare Zarazが自動的にイベントを収集します。

Zarazスクリプトをできるだけ小さく、迅速に保つために、データレイヤー互換モードはデフォルトで無効になっています。有効にするには:

  1. Zaraz > 設定に移動します。
  2. データレイヤー互換モードトグルを有効にします。詳細についてはZaraz設定を参照してください。

Zarazでのデータレイヤーの使用

互換モードを有効にすると、Zarazは自動的にdataLayer.push()呼び出しをzaraz.track()に変換しますので、ブラウザからZarazにイベントを送信するためにdataLayer.push()関数を引き続き使用できます。

イベントは、プッシュされたオブジェクトにeventキーが含まれている場合にのみZarazに送信されます。eventキーはZarazイベントの名前として使用されます。他のキーはeventPropertiesオブジェクトの一部になります。以下の例は、購入イベントがデータレイヤーを使用してZarazに送信される方法を示しています — オブジェクト内のパラメータは追跡したい内容に依存します:

dataLayer.push({
event: 'purchase',
price: '24',
currency: 'USD',
transactionID: '12345678',
});

Cloudflare Zarazは、dataLayer.push()呼び出しをzaraz.track()呼び出しに変換します。したがって、dataLayer.push({event: "purchase", price: "24", "currency": "USD"})zaraz.track("purchase", {"price": "24", "currency": "USD"})と同等です。

ZarazはdataLayer.push()呼び出しをzaraz.track()に変換するため、dataLayer.push()呼び出しに基づいてトリガーを作成することは、zaraz.track()のトリガーを作成することと同じです。以下のトリガーは、purchaseイベントと一致するため、上記のdataLayer.push()呼び出しに一致します。

ルールタイプ変数名一致操作一致文字列
一致ルールイベント名等しいpurchase

dataLayerの使用は推奨しません。しかし、多くのウェブサイトがそれを使用しているため、Cloudflare Zarazにはそれをzaraz.track()に変換する自動翻訳レイヤーがあります。