Skip to main content
Lo Stream Blueprint invia a Dodo Payments un evento di utilizzo con il numero di byte consumati da un cliente da uno stream. Un meter Sum su bytes somma la larghezza di banda di ogni cliente, così puoi fatturarla. Il blueprint è incluso nel pacchetto npm @dodopayments/ingestion-blueprints come trackStreamBytes().

​
Casi d’uso

Lo Stream Blueprint è adatto ai seguenti scenari:

Video Platforms

Fattura ai clienti il consumo di larghezza di banda video e la qualità dello streaming.

Music Streaming

Tieni traccia dell’utilizzo dello streaming audio per utente e per livello di abbonamento.

Live Events

Monitora il consumo delle live stream e addebita l’utilizzo della larghezza di banda.

Real-Time Data

Tieni traccia del trasferimento di dati in tempo reale per applicazioni IoT e di telemetria.
Usalo per piattaforme di streaming video e audio, servizi di live streaming e applicazioni con dati in tempo reale.

​
Avvio rapido

Per tenere traccia dell’utilizzo dello streaming, installa il pacchetto, crea un meter e invia il numero di byte consumati da ogni cliente.
1

Install the SDK

Installa il pacchetto Dodo Payments Ingestion Blueprints:
2

Get Your API Keys

Crea una chiave API di Dodo Payments in Developer → API Keys nella dashboard di Dodo Payments e salvala nella variabile d’ambiente DODO_PAYMENTS_API_KEY. Usa una chiave in modalità test durante lo sviluppo. Una chiave in modalità test funziona solo con test_mode.
3

Create a Meter

Nella dashboard di Dodo Payments, vai su Products → Meters e fai clic su Create Meter. Imposta questi campi:
  • Meter Name: un nome descrittivo, ad esempio Stream Bandwidth.
  • Event Name: stream_consumption oppure un nome a tua scelta. Deve corrispondere esattamente a eventName nel tuo codice (con distinzione tra maiuscole e minuscole).
  • Aggregation Type: Sum, per sommare i byte trasmessi.
  • Over Property: bytes, per fatturare in base all’utilizzo della larghezza di banda.
  • Measurement Unit: l’unità mostrata sulle fatture, ad esempio bytes.
4

Track Stream Usage

Chiama trackStreamBytes() indicando il cliente e il numero di byte consumati:

​
Configurazione

​
Configurazione dell’ingestion

Passa queste opzioni a new Ingestion():
​
string
obbligatorio
La tua chiave API di Dodo Payments dalla dashboard.
​
string
Modalità dell’ambiente: test_mode o live_mode. Il valore predefinito è test_mode. Gli SDK di Dodo Payments utilizzano invece live_mode per impostazione predefinita, quindi imposta esplicitamente live_mode in produzione.
​
string
obbligatorio
Nome dell’evento che corrisponde a Event Name del meter (con distinzione tra maiuscole e minuscole).

​
Opzioni per il monitoraggio dei byte dello stream

Passa queste opzioni a trackStreamBytes():
​
string
obbligatorio
L’ID cliente di Dodo Payments a cui addebitare lo stream, ad esempio cus_123.
​
number
Numero di byte consumati nello stream. Obbligatorio per la fatturazione basata sulla larghezza di banda. Se lo ometti, l’evento non ha un valore bytes, ma viene comunque conteggiato da un meter Count.
​
object
Metadati facoltativi sullo stream, come il tipo di stream, la qualità o l’ID della sessione. Ogni valore deve essere una stringa, un numero o un booleano.

​
Best practice

Monitora per blocchi: per gli stream lunghi, monitora il consumo in blocchi invece di attendere il completamento dell’intero stream.
Ogni chiamata a trackStreamBytes() invia un evento separato e un meter Sum somma i blocchi.
Conteggio accurato dei byte: se fatturi la larghezza di banda totale, includi nel conteggio dei byte tutti i costi aggiuntivi, come gli header e l’overhead del protocollo.
Ultima modifica il 26 settembre 2026