Come misurare il churn in Chargebee

Il churn sembra un numero solo, ma in Chargebee è distribuito su diversi stati, eventi e impostazioni. Un abbonamento può avere una disdetta programmata ed essere ancora attivo. Può essere in pausa e non pagare nulla. Può essere disdetto per mancato pagamento anziché per scelta. Se non decidi prima come conta ogni caso, due persone del tuo team calcoleranno due tassi di churn diversi dagli stessi dati.

Questa guida mostra come costruire una misura chiara del churn da Chargebee Billing: quali stati ed eventi usare, come separare il churn volontario da quello involontario e come gestire pause e riattivazioni. Si attiene alla documentazione di Chargebee: Subscription Cancellation, l’API Cancel a subscription, i tipi di evento, le API List events e List subscriptions, Reason Codes e Pause Subscription (tutti consultati a novembre 2026).

Parti dai report di Chargebee

Chargebee ha report integrati, compreso un report standard Subscriptions. Usalo per primo, e leggi in quella pagina come è definito ogni dato prima di confrontarlo con qualsiasi altra cosa. Questa guida si concentra sul costruire una tua misura a partire dai dati di Chargebee, che ti serve quando vuoi il churn collegato all’utilizzo del prodotto, al canale di iscrizione o ai motivi di disdetta nel tuo data warehouse.

Gli stati che contano

Stato Chargebee	Perso?	Perché
`in_trial`	Non ancora un cliente pagante	Misura la conversione delle prove separatamente
`active`	No	Paga
`non_renewing`	Non ancora	Disdetta programmata a fine periodo; ancora attivo
`paused`	No, ma non paga	Tienilo separato
`cancelled`	Sì	Terminato

La riga non_renewing è quella che i team sbagliano. Secondo l’API Cancel a subscription, una disdetta a fine periodo porta l’abbonamento a non_renewing e imposta a 0 i cicli di fatturazione rimanenti. Può ancora essere salvato con “Remove scheduled cancellation”. Contalo come churn alla data in cui diventa cancelled, non il giorno in cui il cliente ha cliccato.

Gli eventi che contano

I tipi di evento di Chargebee ti danno un registro con timestamp di ogni transizione:

Evento	Usalo per
`subscription_created`	Nuovi abbonamenti
`subscription_cancellation_scheduled`	Disdette programmate (indicatore anticipatore)
`subscription_cancellation_reminder`	Inviato 6 giorni prima di una disdetta programmata
`subscription_cancelled`	Churn, alla data di effetto
`subscription_reactivated`	Clienti tornati dopo aver disdetto
`subscription_paused`, `subscription_resumed`	Periodi di pausa
`subscription_pause_scheduled`	Pause programmate per più avanti

Puoi riceverli come webhook, o recuperare lo storico tramite l’API List events. Per una prima analisi, recuperare gli eventi degli ultimi dodici mesi è spesso il modo più rapido per avere una base di riferimento.

Una nota sull’ortografia: il riferimento degli eventi di Chargebee usa subscription_cancelled con due L, mentre alcune sue altre pagine scrivono “canceled”. Usa la stringa esatta che vedi nei tuoi payload.

Churn volontario e involontario

Richiedono soluzioni diverse, quindi separali fin dal primo giorno.

Involontario: il riferimento dei tipi di evento dice che subscription_cancelled porta un cancel_reason quando la disdetta è stata causata da mancato pagamento o da una carta mancante. Queste sono le tue perdite per pagamenti falliti.
Volontario: disdette senza quel motivo di sistema, che di solito portano un cancel_reason_code dai Reason Codes che hai configurato.

Rendi obbligatori i codici di motivo per le disdette dall’app e dal portale. Secondo la documentazione di Chargebee, quando i codici di motivo sono obbligatori, anche l’API di disdetta deve ricevere un cancel_reason_code. Così ogni disdetta volontaria ha un motivo, e puoi riportare il churn per motivo senza tirare a indovinare.

