ForHosting KIT · Entwickler-Tools

Gewichtete durchschnittliche Produktbewertung berechnen

Wandeln Sie eine Fünf-Sterne-Verteilung in die beiden wichtigsten Kennzahlen für Käufer und E-Commerce-Teams um: die gewichtete Durchschnittsbewertung und die Gesamtzahl der Rezensionen.

● BetaKostenlos · im Browser
Nutzen Sie es über WebAPIE-MailTelegramApp bald

Geben Sie für jede Stufe von einem bis fünf Sternen die jeweilige Anzahl ein. Der Rechner multipliziert jede Anzahl mit ihrem Sternwert, addiert die gewichteten Werte und teilt die Summe durch die vollständige Rezensionenzahl. Zusätzlich werden alle Gruppen zur exakten Gesamtzahl addiert. Die Berechnung ist deterministisch, benötigt keine Produktkennung und weist eine leere Verteilung zurück, statt eine irreführende Nullbewertung anzuzeigen.

Geben Sie die vollständige Bewertungsverteilung ein

Beginnen Sie mit den fünf Anzahlen aus Ihrem Shop, einem Marktplatzexport, einem Bewertungsdienst oder Ihrer Berichtsdatenbank. Tragen Sie die Zahl der Ein-Stern-Rezensionen in das erste Feld ein und verfahren Sie ebenso mit zwei, drei, vier und fünf Sternen. Die Werte müssen ganze Zahlen ab null sein, da sie tatsächliche Rezensionen und keine Prozentwerte oder bereits berechnete Note darstellen. Gruppen ohne Rezensionen tragen Sie als null ein; lassen Sie sie nicht weg. Die Berechnung eignet sich sowohl für einen neuen Artikel mit einer einzigen Rezension als auch für ein etabliertes Angebot mit Millionen Bewertungen, sofern jede Anzahl im sicheren Ganzzahlbereich liegt. Verwenden Sie Daten desselben Produkts, desselben Variantenumfangs, desselben Kanals und desselben Berichtszeitpunkts. Eine historische Fünf-Sterne-Anzahl mit einer monatlichen Ein-Stern-Anzahl zu mischen, ergibt zwar eine mathematisch gültige Zahl, beschreibt aber keine reale Grundgesamtheit. Liefert Ihre Quelle nur Prozentwerte, beschaffen Sie nach Möglichkeit die zugrunde liegenden Anzahlen, denn gerundete Prozente ergeben nicht immer die tatsächliche Gesamtsumme. Senden Sie anschließend alle fünf zueinander passenden Werte gemeinsam als eine Verteilung.

Verstehen Sie die gewichtete Berechnung

Ein einfacher Mittelwert der fünf Gruppenanzahlen würde die falsche Frage beantworten. Der Rechner gewichtet jede Gruppe mit ihrem Sternwert: Eine Ein-Stern-Rezension steuert einen Punkt bei, eine Zwei-Sterne-Rezension zwei Punkte und so weiter bis zu fünf Punkten für jede Fünf-Sterne-Rezension. Diese Beiträge werden zu einer gewichteten Punktzahl addiert und anschließend durch die Gesamtzahl aller Rezensionen geteilt. Zehn Fünf-Sterne-Rezensionen wirken sich beispielsweise fünfmal so stark aus wie zehn Ein-Stern-Rezensionen, weil sie fünfzig statt zehn Punkte beitragen. Der ausgegebene Durchschnitt wird auf höchstens sechs Nachkommastellen gerundet. Dadurch bleibt das Ergebnis stabil und zugleich wesentlich genauer als eine typische Shopanzeige. Die Gesamtzahl der Rezensionen wird separat ausgegeben und niemals aus dem Durchschnitt abgeleitet. Sind alle fünf Anzahlen null, existiert keine Grundgesamtheit und folglich kein definierter gewichteter Mittelwert. In diesem Fall meldet die Funktion eine ungültige Eingabe, statt eine Bewertung von null Sternen zu erfinden, die als echte Kundenmeinung missverstanden werden könnte.

Verwenden Sie das Ergebnis einheitlich

Die Durchschnittsbewertung eignet sich für Qualitätskontrollen im Katalog, interne Dashboards, die Anreicherung von Produktfeeds, Marktplatzabgleiche und Anzeigeregeln. Legen Sie unabhängig davon fest, wie Ihr Shop sie darstellt: mit einer Nachkommastelle, zwei Nachkommastellen oder als grafisch gefüllte Sterne, während Sie den präziseren Wert für Vergleiche aufbewahren. Führen Sie die Gesamtzahl stets neben dem Durchschnitt, denn Aussagekraft und geschäftliche Bedeutung unterscheiden sich erheblich zwischen einer Bewertung aus zwei Rezensionen und derselben Bewertung aus zwanzigtausend. Berechnen Sie beim Kanalvergleich zunächst jeden Kanal aus seinen eigenen fünf Gruppen. Für eine kanalübergreifende Bewertung addieren Sie zuerst die jeweils gleichen Sterngruppen und verarbeiten dann die kombinierte Verteilung; ein direkter Mittelwert der Kanaldurchschnitte kann einem Kanal mit wenigen Rezensionen zu viel Gewicht geben. Bewahren Sie in automatisierten Abläufen den Quellzeitpunkt und den Produktschlüssel zusammen mit dem Ergebnis auf, auch wenn sie keine Eingaben dieser Berechnung sind. Die Browsernutzung ist kostenlos, eine API-Anfrage kostet $0.002. Dieselbe deterministische Arithmetik liefert bei gleichen Anzahlen stets dieselben Werte.

Zusammenfassung im Shop erstellen

Wandeln Sie die fünf gespeicherten Bewertungsgruppen eines Produkts in den Durchschnitt und die anzuzeigende Gesamtzahl um.

Marktplatzberichte prüfen

Berechnen Sie eine gemeldete Bewertung aus exportierten Anzahlen neu und erkennen Sie Zusammenfassungen, die nicht zur Verteilung passen.

Bewertungskanäle zusammenführen

Addieren Sie entsprechende Sterngruppen aus mehreren Kanälen und berechnen Sie eine korrekt gewichtete Gesamtbewertung.

Was kostet die Berechnung?

Auf dieser Seite können Sie sie kostenlos im Browser ausführen. Jede API-Anfrage kostet $0.002.

Warum darf ich nicht fünfmal null eingeben?

Eine Grundgesamtheit ohne Rezensionen besitzt keinen definierten Durchschnitt. Null würde fälschlich den Eindruck erwecken, Kunden hätten null Sterne vergeben.

Darf eine Sternanzahl eine Dezimalzahl sein?

Nein. Die Anzahlen stehen für einzelne Rezensionen und müssen nichtnegative ganze Zahlen sein.

Wie wird der Durchschnitt gerundet?

Das Ergebnis wird für eine stabile und genaue Ausgabe auf höchstens sechs Nachkommastellen gerundet. Ihr Shop kann es für die Anzeige anders runden.

Wie führe ich Bewertungen mehrerer Shops zusammen?

Addieren Sie zunächst alle Ein-Stern-Anzahlen, danach alle Zwei-Sterne-Anzahlen und so weiter. Berechnen Sie aus diesen fünf kombinierten Gruppen die Bewertung, statt die Shopdurchschnitte zu mitteln.

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

POSThttps://api.kit.forhosting.com/ecom/review-rating-average

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

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"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

HTTPCodeBedeutung
401unauthorizedDer API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
402insufficient_balanceIhr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
404unknown_typeUnbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
429rate_limitedZu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →