Snowplowタグ構成ガイド | クライアントサイドタグ

タグのヒント

E-Commerce拡張をサポート
マッピングを使用して：
- 標準の構成値を動的に上書き
- E-Commerce拡張の値を動的に上書き
- 構造化イベントトラッキングをトリガー
- 非構造化イベントトラッキングをトリガー
構造化および非構造化イベントトラッキングは、マッピングを介して構造化/非構造化イベントアクションが定義されたときにトリガーされます。

タグ構成

まず、タグマーケットプレイスに移動し、Snowplowタグを追加します（タグの追加方法について詳しくはこちら）。

タグを追加したら、以下の構成を行います：

コードバージョン
- タグバージョンを選択します（2.18.2、3.1.2、または3.23.0）
タイトル
- 同じベンダーから複数のタグを使用する場合は、一意の名前を割り当てます。
Snowplowオブジェクト（必須）
- グローバルSnowplowオブジェクトの一意の名前。
- Snowplowオブジェクト名はwindow.snowplow.nameとして定義されます。
Snowplow基本URL（必須）
- バージョン付きのSnowplowトラッカーを表すURL。
- 例の形式：//d1fc8wv8zag5ca.cloudfront.net/x.xx.x/sp.js
トラッカーネームスペース（必須）
- Snowplowトラッカーのネームスペース。
- この値を動的に上書きするためにデータマッピングを使用します。
トラッカーエンドポイント（必須）
- SnowplowトラッカーのコレクターエンドポイントURI。
- この値を動的に上書きするためにデータマッピングを使用します。
Cookieドメイン
- クッキーを構成するトップレベルドメイン。
- 例 .mysite.com。
- この値を動的に上書きするためにデータマッピングを使用します。
リンクトラッキングを有効にする
- リンククリックにイベントリスナーを追加します。
- 可能な値はTrueまたはFalseです。
- この値を動的に上書きするためにデータマッピングを使用します。
アクティビティトラッキングを有効にする
- ‘ページピング’イベントを有効にして、ページ上のユーザーアクティビティを追跡します。
- 可能な値はTrueまたはFalseです。
- この値を動的に上書きするためにデータマッピングを使用します。
エラートラッキングを有効にする
- JavaScriptコードの未処理の例外を追跡します。
- 可能な値はTrueまたはFalseです。
- この値を動的に上書きするためにデータマッピングを使用します。
ページビューの保存を有効にする
- HTMLページ全体が読み込まれたときにのみ、ウェブページのコンテキストを再生成します。
- 可能な値はTrueまたはFalseです。
- この値を動的に上書きするためにデータマッピングを使用します。
公開場所
- タグは選択した場所にのみ公開されます：Dev、QA、Prod、またはCustom。
詳細構成
- このタグと、組織内での使用方法についての説明的なメモ。

ロードルール

ロードルールは、サイト上でこのタグのインスタンスをいつ、どこでロードするかを決定します。

推奨されるロードルール：すべてのページ

データマッピング

マッピングは、データレイヤー変数からベンダータグの対応する宛先変数にデータを送信するプロセスです。変数をタグの宛先にマップする方法については、データマッピングを参照してください。

Snowplowタグの宛先変数は、そのデータマッピングタブに組み込まれています。利用可能なカテゴリーは次のとおりです：

標準

宛先名	説明
`customURL`	カスタムURL ページのカスタムURLを構成します。
`referrerURL`	カスタムリファラーURL。リファラーのカスタムURLを構成します。
`pageTitle`	ページタイトルページのタイトルを構成します。
`cookieTimeOut`	Cookieタイムアウトセッションクッキーがアクティブであるべき時間（秒）を構成します。デフォルトは30分（1800秒）です。
`enableAT`	アクティビティトラッキングを有効にするページピングイベントを有効にして、ページ上のユーザーアクティビティを追跡します。値のオプション：`true`または`false`
`minimumVisitLength`	最小訪問時間ページの読み込みと最初のページピングの間の時間を秒単位で構成します。
`heartBeat`	ハートビートページピングの間隔を秒単位で構成します。
`enableET`	エラートラッキングを有効にする JavaScriptコードの未処理の例外を追跡します。値のオプション：`true`または`false`
`preservePageView`	ページビューを保持する HTMLページ全体が読み込まれたときにのみ、ウェブページのコンテキストを再生成します。値のオプション：`true`または`false`

トラッカー

宛先名	説明
`trk_namespace`	トラッカーネームスペース Snowplowトラッカーのネームスペース。構成を上書きするために使用します。構成値を動的に上書きするためにこれを使用します。
`trk_endpoint`	トラッカーエンドポイント SnowplowトラッカーのコレクターエンドポイントURI。構成値を動的に上書きするためにこれを使用します。
`trk_cookieDomain`	クッキードメインクッキーを構成するトップレベルドメイン。構成値を動的に上書きするためにこれを使用します。
`trk_cookieName`	クッキー名 Snowplowクッキーの基本名を構成します。デフォルト値はspです。
`trk_appId`	アプリID トラッカーイベントのアプリケーションIDを構成します。異なるページから異なるIDを送信して、イベントを区別することができます
`trk_platform`	プラットフォームトラッカーのプラットフォームタイプを構成します。デフォルト値はwebです。値のオプションについては、潜在的なプラットフォーム値を参照してください。
`trk_send`	トラッカーの送信文字列/配列同じソースからの複数のアイテムを識別するためのネームスペース値（広告など）。入力されると、ページビュー、広告インプレッション、広告コンバージョン、広告クリック、リンククリックに添付されます。
`trk_encodeBase64`	エンコードBase 64を使用する自己記述イベントとカスタムコンテキストがbase64にエンコードされるかどうかを構成します。デフォルトはtrueです。値のオプションは`true`または`false`です。
`trk_respectDoNotTrack`	Do Not Trackを尊重するブラウザのDo Not Trackオプションが尊重されるかどうかを構成します。デフォルト値は`false`です。値のオプションは`true`または`false`です。
`trk_userFingerprint`	ユーザーフィンガープリント Snowplowがブラウザ機能に基づいてユーザーフィンガープリントを生成するかどうかを構成します。デフォルト値は`true`です。値のオプションは`true`または`false`です。
`trk_userFingerprintSeed`	ユーザーフィンガープリントシードユーザーフィンガープリントを生成するためのハッシュシードを構成します。デフォルトは`123412414`です。
`trk_pageUnloadTimer`	ページアンロードタイマーイベントが発火した後、ページをアンロードするまでの待機時間（ミリ秒）を構成します。デフォルトは500ミリ秒です。
`trk_forceSecure`	セキュアトラッカーを強制する現在のページがhttpであってもトラッカーをhttpsに強制します。デフォルト値は`false`です。値のオプションは`true`または`false`です。
`trk_sendAsPost`	POSTとして送信する GETリクエストの代わりにPOSTリクエストを使用してイベントを構成します。デフォルト値は`false`です。値のオプションは`true`または`false`です。
`trk_bufferSize`	バッファサイズ POSTを使用してイベントをバッチ処理するためのバッファのサイズを構成します。デフォルト値は1です。
`trk_maxPostBytes`	最大POSTバイト数コレクターに送信されるPOSTリクエストの最大サイズ（バイト）を構成します。デフォルト値は40,000バイトです。
`trk_storageStrategy`	状態保存ストラテジートラッカーの状態を保存するためのストラテジーを構成します。デフォルトはクッキーです。値のオプション：`cookie`、`localStorage`、または`none`
`trk_cookieLifetime`	Cookieの有効期限ドメイン固有の訪問クッキーの保持時間（秒）を構成します。デフォルト値は2年です。1日は86,400秒です。
`trk_contextVendor`	コンテキストエディタ配列すべてのイベントに自動的に送信する事前定義されたコンテキストの配列を構成します。ベンダーオプション

