ForHosting KIT · Strumenti per sviluppatori

Calcolare la valutazione media ponderata di un prodotto

Trasformi la distribuzione delle recensioni su cinque stelle nei due dati più utili per acquirenti e team e-commerce: la valutazione media ponderata e il numero totale di recensioni.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Inserisca il conteggio registrato per ciascun livello, da una a cinque stelle. Il calcolatore moltiplica ogni quantità per il relativo valore in stelle, somma i punteggi ponderati e divide per il totale completo delle recensioni. Inoltre, somma tutte le fasce per restituire il numero esatto di giudizi rappresentati. Il calcolo è deterministico, non richiede identificativi di prodotto e rifiuta una distribuzione vuota, evitando di mostrare uno zero fuorviante.

Inserisca la distribuzione completa delle valutazioni

Parta dai cinque conteggi forniti dal Suo negozio, dall’esportazione del marketplace, dal servizio di recensioni o dal database di reportistica. Inserisca il numero di recensioni da una stella nel primo campo, quindi ripeta l’operazione per due, tre, quattro e cinque stelle. I conteggi devono essere numeri interi maggiori o uguali a zero, perché rappresentano recensioni effettive e non percentuali o un punteggio già calcolato. Indichi zero per le fasce prive di recensioni; non le ometta. Il calcolo è adatto sia a un nuovo articolo con una sola recensione sia a un prodotto affermato con milioni di giudizi, purché ogni quantità resti nell’intervallo degli interi sicuri. Utilizzi dati riferiti allo stesso prodotto, allo stesso insieme di varianti, allo stesso canale e allo stesso momento di rilevazione. Mescolare un conteggio storico di cinque stelle con un conteggio mensile di una stella produce un risultato matematicamente valido, ma privo di una popolazione reale di riferimento. Se la fonte fornisce soltanto percentuali, recuperi quando possibile i conteggi originali, poiché percentuali arrotondate potrebbero non ricostruire il vero totale. Invii insieme i cinque valori compatibili come un’unica distribuzione.

Comprenda il calcolo ponderato

Una semplice media dei cinque conteggi risponderebbe alla domanda sbagliata. Il calcolatore assegna a ogni fascia il suo valore in stelle: ogni recensione da una stella contribuisce con un punto, ogni recensione da due stelle con due punti e così via, fino ai cinque punti di ciascuna recensione da cinque stelle. Somma quindi questi contributi per ottenere il punteggio ponderato e lo divide per il numero complessivo di recensioni in tutte le fasce. Per esempio, dieci recensioni da cinque stelle incidono cinque volte più di dieci recensioni da una stella, perché apportano cinquanta punti anziché dieci. La media restituita viene arrotondata a un massimo di sei cifre decimali, assicurando stabilità e una precisione superiore a quella normalmente mostrata in vetrina. Il totale viene restituito separatamente e non è mai dedotto dalla media. Se tutti e cinque i conteggi sono zero, non esiste una popolazione e la media ponderata non è definita. In questo caso la capacità segnala un input non valido anziché creare una valutazione di zero stelle che potrebbe essere scambiata per un autentico giudizio dei clienti.

Utilizzi il risultato in modo coerente

La valutazione media è adatta ai controlli di qualità del catalogo, ai dashboard interni, all’arricchimento dei feed, alla riconciliazione con i marketplace e alle regole di visualizzazione. Stabilisca separatamente come presentarla nel Suo negozio: può mostrare una cifra decimale, due cifre o un riempimento grafico delle stelle, conservando il valore più preciso per i confronti. Mantenga sempre il totale delle recensioni accanto alla media, perché l’affidabilità e il significato commerciale cambiano nettamente tra una valutazione basata su due giudizi e la stessa valutazione basata su ventimila. Nel confronto tra canali, calcoli prima ciascun canale usando le proprie cinque fasce. Per ottenere una valutazione complessiva, sommi prima i conteggi corrispondenti e poi elabori la distribuzione combinata; fare direttamente la media delle medie può attribuire troppo peso a un canale con pochissime recensioni. Nei processi automatizzati, conservi il timestamp della fonte e la chiave del prodotto insieme al risultato, anche se non sono input del calcolo. L’uso nel browser è gratuito, mentre ogni richiesta API costa $0.002. La stessa aritmetica deterministica garantisce che gli stessi conteggi producano sempre gli stessi risultati.

Creare un riepilogo per la vetrina

Converta le cinque fasce memorizzate per un prodotto nella media e nel totale da mostrare accanto al nome.

Verificare i report dei marketplace

Ricalcoli una valutazione dai conteggi esportati e individui i riepiloghi che non corrispondono alla distribuzione.

Unire più canali di recensioni

Sommi le fasce equivalenti di più canali e calcoli una valutazione correttamente ponderata per l’intera popolazione.

Quanto costa il calcolo?

Può eseguirlo gratuitamente nel browser su questa pagina. Ogni richiesta API costa $0.002.

Perché non posso inviare cinque conteggi pari a zero?

Una popolazione senza recensioni non ha una media definita. Restituire zero suggerirebbe erroneamente che i clienti abbiano assegnato una valutazione di zero stelle.

Un conteggio può contenere decimali?

No. I conteggi rappresentano singole recensioni e devono essere numeri interi non negativi.

Come viene arrotondata la media?

Il risultato viene arrotondato a un massimo di sei cifre decimali per garantire precisione e stabilità. Il Suo negozio può applicare un diverso arrotondamento visivo.

Come posso unire le valutazioni di più negozi?

Sommi separatamente tutti i conteggi da una stella, poi quelli da due e così via. Calcoli quindi la valutazione con le cinque fasce combinate, senza fare la media delle medie dei negozi.

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/ecom/review-rating-average

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/ecom/review-rating-average \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"one_star_count":4,"two_star_count":6,"three_star_count":10,"four_star_count":30,"five_star_count":50}'
{
  "one_star_count": 4,
  "two_star_count": 6,
  "three_star_count": 10,
  "four_star_count": 30,
  "five_star_count": 50
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "ecom.review_rating_average",
  "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 →