Limitazioni della misurazione e FAQ
Che cos'è il Metering, in parole semplici?
Quando un cliente acquista un'offerta SaaS su Microsoft Marketplace, di solito paga una tariffa mensile fissa. Ma alcune offerte addebitano anche i costi in base all'utilizzo effettivo — ad esempio email inviate, chiamate API effettuate o GB di dati elaborati. Questo è chiamato fatturazione a consumo.
Il funzionamento è semplice: la sua piattaforma (il software dell'ISV) tiene traccia di quanto il cliente utilizza il servizio e, ogni volta che l'utilizzo supera la quantità inclusa, invia un report a Microsoft dicendo "questo cliente ha utilizzato X unità di Y." Microsoft quindi fattura al cliente quell'utilizzo extra.
Quel report viene inviato tramite la Metering Service API. E quella API ha regole specifiche su come e quando è possibile inviare tali report.
L'unica regola che deve conoscere
Quasi tutto ciò che riguarda la metering API si riduce a una sola regola:
📌 La regola d'oro È possibile inviare UN solo report di utilizzo per sottoscrizione cliente, per metrica di fatturazione, per ogni ora di calendario. Se si tenta di inviarne un secondo per la stessa combinazione nella stessa ora, viene rifiutato come duplicato. |
|---|
Questo è tutto. Tutto il resto è solo una variazione di questa regola.
Che cosa significa realmente "per sottoscrizione + per metrica + per ora"?
Sottoscrizione = un ordine di un cliente. Ogni ordine ha un ID univoco.
Metrica (dimensione) = l'elemento per cui viene effettuata la fatturazione (ad esempio emails_sent, api_calls, storage_gb). Ogni offerta può averne più di una.
Ora di calendario = ad esempio 08:00–08:59 corrisponde a un'ora. Alle 09:00 inizia una nuova finestra temporale.
Quindi la regola si applica a una combinazione specifica di tutti e tre gli elementi. Se ne cambia anche solo uno, si tratta di una finestra completamente separata.
Quindi cosa posso inviare?
✅ Due report per clienti diversi — nessun problema
Se il Cliente A e il Cliente B hanno entrambi sottoscrizioni attive, è possibile inviare un report per entrambi esattamente nello stesso momento. Hanno ID di sottoscrizione diversi, quindi sono completamente indipendenti. Potrebbe inviare report per 100 clienti diversi simultaneamente.
✅ Due report per metriche diverse — nessun problema
Se la sua offerta ha due dimensioni di fatturazione (ad esempio emails_sent e api_calls), è possibile inviare un report per entrambe nello stesso minuto. Metriche diverse = finestre diverse. Nessun conflitto.
✅ Due report per lo stesso cliente, stessa metrica, ore diverse — va bene
Se invia un report per l'utilizzo email del Cliente A alle 08:55 e poi un altro alle 09:05 — va bene. Si tratta di due ore di calendario diverse, quindi sono finestre separate.
❌ Due report per lo stesso cliente, stessa metrica, stessa ora — rifiutati
Se invia un report per l'utilizzo email del Cliente A alle 08:10 e poi un altro alle 08:45 per la stessa metrica — il secondo verrà rifiutato. Ha già occupato quella finestra.
💡 Il modo corretto di gestire questa situazione Non invii ogni evento di utilizzo nel momento in cui si verifica. Al contrario, raccolga e sommi tutto l'utilizzo nell'arco di un'ora, quindi invii un unico report alla fine di quell'ora con il totale. È anche ciò che Microsoft consiglia. |
|---|
Solo sottoscrizioni attive
È possibile inviare report di utilizzo solo per sottoscrizioni attualmente attive. Microsoft rifiuterà gli eventi per sottoscrizioni che sono:
• Annullate / con sottoscrizione annullata
• Sospese
• Ancora in attesa di attivazione (PendingFulfillmentStart)
L'unica eccezione: se un cliente annulla oggi, è comunque possibile inviare report di utilizzo per il periodo precedente all'annullamento — purché venga fatto entro la finestra di 24 ore.
Scenari comuni a colpo d'occhio
Situazione | Risultato | Motivo |
|---|---|---|
Due eventi per lo stesso ordine, stesso contatore, a distanza di 5 minuti (stessa ora) | ❌ Rifiutato | Stessa ora: combinare in un unico evento |
Due eventi per lo stesso ordine, stesso contatore, ore diverse (ad es. 8:50 e 9:05) | ✅ Accettato | Ore diverse, nessun conflitto |
Due eventi per lo stesso ordine, contatori diversi, stessa ora | ✅ Accettato | Dimensioni diverse sono indipendenti |
Due eventi per ordini diversi (sottoscrizioni), stesso contatore, stessa ora | ✅ Accettato | Sottoscrizioni diverse = nessun conflitto |
Evento per una sottoscrizione annullata o sospesa | ❌ Rifiutato | Sono accettate solo le sottoscrizioni attive (Subscribed) |