Snowplow タグの構成ガイド | クライアントサイドタグ | Tealium開発者ドキュメントプレビュー

タグのヒント

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

タグの構成

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

タグを追加した後、次の構成を構成します：

コードバージョン
- タグバージョンを選択します（2.18.2または3.1.2）
タイトル
- 同じベンダーの複数のタグを使用する場合は、一意の名前を割り当てます。
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 です。
- データマッピングを使用してこの値を動的に上書きします。
アクティビティトラッキングの有効化
- ページ上のユーザーアクティビティをトラッキングするために ‘page ping’ イベントを有効にします。
- 可能な値は 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 です。値のオプションについては、Potential platform values を参照してください
`trk_send`	トラッカーの送信 String/Array 広告などの同じソースからの複数のアイテムを識別するための名前空間値です。値が入力されると、ページビュー、広告インプレッション、広告コンバージョン、広告クリック、およびリンククリックに添付されます。
`trk_encodeBase64`	Base 64 エンコードの使用自己記述イベントとカスタムコンテキストを Base64 にエンコードするかどうかを構成します。デフォルトは true です。値のオプションは `true` または `false` です。
`trk_respectDoNotTrack`	Do Not Track の尊重ブラウザの Do Not Track オプションを尊重するかどうかを構成します。デフォルト値は `false` です。値のオプションは `true` または `false` です
`trk_userFingerprint`	ユーザーフィンガープリントブラウザの機能に基づいてユーザーフィンガープリントを生成するかどうかを構成します。デフォルト値は `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 です。値のオプション：`cookie`、`localStorage`、または `none`
`trk_cookieLifetime`	クッキーライフタイムドメイン固有のビジタークッキーの保持時間（秒単位）を構成します。デフォルト値は 2 年です。1日には 86,400 秒あります。
`trk_contextVendor`	コンテキストエディタ Array すべてのイベントと自動的に送信される事前定義されたコンテキストの配列を構成します。ベンダーオプション

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`	製品名のリスト Array デフォルトの E-コマース値 `_cprodname` を上書きするために使用します。
`product_sku`	製品 SKU のリスト Array デフォルトの E-コマース値 `_csku` を上書きするために使用します。
`product_category`	製品カテゴリのリスト Array デフォルトの E-コマース値 `_ccat` を上書きするために使用します。
`product_quantity`	製品数量のリスト Array デフォルトの E-コマース値 `_cquan` を上書きするために使用します。
`product_unit_price`	製品単価のリスト Array デフォルトの E-コマース値 `_cprice` を上書きするために使用します。
`ecm_schema`	トランザクションコンテキストスキーマコンテキストを記述する JSON スキーマです。 Iglu ライブラリに存在する必要があります。
`ecm_context.data`	トランザクションコンテキストデータコンテキストでトラッキングするデータ値。マッピング時に、`ecm_context.data` の `data` を値に関連付けられた名前で置き換えます。
`ecm_contextObj`	トランザクションユーザー定義コンテンツスキーマとデータプロパティを持つカスタムコンテキストオブジェクト。

リンクトラッキング

宛先名	説明
`enableLCT`	リンククリックトラッキングの有効化リンククリックにイベントリスナーを追加します。値のオプションは `true` または `false` です。
`ltr_blacklist`	ブラックリスト String/Array リンククリックトラッカーによって無視されるべき CSS クラスのリストです。他のすべてのリンクはトラッキングされます。
`ltr_whitelist`	ホワイトリスト String/Array リンククリックトラッカーによってトラッキングされるべき 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`	要素のクラス Array 手動でトラッキングされるイベントの場合。要素のリンククラスを構成します。
`ltr_elementTarget`	要素のターゲット手動でトラッキングされるイベントの場合。要素のリンクターゲットを構成します。
`ltr_elementClickContent`	要素のクリックコンテンツ Array 手動でトラッキングされるイベントの場合。要素のリンクコンテンツを構成します。
`ltr_schema`	コンテキストスキーマ String コンテキストを記述する 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 Array キャンペーンが所属する広告主の `adserver` 識別子を構成します。
`ad_campaignId`	キャンペーン ID バナーが所属するキャンペーンの `adserver` 識別子を構成します。
`ad_clickId`	クリック ID 現在のクリックインスタンスの識別子を構成します。
`ad_conversionId`	コンバージョン ID 現在のコンバージョンインスタンスの識別子を構成します。
`ad_category`	カテゴリコンバージョンのカテゴリを構成します。
`ad_action`	アクションコンバージョンのユーザーインタラクションのタイプを構成します。
`ad_property`	プロパティコンバージョンのオブジェクトの説明を構成します。
`ad_initialValue`	初期値コンバージョンの初期価値を構成します。
`ad_schema`	コンテキストスキーマ String コンテキストを記述する JSON スキーマです。 Iglu ライブラリに存在する必要があります。
`ad_context.data`	コンテキストデータコンテキストでトラッキングするデータ値。マッピング時に、`data` の `ad_context.data` を値に関連付けられた名前で置き換えます。
`ad_contextObj`	ユーザー定義コンテキストスキーマとデータプロパティを持つカスタムコンテキストオブジェクト。

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

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

ソーシャルトラッキング

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