# Nutzung im Dashboard aufzeichnen

Erfahren Sie, wie Sie die Nutzung Ihrer Kundinnen/Kunden im Dashboard manuell oder mithilfe einer CSV-Datei aufzeichnen.

Sie müssen die Nutzung bei Stripe erfassen, um Ihren Kundinnen und Kunden in jedem Abrechnungszeitraum die korrekten Beträge zu berechnen. Um die Nutzung aufzuzeichnen, können Sie Nutzungsdaten manuell hinzufügen oder eine CSV-Datei mit den Nutzungsdaten im Dashboard hochladen. Stripe analysiert, validiert und wandelt die Nutzungsdaten in Zählerereignisse um.

Nachdem die Ereignisse erfolgreich hochgeladen wurden, können Sie sie im Live-Zähler-Feed sehen. Sie können auch den Status aller zuvor hochgeladenen Dateien auf der Seite [Datenverwaltung](https://dashboard.stripe.com/data-management/import-set) überprüfen.

## Nutzungsdaten manuell hinzufügen

Auf der Seite der [Zähler](https://dashboard.stripe.com/test/meters) im Stripe-Dashboard können Sie Nutzungsdaten manuell hinzufügen.

1. Wählen Sie auf der Seite der [Zähler](https://dashboard.stripe.com/test/meters) den Zählernamen aus.
1. Klicken Sie auf der Seite des Zählers auf **Nutzung hinzufügen** > **Nutzung manuell eingeben**.
1. Gehen Sie auf der Seite **Nutzung hinzufügen** wie folgt vor:
   - Wählen Sie Ihren Kunden/Ihre Kundin aus der Dropdown-Liste **Kunde/Kundin** aus.
   - Geben Sie für **Wert** einen Beispielwert ein.
   - Klicken Sie auf **Absenden**.

## Laden Sie eine CSV-Datei mit Nutzungsdaten hoch

Nachdem Sie Ihre CSV-Datei mit den Nutzungsdaten vorbereitet haben, können Sie sie im Stripe-Dashboard hochladen. Achten Sie darauf, Ihre Datei so zu formatieren, dass sie mit der im Dashboard verfügbaren Vorlage übereinstimmt. Die maximal zulässige Dateigröße ist 5 MB.

### CSV-Dateiformat und -Felder

Stellen Sie sicher, dass die CSV-Datei diesem Beispieldateiformat entspricht:

|  |
|  |
| `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_Qz0fwcfSysB9Z3           | 600             |

Folgen Sie dem [Zählerereignis-](https://docs.stripe.com/api/billing/meter-event/object.md)-Schema, wenn Sie die folgenden Felder in Ihre Datei aufnehmen:

| Feld                         | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                            |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `timestamp`                  | Das Datum, an dem das Ereignis aufgetreten ist. Wir unterstützen die folgenden Zeitstempelformate:

  - `yyyy-MM-dd` – z. B. `2024-09-23`.
  - `yyyy-MM-dd'T'HH:mm:ssZ` – z. B. `2024-09-23T16:22:25+0530`.
  - `Epoch` – z. B. `1727108545`.                                                                                                                                            |
| `event_name`                 | Der Name des Zählerereignisses.                                                                                                                                                                                                                                                                                                                                                                         |
| `payload_stripe_customer_id` | Die [Kunden-ID](https://docs.stripe.com/api/customers/object.md#customer_object-id), für die das Ereignis erstellt wird. Details zur `customer_id` erhalten Sie auf der [Kundenseite](https://dashboard.stripe.com/customers).                                                                                                                                                                          |
| `payload_value`              | Der numerische Nutzungswert des Zählerereignisses, zum Beispiel die Anzahl der in Rechnung zu stellenden Stunden. Wenn Sie in den `value_settings` einen anderen Schlüssel angegeben haben, müssen Sie den Spaltennamen so aktualisieren, dass er mit dem Schlüsselwert übereinstimmt. Wenn Sie zum Beispiel `tokens` in den `value_settings` angeben, ändern Sie den Spaltennamen in `payload_tokens`. |

### Ihre CSV-Datei hochladen

Wenn Ihre Datei Fehler enthält, können Sie eine Fehlerdatei mit der Ursache für jeden fehlgeschlagenen Datensatz herunterladen. Nachdem Sie die Fehler behoben haben, können Sie die aktualisierte Datei hochladen.

1. Wählen Sie auf der Seite der [Zähler](https://dashboard.stripe.com/meters) den Namen des Zählers aus, zu dem Sie Nutzungsereignisse hinzufügen möchten.
1. Klicken Sie auf der Seite des Zählers auf **Nutzung hinzufügen**\> **Datei hochladen, um Nutzung hinzuzufügen**.
1. Wählen Sie auf der Seite **Datei hochladen, um Nutzung hinzuzufügen** Ihre Datei aus.
1. Klicken Sie auf **Datei hochladen**.
1. Überprüfen Sie die Zählerereignisanzahl und den aggregierten Wert auf der Seite des Zählers.