Un punto pratico dalla documentazione sulla disdetta: cancel_reason_code potrebbe non essere incluso quando recuperi un abbonamento non-renewing, a meno che tu non attivi l’impostazione a livello di sito corrispondente. Attivala, o ricava il motivo dall’evento subscription_cancellation_scheduled.

Pause

La pagina Pause Subscription di Chargebee dice che i rinnovi si fermano mentre un abbonamento è in pausa. Un cliente in pausa non paga e non se n’è andato.

Scegli una regola e mantienila:

Escludi gli abbonamenti in pausa sia dalla base iniziale sia dal churn, e riporta il numero di abbonamenti in pausa accanto al tasso di churn. È la scelta più comune.
Se una pausa finisce con una disdetta, conta il churn alla data della disdetta come per qualsiasi altro caso.

Qualunque cosa tu scelga, non lasciare che le pause abbassino in silenzio il tuo tasso di churn. Un’offerta di pausa che si limita a rimandare la disdetta deve prima o poi comparire come churn.

Riattivazioni

Un cliente che disdice e poi si riattiva (subscription_reactivated) resta churn nel mese in cui se n’è andato. Conta la riattivazione separatamente, come clienti recuperati o riattivati, invece di sottrarla dal churn passato. Riscrivere i mesi passati rende illeggibili le tendenze.

Un calcolo mensile del churn

Con gli stati e gli eventi qui sopra, un tasso di churn dei clienti per un mese:

Base iniziale: abbonamenti active o non_renewing alle 00:00 del primo giorno del mese (escludi in_trial, e paused se è la tua regola). L’API List subscriptions ti dà lo stato attuale; per una data passata, ricostruisci lo stato dagli eventi.
Persi: abbonamenti di quella base con un evento subscription_cancelled nel corso del mese.
Tasso di churn dei clienti: persi diviso base iniziale.
Suddivisione: lo stesso rapporto per l’involontario (cancel_reason di sistema) e il volontario (con cancel_reason_code), che sommati danno il totale.

I nuovi abbonamenti creati durante il mese non sono nella base iniziale, quindi le loro disdette nel mese vengono riportate separatamente o escluse. Metti per iscritto quale delle due.

Per il churn dei ricavi, sostituisci i conteggi con l’importo ricorrente mensile di ogni abbonamento a inizio mese (piani annuali divisi per 12). Riporta la contrazione da downgrade separatamente dalle disdette.

Indicatori anticipatori

Il churn è un numero in ritardo. Questi si muovono prima:

Disdette programmate (subscription_cancellation_scheduled) questo mese, soprattutto per i piani annuali.
Salvataggi dei non-renewing: abbonamenti che escono da non_renewing senza essere disdetti.
Rinnovi falliti non ancora recuperati.
Pause avviate, e la quota di pause che finiscono con una disdetta.

Errori comuni

Contare il churn al clic. La data della disdetta è quando l’abbonamento diventa cancelled, non quando è diventato non_renewing.
Mescolare le prove nella base. Le prove che non si convertono sono un problema di conversione, non churn.
Un unico numero aggregato. Senza la suddivisione tra volontario e involontario, non puoi capire se correggere i tuoi solleciti o il tuo prodotto.
Pause silenziose. Escludere gli abbonamenti in pausa senza riportarli nasconde un gruppo crescente di clienti che non pagano.

Mantieni stabili le definizioni

Metti per iscritto le tue definizioni: cosa conta come base, quando si data il churn, come si trattano pause, prove, riattivazioni e durate contrattuali. Cambiale di rado e, quando lo fai, ricalcola lo storico. Un tasso di churn è utile soprattutto confrontato con sé stesso.

Farlo con NoChurn

Abbonamenti, disdette e report di Chargebee restano in Chargebee. NoChurn legge i tuoi eventi Chargebee, separa il churn volontario da quello involontario, registra il motivo dal suo flusso di disdetta (dove la disdetta è sempre a un clic) e dà a ogni cliente un punteggio di churn da 0 a 100. Puoi inviare via API i tuoi dati di prodotto per vedere quali attributi sono correlati al churn, e se colleghi un help desk, le conversazioni con il supporto vengono lette per il punteggio e gli insight. Vedi NoChurn + Chargebee.