データレイヤー | JavaScript用Tealium (utag.js)

ユニバーサルデータオブジェクト（UDO）には、読み込まれたページに関する基本情報を収集する組み込み変数が含まれています。これらの変数には、utag.jsによって作成されたクッキー、ページからの標準DOM変数、読み込まれた構成に関するTealium固有の変数が含まれます。

利用可能なデータレイヤー変数の種類について詳しく学ぶ。

標準ページデータ

以下の変数は、ウェブページで利用可能な標準的なJavaScriptプロパティから生成されます。これらの変数は、ロードルール、拡張機能、データマッピング、条件とともにiQインターフェース内に自動的に表示されます。

これらの値は、ページのURLを前提としています：

http://www.example.com/path/file.html?param1=value1#hash=fragment

変数	説明	例
`dom.domain`	URLの完全なドメイン。ソース: `location.hostname`	`www.example.com`
`dom.hash`	URLのハッシュフラグメント（#文字を除く）。ソース: `location.hash`	`hash=fragment`
`dom.pathname`	URLのパス、クエリパラメータとドメインを除く。ソース: `location.pathname`	`"/path/file.html"`
`dom.query_string`	URLの完全なクエリストリング。ソース: `location.search`	`param1=value1`
`dom.referrer`	前のページのURL。ソース: `document.referrer`
`dom.title`	`<title>`タグ間のテキスト。ソース: `document.title`	`"Test Page Name"`
`dom.url`	ページの完全なURL。ソース: `document.URL`	`http://www.example.com/` `PATH/FILE.html?param1=VALUE#hash=FRAGMENT`
`dom.viewport_height`	ブラウザビューポートの高さ。ソース: `window.innerHeight` または `document.documentElement. clientHeight`	`1320`
`dom.viewport_width`	ブラウザビューポートの幅。ソース: `window.innerWidth` または `document.documentElement. clientWidth`	`1278`

クッキー

以下の変数は、utag_mainという名前の単一のクッキーに保存され、維持されます。または、utag_main_クッキーネームスペース（バージョン4.50から）のスタンドアロンクッキーとして保存されます。すべての変数は、データオブジェクト内に別々の変数として表示され、すべてcp.utag_main_でプレフィックスされます。

これらの変数をiQ構成に追加するには、Data LayerタブからTealium Built-in Dataという名前のデータバンドルを使用します。

変数	説明	例
`cp.utag_main__pn`	セッションページビューカウント - 現在のセッションで表示されたページの数	`2`
`cp.utag_main__se`	セッションイベントカウント - 現在のセッションで追跡されたイベントの数	`2`
`cp.utag_main__sn`	セッションカウント - このユニークな訪問のセッション数	`1`
`cp.utag_main__ss`	セッションの開始かどうか - ページビューがセッションの開始かどうかを示すフラグ（1=はい、0=いいえ）	`0`
`cp.utag_main__st`	タイムスタンプ - ミリ秒単位のUnix/Epochタイムスタンプ	`1522968400449`
`cp.utag_main_ses_id`	セッションID - セッションの一意の識別子	`1522965346545`
`cp.utag_main_v_id`	訪問ID - 各訪問の一意の識別子	`016297481...` (45文字)

Tealiumデータ

以下の変数には、ページに読み込まれたutag.jsに関する情報と、内部で使用される他の値が含まれています。

ut.*変数をiQ構成に追加するには、Data LayerタブからTealium Built-in Dataという名前のデータバンドルを使用します。