E-コマース

SnowplowタグはE-コマース対応しているため、デフォルトのE-コマース拡張マッピングを自動的に使用します。このカテゴリで手動マッピングが必要なのは、拡張マッピングを上書きしたい場合や、拡張機能で提供されていないE-コマース変数が必要な場合です。

宛先名	説明
`order_id`	注文ID デフォルトのe-commerce値`_corder`を上書きするためにこれを使用します。
`order_total`	注文合計デフォルトのe-commerce値`_ctotal`を上書きするためにこれを使用します。
`order_shipping`	注文の送料デフォルトのe-commerce値`_cship`を上書きするためにこれを使用します。
`order_tax`	注文の税金デフォルトのe-commerce値`_ctax`を上書きするためにこれを使用します。
`order_store`	注文ストアデフォルトのe-commerce値`_cstore`を上書きするためにこれを使用します。
`order_currency`	注文通貨デフォルトのe-commerce値`_ccurrency`を上書きするためにこれを使用します。
`customer_id`	顧客ID デフォルトのe-commerce値`_ccustid`を上書きするためにこれを使用します。
`customer_city`	顧客の都市デフォルトのe-commerce値`_ccity`を上書きするためにこれを使用します。
`customer_state`	顧客の州デフォルトのe-commerce値`_cstate`を上書きするためにこれを使用します。
`customer_country`	顧客の国デフォルトのe-commerce値`_ccountry`を上書きするためにこれを使用します。
`product_name`	製品名のリスト配列デフォルトのe-commerce値`_cprodname`を上書きするためにこれを使用します。
`product_sku`	製品SKUのリスト配列デフォルトのe-commerce値`_csku`を上書きするためにこれを使用します。
`product_category`	製品カテゴリのリスト配列デフォルトのe-commerce値`_ccat`を上書きするためにこれを使用します。
`product_quantity`	製品数量のリスト配列デフォルトのe-commerce値`_cquan`を上書きするためにこれを使用します。
`product_unit_price`	製品単価のリスト配列デフォルトのe-commerce値`_cprice`を上書きするためにこれを使用します。
`ecm_schema`	トランザクションコンテキストスキーマコンテキストを記述するJSONスキーマ。 Igluライブラリに存在する必要があります。
`ecm_context.data`	トランザクションコンテキストデータコンテキストによって追跡されるデータ値。マッピング時に`ecm_context.data`の`data`をあなたの値に関連付けられた名前に置き換えます。
`ecm_contextObj`	トランザクションユーザー定義コンテンツスキーマとデータプロパティを持つカスタムコンテキストオブジェクト。

リンクトラッキング

宛先名	説明
`enableLCT`	リンククリックトラッキングを有効にするリンククリックにイベントリスナーを追加します。値のオプションは`true`または`false`です。
`ltr_blacklist`	ブラックリスト文字列/配列リンククリックトラッカーによって無視されるべきCSSクラスのリスト。他のすべてのリンクが追跡されます。
`ltr_whitelist`	ホワイトリスト文字列/配列リンククリックトラッカーによって追跡されるべきCSSクラスのリスト。他のすべてのリンクは無視されます。
`ltr_filter`	フィルタ `true`または`false`を返すべき関数（または関数参照）。 `true`を返すすべての項目が追跡されます。
`ltr_pseudoClicks`	擬似クリック中クリックをクリックイベントとして認識するかどうかを構成します。デフォルト値は`false`です。値のオプションは`true`または`false`です。
`ltr_clickContent`	クリックコンテンツクリックイベントがリンクのinnerHTMLをキャプチャするかどうかを構成します。値のオプションは`true`または`false`です
`ltr_url`	URL 手動で追跡されるイベント用。ターゲットURLを構成します。
`ltr_elementId`	要素ID 手動で追跡されるイベント用。要素のリンクIDを構成します。
`ltr_elementClasses`	要素クラス配列手動で追跡されるイベント用。要素のリンククラスを構成します。
`ltr_elementTarget`	要素ターゲット手動で追跡されるイベント用。要素のリンクターゲットを構成します。
`ltr_elementClickContent`	要素クリックコンテンツ配列手動で追跡されるイベント用。要素のリンクコンテンツを構成します。
`ltr_schema`	コンテキストスキーマ文字列コンテキストを記述するJSONスキーマ。 Igluライブラリに存在する必要があります。
`ltr_context.data`	コンテキストデータコンテキストによって追跡されるデータ値。マッピング時に`ltr_context.data`の`data`をあなたの値に関連付けられた名前に置き換えます。
`ltr_contextObj`	ユーザー定義コンテキストスキーマとデータプロパティを持つカスタムコンテキストオブジェクト。

