Each event can have fields for associating not only the event name, but the value associated with that event. In addition, "data type" that determines what kind of data is linked to each field is set when the event is sent.
Example) Recommended data type of each field of identify event
The following table shows some of the fields recommended for cooperation in the user identification (identify) event. It is specified for each field which data type should be sent.
Field name | Overview | Sample value | Recommended data type |
---|---|---|---|
user_id | Member ID | "user001" | String type |
age | age | 42 | Numeric type |
subscription | Presence or absence of e-mail magazine registration | true, false | Boolean type |
signup_date | Member registration date | new Date("2020/6/19 12:46:04") | Date type |
Data type type
Basic data type
Data type | Sample value | Major features | Related Links |
---|---|---|---|
String type | "user001" | You will be able to refer to the "most recent 30", and to perform character string comparisons such as partial matches. | - |
Numeric type | 42 | You can refer to "total value" and "maximum value", and you can compare the magnitude of numbers. | - |
Boolean type | true, false | You can limit the value sent to binary | - |
Date type | new Date("2020/6/19 12:46:04") | You can refer to "average interval" and you can make relative/absolute comparison in time. | Details |
Supplement
数値型については、KARTEが利用しているJavaScriptの制約上、1,000兆を超えるような大きな値の数値を連携すると正しく値が認識されません。
具体的には、次の値の範囲がサポートされます。
-9,007,199,254,740,991 〜 9,007,199,254,740,991
特殊なデータ型
次のように、特殊なデータをフィールド値として連携することも可能です。
- 基本データ型の配列
- Examples
['a', 'b', 'c']
[1, 2, 3]
- Examples
- object
- Examples
{foo: 'bar'}
- Examples
- Array of objects
- Examples
[ {foo: 'bar'}, {foo: 'baz'} ]
- Examples
ただし、イベントの統計値での利用のされ方が特殊になります。詳しくは下記の記事をご覧ください。
Remarks
- あるイベントのフィールド値を
null
orundefined
で連携した場合、そのフィールドは無視され、フィールド自体を連携しなかったのと同じ扱いになります