データレイヤー変数のタイプ

データレイヤー画面では、変数をタイプ別に整理します。タイプはデータのソースに基づいています。

サポートされているタイプは次のとおりです：

• UDO変数：ユニバーサルデータオブジェクト(utag_data)からの変数。
• クエリストリングパラメータ：URLクエリストリングからの変数。
• ファーストパーティクッキー：クッキーとして保存された変数。
• JavaScript変数：すでにサイトコードに存在する変数。
• メタデータ要素：<meta>タグからの変数。
• DOM変数：組み込みのDOM変数。
• ローカル保存変数：セッション間でローカルに保存されたデータ。
• セッション保存変数：セッション間で期限切れになるローカルに保存されたデータ。
• AudienceStream属性：AudienceStreamからdata layer enrichmentによってインポートされた変数。

これらのデータレイヤー変数は、Tealium iQの構成で使用するためのものです。サイトのデータレイヤーコードの作成方法については、Data LayerとUniversal Data Objectを参照してください。

UDO変数

UDOタイプは、Universal Data Object（またはutag_dataとも呼ばれる）で定義された変数のためのものです。UDOは、サイトやアプリのコードに実装されています。ほとんどの変数はこのタイプになります。

例

ページコード内：

var utag_data = {
  language : "en"
};

変数名：language
JavaScript拡張での参照：b["language"]

クエリストリングパラメータ

クエリストリングタイプは、URLからのパラメータのためのものです。クエリストリングは、URL内の?文字の後に続くすべてのものを指します。クエリストリングパラメータは、key=valueの形式でキーと値のペアであり、keyはパラメータ名です。

例

URL内：

http://example.com/path/page.html?pg=4&sortOrder=price

iQ内の変数名：sortOrder
JavaScript拡張での参照：b["qp.sortOrder"]

ファーストパーティクッキー

ファーストパーティクッキータイプは、ドメインに構成されたクッキーのためのものです。クッキーはファーストパーティクッキーでなければならず、それは同じドメインで使用されるところで構成されることを意味します。

クッキーにデータを保存するには、ファーストパーティクッキー変数を作成し、Persist Data Value extensionを使用して構成します。

ブラウザのコンソールを見てクッキーを検査します。例えば、このドキュメンテーションサイト(docs.tealium.com)では、.tealium.comのドメイン内のクッキーのみがファーストパーティと見なされます。異なるドメインで構成されたクッキーはサードパーティと見なされます。

ブラウザのクッキー名：_aff
iQ内の変数名：_aff
JavaScript拡張での参照：b["cp._aff"]

デフォルトでは、utag.jsは構成で役立つ可能性のあるいくつかのクッキーを作成し、維持します。
詳細については、Tealium built-in cookiesを参照してください。

バージョン4.49以前

utag.jsのバージョン4.49以前では、いくつかの区切られたキーと値のペアを持つ単一のマルチバリュークッキーutag_mainを作成し、維持します。

utag_mainを使用してカスタムクッキーを作成するには、プレフィックスutag_main_（例：utag_main_mycookie）を持つファーストパーティクッキー変数を作成します。これにより、クッキーはグローバルクッキーネームスペースから分離され、タグマネージャーから来るクッキーが明確になります。このアプローチは、名前の衝突を避けるのに役立ちます。

JavaScript変数

JavaScriptタイプは、Webページ上のJavaScript変数（utag_dataオブジェクト以外）を参照します。変数名は、文字、数字、アンダースコア、ドル記号、配列の括弧、ピリオドのみを含むことができます。オブジェクトのプロパティを参照するには、ドット表記法を使用します（object.propertyName）。

例

ページ内：

var myApp = { page : { name : "Home Page" } };

iQ内の変数名：myApp.page.name
JavaScript拡張での参照：b["js_page.myApp.page.name"]

メタデータ要素

メタデータタイプは、ページの<meta>タグの内容を参照します。

例

ページ内：

<meta name="author" content="Tealium" />

iQ内の変数名：author
JavaScript拡張での参照：b["meta.author"]

DOM変数

DOMタイプは、windowおよびdocumentオブジェクトからのプロパティを参照します。これらの変数はページ内で自動的に構成されます。

JavaScriptページ変数：location.hostname
JavaScript拡張での参照：b["dom.hostname"]

詳細については、standard page dataを参照してください。

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

(utag.js 4.49で新規追加)

ローカル保存とセッション保存のタイプは、ブラウザのローカル保存またはセッション保存からのデータを参照します：

• ローカル保存はブラウザのセッション間で保存されます。このデータは期限切れになりません。
• セッション保存はページセッションが終了すると期限切れになります。

これらの保存タイプの違いとその使用法についての詳細は、MDN Web DocsのWindow.localStorageとWindow.sessionStorageを参照してください。

ローカル保存またはセッション保存に値を構成するには、次のようなカスタムJavaScriptコードを使用したAdvanced JavaScript Code extensionを使用します：

localStorage.setItem("key", value);
sessionStorage.setItem("key", value);

Persist Data ValueまたはSet Data Values拡張機能を使用して、ブラウザのローカルまたはセッション保存に値を構成することはできません。

セッションとローカル保存は、同じサブドメイン内のデータのみにアクセスできます。例えば、www.example.comでアクセスされたデータはstore.example.comでアクセスできません。詳細については、Same Origin Policyを参照してください。

拡張機能内のJavaScriptでこれらの変数を参照します：

• ローカル保存：b["ls.my_local_storage_var"]
• セッション保存：b["ss.my_session_storage_var"]

2023年3月1日以前にls.またはss.プレフィックスを持つUDOタイプとしてローカル保存またはセッション保存変数を追加した場合、それらの変数は新しいローカル保存とセッション保存変数タイプに変換されません。

例

システムはlast_category_viewed変数をローカル保存に保存します：

この値はページから次のようにアクセスできます：

localStorage.getItem("last_category_viewed").

この変数を構成に追加するには、TypeをLocal Storage Variableに構成し、Sourceをlast_category_viewedに構成したデータレイヤー変数を作成します：

localStorage.setItem("last_category_viewed", "Apparel")

バージョン4.48以前

utag.jsのバージョン4.48以前では、以下の名前形式でローカルまたはセッション保存変数をUDOタイプとして手動で追加する必要があります：

• ローカル保存：ls.VARIABLE_NAME
• セッション保存：ss.VARIABLE_NAME

これらの保存変数を使用するには：

1. iQタグ管理 > データレイヤー > +変数を追加に移動します。
2. UDO変数を選択します。
3. ソース変数名を入力します。