API Reference — Events Ingestion
API Reference — Meters Creation
Creazione di un contatore
I contatori definiscono come gli eventi di utilizzo vengono aggregati e misurati ai fini della fatturazione. Prima di creare un contatore, pianifica la tua strategia di tracciamento dell’uso:- Identifica quali eventi di utilizzo desideri monitorare
- Determina come gli eventi devono essere aggregati (conteggio, somma, ecc.)
- Definisci eventuali requisiti di filtraggio per casi d’uso specifici
Procedura passo-passo per la creazione di un contatore
Segui questa guida per configurare il tuo meter:Configure Basic Information
Configure Aggregation Settings
- Count
- Sum
- Max
- Last
Configure Event Filtering (Optional)
- AND Logic
- OR Logic
user_tier = "premium" AND endpoint = "/api/v2/users"Add Condition
Configure Property Key
Select Comparator
equals— Corrispondenza esattanot_equals— Filtro di esclusionegreater_than— Confronto numericogreater_than_or_equals— Confronto numerico (inclusivo)less_than— Confronto numericoless_than_or_equals— Confronto numerico (inclusivo)contains— La stringa contiene la sottostringadoes_not_contain— Filtro di esclusione della stringa
Set Comparison Value
Add Groups
Create Meter
Collegamento del meter a un prodotto
Dopo aver creato il meter, devi collegarlo a un prodotto per abilitare la fatturazione basata sull’utilizzo. Questo processo collega i dati di utilizzo del meter alle regole di prezzo per la fatturazione dei clienti. Il collegamento dei meter ai prodotti stabilisce la connessione tra il monitoraggio dell’utilizzo e la fatturazione:- I prodotti definiscono le regole di prezzo e il comportamento di fatturazione
- I meter forniscono i dati di utilizzo per i calcoli di fatturazione
- È possibile collegare più meter a un singolo prodotto per scenari di fatturazione complessi
Processo di configurazione del prodotto
Trasforma i dati di utilizzo in addebiti fatturabili configurando correttamente le impostazioni del prodotto:Choose Usage-Based Billing Product Type
Select Associated Meter
Add Your Meter
- Fai clic su Add Meters per visualizzare i meter disponibili
- Seleziona dall’elenco a discesa il meter che hai creato
- Il meter selezionato apparirà nella configurazione del prodotto
Configure Price Per Unit
- 1.000 unità consumate = 1.000 × $0.50 = $500.00 addebitati
- 500 unità consumate = 500 × $0.50 = $250.00 addebitati
- 100 unità consumate = 100 × $0.50 = $50.00 addebitati
Set Free Threshold (Optional)
- Soglia gratuita: 100 unità
- Prezzo per unità: $0.50
- Utilizzo del cliente: 250 unità
- Calcolo: (250 - 100) × $0.50 = $75.00 addebitati
Save Configuration
- Gli eventi di utilizzo inviati al meter verranno monitorati e aggregati
- I calcoli di fatturazione applicheranno automaticamente le regole di prezzo
- Ai clienti verrà addebitato il consumo effettivo durante ogni ciclo di fatturazione
Invio degli eventi di utilizzo
Dopo aver configurato il meter, puoi iniziare a inviare eventi di utilizzo dalla tua applicazione per monitorare l’utilizzo dei clienti.Struttura degli eventi
Ogni evento di utilizzo deve includere i seguenti campi obbligatori:Esempi di API per gli eventi di utilizzo
Invia gli eventi di utilizzo ai meter configurati utilizzando l’Events API:Elementi fondamentali per un’acquisizione affidabile
Segui queste pratiche per mantenere il monitoraggio dell’utilizzo accurato e resiliente in produzione.timestamp per gli eventi in tempo reale: il valore predefinito sarà il timestamp UTC corrente. Impostalo esplicitamente (ISO 8601) per gli eventi ritardati o raggruppati, così l’utilizzo viene registrato nel periodo di fatturazione corretto. Tieni presente che l’intervallo accettato è ristretto: gli eventi con timestamp anteriori di oltre 1 ora o posteriori di oltre 5 minuti vengono rifiutati. Il backfill storico non è supportato: invia gli eventi memorizzati entro un’ora.Analisi della fatturazione basata sull’utilizzo
Monitora e analizza i dati della fatturazione basata sull’utilizzo con una dashboard di analisi completa. Tieni traccia dei modelli di consumo dei clienti, delle prestazioni dei meter e delle tendenze di fatturazione per ottimizzare la strategia di prezzo e comprendere i comportamenti di utilizzo.Analisi panoramica
La scheda Overview offre una visione completa delle prestazioni della fatturazione basata sull’utilizzo:Metriche dell’attività
Monitora le principali statistiche di utilizzo su periodi diversi:Grafico delle quantità dei meter

