Vai al contenuto principale
I meter convertono gli eventi grezzi in quantità fatturabili. Filtrano gli eventi e applicano funzioni di aggregazione (Count, Sum, Max, Last) per calcolare l’utilizzo per cliente.
Interfaccia di creazione del misuratore che mostra il nome dell'evento, il tipo di aggregazione e le opzioni di filtraggio

​
Risorse API

Create Meter

Crea contatori in modo programmatico tramite API.

List Meters

Recupera tutti i contatori nel tuo account.

Get Meter

Recupera i dettagli di uno specifico contatore tramite ID.

Archive Meter

Archivia un contatore per interrompere il monitoraggio dell’utilizzo.

Unarchive Meter

Ripristina un contatore archiviato per riprendere il monitoraggio.

​
Creazione di un Misuratore

1

Basic Information

​
string
obbligatorio
Un nome descrittivo per il meter (ad es. “Richieste API”, “Utilizzo dei token”).
​
string
obbligatorio
Il nome esatto dell’evento da trovare (con distinzione tra maiuscole e minuscole). Esempi: api.call, image.generated.
2

Aggregation

​
string
obbligatorio
Scegli come vengono aggregati gli eventi:
  • Count: numero totale di eventi (chiamate API, caricamenti)
  • Sum: somma dei valori numerici (token, byte)
  • Max: valore più alto nel periodo (utenti di picco)
  • Last: valore più recente
​
string
La chiave dei metadati da aggregare (obbligatoria per Sum, Max e Last). Esempi: tokens, bytes, duration_ms.
​
string
obbligatorio
L’etichetta dell’unità per fatture e report. Esempi: calls, tokens, GB, hours.
3

Filtering (Optional)

Interfaccia di filtraggio degli eventi con logica AND/OR e operatori di confronto
Aggiungi condizioni per filtrare quali eventi vengono conteggiati:
  • Logica AND: Tutte le condizioni devono corrispondere
  • Logica OR: Qualsiasi condizione può corrispondere
Comparatori disponibili: uguale, diverso, maggiore di, maggiore o uguale a, minore di, minore o uguale a, contiene, non contiene.Abilita il filtraggio, scegli la logica, quindi aggiungi condizioni con una chiave della proprietà, un comparatore e un valore.
4

Create

Verifica la configurazione e fai clic su Crea meter.

​
Visualizzazione Analitiche

Dashboard di analisi del meter con panoramica dell'utilizzo, eventi e dati dei clienti
La dashboard del meter mostra:
  • Panoramica: utilizzo totale e tendenze dell’utilizzo nel tempo
  • Eventi: singoli eventi ricevuti e relativi metadati
  • Clienti: totali e addebiti dell’utilizzo per cliente

​
Fatturazione in crediti invece che in valuta

Per impostazione predefinita, i meter addebitano ai clienti un importo per unità in dollari (o nella valuta configurata). In alternativa, puoi configurare un meter affinché detragga dal saldo dei crediti del cliente, in modo che l’utilizzo consumi crediti invece di generare un addebito monetario.
La detrazione basata sui crediti richiede un Credit Entitlement associato allo stesso prodotto. Crea prima il credit entitlement, quindi collegalo al meter.

​
Quando usare la deduzione basata sui crediti

​
Configurare un contatore per dedurre crediti

1

Create a Credit Entitlement

Per prima cosa, crea un credit entitlement in Products → Credits. Definisci l’unità (ad es. “Chiamate API”, “Token”), la precisione e le impostazioni del ciclo di vita (scadenza, riporto, eccedenza).Consulta la Guida alla fatturazione basata sui crediti per istruzioni dettagliate.
2

Create or Edit a Usage-Based Product

Vai al tuo prodotto basato sull’utilizzo e apri la sezione di configurazione del Contatore.
3

Add a Meter

Fai clic sul pulsante + per collegare un contatore. Configura il nome dell’evento, il tipo di aggregazione e l’unità di misura come sempre.
4

Enable 'Bill Usage in Credits'

Attiva Bill usage in Credits nella configurazione del meter per visualizzare le impostazioni dei crediti:
Configurazione del misuratore con l'opzione Fattura utilizzo in Crediti abilitata

Toggle 'Bill usage in Credits' to switch from currency-based to credit-based deduction.

