ForHosting KIT · Strumenti per sviluppatori

Calcolo del punteggio di salute del cliente

Il calcolatore della salute dell’account cliente riunisce quattro segnali comuni in un punteggio trasparente da 0 a 100.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Inserisca valori normalizzati per utilizzo del prodotto, ticket di assistenza, NPS e storico dei pagamenti, quindi assegni l’influenza percentuale di ciascun segnale. Lo strumento verifica che i pesi totalizzino esattamente 100%, applica una media ponderata e restituisce sia il risultato complessivo sia ogni singolo contributo. In questo modo Lei può spiegare, riprodurre e usare il risultato con coerenza nei processi di customer success.

Prepari segnali cliente confrontabili

Inizi esprimendo utilizzo, ticket di assistenza, NPS e storico dei pagamenti sulla stessa scala da 0 a 100. Un valore elevato deve indicare sempre un account più sano. Potrebbe quindi essere necessario trasformare l’attività di assistenza prima dell’inserimento: escalation frequenti e irrisolte devono produrre un punteggio più basso, mentre risoluzioni rapide e problemi poco gravi devono produrne uno più alto. Anche l’NPS inserito è un segnale di salute normalizzato, non il valore grezzo del sondaggio compreso tra -100 e 100. Definisca ogni segnale a monte e applichi la stessa definizione a tutti gli account e periodi di rendicontazione. La coerenza conta più di una precisione apparente. L’utilizzo, per esempio, può combinare tasso di utenti attivi, adozione delle funzionalità e frequenza recente delle sessioni; lo storico dei pagamenti può riflettere puntualità e saldo scaduto. Documenti tali regole affinché due analisti ottengano gli stessi dati iniziali. Il calcolatore non deduce né corregge i punteggi di origine, perché trasformazioni nascoste renderebbero difficile verificare il risultato complessivo. Combina esclusivamente i valori forniti e mostra ogni contributo ponderato.

Scelga i pesi e comprenda la formula

Assegni a ogni segnale un peso percentuale in base all’influenza desiderata sulla salute dell’account. I quattro pesi devono totalizzare esattamente 100%. Il calcolatore moltiplica ciascun punteggio per il relativo peso, divide per 100 e somma i quattro contributi. Se l’utilizzo vale 80 e ha un peso del 40%, il suo contributo è di 32 punti. È consentito un peso pari a zero quando un segnale è temporaneamente irrilevante, ma i pesi restanti devono comunque totalizzare 100%. La convalida evita un comune errore dei fogli di calcolo, nel quale percentuali mancanti o duplicate aumentano o riducono il risultato senza essere notate. La risposta elenca il punteggio inserito, il peso e il contributo ponderato di ogni segnale, così Lei può controllare l’aritmetica. I risultati sono arrotondati a quattro cifre decimali per rendere stabile l’automazione senza perdere precisione utile. Al punteggio viene inoltre associata una fascia semplice: sano da 80 in su, da monitorare da 60 fino a meno di 80 e a rischio sotto 60. Consideri queste fasce come riferimenti operativi iniziali, quindi adatti le regole di escalation al ciclo di vita dei Suoi clienti.

Usi il punteggio responsabilmente nelle attività

Un punteggio composito di salute è soprattutto uno strumento coerente per stabilire priorità, non un sostituto del contesto dell’account. Applichi la stessa formula con cadenza regolare e confronti sia il risultato generale sia i contributi sottostanti. Un totale stabile può nascondere movimenti opposti, come una migliore adozione del prodotto insieme a un peggioramento dei pagamenti. Il dettaglio aiuta il responsabile del customer success a individuare il segnale che ha causato il cambiamento e a scegliere un intervento adeguato. Conservi definizioni degli input, pesi e risultato in ogni rilevazione, affinché i confronti storici rimangano significativi quando il modello cambia. Se modifica i pesi, valuti di ricalcolare i periodi precedenti o di indicare chiaramente una nuova versione; altrimenti, una tendenza potrebbe riflettere la metodologia anziché il comportamento del cliente. Confronti le soglie con risultati reali quali rinnovo, espansione, riduzione o abbandono e aggiorni le definizioni iniziali quando i dati lo giustificano. L’API costa $0.002 per calcolo, mentre la versione nel browser è adatta ai controlli individuali. Nessuna modalità contatta servizi esterni e input identici producono sempre risultati identici.

Definisca le priorità del customer success

Ordini gli account con una misura composita coerente ed esamini il contributo più basso prima di scegliere un intervento.

Monitori un portafoglio di rinnovi

Ricalcoli periodicamente la salute degli account e segnali variazioni rilevanti prima delle trattative di rinnovo.

Uniformi i report per la direzione

Applichi tra i team un modello di ponderazione documentato, conservando il dettaglio necessario a spiegare ogni risultato.

Quale formula utilizza il calcolatore?

Moltiplica ogni punteggio normalizzato per il relativo peso percentuale, divide per 100 e somma i quattro contributi ponderati.

Cosa accade se i pesi non totalizzano 100%?

Il calcolo restituisce un errore di input non valido e indica il totale ricevuto. Non viene prodotto alcun punteggio composito.

Posso inserire un NPS grezzo inferiore a zero?

No. Prima dell’uso, converta l’NPS grezzo in un segnale di salute normalizzato da 0 a 100.

Come vengono assegnate le fasce di salute?

I punteggi da 80 in su sono sani, da 60 a meno di 80 richiedono attenzione e sotto 60 sono a rischio.

Un segnale può avere un peso pari a zero?

Sì. Ogni punteggio e peso può variare da 0 a 100, purché i quattro pesi totalizzino 100%.

Quanto costa un calcolo tramite API?

Ogni calcolo tramite API costa $0.002. Il calcolatore nel browser è disponibile per verifiche individuali.

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

POSThttps://api.kit.forhosting.com/biz/customer-health-score-calc

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

curl -X POST https://api.kit.forhosting.com/biz/customer-health-score-calc \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usage_score":82,"usage_weight":35,"support_tickets_score":68,"support_tickets_weight":20,"nps_score":74,"nps_weight":25,"payment_history_score":95,"payment_history_weight":20}'
{
  "usage_score": 82,
  "usage_weight": 35,
  "support_tickets_score": 68,
  "support_tickets_weight": 20,
  "nps_score": 74,
  "nps_weight": 25,
  "payment_history_score": 95,
  "payment_history_weight": 20
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "biz.customer_health_score_calc",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →