Als ich zum ersten Mal einer Client-Site Schema-Markup hinzufügte, tippte ich handgetippt a Product Block in den Theme-Header, setzte ihn ein und ging schlau weiter. Zwei Wochen später teilte mir der Rich Results Test mit, dass das Angebotsobjekt fehlte @type„Der Preis war eine Zahl, bei der Google eine Zeichenfolge wollte, und ein verirrtes Nachlaufkomma hatte den gesamten Block stillschweigend ungültig gemacht. Google hatte es die ganze Zeit ignoriert. Das ist die Sache, vor der Sie niemand mit strukturierten Daten warnt: Ungültiges JSON-LD wirft keinen Fehler und färbt nichts rot. Es tut einfach stillschweigend nichts, und Sie erfahren Monate später, dass das reiche Ergebnis, auf das Sie gezählt haben, nie auftaucht.
Der Wortschatz selbst wird unter veröffentlicht schema.orgUnd was Google tatsächlich als reichhaltiges Ergebnis zeigen wird, ist eine engere Liste in seinem Strukturierte Datendokumentationdrohen
Ich baue Tools für meinen Lebensunterhalt - Toolz.dev, das WP Adminify Plugin, einen Stapel Laravel und React Apps - und strukturierte Daten sind eine dieser Aufgaben, die ich oft genug mache, um es mir zu übeln, es von Hand zu tun, und selten genug, um jedes Mal die genauen Eigenschaftsnamen zu vergessen Also habe ich das gebaut Schema-Markup-Generator Die beiden Fehlermodi zu entfernen, die mich am meisten gekostet haben: falsche Verschachtelung und stille Invalidität Dieser Leitfaden geht durch, was Schema-Markup tatsächlich bewirkt, wie der Generator es aufbaut und welche spezifischen Fehler gültig aussehende Markups davon abhalten, reiche Ergebnisse zu erzielen.
tl; dr: Schema-Markup sind strukturierte Daten (unter Verwendung des Schema.org-Vokabulars), die Suchmaschinen genau sagen, worum es auf einer Seite geht, und sie so für umfangreiche Ergebnisse wie FAQ-Akkordeons, Produktpreise und Brotkrumen geeignet machen. Google empfiehlt das JSON-LD-Format - ein eigenständiges Format
<script type="application/ld+json">Block. Der Generator baut gültiges JSON-LD für neun gängige Typen, nistet Unterobjekte wiePostalAddressundOfferRichtig, Flags fehlen erforderliche und empfohlene Felder und läuft zu 100% in Ihrem Browser, sodass nichts, was Sie eingeben, hochgeladen wird.
Was ist Schema-Markup und warum ist es wichtig?
Schema Markup ist eine standardisierte Art, den Inhalt einer Seite zu beschreiben, damit Maschinen ihn verstehen und nicht nur rendern können. Das Vokabular stammt von schema.org, einem gemeinsamen Projekt, das von Google, Microsoft, Yahoo und Yandex unterstützt wird Wenn Sie eine Seite als markieren ArticleSie sagen es einer Suchmaschine " Dies ist ein Nachrichten- oder Blogartikel, hier ist die Überschrift, hier ist, wer es geschrieben hat, hier ist, wann es veröffentlicht wurde. " Diese strukturierte Beschreibung macht eine Seite für umfangreiche Ergebnisse geeignet - die erweiterten Einträge mit Sternebewertungen, Preisen, FAQ-Dropdowns, Veranstaltungsterminen und Breadcrumb-Trails, die mehr Platz beanspruchen und mehr Klicks verdienen als ein einfacher blauer Link.
Der Grund, warum es darauf ankommt, hat sich in den letzten Jahren geändert Früher ging es bei Google rein um reichhaltige Ergebnisse Jetzt speisen strukturierte Daten auch AI-Antwort-Engines und Google' s AI-Übersichten Wenn ChatGPT, Perplexity oder Gemini versuchen zusammenzufassen, was Ihr Unternehmen tut oder welches Produkt mit einer Abfrage übereinstimmt, sind sauber strukturierte Daten eines der Signale, die ihnen helfen, die Fakten richtig zu machen Eine Seite, die sich eindeutig als eine deklariert Organization Mit einem Namen, einem Logo und sozialen Profilen ist es für jede Maschine weitaus einfacher, darüber nachzudenken, als wenn alles im HTML enthalten bleibt.
Der Haken ist, dass strukturierte Daten unversöhnlich sind Es ist Code, und Code muss genau stimmen Eine Eigenschaft geschrieben datePublish anstelle datePublished Wird einfach ignoriert An Offer Ohne ein @type Wird nicht als Angebot erkannt Und weil keiner dieser Fehler die sichtbare Seite durchbricht, verstecken sie sich unbegrenzt in der ProduktionDas ist die Lücke, die ein Generator füllt - nicht die Konzepte für Sie zu schreiben, sondern jedes Mal die Syntax und Struktur richtig zu machen.
Warum JSON-LD statt Microdata oder RDFa?
Es gibt drei Möglichkeiten, einer Seite Schema-.org-Daten hinzuzufügen, und es hilft zu verstehen, warum der Generator nur eine davon produziert.
Mikrodaten und RDFa Die strukturierten Daten mit Hilfe von Extra-Attributen direkt in Ihr sichtbares HTML einweben - itemscope, itemprop, propertyUnd so weiter. Dein <div> Für eine Produktbewertung erhält Attribute, die jedes Stück sichtbaren Textes beschriften. Dies funktioniert, koppelt Ihr Markup jedoch eng an Ihre Seitenstruktur. Ändern Sie das Layout und Sie riskieren, das Schema zu durchbrechen. Es ist außerdem ausführlich und schwer zu lesen.
JSON-LD Geht den umgekehrten Weg Es legt alle strukturierten Daten in einem einzigen in sich geschlossenen <script type="application/ld+json"> Block, meist in der <head>Ganz getrennt vom sichtbaren HTML. Google hat JSON-LD seit Jahren gerade wegen dieser Trennung empfohlen: Man kann es hinzufügen, aktualisieren, oder durch einen Tag-Manager einspritzen, ohne seine Vorlagen zu berühren Es ist das Format, das jedes moderne Schema-Tutorial lehrt, und es ist das, was der Generator ausgibt.
| Format | Wo es lebt | Wartungsfreundlichkeit | Google's Haltung |
|---|---|---|---|
| JSON-LD | Single <script> Block, getrennt von HTML |
Einfachste - bearbeiten Sie einen Block | empfohlen |
| Mikrodaten | Attribute im sichtbaren HTML | Härter - gekoppelt an Layout | unterstützt |
| RDFa | Attribute im sichtbaren HTML | Härter - gekoppelt an Layout | unterstützt |
Wenn Sie in WordPress arbeiten, ist JSON-LD auch das, was die meisten SEO-Plugins injizieren, und was ein Tool wie WP Adminify sauber daneben sitzt Weil es ein eigenständiger Block ist, können Sie ihn hier generieren und in ein benutzerdefiniertes HTML-Feld, einen Tag-Manager oder ein Laravel Blade-Layout ohne Rahmen-spezifische Gymnastik einfügen.
Wie verwende ich den Schema Markup Generator?
Der Workflow basiert auf der Auswahl eines Typs und dem Ausfüllen eines Kurzformulars mit einer Live-Vorschau, sodass Sie beim Tippen das JSON-LD-Assembly sehen.
Schritt 1 - Wählen Sie einen Schematyp. Pick aus Organisation, LocalBusiness, WebSite, Artikel, Produkt, FAQPage, BreadcrumbList, Person, oder Event Das Formular wechselt sofort zu den Feldern, die diese Art benötigt Diese neun decken die überwältigende Mehrheit dessen ab, wofür kleine und mittlere Websites tatsächlich Markup benötigen.
Schritt 2 - Füllen Sie die Felder aus. Erforderliche Felder sind mit einem Sternchen gekennzeichnet. Während Sie eingeben, baut das Tool das JSON-LD zusammen und lässt jedes Feld fallen, das Sie leer lassen, sodass Sie nie leer bleiben "" Eigenschaften, die die Ausgabe verschmutzen Bei adressbasierten Typen wie LocalBusiness und Event werden die einzelnen Adressfelder in eine ordnungsgemäß eingegebene Datei gefaltet PostalAddress Objekt automatisch.
Schritt 3 - Beobachten Sie die Validierung. Der Generator markiert zwei Arten von Problemen Fehler (fehlende erforderliche Felder, fehlerhafte URLs) blockieren ein sauberes Ergebnis und werden rot angezeigt. Warnungen (fehlende von Google empfohlene Felder wie image oder datePublished, oder eine Such-URL-Vorlage, die ihren Platzhalter verfehlt) werden in Bernstein angezeigt - das Markup ist immer noch gültig, aber Sie hinterlassen Potenzial für reichhaltige Ergebnisse auf der Tabelle.
Schritt 4 - Kopieren und Bereitstellen. Wechseln Sie zwischen den vollen <script> Tag (bereit zum Einfügen in Ihr <head>) und das rohe JSON (für Tag-Manager und CMS-Felder).Die Skriptausgabe entgeht den Zeichen, die sonst einen Streuner loslassen würden </script> In Ihrem Datenbruch die Seite Anschließend validieren Sie die Live-Seite mit Google' s Rich Results Test.
Da alles clientseitig läuft, ist dies sicher auf unveröffentlichten Produktseiten, Staging-Umgebungen und Client-Arbeit unter NDA zu verwenden. Ihre Preise, Ereignisdetails und internen URLs verlassen den Browser nie - die gleiche Datenschutzhaltung hinter jedem Tool auf der Website, über die ich geschrieben habe Datenschutz-Leitfadendrohen
Welche Schematypen sollte ich eigentlich verwenden?
Nicht jede Seite braucht Markup, und das Anhäufen von Typen, die Sie nicht unterstützen können, ist schlimmer als keine. So denke ich über die neun, die der Generator abdeckt.
Organisation Gehört auf Ihre Homepage oder eine About-Seite - es ist das Schema, das Wissenspanels füttert und Google dabei hilft, Ihre Marke mit seinen sozialen Profilen zu verbinden sameAsdrohen WebSite Paart sich damit und kann eine Sitelinks-Suchbox über a deklarieren SearchActionDamit Benutzer Ihre Website direkt von der Ergebnisseite aus durchsuchen können. LocalBusiness Wenn Sie einen physischen Standort haben, ist dies unerlässlich: Es enthält Ihre Adresse, Ihr Telefon, Ihre Preisspanne und Ihre Öffnungszeiten und untermauert die lokalen Paket- und Kartenergebnisse.
Artikel (mit dem der Generator emittiert Article Typ, der auch für Blogbeiträge gilt) markiert redaktionelle Inhalte mit einer Überschrift, einem Autor, einem Herausgeber und Veröffentlichungsterminen. Produkt Etwas zum Verkauf beschreibt, mit einem verschachtelten Offer Transportpreis, Währung und Verfügbarkeit - das macht Preis- und Verfügbarkeitsausschnitte möglich. Veranstaltung Deckt alles mit Datum und Ort ab, von einer Konferenz bis zu einem Webinar.
FAQSeite und Brotkrumenliste Strukturell sind und nicht über ein & quot;thing." FAQPage markiert Frage-und-Antwort-Inhalte; Beachten Sie, dass Google die FAQ-reichen Ergebnisse auf maßgebliche Regierungs- und Gesundheitsseiten eingegrenzt hat, aber das Markup hilft anderen Suchmaschinen und KI-Antwortmaschinen immer noch dabei, Ihre Frage-und-Antwort-Marke zu analysieren; A. BreadcrumList erstellt den unter Ihrem Titel angezeigten Breadcrumb-Trail in den Ergebnissen, der die Lesart Ihrer URL-Struktur verbessert. Person Markiert eine Person - einen Autor, Gründer oder eine Persönlichkeit des öffentlichen Lebens - und ist nützlich für Autorenbios und EET-Signale.
Die Regel, die ich befolge: Markieren Sie, worum es auf der Seite wirklich geht, und beanspruchen Sie nur Eigenschaften, die tatsächlich auf der Seite sichtbare Inhalte widerspiegeln. Die Richtlinien von Google's sehen ausdrücklich vor, dass strukturierte Daten reale, sichtbare Inhalte beschreiben müssen - die Markierung eines Preises, der nicht auf der Seite erscheint, stellt einen Verstoß und keine Abkürzung dar.
Wie hält der Generator den Markup gültig?
Der Wert liegt in den Details, die man leicht von Hand falsch machen kann Ein paar, die es wert sind, angerufen zu werden.
Korrekte Verschachtelung mit @typedrohen In JSON-LD sind verschachtelte Objekte keine einfachen Unterobjekte - jedes braucht sein eigenes @type. Eine Adresse ist ein PostalAddress, ein Angebot ist ein OfferEin Artikel's Autor ist ein PersonSein Herausgeber ist ein Organization Wessen Logo ist ein ImageObject. Der Generator baut jedes davon mit dem richtigen Typ, damit der Parser sie erkennt, anstatt sie als anonyme Blobs zu behandeln.
Beschneiden leert. Wenn Sie ein Feld leer lassen, sollte die Eigenschaft entfernt und nicht emittiert werden "telephone": "". Leere Zeichenfolgen und leere Arrays werden automatisch aus der Ausgabe entfernt, sodass das, was Sie kopieren, immer sauber ist.
Skriptsicheres Entkommen. Der gefährlichste Charakter in Inline-JSON-LD ist a < - konkret die Sequenz </script> In Ihren Daten erscheinen (z. B. in einer Beschreibung), was den Skriptblock vorzeitig beenden und die Seite unterbrechen würde. Der Generator entweicht <, >, und & In der Skript-Tag-Ausgabe mittels Unicode-Escapes, was genau Google' eigene Beispiele tun.
Erforderliche und empfohlene Sensibilisierung. Jeder Typ trägt seine eigene Liste dessen, was Google verlangt, im Vergleich zu Empfehlungen. Artikel will wirklich eine image und datePublished; Produkt will a price; Veranstaltung braucht a startDate. Das Tool unterscheidet harte Anforderungen (die es als Fehler behandelt) von Empfehlungen (Warnungen), sodass Sie den Unterschied zwischen & quot; dies wird nicht funktionieren" und " dies könnte besser funktionieren."
Wenn Sie einen breiteren technischen Workflow zusammenstellen, steht der Schemagenerator natürlich neben den anderen SEO-Dienstprogrammen - dem Meta-Tag-Generator Für Ihren Titel, Ihre Beschreibung und Ihre Open Graph-Tags und die XML-Sitemaps-Generator Für das Absenden Ihrer URLs. Zusammen decken sie den größten Teil der technischen SEO-Oberfläche auf der Seite ab, und ich habe sie aus diesem Grund in der gruppiert Web Developer Toolkit Übersichtdrohen
Wie teste und stelle ich strukturierte Daten bereit?
Das Generieren von gültigem JSON-LD ist die Hälfte der Arbeit; Die andere Hälfte bestätigt, dass Google es so liest, wie Sie es beabsichtigen.
Beginnen Sie mit Google's Rich-Ergebnisse-Test, die eine URL abruft oder eingefügten Code akzeptiert und meldet, für welche Rich-Result-Typen sich die Seite qualifiziert, plus etwaige Fehler oder Warnungen. Führen Sie dann das gleiche Markup durch die Schema-Markup-Validator Bei validator.schema.org, das die Konformität mit dem schema.org-Vokabular selbst und nicht mit Google' prüft, sind die Rich-Result-Anforderungen Die beiden fangen unterschiedliche Dinge: Der Rich Results Test sagt Ihnen, ob Sie sich für eine bestimmte Google-Funktion qualifizieren, während der Validator Ihnen sagt, ob das Markup strukturell ein solides Schema ist.org.
Sobald die Seite live ist, meldet sich die Verbesserung Google Search Console Track Leistung im Zeitverlauf und Flag Fehler Google findet während des Crawlens Hier fängt man Probleme, die nur in der Skala erscheinen - eine Vorlage, die doppelte Breadcrumb Positionen aussendet, sagen wir, oder ein Produktfeed, der gelegentlich ein erforderliches Feld weglässt.
Fügen Sie zur Bereitstellung die ein <script> Block in die <head> Von der spezifischen Seite, die es beschreibt Legen Sie keinen einzigen Produktblock in eine globale Vorlage, die auf jeder Seite läuft - das Markup muss mit der Seite übereinstimmen, auf der es lebt In einem CMS verwenden Sie das benutzerdefinierte HTML- oder SEO-Feld, das Ihnen die Plattform bietet Verwenden Sie in einem Tag-Manager ein benutzerdefiniertes HTML-Tag und kopieren Sie das JSON. In einer React- oder Laravel-App injizieren Sie die Blockserverseite, damit Crawler es im anfänglichen HTML sehen, und nicht nach der Flüssigkeitszufuhr.
Häufige Fehler, die ich immer noch sehe
Immer wieder tauchen eine Handvoll Fehler auf, und jeder von ihnen produziert Markup, der gut aussieht, aber nichts bewirkt.
Der Klassiker ist Unsichtbare Inhalte markieren - eine Bewertung oder einen Preis hinzufügen, der nirgendwo auf der Seite erscheint Google verbietet dies ausdrücklich und kann dafür eine manuelle Aktion ausgeben Die zweite ist Der falsche Typ auf einem verschachtelten ObjektMeist fehlt ein @type Auf einer Adresse oder einem Angebot Der dritte ist Ähnliche Typen miteinander verschmelzen(wie verwenden Product Markup auf einer Kategorie-Listing-Seite statt auf einem einzelnen Produkt Und das vierte, mein persönlicher Erzfeind, ist Ein Syntaxfehler aus der Handbearbeitung - ein nachlaufendes Komma oder ein nicht entweichendes Zitat, das den gesamten Block ungültig macht.
Jeder einzelne davon ist der Grund, warum ein Generator seinen Keep verdient Es kann nicht wissen, ob Ihr Preis auf der Seite sichtbar ist - das ist auf Ihnen - aber es wird niemals ein nachlaufendes Komma aussenden, ein fehlendes @type, oder eine leere Eigenschaft Das allein beseitigt die meisten Arten, wie strukturierte Daten stillschweigend ausfallen Für tieferen Hintergrund zu den Entwickler-Workflows rund um diese Art von Tools ist die Anleitung für die Coding-Tools gute Begleitung ist lesen.
Häufig gestellte Fragen
Was ist ein Schema-Markup?
Schema-Markup sind strukturierte Daten, die eine Seite beschreiben' s Inhalt an Suchmaschinen mit dem gemeinsamen Schema.org Vokabular Hinzufügen kann eine Seite für reichhaltige Ergebnisse wie FAQ Akkordeons, Produktpreise, Rezension Sterne, und Brotkrumen geeignet machen JSON-LD, das Format, das dieses Tool produziert, ist die Syntax, die Google empfiehlt, weil es in einem einzigen Skript-Tag getrennt von Ihrem sichtbaren HTML lebt.
Was ist der Unterschied zwischen JSON-LD, Microdata und RDFA?
Alle drei sind Möglichkeiten, um strukturierte Daten von schema.org zu einer Seite hinzuzufügen. Mikrodaten und RDFA sind Attribute, die in Ihr sichtbares HTML eingewebt sind, während JSON-LD ein eigenständiger Block von JSON in einem Skript-Tag ist. Google empfiehlt JSON-LD, da es einfacher ist, das Seitenmarkup hinzuzufügen, zu aktualisieren und zu halten. Dieses Tool gibt aus diesem Grund JSON-LD aus.
Wo stelle ich die generierte JSON-LD ein?
Fügen Sie das Ganze ein <script type="application/ld+json"> Tag in die <head> der Seite, die es beschreibt, oder irgendwo in der <body> - Google liest es an beiden Orten Wenn Sie Google Tag Manager verwenden, kopieren Sie den JSON und fügen Sie ihn durch ein Benutzerdefiniertes HTML-Tag hinzu. Platzieren Sie das Markup immer auf derselben Seite, deren Inhalt es beschreibt, und nicht auf einer Vorlage, die es überall anwendet.
Garantiert das Hinzufügen eines Schema-Markups umfangreiche Ergebnisse?
kein . Gültige strukturierte Daten machen eine Seite für reichhaltige Ergebnisse in Frage, Google entscheidet jedoch, ob sie auf der Grundlage von Qualität, Relevanz und eigenen Richtlinien angezeigt werden soll. Ihr Markup muss auch Inhalte widerspiegeln, die tatsächlich auf der Seite sichtbar sind. Stellen Sie sich das Schema als Voraussetzung für reichhaltige Ergebnisse vor, nicht als Schalter, der sie einschaltet.
Wie teste ich meine strukturierten Daten?
Führen Sie das generierte Markup durch Google' s Rich Results Test und den Schema Markup Validator (schema.org' s Validator) aus.Sowohl analysieren Sie Ihr JSON-LD und melden fehlende erforderliche Felder oder Syntaxfehler. Nachdem die Seite live ist, verfolgen die Google Search Console-Verbesserungsberichte, wie sich Ihre strukturierten Daten im Laufe der Zeit entwickeln.
Welche Felder sind für jeden Typ erforderlich?
Anforderungen variieren je nach Typ: Artikel benötigt eine Überschrift, Produkt benötigt einen Namen, Event benötigt einen Namen und Startdatum und FAQPage benötigt mindestens eine Frage und Antwort. Dieses Werkzeug markiert die erforderlichen Felder und die Ausgaben für die Ausgabe, während sie auch vor empfohlenen Feldern warnen, die Ihre Chancen verbessern, ein reichhaltiges Ergebnis zu erzielen.
Kann ich ein FAQ-Schema für meine Seite generieren?
Ja. Wählen Sie den FAQ-Seitentyp, fügen Sie jede Frage mit seiner Antwort hinzu, und das Tool erstellt automatisch das MainEntity-Array von Fragen- und Antwortobjekten. Beachten Sie, dass Google Now FAQ-Ergebnisse hauptsächlich für maßgebliche Regierungs- und Gesundheitsseiten anzeigt. Das Markup bleibt jedoch für andere Suchmaschinen und KI-Antwortengüter gültig und nützlich.
Werden meine Daten privat gehalten?
Ja. Die JSON-LD wird komplett in Ihrem Browser mit einfachem JavaScript zusammengesetzt Nichts, was Sie eingeben - einschließlich unveröffentlichter Preise, Ereignisdetails oder privater URLs - wird übertragen, protokolliert oder gespeichert, und der Generator arbeitet nach dem Laden ohne Netzwerkverbindung weiter.
