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

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

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

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

これらのデータレイヤー変数は、Tealium iQの構成で使用するためのものです。サイトのデータレイヤーコードを作成する方法については、次のJavaScriptインストールドキュメンテーションを参照してください：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を参照してください。

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

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

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

これらの保存タイプの違いとその使用についての詳細は、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に構成したデータレイヤー変数を作成します：

値を構成するには、次のようなカスタムJavaScriptコードを使用したAdvanced JavaScript Code Extensionを使用します：

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