広告トラッキング

宛先名	説明
`adtracking`	広告トラッキング追跡される広告のタイプを構成します。これが入力されている場合のみ、広告イベントが発火します。値のオプションは`impression`、`click`、または`conversion`です。
`ad_impressionId`	インプレッションID 現在のインプレッションインスタンスの識別子を構成します。
`ad_costModel`	コストモデルキャンペーンのコストモデルを構成します。値のオプション: `cpc`、`cpm`、または`cpa`
`ad_cost`	コスト広告のコストを構成します。
`ad_targetUrl`	ターゲットURL 広告の宛先URLを構成します。
`ad_bannerId`	バナーID 広告の`adserver`識別子を構成します。
`ad_zoneId`	ゾーンID 広告が配置されているゾーンの`adserver`識別子を構成します。
`ad_advertiserId`	広告主ID 配列キャンペーンが所属する広告主の`adserver`識別子を構成します。
`ad_campaignId`	キャンペーンID バナーが所属するキャンペーンの`adserver`識別子を構成します。
`ad_clickId`	クリックID 現在のクリックインスタンスの識別子を構成します。
`ad_conversionId`	コンバージョンID 現在のコンバージョンインスタンスの識別子を構成します。
`ad_category`	カテゴリコンバージョンのカテゴリを構成します。
`ad_action`	アクションコンバージョンのユーザーインタラクションのタイプを構成します。
`ad_property`	プロパティコンバージョンのオブジェクト説明を構成します。
`ad_initialValue`	初期値コンバージョンの初期価値を構成します。
`ad_schema`	コンテキストスキーマ文字列コンテキストを記述するJSONスキーマ。 Igluライブラリに存在する必要があります。
`ad_context.data`	コンテキストデータコンテキストによって追跡されるデータ値。マッピング時に`ad_context.data`の`data`をあなたの値に関連付けられた名前に置き換えます。
`ad_contextObj`	ユーザー定義コンテキストスキーマとデータプロパティを持つカスタムコンテキストオブジェクト。

ページビューカスタムコンテキスト

宛先名	説明
`cc_schema`	コンテキストスキーマ文字列コンテキストを記述するJSONスキーマ。 Igluライブラリに存在する必要があります。
`cc_context.data`	コンテキストデータコンテキストによって追跡されるデータ値。マッピング時に`cc_context.data`の`data`をあなたの値に関連付けられた名前に置き換えます。
`cc_contextObj`	ユーザー定義コンテキストスキーマとデータプロパティを持つカスタムコンテキストオブジェクト。

ソーシャルトラッキング

宛先名	説明
`sot_action`	アクションユーザーが実行したアクション。
`sot_network`	ソーシャルネットワークユーザーが交流したネットワーク。
`sot_target`	ターゲット実行されたアクションの対象。
`sot_schema`	コンテキストスキーマ文字列コンテキストを記述するJSONスキーマ。 Igluライブラリに存在する必要があります。
`sot_context.data`	コンテキストデータコンテキストによって追跡されるデータ値。マッピング時に`sot_context.data`の`data`をあなたの値に関連付けられた名前に置き換えます。
`sot_contextObj`	ユーザー定義コンテキストスキーマとデータプロパティを持つカスタムコンテキストオブジェクト。