変数	名前	例
`tealium_account`	アカウント名	`sandbox`
`tealium_datasource`	データソースキー	`"abc123"`
`tealium_environment`	公開環境	`prod`
`tealium_event`	Tealiumイベント名（直接構成されていない場合は"view"または"link"にデフォルト構成）	`view`
`tealium_library_name`	ライブラリ名	`utag.js`
`tealium_library_version`	ライブラリバージョン	`4.44.0`
`tealium_profile`	アカウントプロファイル	`main`
`tealium_random`	ランダム数	`7782219635308327`
`tealium_session_id`	`utag_main_ses_id`のコピー	`1522965346545`
`tealium_timestamp_epoch`	現在のUnixタイムスタンプ（秒）	`1522956509`
`tealium_timestamp_local`	ローカルタイムスタンプ	`2018-04-05T12:28:29.019`
`tealium_timestamp_utc`	UTCタイムスタンプ	`2018-04-05T19:28:29.019Z`
`tealium_visitor_id`	`utag_main_v_id`のコピー	`016297481...` (45文字)
`ut.account`	tealium_accountのコピー	`sandbox`
`ut.domain`	クッキーを構成するためのトップレベルドメイン。	`example.com`
`ut.env`	`tealium_environment`のコピー	`prod`
`ut.event`	`tealium_event`のコピー	`view`
`ut.profile`	`tealium_profile`のコピー	`main`
`ut.session_id`	`tealium_session_id`のコピー	`1522956509018`
`ut.version`	公開バージョン（`utag.js`バージョン + タイムスタンプ）	`ut4.44.201710171745`
`ut.visitor_id`	`tealium_visitor_id`のコピー	`016297481...` (45文字)

ローカル保存とセッション保存

ローカル保存とセッション保存のキーは、localStorageとsessionStorage変数を使用してデータレイヤーに自動的に表示されます。

これらの保存変数を使用するには、iQタグ管理 > データレイヤー > +変数を追加に移動します。UDO変数を選択し、ソース変数名を入力します。ローカル保存の場合はls.variable_name、セッション保存の場合はss.variable_nameを使用します。

ローカル保存とセッション保存変数についての詳細は、データレイヤー変数を参照してください。

サンプル

以下は、utag.data内の組み込みデータのサンプルです。

{  
    "cp.utag_main_v_id"       : "015da2e1daf10020914ce74dfaf00207900780700093c",
    "cp.utag_main__sn"        : "389",
    "cp.utag_main__ss"        : "0",
    "cp.utag_main__st"        : "1522970376944",
    "cp.utag_main__se"        : "2",
    "cp.utag_main_ses_id"     : "1522915346545",
    "cp.utag_main__pn"        : "8",
    "qp.param1"               : "value1",
    "qp.hash1"                : "val1",
    "dom.referrer"            : "",
    "dom.title"               : "Test Page",
    "dom.domain"              : "www.example.com",
    "dom.query_string"        : "param1=value1",
    "dom.hash"                : "hash=fragment",
    "dom.url"                 : "http://www.example.com/path/file.html?param1=value1#hash=fragment",
    "dom.pathname"            : "/path/file.html",
    "dom.viewport_height"     : 780,
    "dom.viewport_width"      : 1436,
    "ut.domain"               : "example.com",
    "ut.version"              : "ut4.44.201710171745",
    "ut.event"                : "view",
    "ut.visitor_id"           : "015da2e1daf10020914ce74dfaf00207900780700093c",
    "ut.session_id"           : "1522965346545",
    "ut.account"              : "sandbox",
    "ut.profile"              : "main",
    "ut.env"                  : "prod",
    "tealium_event"           : "view",
    "tealium_visitor_id"      : "015da2e1daf10020914ce74dfaf00207900780700093c",
    "tealium_session_id"      : "1522915346545",
    "tealium_datasource"      : "abc123",
    "tealium_account"         : "sandbox",
    "tealium_profile"         : "main",
    "tealium_environment"     : "prod",
    "tealium_random"          : "7421526627003796",
    "tealium_library_name"    : "utag.js",
    "tealium_library_version" : "4.44.0",
    "tealium_timestamp_epoch" : 1522968576,
    "tealium_timestamp_utc"   : "2018-04-05T22:49:36.945Z",
    "tealium_timestamp_local" : "2018-04-05T15:49:36.945"
}