- Visualizzazione delle serie temporali: monitora i modelli di utilizzo per giorni, settimane o mesi
- Supporto di più meter: visualizza contemporaneamente i dati di meter diversi
- Analisi delle tendenze: identifica picchi di utilizzo, modelli e traiettorie di crescita
Analisi degli eventi

Visualizzazione delle informazioni sugli eventi
La tabella degli eventi offre una visione chiara dei singoli eventi di utilizzo con le seguenti colonne:- Nome evento: l’azione o il trigger specifico che ha generato l’evento di utilizzo
- ID evento: un identificatore univoco per ogni istanza dell’evento
- ID cliente: il cliente associato all’evento
- Timestamp: il momento in cui si è verificato l’evento
Analisi dei clienti
La scheda Customers offre una visualizzazione dettagliata in formato tabella dei dati di utilizzo dei clienti con le seguenti informazioni:Colonne di dati disponibili
Funzionalità della tabella
- Filtraggio delle colonne: usa la funzionalità “Edit Columns” per mostrare o nascondere colonne di dati specifiche
- Aggiornamenti in tempo reale: i dati di utilizzo riflettono le metriche di consumo più aggiornate
Esempi di aggregazione
Ecco alcuni esempi pratici del funzionamento dei diversi tipi di aggregazione:Comprendere i tipi di aggregazione
I diversi tipi di aggregazione sono adatti a scenari di fatturazione differenti. Scegli il tipo corretto in base a come desideri misurare e addebitare l’utilizzo.Esempi pratici di implementazione
Questi esempi illustrano applicazioni reali di ogni tipo di aggregazione con eventi di esempio e risultati previsti:Count Aggregation — API Calls
Count Aggregation — API Calls
- Nome evento:
api.call - Tipo di aggregazione: Count
- Unità di misura:
calls
Sum Aggregation — Data Transfer
Sum Aggregation — Data Transfer
- Nome evento:
data.transfer - Tipo di aggregazione: Sum
- Over Property:
bytes - Unità di misura:
GB
Max Aggregation — Peak Concurrent Users
Max Aggregation — Peak Concurrent Users
- Nome evento:
concurrent.users - Tipo di aggregazione: Max
- Over Property:
count - Unità di misura:
users
Esempi di filtraggio degli eventi
- Filter by API Endpoint
- Filter by Value Range
- Complex Multi-Condition Filters
- Proprietà:
endpoint - Comparatore:
equals - Valore:
/v1/orders
Risoluzione dei problemi
Risolvi i problemi comuni dell’implementazione della fatturazione basata sull’utilizzo e assicurati che il monitoraggio e la fatturazione siano accurati.Problemi comuni
La maggior parte dei problemi relativi alla fatturazione basata sull’utilizzo rientra nelle seguenti categorie:- Problemi di consegna ed elaborazione degli eventi
- Problemi di configurazione dei meter
- Errori di tipo e formattazione dei dati
- Problemi relativi all’ID cliente e all’autenticazione
Passaggi di debug
Durante la risoluzione dei problemi relativi alla fatturazione basata sull’utilizzo:- Verifica la consegna degli eventi nella scheda di analisi Events
- Controlla che la configurazione del meter corrisponda alla struttura degli eventi
- Convalida gli ID cliente e l’autenticazione API
- Esamina le condizioni di filtraggio e le impostazioni di aggregazione
Soluzioni e correzioni
Events not showing in meter
Events not showing in meter
- Il nome dell’evento non corrisponde esattamente alla configurazione del meter
- Le condizioni di filtraggio degli eventi escludono i tuoi eventi
- L’ID cliente non esiste nel tuo account Dodo Payments
- Il timestamp dell’evento è al di fuori del periodo di fatturazione corrente
- Verifica l’ortografia del nome dell’evento e la distinzione tra maiuscole e minuscole
- Esamina e testa le condizioni di filtraggio
- Conferma che l’ID cliente sia valido e attivo
- Controlla che i timestamp degli eventi siano recenti e formattati correttamente
Aggregation not working as expected
Aggregation not working as expected
- Il nome di Over Property non corrisponde alle chiavi dei metadati dell’evento
- I valori dei metadati hanno il tipo di dati errato (stringa invece di numero)
- Mancano proprietà dei metadati obbligatorie
- Assicurati che le chiavi dei metadati corrispondano esattamente all’impostazione Over Property
- Converti i numeri stringa in numeri reali nei tuoi eventi
- Includi tutte le proprietà obbligatorie in ogni evento
Filtering not working
Filtering not working
- I nomi delle proprietà del filtro non corrispondono ai metadati dell’evento
- Comparatore errato per il tipo di dati (stringa invece di numero)
- Distinzione tra maiuscole e minuscole nei confronti tra stringhe
- Verifica attentamente che i nomi delle proprietà corrispondano esattamente
- Usa comparatori appropriati per i tuoi tipi di dati
- Tieni conto della distinzione tra maiuscole e minuscole quando filtri le stringhe