Skip to main content
Das Stream Blueprint sendet ein Nutzungsereignis an Dodo Payments mit der Anzahl der Bytes, die ein Kunde aus einem Stream verbraucht hat. Ein Sum-Meter über bytes addiert die Bandbreite jedes Kunden, sodass Sie sie abrechnen können. Das Blueprint ist im npm-Paket @dodopayments/ingestion-blueprints als trackStreamBytes() enthalten.

​
Anwendungsfälle

Das Stream Blueprint eignet sich für folgende Szenarien:

Video Platforms

Rechnen Sie den Bandbreitenverbrauch und die Streaming-Qualität von Videos bei Kunden ab.

Music Streaming

Verfolgen Sie die Audio-Streaming-Nutzung pro Benutzer für Abonnementstufen.

Live Events

Überwachen Sie den Verbrauch von Livestreams und rechnen Sie die Bandbreitennutzung ab.

Real-Time Data

Verfolgen Sie die Übertragung von Echtzeitdaten für IoT- und Telemetrieanwendungen.
Verwenden Sie es für Video- und Audio-Streamingplattformen, Livestreaming-Dienste und Echtzeitdatenanwendungen.

​
Schnellstart

Um die Streaming-Nutzung zu verfolgen, installieren Sie das Paket, erstellen Sie ein Meter und senden Sie die Anzahl der Bytes, die jeder Kunde verbraucht.
1

Install the SDK

Installieren Sie das Dodo Payments Ingestion Blueprints-Paket:
2

Get Your API Keys

Erstellen Sie unter Developer → API Keys im Dodo Payments dashboard einen Dodo Payments API-Schlüssel und speichern Sie ihn in der Umgebungsvariable DODO_PAYMENTS_API_KEY. Verwenden Sie während der Entwicklung einen Testmodus-Schlüssel. Ein Testmodus-Schlüssel funktioniert nur mit test_mode.
3

Create a Meter

Gehen Sie im Dodo Payments dashboard zu Products → Meters und klicken Sie auf Create Meter. Legen Sie diese Felder fest:
  • Meter Name: ein beschreibender Name, z. B. Stream Bandwidth.
  • Event Name: stream_consumption oder ein von Ihnen gewählter Name. Er muss in Ihrem Code exakt mit eventName übereinstimmen (Groß-/Kleinschreibung beachten).
  • Aggregation Type: Sum, um die gestreamten Bytes zu addieren.
  • Over Property: bytes, um nach Bandbreitennutzung abzurechnen.
  • Measurement Unit: die auf Rechnungen angezeigte Einheit, z. B. bytes.
4

Track Stream Usage

Rufen Sie trackStreamBytes() mit dem Kunden und der Anzahl der verbrauchten Bytes auf:

​
Konfiguration

​
Ingestion-Konfiguration

Übergeben Sie diese Optionen an new Ingestion():
​
string
erforderlich
Ihr Dodo Payments API-Schlüssel aus dem Dashboard.
​
string
Umgebungsmodus: test_mode oder live_mode. Der Standardwert ist test_mode. Die Dodo Payments SDKs verwenden standardmäßig stattdessen live_mode. Legen Sie daher in der Produktion live_mode ausdrücklich fest.
​
string
erforderlich
Ereignisname, der mit dem Event Name Ihres Meters übereinstimmt (Groß-/Kleinschreibung beachten).

​
Optionen für Track Stream Bytes

Übergeben Sie diese Optionen an trackStreamBytes():
​
string
erforderlich
Die Dodo Payments-Kunden-ID, der der Stream in Rechnung gestellt werden soll, z. B. cus_123.
​
number
Anzahl der im Stream verbrauchten Bytes. Für eine bandbreitenbasierte Abrechnung erforderlich. Wenn Sie diesen Wert nicht angeben, enthält das Ereignis keinen bytes-Wert, wird aber weiterhin für ein Count-Meter gezählt.
​
object
Optionale Metadaten zum Stream, z. B. Streamtyp, Qualität oder Sitzungs-ID. Jeder Wert muss eine Zeichenfolge, eine Zahl oder ein boolescher Wert sein.

​
Best Practices

Nach Chunk verfolgen: Verfolgen Sie bei langen Streams den Verbrauch in Chunks, anstatt das Ende des gesamten Streams abzuwarten.
Jeder Aufruf von trackStreamBytes() sendet ein separates Ereignis, und ein Sum-Meter addiert die Chunks.
Genaue Byte-Zählung: Wenn Sie die gesamte Bandbreite abrechnen, berücksichtigen Sie in Ihrer Byte-Zählung auch den gesamten Overhead, z. B. Header und Protokoll-Overhead.
Zuletzt geändert am 26. September 2026