データレイヤー

カスタムデータ

すべてのイベントで一般的なデータレイヤーの値が必要な場合がよくあります。これらの値をすべてのトラッキングコールに追加する必要がないようにするために、tealium.dataLayerメソッドを使用して、すべてのトラッキングコールに適用されるデータレイヤーの値を永続化します。値が保存されると、自動的にすべてのトラッキングイベントに含まれます。

データの有効期限

データレイヤーの値には有効期限があり、有効期限が切れるとデータレイヤーから削除されます。カスタムデータレイヤーの値を構成する際に、値の有効期限をオプションで構成することができます。デフォルトの有効期間は現在のセッションです。

次の有効期限のタイプが利用可能です：

有効期限のタイプに基づいて、add()を使用してデータをデータレイヤーに保存します。

セッションデータ

セッションデータの値はセッションの間永続化されます。セッションは、一定の時間枠内でのユーザーのアクティビティによって決まります。セッションは、ユーザーの非アクティビティが30分続いた後に終了します。

セッションの後に有効期限が切れるデータレイヤーの値を永続化するには、次のようにします：

tealium?.dataLayer.add(key: "mysessionvar", value: "hello", expiry: .session)

すべてのセッションデータを取得するには：

let sessionData = tealium?.dataLayer.allSessionData

再起動データ

再起動データの値は、各イベントの間永続化されます。アプリが閉じられるか再起動されると、データは削除されます。

次のアプリの再起動までデータレイヤーの値を永続化するには：

tealium?.dataLayer.add(key: "myrestartvar", value: "foo", expiry: .untilRestart)

永久データ

永久データの値は、現在のアプリのバージョンの寿命の間永続化されます。アプリがアンインストールされるか更新されると、データはデータレイヤーから削除されます。

永久データを永続化するには：

tealium?.dataLayer.add(key: "myforevervar", value: "world", expiry: .forever)

カスタム日付データ

カスタム日付データの値は、指定した日付で永続化されます。

カスタム日付の有効期限を持つデータレイヤーの値を永続化するには：

tealium?.dataLayer.add(key: "customdate", value: "bar", expiry: .after(yourDate))

カスタム期間データ

カスタム期間データの値は、指定した期間の後に永続化されます。

1日後に有効期限が切れるデータレイヤーの値を永続化するには：

tealium?.dataLayer.add(key: "lengthoftime", value: "days", expiry: .afterCustom((.days, 1)))

1ヶ月後に有効期限が切れるデータレイヤーの値を永続化するには：

tealium?.dataLayer.add(key: "lengthoftime", value: "months", expiry: .afterCustom((.months, 1)))

すべてのデータの取得

データレイヤーに現在保存されているすべてのデータを取得するには、all()メソッドを使用します：

let data: [String: Any] = tealium?.dataLayer.all

また、Tealium.gatherTrackData()も参照してください。

データのクリア

特定のキーのデータをクリアするには、delete()メソッドを使用します：

• 複数のキー：dataLayer.delete(forKeys:)
• 単一のキー：dataLayer.delete(forKey:)

すべてのデータをクリアするには、deleteAll()メソッドを使用します。

例

以下の例は、上記のメソッドを示しています：

class TealiumHelper {
	var tealium: Tealium?
	let config = TealiumConfig(...)
	tealium = Tealium(config: config) { [weak self] _ in
		guard let self = self, let teal = self.tealium else { return }

		teal.dataLayer.add(key: "mysessionvar", value: 123456)

		teal.dataLayer.add(key: "myvarforever", value: "hello", expiry: .forever)

		teal.dataLayer.add(key: "campaign", value: "summer", expiry: .afterCustom((.months, 3)))

		print("All event data: \(teal.dataLayer.all)")
		print("All session data: \(teal.dataLayer.allSessionData)")
		print("Single event data key `campaign`: \(teal.dataLayer.all["campaign"])")

		teal.dataLayer.delete(forKeys: ["myvarforever"])

		teal.dataLayer.deleteAll()
	}
}

モジュールデータ

アプリデータコレクター

以下の変数は、AppDataモジュールによってデータレイヤーに追加されます。

アトリビューションコレクター

以下の変数は、Attributionモジュールによってデータレイヤーに追加されます。

オートトラッキングコレクター

以下の変数は、Autotrackingモジュールによってデータレイヤーに追加されます。

Collectディスパッチャー

以下の変数は、Collectディスパッチャーによってデータレイヤーに追加されます。

Consent Managerモジュール

以下の変数は、ConsentManagerモジュールが有効になっている場合にデータレイヤーに追加されます。

Core

以下の変数は、Coreモジュールによってデータレイヤーに追加されます。

クラッシュコレクター

以下の変数は、CrashReporterモジュールによってデータレイヤーに追加されます。

デバイスデータコレクター

以下の変数は、DeviceDataモジュールによってデータレイヤーに追加されます。

ライフサイクルコレクター

以下の変数は、Lifecycleモジュールによってデータレイヤーに追加されます。

ロケーションコレクター

以下の変数は、Locationモジュールによってデータレイヤーに追加されます。

タグ管理

以下の変数は、Tag Managementモジュールによってデータレイヤーに追加されます。