# ダッシュボードで使用量を記録する

顧客の使用量データを、ダッシュボードから手動で、または CSV ファイルを使用して記録する方法をご紹介します。

請求期間ごとに正しい金額を顧客に請求するために、Stripe に使用量を記録する必要があります。使用量を記録するには、ダッシュボードの使用量データに手動で使用量データを追加するか、CSV ファイルをアップロードできます。Stripe は使用量データを解析し、検証し、従量イベントに変換します。

イベントが正常にアップロードされると、本番環境の従量課金のフィードにそれらのイベントが表示されるようになります。[データ管理](https://dashboard.stripe.com/data-management/import-set)ページで、以前にアップロードしたすべてのファイルのステータスを確認できます。

## 使用量データを手動で追加する

Stripe ダッシュボードの[メーター](https://dashboard.stripe.com/test/meters)ページで使用量データを手動で追加できます。

1. [メーター](https://dashboard.stripe.com/test/meters)ページで、メーター名を選択します。
2. メーターページで、**使用量を追加** > **使用量を手動で入力**をクリックします。
3. **使用量を追加**ページで、以下を実行します。
   - **顧客**ドロップダウンから、対象の顧客を選択します。
   - **値**には、サンプルの値を入力します。
   - **送信**をクリックします。

## 使用量データを含む CSV ファイルをアップロードする

使用量データを含む CSV ファイルを準備したら、Stripe ダッシュボードにアップロードできます。ダッシュボードで提供されているテンプレートに一致するようにファイル形式を設定してください。許可される最大ファイルサイズは 5 MB です。

### CSV ファイル形式とフィールド

CSV ファイルが次のサンプルファイル形式に従っていることを確認してください:

|  |
| `timestamp` | `event_name` | `payload_stripe_customer_id` | `payload_value` |
| 2024-09-25 | ai_search_api | cus_QMJJtcu70R1x46 | 400 |
| 2024-09-26 | ai_search_api | cus_GAXJtSu6021a6s | 600 |
| 2024-09-27 | cpu_usage | cus_Qz0fwrefsysB9Z3 | 600 |

[Meter Event](https://docs.stripe.com/api/billing/meter-event/object.md) (メーターイベント) のスキーマに従って、ファイルに次のフィールドを含めます。

| フィールド | 説明 |
| --- | --- |
| `timestamp` | イベントが発生した日付。以下のタイムスタンプ形式をサポートしています。

- `yyyy-MM-dd` – 例: `2024-09-23`。
- `yyyy-MM-dd'T'HH:mm:ssZ` – 例: `2024-09-23T16:22:25+0530`。
- `Epoch` – 例: `1727108545`。 |
| `event_name` | 従量イベントの名前。 |
| `payload_stripe_customer_id` | イベントの作成対象となる顧客の ID。顧客設定の [Account](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-id) または [Customer](https://docs.stripe.com/api/customers/object.md#customer_object-id) のいずれかです。[Customers](https://dashboard.stripe.com/customers) ページで `Account` ID (`acct_xxxx`) または `Customer` ID (`cus_xxxx`) を確認します。 |
| `payload_value` | 請求する時間数など、従量イベントの使用量の数値です。`value_settings` で異なるキーを指定した場合は、キーの値に合わせて列名を更新する必要があります。たとえば、`value_settings` で `tokens` を指定した場合、列名を `payload_tokens` に更新します。 |

### CSV ファイルをアップロードする

ファイルにエラーが含まれる場合、失敗した各レコードの理由を含むエラーファイルをダウンロードできます。エラーを修正した後で、更新されたファイルをアップロードできます。

1. [メーター](https://dashboard.stripe.com/meters)ページで、使用量イベントを追加するメーター名を選択します。
2. 従量ページで、**使用量を追加** > **使用量を追加するためにファイルをアップロードする**をクリックします。
3. **使用量を追加するためにファイルをアップロードする**ページで、ファイルを選択します。
4. **ファイルをアップロード**をクリックします。
5. メーターページで、従量イベントの件数と集計値を確認します。