---
title: 数値属性
description: この記事では数値属性の使用方法について説明します。
url: https://docs.tealium.com/ja/server-side/attributes/data-types/number/
---
数値属性は、訪問数、ページビュー、イベントなどのブラウジング指標の数値を保存します。一般的な例には、ライフタイムバリュー、注文合計トランザクション、最終購入からの日数が含まれます。

## 仕組み

数値は小数または整数として保存されます。ニーズに合ったタイプを選択してください：

* **小数（デフォルト）**
    * 小数値は0個以上の小数桁を持つことができます。
    * 例：`12`, `12.0`, `12.345`
    * 小数値はJava Doubleクラスを使用します。詳細については、[Class Double](https://docs.oracle.com/javase/8/docs/api/java/lang/Double.html)を参照してください。
    * 金額を表す属性に推奨されます。
* **整数**  
    * 整数値は全て整数で保存されます。
    * 例：`12`, `-4`, `3214`
    * 数量、カウンター、スコアを表す数値属性に役立ちます。

数値属性は、イベント、訪問、訪問のスコープで利用可能です。

![](https://docs.tealium.com/images/server-side/scope-3checks.png)

### サイズ制限

数値属性の小数値は `-1.7976931348623157×10^308` から `1.7976931348623157×10^308` の範囲内でなければなりません。整数値は `-2147483647` から `2147483647` の範囲内でなければなりません。

数値属性は、暗号化および圧縮後のプロファイルの最大サイズ（400 KB）によっても制限されます。

## エンリッチメント

### 数値の増減エンリッチメント

このエンリッチメントは、正の値（増加）または負の値（減少）で数値を変更します。変更値は別の数値属性または定数値であることができます。

例えば、訪問の注文のライフタイムトータルバリュー（LTV）を計算するために、`purchase` イベントが発生するたびに `order_total` 属性の値で属性を増加させます。

**属性名**: ライフタイムトータルバリュー

* **初期値**: `121.78` 
* **エンリッチされた値**:  order_total `220.00`
* **結果**: `341.78`

### 比率の構成

二つの数値の商を新しい比率数値として構成します。

例えば、注文ごとの平均カートアイテム数を計算するために、購入されたカートアイテム総数属性と完了した注文総数属性の比率を構成します。

**属性名**: 注文ごとの平均カートアイテム数

* **初期値**: ---
* **エンリッチされた値**:  
購入されたカートアイテム総数: `48.00`  
完了した注文総数: `3.00` 
* **結果**: `16.00`

### 積の構成

二つの数値の積を新しい数値として構成します。

例えば、`coupon_discount_amount` を計算するために、`order_subtotal` と `coupon_discount_percent` を掛け合わせます。

**属性名**: `coupon_discount_amount`

* **初期値**:---
* **エンリッチされた値**:  
order_subtotal: `42.00`  
coupon_discount_percent: `0.05`
* **結果**: `2.10`

### 差の構成

二つの数値の差を新しい数値として構成します。

**属性名**: `order_subtotal`

* **初期値**: `42.00 `
* **エンリッチされた値**:  
order_subtotal: `42.00`  
coupon_discount_amount: `2.10`
* **結果**: `39.90`

### 和の構成

二つの数値の和を構成します。

例えば、`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`

### 二つの日付の差の構成
（AudienceStreamのみ）

二つのイベント間の経過時間を計算します。経過時間は次のいずれかで表現できます：

* 分
* 時間
* 日
* 週
* 月

差は常に正の値として保存されるため、日付は任意の順序で構成できます。

例えば、最終購入日と現在の訪問日の間の日数として最終購入からの日数を計算します。


<blockquote>
日付属性はUnixタイムスタンプとして保存されますが、これらの例では可読性のためにフォーマットされた日付を使用しています。
</blockquote>


**属性名**: 最終購入からの日数

* **初期値**: ---
* **エンリッチされた値**:  
最終購入日: `"2018/10/30"`  
現在の訪問日: `"2019/11/01"`
* **結果**: `367`

### タイムラインに基づいた移動平均の構成
（AudienceStreamのみ）

移動平均は、時間の経過とともにキャプチャされた数値の算術平均です。これらの値は、[timeline](https://docs.tealium.com/timeline-attribute/)内のエントリとして収集される数値および[tally](https://docs.tealium.com/tally-attribute/)属性から来ます。タイムラインの有効期限が最終平均にどのエントリを含めるかを決定します。有効期限がない場合は、単純な平均解です。

**属性名**: 平均注文価値

* **初期値**: ---
* **エンリッチされた値**: `[20.00, 30.00, 40.00, 50.00]`
* **結果**: `35.00`

### タイムラインに基づいた移動合計の構成
（AudienceStreamのみ）

移動合計は、[timeline](https://docs.tealium.com/timeline-attribute/)内のエントリとしてキャプチャされた数値または[tally](https://docs.tealium.com/tally-attribute/)属性の数値の集計です。タイムラインの有効期限が集計中にどのエントリを含めるかを決定します。

**属性名**: 総注文価値

* **初期値**: ---
* **エンリッチされた値**: `[10.00, 20.00, 30.00, 40.00, 50.00]`
* **結果**: `150.00`

### タイムライン内のエントリ数に数値を構成

タイムライン内のエントリ数に数値を構成します。

**属性名**: 総注文数

* **初期値**: ---
* **エンリッチされた値**: `[10.00, 20.00, 30.00, 40.00, 50.00]`
* **結果**: `5.00`

### 集計値に数値を構成
（AudienceStreamのみ）

集計内の特定の値に数値を構成します。集計属性と集計内のエントリの名前を指定します。例えば、サイトカテゴリビューの集計には「靴」のエントリがあるかもしれません。

**属性名**: 靴カテゴリビュー数

* **初期値**: ---
* **エンリッチされた値**: サイトカテゴリビュー: `{"Shoes": 42}`
* **結果**: `42`

### 集計内のアイテム数に数値を構成
（AudienceStreamのみ）

集計内のエントリ数に属性を構成します。例えば、サイトカテゴリビューの集計には3つのエントリがあるかもしれません。

**属性名**: 閲覧されたカテゴリ数

* **初期値**: ---
* **エンリッチされた値**:  
``` 
{  
  "Shoes": 42,  
  "Shirts": 11,  
  "Pants": 8
} 
``` 
* **結果**: `3.00`

### 文字列セット内のアイテム数に数値を構成
（AudienceStreamのみ）

文字列セット内のアイテム数に数値を構成します。例えば、アクティブブラウザタイプのセットには3つのエントリがあるかもしれません。

**属性名**: アクティブブラウザタイプ数

* **初期値**: ---
* **エンリッチされた値**: `["Firefox", "Safari", "Chrome"]`
* **結果**: `3.00`

### タイムラインに基づいた集計の最大値に数値を構成
（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`