数値属性
この記事では、数値属性の使用方法について説明します。
数値属性は、訪問数、ページビュー数、イベント数などのブラウジングメトリクスの数値を保存します。一般的な例としては、ライフタイムバリュー、注文合計取引、最終購入からの日数などがあります。
仕組み
数値は小数または整数として保存されます。あなたのニーズに合ったタイプを選択してください:
- 小数(デフォルト)
- 小数値はゼロ(0)以上の小数桁を持つことができます。
- 例:
12
、12.0
、12.345
- 小数値はJava Doubleクラスを使用します。詳細については、Class Doubleを参照してください。
- 通貨値を表す属性に推奨されます。
- 整数
- 整数値のみが保存されます。
- 例:
12
、-4
、3214
- 数量、カウンター、スコアを表す数値属性に便利です。
数値属性は次のスコープで利用可能です:イベント、訪問、訪問者。
![](/images/server-side/scope-3checks.png)
サイズ制限
数値属性のストレージ容量制限はありませんが、これらの属性は依然としてプロファイルの最大サイズに制限されます(暗号化と圧縮後の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つの日付間の差の設定
2つのイベント間の経過時間を計算します。経過時間は以下のいずれかで表現できます:
- 分
- 時間
- 日
- 週
- 月
差は常に正の値として保存されるため、日付は任意の順序で設定できます。
例えば、最後の購入日と現在の訪問日との間の日数の差として、最後の購入からの日数を計算します。
日付属性はUnixタイムスタンプとして保存されますが、これらの例では読みやすさのためにフォーマットされた日付を使用しています。
属性名:最後の購入からの日数
- 初期値:—
- エンリッチメント対象:
最後の購入日:"2018/10/30"
現在の訪問日:"2019/11/01"
- 結果:
367
タイムラインに基づく移動平均の設定
移動平均は、時間経過とともに取得された数値の算術平均です。これらの値は、timeline内のエントリとして収集される数値とtally](/server-side/attributes/data-types/tally/)属性から来ます。タイムラインの有効期限が最終平均にどのエントリを考慮に入れるかを決定します。有効期限がない場合、それは単純な平均解です。
属性名:平均注文値
- 初期値:—
- エンリッチメント対象:
[20.00, 30.00, 40.00, 50.00]
- 結果:
35.00
タイムラインに基づく移動合計の設定
移動合計は、数値または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値に設定
数値をtally内の特定の値に設定します。tally属性とtally内のエントリの名前を指定します。例えば、サイトカテゴリビューのtallyには"Shoes"というエントリがあるかもしれません。
属性名:シューズカテゴリビューカウント
- 初期値:—
- エンリッチメント対象: サイトカテゴリビュー:
{"Shoes": 42}
- 結果:
42
数値をtallyのエントリ数に設定
属性をtallyのエントリ数に設定します。例えば、サイトカテゴリビューのtallyには3つのエントリがあるかもしれません。
属性名:閲覧したカテゴリ数
- 初期値:—
- エンリッチメント対象:
{
"Shoes": 42,
"Shirts": 11,
"Pants": 8
}
- 結果:
3.00
文字列セットのアイテム数に数値を設定
数値を文字列セットのアイテム数に設定します。例えば、アクティブなブラウザタイプの文字列セットには3つのエントリがあるかもしれません。
属性名:アクティブなブラウザタイプの数
- 初期値:—
- エンリッチメント対象:
["Firefox", "Safari", "Chrome"]
- 結果:
3.00
タイムラインに基づくtallyの移動最大値に数値を設定
数値を、タイムライン内で取得された別の数値の移動最大値に設定します。
属性名:最高注文値
- 初期値:—
- エンリッチメント対象:
[10.00, 20.00, 30.00, 40.00, 50.00]
- 結果:
50.00
数値の変化に数値を設定
この属性を、最後のイベントからの別の属性との差に設定します。例えば、このエンリッチメントを使用して、前回の注文金額と現在の注文金額の差を取得します。注文値の変化という属性を設定するには、前回の注文からorder_subtotal
の変化を設定します。
属性名:注文値の変化
- 初期値:
30.00
- エンリッチメント対象: order_subtotal:
42.00
- 結果:
12.00
日付の変化に数値を設定
この属性を、このイベントと最後のイベントの間の選択された値の変化に設定します。例えば、このエンリッチメントを使用して、購入が行われるたびに最後の購入日の日付属性の月数の変化を取得します。
日付の変化は以下のいずれかで表現できます:
- 分
- 時間
- 日
- 週
- 月
属性名:最後の購入からの月数
- 初期値:
- エンリッチメント対象:
最後の購入日(最後のイベント):"10/31/2019"
最後の購入日(このイベント):"12/31/2019"
- 結果: 2 (月)
配列内のアイテム数に設定
配列内のアイテム数に設定します。例えば、カート内の商品数を保存するために、このエンリッチメントを使用してcart_product_id
配列内のアイテム数を取得します。
属性名:num_cart_items
- 初期値:—
- エンリッチメント対象: product_id:
["prod123", "prod456"]
- 結果:
2.00
最終更新日 :: 2024年April月17日