Scarto del KPI dall'obiettivo: valore assoluto e percentuale
Il calcolatore dello scarto del KPI trasforma due valori in una misura chiara della distanza tra la prestazione attuale e l'obiettivo stabilito.
Esegui gratis nel browser
Inserisca il KPI corrente e il target per ottenere la differenza assoluta e, se richiesto, la stessa differenza in percentuale rispetto all'obiettivo. È adatto a ricavi, conversioni, servizi, produzione, qualità e altri indicatori numerici, senza presupporre una particolare unità o un modello aziendale.
Legga lo scarto assoluto nell'unità propria del KPI
Lo scarto assoluto è l'ampiezza della differenza tra il valore attuale e l'obiettivo. Il calcolatore sottrae un valore dall'altro e usa il risultato assoluto, quindi l'uscita non è mai negativa. Se i ricavi ricorrenti mensili attuali sono 72 e il target è 90, lo scarto assoluto è 18 nella stessa unità utilizzata per gli input. Se la prestazione ha già superato l'obiettivo, il risultato continua a mostrare la distanza tra i due valori, senza definirla un deficit. Questa distinzione è importante quando il calcolo alimenta un cruscotto: il numero misura la separazione, mentre il rapporto deve indicare se il valore corrente si trova sopra o sotto il target. Mantenga entrambi gli input nella stessa unità e scala. Non confronti una percentuale espressa come 0.72 con un target espresso come 90, né dollari con migliaia di dollari. Input coerenti rendono lo scarto subito utilizzabile in previsioni, scorecard, avvisi e revisioni dei progressi.
Comprenda il calcolo dello scarto percentuale
Quando l'uscita percentuale è attiva, il calcolatore divide lo scarto assoluto per il valore assoluto del target e moltiplica il risultato per 100. Con i valori precedenti, 18 diviso 90 produce uno scarto del 20 per cento. Prendere l'obiettivo come riferimento facilita il confronto tra KPI con scale diverse: una distanza di 10 può essere minima rispetto a un target di 1,000, ma rilevante rispetto a 25. Il denominatore usa l'ampiezza del target; pertanto anche un obiettivo negativo produce una percentuale non negativa che rappresenta la distanza relativa alla sua dimensione. Un target pari a zero non può fungere da denominatore. Per questo motivo, richiedere una percentuale con obiettivo zero restituisce un errore di input anziché infinito o un segnaposto fuorviante. Se per quel KPI è significativa solo la differenza assoluta, disattivi l'uscita percentuale. La risposta ometterà il relativo campo e restituirà normalmente lo scarto assoluto.
Utilizzi il risultato in modo coerente nei report
Definisca il KPI, il periodo di misurazione, l'unità e il target prima di calcolare lo scarto. Un valore settimanale va confrontato con un obiettivo settimanale e una percentuale netta deve usare la stessa rappresentazione su entrambi i lati. Il risultato è deterministico, quindi è adatto a report programmati, sostituzioni di fogli di calcolo, pipeline di dati e controlli automatici. Conservi i due valori di origine insieme al risultato, affinché chi esegue la revisione possa riprodurre il calcolo e comprendere successive modifiche del target. Poiché l'operazione restituisce un'ampiezza, aggiunga una regola di stato separata quando la direzione conta. Per un KPI in cui un valore maggiore è migliore, confronti corrente e target per indicare se è inferiore, raggiunto o superato; se un valore minore è preferibile, inverta la regola. Non interpreti lo scarto percentuale come crescita necessaria quando intervengono capitalizzazione, variazioni dei tassi o rapporti non lineari. È una differenza relativa diretta dal target, non una previsione delle azioni necessarie per colmarla.
Casi d'uso
Monitorare le prestazioni commerciali
Confronti ricavi, prenotazioni o unità vendute con l'obiettivo del periodo e pubblichi una misura coerente dello scarto.
Controllare i livelli operativi
Misuri quanto un KPI di risposta, produttività o qualità dista dal target concordato.
Uniformare i cruscotti direzionali
Calcoli scarti percentuali comparabili per KPI con unità e scale diverse, mantenendo ogni differenza assoluta.
Domande frequenti
Come viene calcolato lo scarto assoluto?
È il valore assoluto di target_value meno current_value, quindi il risultato è sempre zero o positivo.
Come viene calcolato lo scarto percentuale?
Lo scarto assoluto viene diviso per il valore assoluto del target e moltiplicato per 100.
Che cosa accade quando il target è zero?
Un obiettivo zero genera un errore se viene richiesta la percentuale, perché la divisione per zero non è definita. Disattivi la percentuale per calcolare solo lo scarto assoluto.
Il risultato indica se la prestazione è sopra o sotto il target?
No. Il calcolatore restituisce l'ampiezza dello scarto. Confronti separatamente valore corrente e obiettivo se necessita della direzione o di uno stato.
Posso usare valori KPI negativi?
Sì. Entrambi gli input possono essere numeri finiti negativi. La percentuale usa come denominatore l'ampiezza assoluta del target.
Quanto costa un calcolo tramite API?
Ogni richiesta API costa $0.002. Lo stesso calcolo deterministico è disponibile anche nel browser.
Per sviluppatori — accesso via API
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.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/biz/kpi-target-gap-calc \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"current_value":72,"target_value":90}'const res = await fetch("https://api.kit.forhosting.com/biz/kpi-target-gap-calc", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"current_value": 72,
"target_value": 90
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/biz/kpi-target-gap-calc",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"current_value": 72,
"target_value": 90
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/biz/kpi-target-gap-calc", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"current_value":72,"target_value":90}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"current_value":72,"target_value":90}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/biz/kpi-target-gap-calc", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"current_value": 72,
"target_value": 90
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "biz.kpi_target_gap_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.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |