---
title: データ値の永続化拡張
description: データ値の永続化拡張は、ファーストパーティクッキーに値を構成するために使用されます。
url: https://docs.tealium.com/ja/iq-tag-management/extensions/extensions-list/persist-data-value-extension/
---
## 前提条件

* `utag.js`のバージョン4.38以降。`utag.js`テンプレートの更新についての詳細は、当社のナレッジベース記事[utag.jsの最新バージョンへの更新のベストプラクティス](https://support.tealiumiq.com/en/support/solutions/articles/36000363470)を参照してください。
* [拡張機能の動作方法]()
* [データレイヤー変数: ファーストパーティクッキー](https://docs.tealium.com/data-layer-variables/#first-party-cookies)

## 動作方法

データ値の永続化拡張は、テキスト値またはデータレイヤー変数からの値を使用してファーストパーティクッキーを構成します。構成するクッキーは、データレイヤー変数としても作成する必要があります。詳細については、[ファーストパーティクッキー変数](https://docs.tealium.com/data-layer-variables/#first-party-cookies)を参照してください。

クッキーの有効期限は、ユーザーのセッションまたは時間の長さ（時間または日数）に基づいています。クッキーは一度構成することも、すべてのページビューで更新することも、条件に基づいて構成することもできます。

## 拡張機能の使用

拡張機能が追加されると、次の構成オプションが利用可能になります：

* **永続化**: クッキーに保存する値のタイプを選択します：
    * **テキスト**: 入力したテキストをクッキーの値に構成します。
    * **変数**: クッキーをデータレイヤー変数の値に構成します。
* **期間**: クッキーにデータが保持される時間を構成します。
    * **セッション**: データは訪問がブラウザウィンドウを閉じるまでクッキーに残ります。  
    
<blockquote>
セッションクッキーは現在のセッションが終了すると削除されます。ブラウザは現在のセッションがいつ終了するかを定義し、一部のブラウザは再起動時にセッションの復元を使用します。セッションの復元は、セッションクッキーが無期限に続く原因となることがあります。
</blockquote>

    * **訪問**: データは訪問またはブラウザがクッキーを削除するまでクッキーに残ります。
    * **時間**: データは指定した時間数またはブラウザが削除するまでクッキーに残ります。
    * **日数**: データは指定した日数またはブラウザが削除するまでクッキーに残ります。
* **更新**: 値を構成または更新するタイミングを選択します。
    * **ページビュー時に更新を許可**: 訪問がページを表示するたびに、データが更新されます。更新ごとに期間タイマーがリセットされます。
    * **最初に構成した値を保持**: 最初の訪問からのデータのみが保存されます。後続の訪問はこの値を変更しません。
* **条件**: **条件を追加**をクリックして、この拡張機能を実行するタイミングを指定します。条件は1つだけ追加できます。
* **クッキーに保存**: 構成するクッキー変数を選択します。新しいものを作成するには、**+**ボタンをクリックします。

### バージョン4.49以前

`utag.js`のバージョン4.49以前では、Tealiumのクッキーは`utag_main`という名前の単一のマルチバリュークッキーです。Tealiumのクッキーに値を保存するには、クッキー変数を`utag_main_NAME`の形式で命名します。ここで、`NAME`はクッキーの名前です。

![](https://docs.tealium.com/images/iq-tag-management/whiteui-tiq-tealium-cookies-add-first-party-cookie-variable.jpg)

詳細については、[Tealiumのクッキー]()を参照してください。

## 例：訪問の位置情報クッキー

この例では、訪問の位置情報をクッキーに永続化する方法を示します。位置情報は、既存のデータレイヤー変数`city_state_zip`から取得されます。この変数は1ページだけで利用可能な場合がありますが、サイト全体のすべてのページで値が必要なため、データ値の永続化拡張を使用してセッションの寿命にわたってクッキーに保存します。

位置情報クッキーを作成するには：

1. データ値の永続化拡張を追加します。
1. **永続化**ドロップダウンリストから**変数**を選択し、次に変数`city_state_zip (js)`を選択します。
1. **期間**を**セッション**に構成します。
1. **更新**を**ページビュー時に更新を許可**に構成します。
1. **クッキーに保存**フィールドで、**+**ボタンをクリックして変数`utag_main_location`を作成します。

![](https://docs.tealium.com/images/iq-tag-management/no-title-465i1c7944ae10209e84.png)

![](https://docs.tealium.com/images/iq-tag-management/no-title-466i43807063317f396a.png)