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 überprüfen.

Nutzungsdaten manuell hinzufügen

Auf der Seite der Zähler im Stripe-Dashboard können Sie Nutzungsdaten manuell hinzufügen.

Wählen Sie auf der Seite der Zähler den Zählernamen aus.
Klicken Sie auf der Seite des Zählers auf Nutzung hinzufügen > Nutzung manuell eingeben.
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--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, für die das Ereignis erstellt wird. Details zur `customer_id` erhalten Sie auf der Kundenseite.
`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.

Wählen Sie auf der Seite der Zähler den Namen des Zählers aus, zu dem Sie Nutzungsereignisse hinzufügen möchten.
Klicken Sie auf der Seite des Zählers auf Nutzung hinzufügen> Datei hochladen, um Nutzung hinzuzufügen.
Wählen Sie auf der Seite Datei hochladen, um Nutzung hinzuzufügen Ihre Datei aus.
Klicken Sie auf Datei hochladen.
Überprüfen Sie die Zählerereignisanzahl und den aggregierten Wert auf der Seite des Zählers.