データ値の永続化拡張

前提条件

• utag.jsのバージョン4.38以降。utag.jsテンプレートの更新についての詳細は、当社のナレッジベース記事utag.jsの最新バージョンへの更新のベストプラクティスを参照してください。
• 拡張機能の動作方法
• データレイヤー変数: ファーストパーティクッキー

動作方法

データ値の永続化拡張は、テキスト値またはデータレイヤー変数からの値を使用してファーストパーティクッキーを構成します。構成するクッキーは、データレイヤー変数としても作成する必要があります。詳細については、ファーストパーティクッキー変数を参照してください。

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

拡張機能の使用

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

• 永続化: クッキーに保存する値のタイプを選択します：

  • テキスト: 入力したテキストをクッキーの値に構成します。
  • 変数: クッキーをデータレイヤー変数の値に構成します。

• 期間: クッキーにデータが保持される時間を構成します。

  • セッション: データは訪問がブラウザウィンドウを閉じるまでクッキーに残ります。

  セッションクッキーは現在のセッションが終了すると削除されます。ブラウザは現在のセッションがいつ終了するかを定義し、一部のブラウザは再起動時にセッションの復元を使用します。セッションの復元は、セッションクッキーが無期限に続く原因となることがあります。

  • 訪問: データは訪問またはブラウザがクッキーを削除するまでクッキーに残ります。
  • 時間: データは指定した時間数またはブラウザが削除するまでクッキーに残ります。
  • 日数: データは指定した日数またはブラウザが削除するまでクッキーに残ります。

• 更新: 値を構成または更新するタイミングを選択します。

  • ページビュー時に更新を許可: 訪問がページを表示するたびに、データが更新されます。更新ごとに期間タイマーがリセットされます。
  • 最初に構成した値を保持: 最初の訪問からのデータのみが保存されます。後続の訪問はこの値を変更しません。

• 条件: 条件を追加をクリックして、この拡張機能を実行するタイミングを指定します。条件は1つだけ追加できます。

• クッキーに保存: 構成するクッキー変数を選択します。新しいものを作成するには、**+**ボタンをクリックします。

バージョン4.49以前

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

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

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

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

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

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