フォームトラッキング

宛先名	説明
`enableFormTracking`	フォームトラッキングを有効にするフォームの変更と提出を追跡するかどうかを構成します。値のオプションは`true`または`false`です。
`ftr_formBlacklist`	フォームカスタムブラックリスト配列フォームトラッカーによって無視されるべきフォームCSSクラスのリスト。他のすべてのリンクが追跡されます。例：ログインフォーム、リクエストフォーム
`ftr_formWhitelist`	フォームカスタムホワイトリスト配列フォームトラッカーによって追跡されるべきフォームCSSクラスのリスト。他のすべてのリンクが無視されます。例：ログインフォーム、リクエストフォーム
`ftr_fieldBlacklist`	フィールドカスタムブラックリスト配列フォームトラッカーによって無視されるべきフィールドCSSクラスのリスト。他のすべてのリンクが追跡されます。例：パスワードフィールド、メールフィールド
`ftr_fieldWhitelist`	フィールドカスタムホワイトリスト配列フォームトラッカーによって追跡されるべきフィールドCSSクラスのリスト。他のすべてのリンクが無視されます。例：パスワードフィールド、メールフィールド
`ftr_filterForm`	カスタムフォームフィルタ関数 `true`または`false`を返すべき関数（または関数参照）。 `true`を返すすべてのアイテムが追跡されます。
`ftr_filterField`	カスタムフィールドフィルタ関数 `true`または`false`を返すべき関数（または関数参照）。 `true`を返すすべてのアイテムが追跡されます。
`ftr_ctmConfig`	ユーザー定義構成上記のプロパティを持つカスタム構成オブジェクト。個々のプロパティの代わりに使用します。

カートトラッキング

宛先名	説明
`cartTracking`	カートトラッキング追跡されるカートイベントのタイプを構成します。これが入力されている場合のみ、カートイベントが発火します。値のオプションは`cart_add`または`cart_remove`です。
`cart_sku`	カートアイテムSKU カートで移動されるアイテムのSKU。
`cart_name`	カートアイテム名カートで移動されるアイテムの名前。
`cart_category`	カートアイテムカテゴリカートで移動されるアイテムのカテゴリ。
`cart_price`	カートアイテム単価カートで移動されるアイテムの価格。
`cart_quantity`	カートアイテム数量カートで移動されるアイテムの数量。
`cart_currency`	カートアイテム通貨カートで移動されるアイテムの通貨。
`cart_schema`	コンテキストスキーマ文字列コンテキストを記述するJSONスキーマ。 Igluライブラリに存在する必要があります。
`cart_context.data`	コンテキストデータコンテキストによって追跡されるデータ値。マッピング時に`cart_context.data`の`data`をあなたの値に関連付けられた名前に置き換えます。
`cart_contextObj`	ユーザー定義コンテキストスキーマとデータプロパティを持つカスタムコンテキストオブジェクト。

サイト検索トラッキング

宛先名	説明
`sst_terms`	検索用語配列サイト検索で使用される用語のリスト。これが入力されている場合のみ、検索イベントが発火します。
`sst_filters`	検索フィルタフィルタタイプと用語を定義するJSONオブジェクト。
`sst_totalResults`	検索結果の総数検索結果の総数
`sst_pageResults`	最初のページの結果最初のページに表示される結果の数。
`sst_schema`	コンテキストスキーマ文字列コンテキストを記述するJSONスキーマ。 Igluライブラリに存在する必要があります。
`sst_context.data`	コンテキストデータコンテキストによって追跡されるデータ値。マッピング時に`sst_context.data`の`data`をあなたの値に関連付けられた名前に置き換えます。
`sst_contextObj`	ユーザー定義コンテキストスキーマとデータプロパティを持つカスタムコンテキストオブジェクト。

