1. Startseite
  2. Blog
  3. Fehlendes Feld „aggregateRating“ und andere Fehler bei strukturierten Daten
  • SEO
  • 9 Min. Lesezeit

Fehlendes Feld „aggregateRating“ und andere Fehler bei strukturierten Daten

Die Warnung „Fehlendes Feld aggregateRating“ bedeutet, dass im Produkt-Schema die optionale Bewertungsangabe fehlt. Sie verhindert keine Rich-Suchergebnisse, und das Feld sollte nur ergänzt werden, wenn die Seite echte Bewertungen zeigt. In diesem Ratgeber erklären wir häufige Fehler bei strukturierten Daten im Test für Rich-Suchergebnisse und im Schema Markup Validator – und wie Sie sie beheben.

By meomanWordPress seit 2008

Syntaxfehler und Formatierungsprobleme in JSON-LD

Zum Testen strukturierter Daten nutzen Sie den Test für Rich-Suchergebnisse von Google (search.google.com/test/rich-results) und den Schema Markup Validator (validator.schema.org); das alte Test-Tool für strukturierte Daten wurde eingestellt. Rote Fehler verhindern Rich-Suchergebnisse, gelbe Warnungen wie das fehlende Feld „aggregateRating“ betreffen dagegen optionale Felder. JSON-LD reagiert sehr empfindlich auf Zeichenfehler: Ein einziges vergessenes Komma oder eine überzählige geschweifte Klammer kann den ganzen Block unlesbar machen.

Bei technischen Audits zeigt sich oft: Typografische Anführungszeichen (curly quotes) verhindern, dass Bots die Daten auswerten können. Gerade Anführungszeichen sind Pflicht. Werden in großen Datensätzen Arrays nicht korrekt mit eckigen Klammern geschlossen, brechen Crawler die Daten zudem mittendrin ab. Aktuelle Bot-Algorithmen nehmen Seiten mit solchen Syntaxfehlern sofort aus dem Pool der Rich-Suchergebnisse.

Bei der Fehlersuche sollte der Rohcode durch einen Validator laufen. Selbst Kommentarzeilen im Code können die JSON-Struktur mitunter zerstören. Wer in Blöcken mit strukturierten Daten auf Kommentare verzichtet und sich auf reine Datenobjekte beschränkt, minimiert die Fehlerquote – ein professioneller Ansatz.

  • Prüfen, ob in JSON-LD-Codeblöcken zwischen den Schlüssel-Wert-Paaren Kommas stehen und nach dem letzten Paar keins.
  • Sicherstellen, dass alle Textwerte in doppelten Anführungszeichen (") stehen.
  • Sicherstellen, dass die geschweiften Klammern ({ }) am Ende des Codes hierarchisch zueinander passen.
FehlerartHäufige UrsacheWirkungLösungPrüftool
Parsing-FehlerFehlendes Komma oder AnführungszeichenKritisch (Daten nicht lesbar)JSON-LD-Format validierenSchema Validator
Fehlendes FeldPflichteigenschaft fehltHoch (kein Rich Snippet)Fehlende Eigenschaften im Code ergänzenRich Results Test
Falscher DatentypFalsches Format verwendetMittel (löst Warnung aus)In ISO-Standard umwandelnSearch Console
RichtlinienverstoßMarkup für versteckte InhalteKritisch (manuelle Maßnahme)Nur sichtbare Inhalte auszeichnenGoogle-Richtlinien
HierarchiefehlerFalsche VerschachtelungMittel (getrennte Daten)Objekte mit @id verknüpfenClass-specific Test

Fehlende Felder: Pflicht- und empfohlene Eigenschaften

Schemas für strukturierte Daten legen für bestimmte Objekttypen „erforderliche“ (required) und „empfohlene“ (recommended) Eigenschaften fest. Fehlen in einem „Product“-Schema beispielsweise die Felder 'name' und 'offers' (der Abschnitt mit den Preisangaben), zeigen Test-Tools einen roten Fehler. Solange diese Fehler bestehen, erscheint Ihre Seite in den Google-Suchergebnissen nicht mit Rich-Elementen wie Sternebewertungen oder Preisangaben.

Fehlende empfohlene Felder erscheinen meist als gelbe Warnung. Diese Warnungen verhindern Rich-Suchergebnisse zwar nicht vollständig, erschweren es der Suchmaschine aber, die Seite vollständig zu verstehen. Empfohlene Felder wie 'brand' und 'sku' lassen sich leicht ergänzen; 'aggregateRating' sollte dagegen nur hinzugefügt werden, wenn auf der Seite echte Nutzerbewertungen sichtbar sind – Bewertungen auszuzeichnen, die auf der Seite nicht vorkommen, verstößt gegen die Google-Richtlinien.

Um fehlende Felder zu beheben, sollten Sie prüfen, wie Ihr Theme oder Plugin die Daten abruft. Fehlt in einem Artikel-Schema das Feld 'author', sollte dieser Wert dynamisch aus der Datenbank gelesen und in den JSON-LD-Block aufgenommen werden. Bleiben diese Felder bei der Dateneingabe leer, leidet Ihre technische SEO-Performance direkt.

  • Die Felder 'price', 'priceCurrency' und 'availability' in Product-Schemas prüfen.
  • Die Eigenschaften 'author', 'datePublished' und 'headline' in Article-Schemas ergänzen.
  • In LocalBusiness-Schemas die Angaben 'address' und 'telephone' vollständig eintragen.

Anforderungen je nach Schema-Typ

Jeder Inhaltstyp benötigt andere Daten. Bei Rezepten sind Name und Bild Pflicht, ein Event-Schema braucht dagegen Startdatum und Veranstaltungsort.

  • Beim Recipe-Schema die Felder 'image' und 'recipeIngredient' prüfen.
  • Beim Event-Schema die 'address'-Angaben im Objekt 'location' eintragen.
  • Beim SoftwareApplication-Schema die Angabe 'operatingSystem' definieren.

Falsche Datentypen und Werte

In strukturierten Daten akzeptiert jede Eigenschaft einen bestimmten Datentyp (String, Number, Boolean, Date usw.). Steht in einem Preisfeld etwa „150 TL“ statt nur „150“, wird der Wert als Text statt als Zahl gelesen und ein Fehler ausgegeben. Ebenso verhindern Datumsangaben, die nicht dem Standard ISO 8601 (JJJJ-MM-TT) entsprechen, kalenderbasierte Rich-Suchergebnisse.

Suchmaschinen prüfen Unstimmigkeiten zwischen Datentypen inzwischen strenger. Für den Lagerstatus eines Produkts ist statt eines Textes wie „Auf Lager“ das vom Schema erwartete URL-Format „https://schema.org/InStock“ nötig. Falsche URL-Strukturen oder ungültige Verweise auf Schema-Typen zerstören den semantischen Kontext der Daten und führen Suchmaschinen-Bots in die Irre.

Zur Behebung müssen Sie jede Eigenschaft mit dem in der Schema-Dokumentation erwarteten Typ abgleichen. Gerade in Onlineshops gerät bei Massenaktualisierungen häufig Text in numerische Felder. Um solche Fehler zu vermeiden, sollten bei der Datenausgabe Funktionen zur Typumwandlung (type casting) eingesetzt werden.

  • Datumsangaben im Format ISO 8601 ausgeben, z. B. '2023-05-20'.
  • Texteinheiten (TL, $, Punkte) aus numerischen Werten wie Preisen und Bewertungen entfernen.
  • Boolesche Werte (true/false) ohne Anführungszeichen verwenden.
Passende LeistungTechnische SEO für WordPress

Widersprüche zwischen Inhalt und Schema-Daten

Die strengste Regel in den Richtlinien von Google und anderen Suchmaschinen zu strukturierten Daten lautet: Was im Schema steht, muss auch auf der Seite für Nutzer sichtbar sein. Strukturierte Daten, die Nutzer nicht sehen und die nur für Bots eingefügt werden (etwa in versteckten divs), gelten als „irreführende Inhalte“. Das kann dazu führen, dass die Funktionen für strukturierte Daten Ihrer Website deaktiviert werden – bis hin zu einer manuellen Maßnahme.

Ein häufiger Fehler, vor allem bei Preisänderungen oder Lagerbewegungen: Der Text auf der Seite wird aktualisiert, der JSON-LD-Code bleibt aber veraltet. Sieht ein Suchmaschinen-Bot auf dem Bildschirm 500 TL, im Code aber 400 TL, stuft er die Daten als unzuverlässig ein. Da Vertrauenssignale im Zentrum von SEO stehen, schaden solche Widersprüche auch dem Ruf Ihrer Marke.

Die Lösung: Schema-Daten direkt aus den Variablen erzeugen, aus denen auch der Seiteninhalt entsteht. Manuell eingegebener Schema-Code birgt immer das Risiko von Fehlern und Widersprüchen. Mit einer dynamischen Struktur fließen die Daten aus dem Content-Management-System (CMS) gleichzeitig in HTML und JSON-LD-Blöcke ein.

  • Der Preis im Schema stimmt exakt mit dem Preis auf der Seite überein.
  • Anzahl der Bewertungen und Durchschnittsnote passen zu den Nutzerbewertungen.
  • Der Lagerstatus der Produkte wird mit Echtzeitdaten synchronisiert.

Falsch konfigurierte verschachtelte Objekte (Nested Elements)

In strukturierten Daten sind Objekte meist miteinander verbunden. Ein „Product“-Objekt enthält Unterobjekte wie „Offer“ und „AggregateRating“. Werden diese Objekte hierarchisch falsch platziert oder nicht sauber per @id verknüpft, erscheinen sie in Test-Tools getrennt oder unvollständig. Gerade bei komplexen Seitenstrukturen geht leicht der Überblick verloren, welches Objekt wohin gehört.

Bei fortgeschrittenen Schema-Umsetzungen verbessert die gegenseitige Referenzierung von Objekten über die Eigenschaft @id die Lesbarkeit und Genauigkeit des Codes. Statt ein Autorenobjekt etwa an mehreren Stellen der Seite zu definieren, legen Sie es einmal an und rufen es an anderen Stellen per ID auf – das reduziert technische Fehler. Falsche Verschachtelung führt dazu, dass Bots das Hauptobjekt (Main Entity) nicht erkennen.

Hilfreich ist es, sich die Schema-Struktur wie ein Baumdiagramm vorzustellen. Das Hauptobjekt steht ganz oben, alle zugehörigen Eigenschaften und Unterobjekte bilden die Äste dieses Stamms. Prüfen Sie mit der Visualisierung der Test-Tools regelmäßig, ob die Verbindungen zwischen den Objekten intakt sind.

  • Das Objekt 'Offer' immer innerhalb von 'Product' oder 'Service' definieren.
  • Den position-Wert jedes 'ListItem' in einer 'BreadcrumbList' prüfen.
  • Die logische Beziehung zwischen Unterobjekten und Hauptobjekt mit @type klarstellen.

5 wichtige Tools zur Prüfung strukturierter Daten

Um Fehler in strukturierten Daten zu finden und zu beheben, sind professionelle Tools unverzichtbar. Die von Webentwicklern und SEO-Fachleuten am häufigsten genutzten Tools prüfen sowohl die Syntax des Codes als auch die Einhaltung der Google-Richtlinien. Jedes Tool setzt einen anderen Schwerpunkt; für ein gründliches Audit empfiehlt sich die Kombination.

Die Tools von Google zielen direkt auf die Darstellung in den Suchergebnissen, der Validator von Schema.org bietet dagegen eine breitere semantische Prüfung. Um Fehler schnell zu finden, sollten Sie den Zeilenangaben der Tools folgen. Die folgende Liste enthält die wirksamsten Lösungen, um die Fehlerquote in technischen SEO-Prozessen auf null zu senken.

  • Google Rich Results Test: Prüft, ob die Seite für Rich-Suchergebnisse infrage kommt.
  • Schema Markup Validator: Prüft die allgemeine Konformität mit den Schema-Standards.
  • Bing URL Inspection: Analysiert strukturierte Daten für die Suchmaschine Microsoft Bing.
  • Merkle Schema Generator: Erzeugt fertige Codeblöcke, die das Fehlerrisiko senken.
  • Yandex Webmaster Validator: Validiert Daten für alternative Suchmaschinen.

Probleme mit strukturierten Daten bei dynamischen Inhalten

Moderne Websites laden Inhalte häufig dynamisch mit JavaScript-Frameworks wie React, Vue oder Angular. Werden strukturierte Daten erst nach dem Laden der Seite per JavaScript in das DOM eingefügt, können Suchmaschinen-Bots sie mitunter nicht erfassen. Die Folge: In der Google Search Console erscheint „keine Daten gefunden“, obwohl der Code in Test-Tools sichtbar ist.

Auch wenn die Bots von Google JavaScript sehr gut ausführen, bevorzugen sie zur Optimierung des Crawl-Budgets weiterhin Daten im statischen HTML. Entscheidend ist, dass dynamisch erzeugte JSON-LD-Blöcke direkt nach dem Rendern für Bots zugänglich sind. Schemas, die an verzögert geladene Inhalte (Lazy Load) gebunden sind, haben oft Probleme mit der Indexierung.

Abhilfe schaffen Server-Side Rendering (SSR) oder Hydration. Am sichersten ist es, strukturierte Daten auf dem Server zu erzeugen und direkt in den HTML-Quelltext einzubetten. Ist eine clientseitige Einbindung unvermeidlich, muss sichergestellt sein, dass die Daten vor dem Ereignis 'DOMContentLoaded' bereitstehen.

  • Kritische strukturierte Daten serverseitig (SSR) erzeugen und ins HTML ausgeben.
  • Per JavaScript eingefügte Schemas im Bereich 'Rendered HTML' aus Sicht des Googlebot prüfen.
  • Sicherstellen, dass Verzögerungen bei API-Daten die Erzeugung der strukturierten Daten nicht verhindern.

Quelle: Allgemeine Richtlinien von Google für strukturierte Daten

Häufige Fragen

1. Senken Fehler in strukturierten Daten direkt mein Ranking?

Fehler sind kein direkter Rankingfaktor. Der Verlust von Rich-Suchergebnissen senkt aber die Klickrate und kann so indirekt Ihren Traffic und Ihre Autorität verringern.

2. Müssen (gelbe) Warnungen unbedingt behoben werden?

Warnungen verhindern keine Rich-Suchergebnisse. Für eine umfassendere Sichtbarkeit in Suchmaschinen ist es aber immer sinnvoll, die empfohlenen Felder auszufüllen.

3. Wie behebe ich die Warnung „Fehlendes Feld aggregateRating“?

Hat das Produkt echte Nutzerbewertungen, ergänzen Sie aggregateRating mit ratingValue und reviewCount. Gibt es keine Bewertungen, verhindert diese optionale Warnung keine Rich-Suchergebnisse – Sie können sie ignorieren.

4. Wo finde ich das Test-Tool für strukturierte Daten von Google?

Das alte Test-Tool für strukturierte Daten wurde eingestellt. An seine Stelle treten der Test für Rich-Suchergebnisse von Google und der Schema Markup Validator von Schema.org (validator.schema.org).

5. Wann aktualisiert Google die Seite, nachdem ich die Fehler behoben habe?

Klicken Sie nach der Fehlerbehebung in der Search Console auf „Fehlerbehebung überprüfen“; Google crawlt Ihre Seiten dann innerhalb von einigen Tagen bis einigen Wochen erneut.

Strukturierte Daten regelmäßig zu testen und von Syntax- und Logikfehlern zu befreien, ist ein grundlegender Schritt für eine nachhaltige Online-Präsenz. Eine technisch saubere Schema-Struktur hilft Suchmaschinen, Ihre Website besser zu verstehen als die Ihrer Mitbewerber.

Kurz gesagt
Wer Fehler in strukturierten Daten behebt, stärkt das technische SEO-Fundament seiner Website und erscheint in den Suchergebnissen auffälliger und informativer. Nach heutigen Standards ist eine fehlerfreie Schema-Struktur nicht nur für Bots, sondern auch für das Vertrauen der Nutzer unverzichtbar.