Snowplowタグ構成ガイド

タグのヒント

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

タグの構成

まず、タグマーケットプレイスにアクセスして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。
- この値を動的に上書きするためにデータマッピングを使用します。
クッキードメイン
- クッキーを構成するトップレベルドメイン。
- 例：.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`	クッキータイムアウトセッションクッキーがアクティブであるべき時間（秒単位）を構成します。デフォルトは30分（1800秒）です。
`enableAT`	アクティビティトラッキングを有効にするページ上のユーザーアクティビティを追跡するための`page ping`イベントを有効にします。値のオプション：`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`	クッキーの寿命ドメイン固有の訪問クッキーの保持時間（秒単位）を構成します。デフォルト値は2年です。1日は86,400秒です。
`trk_contextVendor`	コンテキストエディタ配列すべてのイベントに自動的に送信される事前定義されたコンテキストの配列を構成します。ベンダーオプション

E-コマース

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

宛先名	説明
`order_id`	注文ID デフォルトのE-コマース値 `_corder` を上書きするために使用します。
`order_total`	注文合計デフォルトのE-コマース値 `_ctotal` を上書きするために使用します。
`order_shipping`	注文配送料デフォルトのE-コマース値 `_cship` を上書きするために使用します。
`order_tax`	注文税額デフォルトのE-コマース値 `_ctax` を上書きするために使用します。
`order_store`	注文店舗デフォルトのE-コマース値 `_cstore` を上書きするために使用します。
`order_currency`	注文通貨デフォルトのE-コマース値 `_ccurrency` を上書きするために使用します。
`customer_id`	顧客ID デフォルトのE-コマース値 `_ccustid` を上書きするために使用します。
`customer_city`	顧客の市デフォルトのE-コマース値 `_ccity` を上書きするために使用します。
`customer_state`	顧客の州デフォルトのE-コマース値 `_cstate` を上書きするために使用します。
`customer_country`	顧客の国デフォルトのE-コマース値 `_ccountry` を上書きするために使用します。
`product_name`	製品名リスト配列デフォルトのE-コマース値 `_cprodname` を上書きするために使用します。
`product_sku`	製品SKUリスト配列デフォルトのE-コマース値 `_csku` を上書きするために使用します。
`product_category`	製品カテゴリリスト配列デフォルトのE-コマース値 `_ccat` を上書きするために使用します。
`product_quantity`	製品数量リスト配列デフォルトのE-コマース値 `_cquan` を上書きするために使用します。
`product_unit_price`	製品単価リスト配列デフォルトのE-コマース値 `_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 トラッカーのドキュメント