構造化イベント

宛先名	説明
`stctCat`	カテゴリ追跡しているオブジェクトのグループ名。
`stctActn`	アクション名追跡しているオブジェクトに対するユーザーのインタラクションの名前。
`stctLabel`	ラベル追跡している特定のオブジェクトを識別する追加の名前。
`stctProp`	プロパティオブジェクトやそれに対するアクションを記述する追加のアイテム。
`stctVal`	値ユーザーのインタラクションを記述する追加の小数。
`stc_schema`	コンテキストスキーマ文字列コンテキストを記述するJSONスキーマ。 Igluライブラリに存在する必要があります。
`stc_context.data`	コンテキストデータコンテキストによって追跡されるデータ値。マッピング時に`stc_context.data`の`data`をあなたの値に関連付けられた名前に置き換えます。
`stc_contextObj`	ユーザー定義コンテキストスキーマとデータプロパティを持つカスタムコンテキストオブジェクト。

非構造化イベント

宛先名	説明
`unstctDataSchema`	スキーマイベントを記述するJSONスキーマ。Igluライブラリに存在する必要があります。
`unstctData.data`	ユーザー定義データイベントによって追跡されるデータ値。マッピング時に`unstctData.data`の`data`をあなたの値に関連付けられた名前に置き換えます。
`unstctDataObj`	ユーザー定義データオブジェクト上記のプロパティを持つカスタム構成オブジェクト。個々のプロパティの代わりに使用します。
`stc_schema`	コンテキストスキーマ文字列コンテキストを記述するJSONスキーマ。 Igluライブラリに存在する必要があります。
`nstc_context.data`	コンテキストデータコンテキストによって追跡されるデータ値。マッピング時に`unstc_context.data`の`data`をあなたの値に関連付けられた名前に置き換えます。
`unstc_contextObj`	ユーザー定義コンテキストスキーマとデータプロパティを持つカスタムコンテキストオブジェクト。

同意トラッキング

宛先名	説明
`consentGranted`	ユーザーが同意を与えたデータ収集に対するユーザーの同意を追跡するために使用されます。 `id`と`version`の引数が少なくとも提供されている場合、同意文書のコンテキストがイベントに添付されます。
`consentWithdrawn`	ユーザーが一部の同意を撤回したデータ収集に対するユーザーの同意の撤回を追跡するために使用されます。 `id`と`version`の引数が少なくとも提供されている場合、同意文書のコンテキストがイベントに添付されます。
`allConsentWithdrawn`	ユーザーが全ての同意を撤回した全ての同意を撤回すべきかどうかを指定します。
`con_documentId`	同意文書ID 同意文書は、メソッドに提供された引数（同意が与えられたイベントと撤回されたイベントの両方でこれは：`id`、`version`、`name`、`description`）を保存するカスタムコンテキストです。どちらの同意方法でも、コンテキスト引数内の同意文書の自己記述JSONの配列を渡すことで、追加の文書をイベントに追加することができます。
`con_documentVer`	同意文書のバージョン必須同意を与える文書のバージョン
`con_documentName`	同意文書の名前同意文書の名前。
`con_documentDesc`	同意文書の説明同意文書の説明。
`con_documentExpiry`	同意文書の有効期限ユーザーが提供された日時まで添付文書に同意し、その後は同意が無効になることを指定します。
`unstc_schema`	コンテキストスキーマ文字列コンテキストを記述するJSONスキーマ。 Igluライブラリに存在する必要があります。
`nstc_context.data`	コンテキストデータコンテキストによって追跡されるデータ値。マッピング時に`unstc_context.data`の`data`を、値に関連付けられた名前に置き換えます。
`con_contextObj`	ユーザー定義コンテキストスキーマとデータプロパティを持つカスタムコンテキストオブジェクト。

ベンダー文書

SnowPlow Javascript Tracker documentation