数値属性
この記事では、数値属性の使用方法について説明します。
数値属性は、訪問数、ページビュー数、イベント数などのブラウジングメトリクスの数値を保存します。一般的な例としては、ライフタイムバリュー、注文総取引額、最終購入からの日数などがあります。
仕組み
数値は小数または整数として保存されます。あなたのニーズに合ったタイプを選択してください：
- 小数（デフォルト）
- 小数値はゼロ（0）以上の小数桁を持つことができます。
- 例：
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イベントが発生するたびに、Last Purchase Amountをorder_totalの値に構成します。
属性名：Last Purchase Amount
- 初期値：—
- エンリッチメント対象： order_total:
43.19 - 結果：
43.19
2つの日付間の差の構成
2つのイベント間の経過時間を計算します。経過時間は以下のいずれかで表現できます：
- 分
- 時間
- 日
- 週
- 月
差は常に正の値として保存されるため、日付は任意の順序で構成できます。
例えば、最終購入日と現在の訪問日の間の日数の差として、最終購入からの日数を計算します。
日付属性はUnixタイムスタンプとして保存されますが、これらの例では可読性のためにフォーマットされた日付を使用しています。
属性名：最終購入からの日数
- 初期値：—
- エンリッチメント対象：
最終購入日:"2018/10/30"
現在の訪問日:"2019/11/01" - 結果：
367
タイムラインに基づく移動平均の構成
移動平均は、時間経過によって取得された数値の算術平均です。これらの値は、tally属性と数値属性から取得され、timelineのエントリとして収集されます。タイムラインの有効期限が最終平均に組み入れることができるエントリを決定します。有効期限がない場合、それは単純な平均解です。
属性名：平均注文値
- 初期値：—
- エンリッチメント対象：
[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"というエントリがあるかもしれません。
属性名：シューズカテゴリビューカウント
- 初期値：—
- エンリッチメント対象： Site Category Views:
{"Shoes": 42} - 結果：
42
数値をtallyのエントリ数に構成
属性をtallyのエントリ数に構成します。例えば、サイトカテゴリビューのtallyには3つのエントリがあるかもしれません。
属性名：閲覧したカテゴリ数
- 初期値：—
- エンリッチメント対象：
{
"Shoes": 42,
"Shirts": 11,
"Pants": 8
}
- 結果：
3.00
文字列セットのアイテム数に数値を構成
数値を文字列セットのアイテム数に構成します。例えば、Active Browser Typesという文字列セットには3つのエントリがあるかもしれません。
属性名：アクティブなブラウザタイプの数
- 初期値：—
- エンリッチメント対象：
["Firefox", "Safari", "Chrome"] - 結果：
3.00
タイムラインに基づくtallyの移動最大値に数値を構成
数値を、タイムライン内で取得された別の数値の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年November月13日