数値属性
この記事では、数値属性の使用方法について説明します。
数値属性は、訪問数、ページビュー数、イベント数などのブラウジングメトリクスの数値を保存します。一般的な例としては、ライフタイムバリュー、注文合計取引、最終購入からの日数などがあります。
仕組み
数値は小数または整数として保存されます。あなたのニーズに合ったタイプを選択してください：
- 小数（デフォルト）
- 小数値はゼロ以上の小数桁を持つことができます。
- 例：
12、12.0、12.345 - 小数値はJava Doubleクラスを使用します。詳細は、Class Doubleを参照してください。
- 通貨値を表す属性に推奨されます。
- 整数
- 保存されるのは整数値のみです。
- 例：
12、-4、3214 - 数量、カウンター、スコアを表す数値属性に便利です。
数値属性は次のスコープで利用可能です：イベント、訪問、訪問。
サイズ制限
数値属性の小数値は-1.7976931348623157×10^308から1.7976931348623157×10^308の範囲内でなければなりません。数値属性の整数値は-2147483647から2147483647の範囲内でなければなりません。
数値属性は、暗号化と圧縮後のプロファイルの最大サイズ（400 KB）によっても制限されます。
エンリッチメント
数値の増減エンリッチメント
このエンリッチメントは、正の値（増加）または負の値（減少）で数値を変更します。変更値は別の数値属性または定数値であることができます。
例えば、訪問の注文のライフタイムトータルバリュー（LTV）を計算するために、purchaseイベントが発生するたびにorder_total属性の値で属性を増加させるためにこのエンリッチメントを使用します。
属性名：ライフタイムトータルバリュー
- 初期値：
121.78 - エンリッチメント対象： order_total
220.00 - 結果：
341.78
比率の構成
2つの数値の商を新しい比率の数値として構成します。
例えば、平均カートアイテム数/注文数を計算するために、このエンリッチメントを使用して、購入したカートアイテムの合計属性と完了した注文の合計属性の比率を構成します。
属性名：平均カートアイテム数/注文数
- 初期値：—
- エンリッチメント対象：
購入したカートアイテムの合計:48.00
完了した注文の合計:3.00 - 結果：
16.00
積の構成
2つの数値の積を新しい数値として構成します。
例えば、coupon_discount_amountを計算するために、このエンリッチメントを使用してorder_subtotalとcoupon_discount_percentを掛け合わせます。
属性名：coupon_discount_amount
- 初期値：—
- エンリッチメント対象：
order_subtotal:42.00
coupon_discount_percent:0.05 - 結果：
2.10
差の構成
2つの数値の差を新しい数値として構成します。
属性名：order_subtotal
- 初期値：
42.00 - エンリッチメント対象：
order_subtotal:42.00
coupon_discount_amount:2.10 - 結果：
39.90
合計の構成
2つの数値の合計に構成します。
例えば、order_totalをorder_subtotalとorder_tax_amountの合計に構成します。
属性名：order_total
- 初期値：—
- エンリッチメント対象：
order_subtotal:39.90
order_tax_amount:3.29 - 結果：
43.19
数値の構成
数値を特定の数値に構成します。
例えば、purchaseイベントが発生するたびに、最終購入金額をorder_totalの値に構成します。
属性名：最終購入金額
- 初期値：—
- エンリッチメント対象： order_total:
43.19 - 結果：
43.19
2つの日付間の差の構成
(AudienceStreamのみ)
2つのイベント間の経過時間を計算します。経過時間は以下のいずれかで表現できます：
- 分
- 時間
- 日
- 週
- 月
差は常に正の値として保存されるため、日付は任意の順序で構成できます。
例えば、最終購入日と現在の訪問日との間の日数の差として、最終購入からの日数を計算します。
日付属性はUnixタイムスタンプとして保存されますが、これらの例では読みやすさのためにフォーマットされた日付を使用しています。
属性名：最終購入からの日数
- 初期値：—
- エンリッチメント対象：
最終購入日:"2018/10/30"
現在の訪問日:"2019/11/01" - 結果：
367
タイムラインに基づくローリング平均の構成
(AudienceStreamのみ)
ローリング平均は、時間経過とともに取得された数値の算術平均です。これらの値は、tally属性として収集されたエントリーのtimeline属性から取得されます。タイムラインの有効期限が最終平均にどのエントリーを含めることができるかを決定します。有効期限がない場合、それは単純な平均解です。
属性名：平均注文値
- 初期値：—
- エンリッチメント対象：
[20.00, 30.00, 40.00, 50.00] - 結果：
35.00
タイムラインに基づくローリング合計の構成
(AudienceStreamのみ)
ローリング合計は、数値またはtally属性の数値の集計で、これらはtimelineのエントリーとして取得されます。タイムラインの有効期限が、集計中にどのエントリーを含めることができるかを決定します。
属性名：合計注文値
- 初期値：—
- エンリッチメント対象：
[10.00, 20.00, 30.00, 40.00, 50.00] - 結果：
150.00
タイムラインのエントリー数に数値を構成
数値をタイムラインのエントリー数に構成します。
属性名：合計注文数
- 初期値：—
- エンリッチメント対象：
[10.00, 20.00, 30.00, 40.00, 50.00] - 結果：
5.00
数値をtally値に構成
(AudienceStreamのみ)
数値をtally内の特定の値に構成します。tally属性とtally内のエントリーの名前を指定します。例えば、サイトカテゴリビューのtallyには"Shoes"というエントリーがあるかもしれません。
属性名：シューズカテゴリビューカウント
- 初期値：—
- エンリッチメント対象： サイトカテゴリビュー:
{"Shoes": 42} - 結果：
42
数値をtallyのエントリー数に構成
(AudienceStreamのみ)
属性をtallyのエントリー数に構成します。例えば、サイトカテゴリビューのtallyには3つのエントリーがあるかもしれません。
属性名：閲覧したカテゴリ数
- 初期値：—
- エンリッチメント対象：
{
"Shoes": 42,
"Shirts": 11,
"Pants": 8
}
- 結果：
3.00
文字列のセット内のアイテム数に数値を構成
(AudienceStreamのみ)
数値を文字列のセット内のアイテム数に構成します。例えば、アクティブなブラウザタイプの文字列のセットには3つのエントリーがあるかもしれません。
属性名：アクティブなブラウザタイプの数
- 初期値：—
- エンリッチメント対象：
["Firefox", "Safari", "Chrome"] - 結果：
3.00
タイムラインに基づくtallyのローリング最大値に数値を構成
(AudienceStreamのみ)
数値を、タイムライン内で取得された別の数値のローリング最大値に構成します。
属性名：最高注文値
- 初期値：—
- エンリッチメント対象：
[10.00, 20.00, 30.00, 40.00, 50.00] - 結果：
50.00
数値の変化に数値を構成
(AudienceStreamのみ)
この属性を、最後のイベントから別の属性との差に構成します。例えば、このエンリッチメントを使用して、前回の注文金額と現在の注文金額の差を取得します。注文値の変化という属性を構成するには、前回の注文からorder_subtotalの変化を構成します。
属性名：注文値の変化
- 初期値：
30.00 - エンリッチメント対象： order_subtotal:
42.00 - 結果：
12.00
日付の変化に数値を構成
(AudienceStreamのみ)
この属性を、このイベントと最後のイベントとの間の選択された値の変化に構成します。例えば、このエンリッチメントを使用して、購入が行われるたびに最終購入日の日付属性の月の変化を取得します。 日付の変更は次のいずれかで表現できます：
- 分
- 時間
- 日
- 週
- 月
属性名：最後の購入からの月数
- 初期値：
- エンリッチメント情報：
最後の購入日（最後のイベント）："10/31/2019"
最後の購入日（このイベント）："12/31/2019" - 結果：2 (月)
数値の配列の平均に基づいて数値を構成する
（EventStreamのみ）
この属性を数値の配列の平均に構成します。
属性名：平均購入価格
- 初期値：—
- エンリッチメント情報：
[20.00, 25.00, 30.00, 35.00, 40.00] - 結果：
30.00
数値の配列の最大値に基づいて数値を構成する
（EventStreamのみ）
この属性を数値の配列内の最大値に構成します。
属性名：購入した最も高価な商品
- 初期値：—
- エンリッチメント情報：
[20.00, 25.00, 30.00, 35.00, 40.00] - 結果：
40.00
数値の配列の最小値に基づいて数値を構成する
（EventStreamのみ）
この属性を数値の配列内の最小値に構成します。
属性名：購入した最も安価な商品
- 初期値：—
- エンリッチメント情報：
[20.00, 25.00, 30.00, 35.00, 40.00] - 結果：
20.00
配列内のアイテム数に構成する
配列内のアイテム数に構成します。例えば、カート内の商品数を保存するために、このエンリッチメント情報を使用してcart_product_id配列内のアイテム数を取得します。
属性名：num_cart_items
- 初期値：—
- エンリッチメント情報：product_id:
["prod123", "prod456"] - 結果：
2.00
最終更新日 :: 2025年January月16日