​
string
obbligatorio
Seleziona da quale credit entitlement deve detrarre questo meter.
​
number
obbligatorio
Il numero di unità di utilizzo necessario per dedurre 1 credito. Ad esempio:
  • 1 = ogni evento del contatore deduce 1 credito
  • 100 = 100 eventi del contatore deducono 1 credito
  • 1000 = 1.000 chiamate API consumano 1 credito
5

Free Threshold and Credits

La Free Threshold si applica ai meter fatturati in denaro, non ai meter fatturati in crediti. Quando un meter fattura in crediti, ogni unità contribuisce alla detrazione dei crediti.Esempio: con un rapporto di 1 unità del meter per credito, a un cliente che effettua 2.500 chiamate API vengono detratti 2.500 crediti.

​
Come funziona la deduzione dei crediti

Una volta configurata, la pipeline di deduzione viene eseguita automaticamente:
  1. Arrivano gli eventi — La tua applicazione invia gli eventi di utilizzo tramite Event Ingestion API.
  2. Il meter aggrega — Gli eventi vengono aggregati in base alla configurazione del meter (Count, Sum, Max, Last).
  3. Il worker in background elabora — Ogni minuto, un worker recupera i nuovi eventi dall’ultimo checkpoint.
  4. I crediti vengono detratti — L’utilizzo aggregato viene convertito in crediti utilizzando il tasso meter_units_per_credit e detratto secondo l’ordine FIFO (vengono utilizzate per prime le concessioni con scadenza più vicina).
  5. L’eccedenza viene registrata — Se il saldo raggiunge zero, l’utilizzo successivo viene registrato come eccedenza e gestito in base al comportamento configurato (condonato al reset, fatturato alla fattura successiva o riportato come deficit). Dodo Payments non blocca l’utilizzo quando il saldo si esaurisce. Per interrompere l’accesso a saldo zero, verifica il saldo nella tua applicazione.
La detrazione dei crediti viene eseguita in modo asincrono (ogni ~1 minuto). Potrebbe verificarsi un breve ritardo tra l’acquisizione dell’evento e la detrazione dal saldo. Progetta la tua applicazione per gestire questo ritardo e non fare affidamento sui controlli del saldo in tempo reale per il controllo dell’accesso alle singole richieste.

​
Più contatori, un unico pool di crediti

Puoi collegare più meter dello stesso prodotto allo stesso credit entitlement. Tutti i meter detraggono da un unico saldo condiviso. Esempio: una piattaforma AI con due meter:
  • text.generation — 1 credito ogni 1.000 token
  • image.generation — 10 crediti per immagine
Entrambi deducono dallo stesso pool “AI Credits”. Il cliente vede un unico saldo unificato nel portale.
Usa tassi meter_units_per_credit differenti tra i contatori per esprimere costi relativi. Le operazioni costose (generazione di immagini) richiedono meno unità del contatore per credito rispetto a quelle economiche (completamento di testo).

List Customer Ledger

Visualizza l’intera cronologia di deduzione dei crediti per un cliente.

Get Customer Balance

Controlla il saldo di crediti attuale di un cliente tramite API.

​
Risoluzione dei problemi

  • Il nome dell’evento deve corrispondere esattamente (con distinzione tra maiuscole e minuscole)
  • Verifica che i filtri del meter non escludano gli eventi
  • Verifica che gli ID cliente esistano nel tuo account
  • Disabilita temporaneamente i filtri per eseguire un test
  • Verifica che Over Property corrisponda esattamente alla chiave dei metadati
  • Usa numeri, non stringhe: tokens: 150 non tokens: "150"
  • Includi le proprietà obbligatorie in tutti gli eventi
  • Rispetta esattamente maiuscole e minuscole
  • Usa gli operatori corretti per il tipo di dati
  • Assicurati che gli eventi includano le proprietà filtrate
  • Controlla la scheda Events per contare gli eventi effettivamente ricevuti
  • Verifica il tipo di aggregazione (Count rispetto a Sum)
  • Assicurati che i valori siano numerici per Sum e Max

​
Prossimi passi

Send Events

Inizia a inviare eventi di utilizzo dalla tua applicazione ai contatori.

View Blueprints

Usa configurazioni di contatori preconfezionate per casi d’uso comuni.
Ultima modifica il 26 settembre 2026