DataLayer
データレイヤークラスとTealiumが提供するメソッドのリファレンスガイド(Android Kotlin用)。
クラス: DataLayer
このクラスは、トラッキングされるすべてのイベントに含まれるキーと値のデータを永続的に保存するためのものです。
DataLayer
クラスで利用可能なメソッドは以下の通りです。
メソッド | 説明 |
---|---|
all() |
データレイヤーに現在格納されているすべてのキーと値のペアを取得します |
clear() |
データレイヤーからすべてのデータを削除します |
contains() |
指定したキーがデータレイヤーに存在する場合はtrue を返します |
count() |
データレイヤーに現在格納されている値の数を返します |
get() |
指定したキーの値を取得します |
getBoolean() |
指定したキーのBoolean 値を取得します |
getBooleanArray() |
指定したキーのArray<Boolean> 値を取得します |
getDouble() |
指定したキーのDouble 値を取得します |
getDoubleArray() |
指定したキーのArray<Double> 値を取得します |
getInt() |
指定したキーのInt 値を取得します |
getIntArray() |
指定したキーのArray<Int> 値を取得します |
getJsonArray() |
指定したキーのorg.json.JSONArray 値を取得します |
getJsonObject() |
指定したキーのorg.json.JSONObject 値を取得します |
getLong() |
指定したキーのLong 値を取得します |
getLongArray() |
指定したキーのArray<Long> 値を取得します |
getString() |
指定したキーのString 値を取得します |
getStringArray() |
指定したキーのArray<String> 値を取得します |
keys() |
データレイヤーに現在格納されているすべてのキーのList<String> を返します |
putBoolean() |
指定したキーにBoolean 値を格納します |
putBooleanArray() |
指定したキーにArray<Boolean> 値を格納します |
putDouble() |
指定したキーにDouble 値を格納します |
putDoubleArray() |
指定したキーにArray<Double> 値を格納します |
putInt() |
指定したキーにInt 値を格納します |
putIntArray() |
指定したキーにArray<Int> 値を格納します |
putJsonArray() |
指定したキーにorg.json.JSONArray 値を格納します |
putJsonObject() |
指定したキーにorg.json.JSONObject 値を格納します |
putLong() |
指定したキーにLong 値を格納します |
putLongArray() |
指定したキーにArray<Long> 値を格納します |
putString() |
指定したキーにString 値を格納します |
putStringArray() |
指定したキーにArray<String> 値を格納します |
remove() |
指定したキーの値を削除します |
all
データレイヤーに現在格納されているすべてのキーと値のマップを返します。
val dataLayer = tealium.dataLayer.all()
clear
データレイヤーに現在格納されているすべてのアイテムを削除します。
tealium.dataLayer.clear()
contains
指定したキーがデータレイヤーに存在する場合はtrue
を返し、存在しない場合はfalse
を返します。
パラメーター | 型 | 説明 |
---|---|---|
key |
String |
削除する変数の名前 |
tealium.dataLayer.contains("KEY")
count
データレイヤーに現在格納されているアイテムの数を返します。
tealium.dataLayer.count()
get
指定したキーの値を取得します。返される型は許可されている型のいずれかに一致し、それ以外の場合はnull
が返されます。
このメソッドはAny
型の変数(JavaのObject
に相当)を取得します。データ型を適切に使用するために、型キャストやinstanceof
を使用して型を調べる必要があります。
パラメーター | 型 | 説明 |
---|---|---|
key |
String |
取得する変数の名前 |
val any = tealium.dataLayer.get("KEY")
getBoolean
指定したキーのBoolean
値を取得します。指定したキーの値がBoolean
でない場合はnull
が返されます。
パラメーター | 型 | 説明 |
---|---|---|
key |
String |
取得する変数の名前 |
val bool = tealium.dataLayer.getBoolean("KEY")
getBooleanArray
指定したキーのArray<Boolean>
値を取得します。指定したキーの値がArray<Boolean>
でない場合はnull
が返されます。
パラメーター | 型 | 説明 |
---|---|---|
key |
String |
取得する変数の名前 |
val booleanArray = tealium.dataLayer.getBooleanArray("KEY")
getDouble
指定したキーのDouble
値を取得します。指定したキーの値がDouble
でない場合はnull
が返されます。
パラメーター | 型 | 説明 |
---|---|---|
key |
String |
取得する変数の名前 |
val double = tealium.dataLayer.getDouble("KEY")
getDoubleArray
指定したキーのArray<Double>
値を取得します。指定したキーの値がArray<Double>
でない場合はnull
が返されます。
パラメーター | 型 | 説明 |
---|---|---|
key |
String |
取得する変数の名前 |
val doubleArray = tealium.dataLayer.getDoubleArray("KEY")
getInt
指定したキーのInt
値を取得します。指定したキーの値がInt
でない場合はnull
が返されます。
パラメーター | 型 |
説明 |
---|---|---|
key |
String |
取得する変数の名前 |
val int = tealium.dataLayer.getInt("KEY")
getIntArray
指定したキーのArray<Int>
値を取得します。指定したキーの値がArray<Int>
でない場合はnull
が返されます。
パラメーター | 型 | 説明 |
---|---|---|
key |
String |
取得する変数の名前 |
val intArray = tealium.dataLayer.getIntArray("KEY")
getJsonArray
指定したキーのorg.json.JSONArray
値を取得します。指定したキーの値がJSONArrayでない場合はnull
が返されます。
パラメーター | 型 | 説明 |
---|---|---|
key |
String |
取得する変数の名前 |
val jsonArray = tealium.dataLayer.getJsonArray("KEY")
getJsonObject
指定したキーのorg.json.JSONObject
値を取得します。指定したキーの値がJSONObjectでない場合はnull
が返されます。
パラメーター | 型 | 説明 |
---|---|---|
key |
String |
取得する変数の名前 |
val jsonObject = tealium.dataLayer.getJsonObject("KEY")
getLong
指定したキーのLong
値を取得します。指定したキーの値がLong
でない場合はnull
が返されます。
パラメーター | 型 | 説明 |
---|---|---|
key |
String |
取得する変数の名前 |
val long = tealium.dataLayer.getLong("KEY")
getLongArray
指定したキーのArray<Long>
値を取得します。指定したキーの値がArray<Long>
でない場合はnull
が返されます。
パラメーター | 型 | 説明 |
---|---|---|
key |
String |
取得する変数の名前 |
val longArray = tealium.dataLayer.getLongArray("KEY")
getString
指定したキーのString
値を取得します。指定したキーの値がString
でない場合はnull
が返されます。
パラメーター | 型 | 説明 |
---|---|---|
key |
String |
取得する変数の名前 |
val string = tealium.dataLayer.getString("KEY")
getStringArray
指定したキーのArray<String>
値を取得します。指定したキーの値がArray<String>
でない場合はnull
が返されます。
パラメーター | 型 | 説明 |
---|---|---|
key |
String |
取得する変数の名前 |
val stringArray = tealium.dataLayer.getStringArray("KEY")
keys
データレイヤーに現在格納されているすべてのキーのList<String>
を返します。
tealium.dataLayer.keys()
putBoolean
指定したキーにBoolean
値を格納します。
パラメーター | 型 | 説明 |
---|---|---|
key |
String |
格納する変数の名前 |
value |
Boolean |
格納するBoolean 値 |
expiry |
Expiry |
(オプション) この変数の有効期限 |
tealium.dataLayer.putBoolean("KEY", true, Expiry.FOREVER)
putBooleanArray
指定したキーにArray<Boolean>
値を格納します。
パラメーター | 型 | 説明 |
---|---|---|
key |
String |
格納する変数の名前 |
value |
Array<Boolean> |
格納するArray<Boolean> 値 |
expiry |
Expiry |
(オプション) この変数の有効期限 |
tealium.dataLayer.putBooleanArray("KEY", arrayOf(true, false, true), Expiry.FOREVER)
putDouble
指定したキーにDouble
値を格納します。
パラメーター | 型 | 説明 |
---|---|---|
key |
String |
格納する変数の名前 |
value |
Double |
格納するDouble 値 |
expiry |
Expiry |
(オプション) この変数の有効期限 |
tealium.dataLayer.putDouble("KEY", 10.5, Expiry.FOREVER)
putDoubleArray
指定したキーにArray<Double>
値を格納します。
パラメーター | 型 | 説明 |
---|---|---|
key |
String |
格納する変数の名前 |
value |
Array<Double> |
格納するArray<Double> 値 |
expiry |
Expiry |
(オプション) この変数の有効期限 |
tealium.dataLayer.putDoubleArray("KEY", arrayOf(0.1, 10.5), Expiry.FOREVER)
putInt
指定したキーにInt
値を格納します。
パラメーター | 型 | 説明 |
---|---|---|
key |
String |
格納する変数の名前 |
value |
Int |
格納するInt 値 |
expiry |
Expiry |
(オプション) この変数の有効期限 |
tealium.dataLayer.putInt("KEY", 10, Expiry.FOREVER)
putIntArray
指定したキーにArray<Int>
値を格納します。
パラメーター | 型 | 説明 |
---|---|---|
key |
String |
格納する変数の名前 |
value |
Array<Int> |
格納するArray<Int> 値 |
expiry |
Expiry |
(オプション) この変数の有効期限 |
tealium.dataLayer.putIntArray("KEY", arrayOf(100, Int.MAX_VALUE), Expiry.FOREVER)
putJsonArray
指定したキーにorg.json.JSONArray
値を格納します。
パラメーター | 型 | 説明 |
---|---|---|
key |
String |
格納する変数の名前 |
value |
JSONArray |
格納するorg.json.JSONArray 値 |
expiry |
Expiry |
(オプション) この変数の有効期限 |
val my_list = new JSONArray();
my_list.put("value_1");
my_list.put("value_2");
tealium.dataLayer.putJsonArray("KEY", my_list, Expiry.FOREVER);
putJsonObject
指定したキーにorg.json.JSONObject
値を格納します。
パラメーター | 型 | 説明 |
---|---|---|
key |
String |
格納する変数の名前 |
value |
JSONObject |
格納するorg.json.JSONObject 値 |
expiry |
Expiry |
(オプション) この変数の有効期限 |
val my_obj = new JSONObject();
my_obj.put("key", "value");
tealium.dataLayer.putJsonObject("KEY", my_obj, Expiry.FOREVER);
putLong
指定したキーにLong
値を格納します。
パラメーター | 型 | 説明 |
---|---|---|
key |
String |
格納する変数の名前 |
value |
Long |
格納するLong 値 |
expiry |
Expiry |
(オプション) この変数の有効期限 |
tealium.dataLayer.putLong("KEY", Long.MAX_VALUE, Expiry.FOREVER)
putLongArray
指定したキーにArray<Long>
値を格納します。
パラメーター | 型 | 説明 |
---|---|---|
key |
String |
格納する変数の名前 |
value |
Array<Long> |
格納するArray<Long> 値 |
expiry |
Expiry |
(オプション) この変数の有効期限 |
tealium.dataLayer.putLongArray("KEY", arrayOf(1000L, Long.MAX_VALUE), Expiry.FOREVER)
putString
指定したキーにString
値を格納します。
パラメーター | 型 | 説明 |
---|---|---|
key |
String |
格納する変数の名前 |
value |
String |
格納するString 値 |
expiry |
Expiry |
(オプション) この変数の有効期限 |
tealium.dataLayer.putString("KEY", "String Value", Expiry.FOREVER)
putStringArray
指定したキーにArray<String>
値を格納します。
パラメーター | 型 | 説明 |
---|---|---|
key |
String |
格納する変数の名前 |
value |
Array<String> |
格納するArray<String> 値 |
expiry |
Expiry |
(オプション) この変数の有効期限 |
tealium.dataLayer.putStringArray("KEY",
arrayOf("String 1", "String 2"), Expiry.FOREVER)
remove
指定したキーの値を削除します。
パラメーター | 型 | 説明 |
---|---|---|
key |
String |
削除する変数の名前 |
tealium.dataLayer.remove("KEY")
最終更新日 :: 2024年March月29日