So zeichnen Sie Ihre Website mit JSON-LD nach schema.org aus

Was ist JSON?

Die Abkürzung JSON steht für Ja­va­Script Object Notation und be­zeich­net ein kompaktes, text­ba­sier­tes Format zum Austausch von Daten, das sowohl von Menschen als auch von Maschinen leicht zu ver­ar­bei­ten ist. JSON ist eine Ableitung von Ja­va­Script, lässt sich jedoch auch un­ab­hän­gig von der je­wei­li­gen Pro­gram­mier­spra­che platt­form­über­grei­fend ein­setz­ten. Als Da­ten­for­mat für die Se­ria­li­sie­rung – die Abbildung pro­gram­mier­ba­rer Objekte in eine se­quen­zi­el­le Dar­stel­lungs­form – kommt JSON beim Über­tra­gen und Speichern struk­tu­rier­ter Daten, bei Web­an­wen­dun­gen und mobilen Apps zur Anwendung. Die Syntax eines JSON-Objekts besteht im We­sent­li­chen aus Namen-Wert-Paaren (name-value pairs), die (mit Ausnahme von Zahl­wer­ten) in doppelte An­füh­rungs­zei­chen gesetzt und durch einen Dop­pel­punkt getrennt notiert werden. Jedes Namen-Wert-Paar beginnt üb­li­cher­wei­se in einer neuen Zeile und endet mit einem Komma. Ausnahme: Das letzte Namen-Wert-Paar vor der schlie­ßen­den Schlei­fen­klam­mer wird ohne Komma notiert.

Folgendes Beispiel ver­deut­licht das Grund­sche­ma der JSON-Syntax:

Im ein­lei­ten­den Text­ab­schnitt findet sich das Wortpaar „Manu Sporny“. Ein mensch­li­cher Leser wird aufgrund des Kontextes schnell erfassen, dass es sich bei der Buch­sta­ben­se­quenz um einen Namen handelt, und den hin­ter­leg­ten Hyperlink als Verweis auf die Web­prä­senz des JSON-LD-Ent­wick­lers deuten. Programme wie Web­brow­ser oder Such­ma­schi­nen-Crawler hingegen benötigen Metadaten, um einen solchen Zu­sam­men­hang her­zu­stel­len. Genau diese bietet JSON.

Das Code-Beispiel zeigt die beiden Na­mens­ele­men­te „name“ und „homepage“ mit ihren je­wei­li­gen Werten. Ein Programm, das eine Webseite mit diesem JSON-Objekt ausliest, ist somit in der Lage, „Manu Sporny“ als Name und „http://manu.sporny.org/about/“ als Homepage zu iden­ti­fi­zie­ren.

Der große Vorteil von JSON-LD gegenüber kon­kur­rie­ren­den Formaten besteht jedoch darin, dass Metadaten nicht direkt in den HTML-Code ein­ge­bet­tet werden müssen, sondern separat an be­lie­bi­ger Stelle im­ple­men­tiert werden können. Im­ple­men­tie­rung von JSON-LD in den HTML-Code erfolgt mithilfe des script-Tags nach folgendem Schema:

Die strikte Trennung von HTML und se­man­ti­scher An­no­ta­ti­on punktet nicht nur durch eine deutlich bessere Les­bar­keit des Quell­tex­tes. Eine Im­ple­men­tie­rung dieser Art er­mög­licht zudem eine dy­na­mi­sche Ge­ne­rie­rung von Da­ten­struk­tu­ren un­ab­hän­gig vom sicht­ba­ren Content. Metadaten können bei JSON-LD somit über das Backend ein­ge­pflegt, aus einer Datenbank aus­ge­le­sen und au­to­ma­tisch per Template generiert werden. Dies er­mög­licht eine bequeme se­man­ti­sche An­no­ta­ti­on auch für dy­na­mi­sche Web­in­hal­te, die im Internet immer mehr Raum einnehmen.

Derzeit un­ter­stützt Google ein JSON-LD-Markup für folgende Er­wei­te­run­gen. Ein Beispiel zu jedem Search-Result-Feature stellt der Such­ma­schi­nen­an­bie­ter in der Search-Gallery unter de­ve­lo­pers.google.com bereit.

• Bread­crumbs: Die so­ge­nann­te Brot­krü­mel-Na­vi­ga­ti­on zeigt die Position der aktuellen Webpage in der Hier­ar­chie der Website an. Web­sei­ten­be­trei­ber, die Bread­crumbs se­man­tisch aus­zeich­nen, erlauben Google, diese auf den SERPs an­zu­zei­gen. Bread­crumbs gehören zu den wenigen Search Result Features, die Google auch bei Basic Results ausspielt.

• Fir­men­kon­takt­in­for­ma­tio­nen: Wurden Fir­men­kon­takt­in­for­ma­tio­nen se­man­tisch aus­ge­zeich­net, kann Google diese als Knowledge Graph Display, einer Dar­stel­lungs­form des Knowledge-Graph-Al­go­rith­mus, in den SERPs aus­spie­len.

• Logos: Mit einem Logo-Markup ver­deut­li­chen Web­sei­ten­be­trei­ber, welche Grafik von der Such­ma­schi­ne als Fir­men­lo­go verwendet werden soll. Dies er­mög­licht es Google, Such­ergeb­nis­se zur ent­spre­chen­den Firma um ein Logo zu erweitern.

• Sitelinks Searchbox: Stellt eine Website eine Such­funk­ti­on zur Verfügung und wurde diese se­man­tisch aus­ge­zeich­net, spielt Google Sucherge­bis­se zur Website u. U. mit einer Sitelinks-Searchbox aus.

• Social-Profile-Links: Kommt ein Markup für Links zu Social-Media-Profilen zum Einsatz, erweitert Google das Knowledge Graph Display zu Personen oder Or­ga­ni­sa­tio­nen u. U. um ent­spre­chen­de Schalt­flä­chen. Google un­ter­stützt derzeit ein JSON-LD-Markup für Facebook, Twitter, Google+, Instagram, YouTube, LinkedIn, Myspace, Pinterest, Sound­Cloud und Tumblr.

Web­sei­ten­be­trei­ber, die Ihre Inhalte gut sichtbar auf den Google-SERPs plat­zie­ren möchten, haben die Mög­lich­keit, ver­schie­de­ne Da­ten­ty­pen se­man­tisch aus­zu­zeich­nen. Dabei ist zu beachten, dass allein Google auswählt, ob ein Such­ergeb­nis als Basic Result oder mit Er­wei­te­run­gen aus­ge­spielt wird. Derzeit un­ter­stützt Google ein JSON-LD-Markup für folgende Da­ten­ty­pen und nutzt dieses, um In­for­ma­tio­nen als Rich Search Results, Enriched Search Results oder Knowledge Graph Results auf­zu­be­rei­ten.

• Artikel: Web­sei­ten­be­trei­ber, die News- oder Blog-Artikel se­man­tisch aus­zeich­nen, erlauben Google, diese in das Top-Stories-Karussell auf­zu­neh­men oder auf den SERPs um Search Result Features wie Über­schrif­ten oder Vor­schau­bil­der zu ergänzen.

• Bücher: Bieten Web­sei­ten­be­trei­ber ein JSON-LD-Markup für In­for­ma­tio­nen, die sich auf Bücher beziehen, erstellt Google bei re­le­van­ten Such­an­fra­gen eine Knowledge Graph Card. Diese enthält nicht nur an­schau­li­che In­for­ma­tio­nen zum Buch, sondern er­mög­licht Google-Nutzern bei Bedarf auch den Erwerb direkt aus der Such­ma­schi­ne heraus.

• Musik (Einträge für Musiker und Alben): Ähnlich wie In­for­ma­tio­nen zu Büchern lassen sich auch Mu­sik­an­ge­bo­te an­no­tie­ren. Dies er­mög­licht Google, Knowledge Graph Cards für Mu­sik­in­hal­te zu erzeugen. Diese bieten Suchenden nicht nur In­for­ma­tio­nen zu Alben und Musikern, sondern er­mög­li­chen In­ter­ak­tio­nen wie das Abspielen der Musik oder den Erwerb.

• Kurs­an­ge­bo­te: Web­sei­ten­be­trei­ber, die Kurse (z. B. Sprach­kur­se) mit einem JSON-LD-Markup versehen, das es er­mög­licht, den Titel, ein kurze Be­schrei­bung sowie den Anbieter au­to­ma­tisch aus­zu­le­sen, haben die Chance, dass Google diese In­for­ma­tio­nen als er­wei­ter­te Such­ergeb­nis­se in den SERPs ausspielt.

• Ver­an­stal­tun­gen: Anbieter öf­fent­li­cher Ver­an­stal­tun­gen wie Konzerte und Festivals haben die Mög­lich­keit, relevante In­for­ma­tio­nen (z. B. Ort der Ver­an­stal­tung, Datum und Uhrzeit) via JSON-LD zu an­no­tie­ren, sodass Google diese In­for­ma­tio­nen au­to­ma­tisch ex­tra­hie­ren und gelistet auf den SERPs oder in anderen Google-Produkten wie Maps anzeigen kann.

• Stel­len­an­zei­gen: Auch Job-Angebote, die Or­ga­ni­sa­tio­nen auf ihrer Webseite ver­öf­fent­li­chen, lassen sich so aus­zeich­nen, dass Google relevante In­for­ma­tio­nen für er­wei­ter­te Such­ergeb­nis­se auslesen kann.

• Einträge lokaler Anbieter: Lokale Anbieter, die auf der Web­prä­senz zum Geschäft oder Re­stau­rant struk­tu­rier­te Daten anbieten, er­mög­li­chen Google, Knowledge Graph Cards zu erstellen, die bei re­le­van­ten Such­an­fra­gen auf den SERPs oder in Google Maps angezeigt werden (siehe hierzu auch Google Maps Eintrag erstellen). Sucht ein Google-Nutzer bei­spiels­wei­se nach einem viet­na­me­si­schen Re­stau­rant, spielt Google ein Karussell mit passenden Anbietern in der Nähe aus.

• Da­ten­sät­ze: Auch Da­ten­sät­ze wie CSV-Tabellen oder Dateien in pro­prie­tä­ren Formaten lassen sich via JSON-LD-Markup für die Such­ma­schi­ne zu­gäng­lich machen.

• Podcasts: Google un­ter­stützt ein JSON-LD-Markup für Podcast-In­for­ma­tio­nen. Ent­spre­chend aus­ge­zeich­ne­te Angebote können direkt in der Such­ma­schi­ne angezeigt und ab­ge­spielt werden.

• Videos: Content-Anbieter, die für Videos auf Ihrer Website struk­tu­rier­te Daten wie eine Be­schrei­bung, einen Link zu einem Vor­schau­bild, das Upload-Datum oder die Ab­spiel­zeit zur Verfügung stellen, erlauben Google, diese In­for­ma­tio­nen zu ex­tra­hie­ren und als Rich Cards oder in Form von Ka­rus­sells auf den SERPs aus­zu­spie­len.

• Filme und Shows: Liefert eine Website struk­tu­rier­te Daten zu Film­an­ge­bo­ten oder Shows, übernimmt Google diese bei re­le­van­ten Such­an­fra­gen als Knowledge Graph Cards auf die Such­ergeb­nis­sei­ten. Diese lassen sich bei Bedarf um in­ter­ak­ti­ve Elemente erweitern, die den Konsum oder Erwerb des Angebots er­mög­li­chen.

• Rezepte: Auch Koch­re­zep­te bietet Google seit einigen Jahren als Featured Result in der Such­ma­schi­ne an. Vor­aus­set­zung dafür ist, dass die Be­reit­stel­ler der Inhalte alle re­le­van­ten Rezept-In­for­ma­tio­nen als struk­tu­rier­te Daten zur Verfügung stellen. Eine mögliche Dar­stel­lung auf den SERPs ist ein Karussell mit passenden Rich Cards zur Such­an­fra­ge.

• Be­wer­tun­gen: Google un­ter­stützt Be­wer­tun­gen für ver­schie­de­ne Schema.org-Da­ten­ty­pen wie lokale Geschäfte, Re­stau­rants, Produkte, Bücher, Filme oder Krea­tiv­ar­bei­ten. Die Dar­stel­lung ent­spre­chen­der Inhalte erfolgt als Snippet. Dabei un­ter­schei­det Google zwischen Kritiken einzelner Autoren und Beiträgen auf Be­wer­tungs­por­ta­len. Liegt eine se­man­ti­sche An­no­ta­ti­on vor, werden beide Arten der Bewertung bei re­le­van­ten Such­an­fra­gen als Featured Results auf den SERPs aus­ge­spielt.

• Produkte: On­line­händ­ler, die auf ihrer Website Pro­dukt­in­for­ma­tio­nen wie Preise, Ver­füg­bar­kei­ten oder Be­wer­tun­gen als struk­tu­rier­te Daten zur Verfügung stellen, er­mög­li­chen Google, diese In­for­ma­tio­nen bei re­le­van­ten Such­an­fra­gen als Rich-Search-Results aus­zu­spie­len.

Er­wei­ter­te Such­ergeb­nis­se – egal, ob es sich um Featured Results oder Knowledge Graph Displays handelt – haben für Web­sei­ten­be­trei­ber vor allem einen Vorteil: Sie heben sich von anderen Such­ergeb­nis­sen auf den SERPs ab.

Google stellt Displays und Ka­rus­sel­le für Featured Results an ex­po­nier­ter Stelle oberhalb der Basic Results und somit auf Position null dar. Knowledge Graph Displays er­schei­nen entweder ebenfalls als Karussell am oberen Sei­ten­rand oder von einem Rahmen ab­ge­grenzt rechts neben der or­ga­ni­schen Websuche. Er­wei­ter­te Such­ergeb­nis­se bieten Web­sei­ten­be­trei­bern somit die Chance, die Pole-Position der Such­ergeb­nis­sei­te zu erringen, ohne dass Zeit und Geld in die Ver­bes­se­rung des or­ga­ni­schen Rankings in­ves­tiert werden muss.

Doch nicht nur die her­vor­ge­ho­be­ne Position, auch diverse Er­wei­te­run­gen wie Vor­schau­bil­der, Ratings, Text­aus­zü­ge und in­ter­ak­ti­ve Elemente erregen die Auf­merk­sam­keit des Suchenden und regen zum Klicken an. Web­sei­ten­be­trei­ber können davon ausgehen, dass sich die Click-Through-Rate bei er­wei­ter­ten Such­ergeb­nis­sen im Vergleich zu Basic Results deutlich erhöht.

Zudem wird er­wei­ter­ten Such­ergeb­nis­sen ein positiver Effekt auf die Ab­sprungra­te zu­ge­spro­chen. Anders als Basic Results, die in der Regel lediglich den Meta-Title, eine URL sowie eine kurze Be­schrei­bung umfassen, geben er­wei­ter­te Such­ergeb­nis­se Google-Nutzern einen um­fas­sen­den Eindruck davon, welche Inhalte sie auf der ver­link­ten Website zu erwarten haben. Ein Suchender kann die Relevanz einer Website für die eigene Such­an­fra­ge somit schon vor dem Aufruf prüfen und nur bei Bedarf klicken.

Als Ranking-Faktor zieht Google das Vor­han­den­sein oder Fehlen einer se­man­ti­schen Aus­zeich­nung via JSON-LD jedoch nicht heran. Das stellte Matt Cutts, ehe­ma­li­ger Chef des Google-Web-Spam-Teams, bereits 2012 in folgendem YouTube-Video der Google-Web­mas­ters-Reihe klar:

Wie bei der Anwendung punktet JSON-LD auch bei der Crawl­bar­keit durch die Aus­la­ge­rung des Markups in separate Skript-Ab­schnit­te. Im Vergleich zu al­ter­na­ti­ven An­no­ta­tio­nen wie Microdata oder RDFa erlaubt JSON-LD trotz se­man­ti­scher An­no­ta­ti­on einen schlanken Quellcode, der vom Google-Bot und anderen Crawlern schnell durch­sucht und leicht indexiert werden kann. Doch die Aus­la­ge­rung von struk­tu­rier­ten Daten hat auch Nachteile. Prin­zi­pi­ell gilt bei Google und anderen Such­ma­schi­nen-Anbietern die Grund­re­gel, dass lediglich die Inhalte ma­schi­nen­les­bar aus­ge­zeich­net werden, die auch mensch­li­chen Sei­ten­be­su­chern zur Verfügung stehen. Mit JSON-LD jedoch lässt sich theo­re­tisch jedes beliebige Markup im­ple­men­tie­ren, selbst dann, wenn es für die an­ge­führ­ten Metadaten im ei­gent­li­chen Web­sei­ten­in­halt keine Ent­spre­chung gibt. In diesem Fall wird sowohl der Such­ma­schi­ne als auch dem Nutzer ein möglicher Mehrwert ver­spro­chen, den eine derart aus­ge­schmück­te Website nicht bietet. Praktisch ist von einem solchen Vorgehen abzuraten. An­dern­falls laufen Web­sei­ten­be­trei­ber Gefahr, wegen Web-Spam-Maßnahmen ab­ge­straft zu werden. Um zu ver­hin­dern, dass Web­sei­ten­be­su­cher ver­se­hent­lich die Grenzen der such­ma­schi­nen­kon­for­men se­man­ti­schen An­no­ta­ti­on über­schrei­ten, bietet Google mit den Struc­tu­red Data General Gui­de­lines ein aus­führ­li­ches Regelwerk, das sich im We­sent­li­chen auf folgende Punkte re­du­zie­ren lässt:

• Format: Struk­tu­rier­te Daten müssen in einem der drei eta­blier­ten Formate Microdata, RDFa oder JSON-LD vorliegen. Google empfiehlt Letzteres.

• Zu­gäng­lich­keit: Seiten mit struk­tu­rier­ten Daten müssen für den Googlebot zu­gäng­lich sein. Access-Control-Methoden (z. B. via robots.txt oder noindex) ver­hin­dern das Auslesen der Metadaten.

• Content-Äqui­va­lenz: Das JSON-LD-Markup darf lediglich Entitäten be­schrei­ben, die auch im HTML-Code be­schrie­ben werden.

• Relevanz: Ein JSON-LD-Markup sollte sich lediglich auf relevante Ent­spre­chun­gen der ver­wen­de­ten Da­ten­ty­pen beziehen. Ein Web­sei­ten­be­trei­ber, der eine tech­ni­sche Anleitung als Rezept aus­zeich­net, verstieße bei­spiels­wei­se gegen die Richt­li­nie der Relevanz.

• Voll­stän­dig­keit: Alle im JSON-LD-Markup auf­ge­führ­ten Da­ten­ty­pen (types) müssen voll­stän­dig und inklusive der er­for­der­li­chen Ei­gen­schaf­ten (pro­per­ties) aus­ge­zeich­net werden. Da­ten­ty­pen, bei denen es­sen­zi­el­le Ei­gen­schaf­ten fehlen, eignen sich nicht für er­wei­ter­te Such­ergeb­nis­se.

• Spe­zi­fi­tät: Linked-Data-Projekte wie Schema.org bieten eine Vielzahl von Da­ten­ty­pen. Um die eigenen Inhalte für eine er­wei­ter­te Such­ergeb­nis­dar­stel­lung zu qua­li­fi­zie­ren, sollten Web­sei­ten­be­trei­ber Schemata so spe­zi­fisch wie möglich wählen.

Schritt 2: Relevante Inhalte bestimmen

Erstellen Sie eine Liste aller Inhalte, die einen Mehrwert bieten. Ent­schei­den Sie, auf welche Inhalte po­ten­zi­el­le Besucher bereits auf den Such­ergeb­nis­sei­ten auf­merk­sam gemacht werden sollten.

Google bei­spiels­wei­se empfiehlt eine Aus­zeich­nung mit JSON-LD für In­for­ma­tio­nen, die Ver­an­stal­tun­gen (Events) betreffen. In HTML lassen sich Ver­an­stal­tungs­an­kün­di­gun­gen für Konzerte, Musicals oder Thea­ter­vor­stel­lun­gen z. B. nach folgendem Schema dar­stel­len:

Typische In­for­ma­tio­nen des Datentyps „Event“ sind Datum und Uhrzeit, der Preis, die Ver­füg­bar­keit von Tickets, die Adresse des Ver­an­stal­tungs­orts sowie Links zu wei­ter­füh­ren­den In­for­ma­tio­nen zum Event oder zum Ver­an­stal­tungs­ort. Mensch­li­che Sei­ten­be­su­cher sind in der Lage, diese In­for­ma­tio­nen einem Text­ab­schnitt, einer Tabelle oder anderen Dar­stel­lungs­for­men zu entnehmen und dem ent­spre­chen­den Be­deu­tungs­zu­sam­men­hang zu­zu­ord­nen. Programme wie Such­ma­schi­nen-Crawler hingegen benötigen Metadaten, die An­wei­sun­gen enthalten, wie die dar­ge­bo­te­nen In­for­ma­tio­nen zu ver­ar­bei­ten sind. JSON-LD liefert diese in Form eines Da­ten­for­mats, das separat vom Inhalt an be­lie­bi­ger Stelle des HTML-Quell­codes eingefügt wird.

All­ge­mein­gül­ti­ge Regeln, wie Sie als Web­sei­ten­be­trei­ber ein JSON-LD-Markup erstellen und in Ihre Website einbetten, stellt ihnen Schema.org zur Verfügung.

Schritt 3: Schemata auswählen

Schema.org bietet Web­sei­ten­be­trei­bern ein um­fang­rei­ches Vokabular für die Da­ten­struk­tu­rie­rung. Insgesamt umfasst die Datenbank rund 600 Types, die sich mit mehr als 860 Propertys näher spe­zi­fi­zie­ren lassen.

Bei der Auswahl passender Da­ten­ty­pen bieten sich zwei Stra­te­gien an:

• Theo­re­tisch steht es ihnen offen, alle zuvor be­stimm­ten Inhalte mit den zur Verfügung stehenden Da­ten­ty­pen des Schema.org-Vo­ka­bu­lars ab­zu­glei­chen und jeweils den spe­zi­fischs­ten Datentyp für das jeweilige In­halts­ele­ment aus­zu­wäh­len. Ein solches Vorgehen ist lang­wie­rig und in der Regel unnötig.

• In der Praxis be­schrän­ken sich Web­sei­ten­be­trei­ber meist auf eine Teilmenge der Schema.org-Da­ten­ty­pen: Verfolgen Sie mit dem JSON-LD-Markup lediglich das Ziel, der Such­ma­schi­ne struk­tu­rier­te Daten be­reit­zu­stel­len, genügt es, sich zunächst auf die Da­ten­ty­pen zu be­schrän­ken, die von Google aktuell un­ter­stützt und im Google-Developer-Bereich aus­führ­lich be­schrie­ben werden.

Wir empfehlen ihnen Strategie b. – und das aus folgendem Grund: Google bietet für alle von der Such­ma­schi­ne un­ter­stütz­ten Da­ten­ty­pen eine aus­führ­li­che Do­ku­men­ta­ti­on. Für jeden Datentyp wird ein Beispiel-Markup zur Verfügung gestellt.

Um Ihre Website mit struk­tu­rier­ten Daten aus­zu­stat­ten, müssen Sie das Rad nicht neu erfinden. Gerade wenn Sie bisher noch keine Erfahrung mit der Syntax von JSON-LD haben, spart es Zeit und Energie, auf vor­ge­fer­tig­te Muster zu­rück­zu­grei­fen, anstatt das Markup für jeden Datentyp von Grund auf neu zu schreiben. In der Google-Do­ku­men­ta­ti­on finden Web­sei­ten­be­trei­ber folgendes Markup-Beispiel für Ver­an­stal­tun­gen:

Die Script-Tags de­fi­nie­ren das Element von Zeile 01 bis Zeile 39 als Skript des Typs „ap­pli­ca­ti­on/ld+json“. Die nach­fol­gen­den In­for­ma­tio­nen richten sich somit an Programme, die in der Lage sind, Linked Data im JSON-Format aus­zu­le­sen.

Auf der ersten Ebene finden sich die Schlüs­sel­wör­ter „@context“ und „@type“ mit den Werten „http://schema.org“ und „Event“ (Zeile 03 und 04). Ein parsendes Programm erhält hier die Anweisung, dass die folgenden In­for­ma­tio­nen dem Schema „Event“ gemäß Schema.org zu­zu­ord­nen sind, es handelt sich somit um spe­zi­fi­sche Ei­gen­schaf­ten der be­schrie­be­nen Ver­an­stal­tung. Diese werden in Form von Namen-Wert-Paaren dar­ge­stellt.

Ebenfalls auf der ersten Ebene finden sich die Ei­gen­schaf­ten „name“, „startDate“, „location“, „image“, „de­scrip­ti­on“, „enddate“, „offers“ und „performer“, denen die je­wei­li­gen Ver­an­stal­tungs­in­for­ma­tio­nen als Werte zu­ge­ord­net sind. Ein Such­ma­schi­nen-Crawler kann die In­for­ma­ti­on „Jan Lieberman Concert Series: Journey in Jazz“ somit zwei­fels­frei als Titel der Ver­an­stal­tung (name) iden­ti­fi­zie­ren und „2017-04-24T19:30-08:00“ als genauen Start­zeit­punkt (StartDate).

Analog zu RDFa und Microdata un­ter­stützt auch JSON-LD-Syntax Ver­schach­te­lun­gen (Nesting). Dabei wird einer Ei­gen­schaft kein Wert, sondern ein (Sub-)Schema zu­ge­ord­net, das wiederum mit spe­zi­fi­schen Ei­gen­schaf­ten näher bestimmt werden kann. Einen solchen Fall findet Sie auf der zweiten Ebene des Code­bei­spiels in den Zeilen 08, 27 und 35.

In Zeile 08 bei­spiels­wei­se wird die Event-Ei­gen­schaft „location“ als (Sub-)Schema des Typs „Place“ definiert und mit den Ei­gen­schaf­ten „name“ und „address“ versehen. Die Ei­gen­schaft „address“ wiederum wird in Zeile 11 als (Sub)-Schema des Typs „Posta­l­Ad­dress“ definiert und ih­rer­seits mit den schem­a­spe­zi­fi­schen Ei­gen­schaf­ten „street­Ad­dress“, „ad­dress­Lo­ca­li­ty“, „postal­Code“, „ad­dress­Re­gi­on“ und „ad­dress­Coun­try“ aus­ge­zeich­net.

Jede ver­schach­tel­te Ebene wird in ge­schweif­te Klammern gefasst und so von der über­ge­ord­ne­ten Ebene ab­ge­grenzt.

Aus­schnitt (Zeile 07 bis 18):

Schema.org stellt Web­sei­ten­be­trei­bern Da­ten­ty­pen somit in Form einer hier­ar­chi­schen Baum­struk­tur zur Verfügung, die ausgehend vom all­ge­meins­ten Datentyp „Thing“ (Sache) immer spe­zi­fi­scher wird.

Im folgenden Schritt zeigen wir Ihnen, wie Sie das Google-Beispiel zum Datentyp „Event“ an die oben auf­ge­führ­te Ver­an­stal­tungs­an­kün­di­gung anpassen.

Schritt 4: JSON-LD-Markup anpassen

Die Google-Do­ku­men­ta­ti­on be­inhal­tet lediglich Beispiele, die zeigen, wie sich die auf­ge­führ­ten Da­ten­ty­pen via JSON-LD aus­zeich­nen lassen. Kommen diese als Vorlagen für ein eigenes Metadaten-Markup zum Einsatz, muss der Code in jedem Fall in­di­vi­du­ell angepasst werden. U. U. ist es hilfreich, dabei auf die Schema.org-Do­ku­men­ta­ti­on zum ent­spre­chen­den Datentyp zu­rück­zu­grei­fen, um mehr über die Ver­wen­dung eines be­stimm­ten Schemas sowie mögliche Ei­gen­schaf­ten zu erfahren. Folgendes Beispiel zeigt eine in­di­vi­du­el­le Anpassung des Google-Muster-Codes für den Datentyp Event:

Im ersten Schritt haben wir alle Werte des Muster-Markups durch ent­spre­chen­de Werte der oben auf­ge­führ­ten Ver­an­stal­tungs­an­kün­di­gung ersetzt. Dabei wurden un­zu­tref­fen­de (Sub-)Schemata und Ei­gen­schaf­ten gelöscht. Bei­spiels­wei­se haben wird die Ei­gen­schaft „ad­dress­Re­gi­on“ weg­ge­las­sen, da diese Angabe in Deutsch­land nicht üblich ist. Statt „Per­forming­Group“ nutzen wir unter „performer“ das (Sub-)Schema „Person“, da wir es nicht mit einer Band, sondern mit einem einzelnen Dar­stel­ler zu tun haben. Ab­schlie­ßend haben wir das Markup um In­for­ma­tio­nen ergänzt, die in der Google-Vorlage nicht erfasst wurden. So finden sich in Zeile 07 und Zeile 10 bei­spiels­wei­se URLs zum Event bzw. zum Ver­an­stal­tungs­ort. Mögliche Ei­gen­schaf­ten entnehmen Sie bei bedarf der Schema.org-Do­ku­men­ta­ti­on.

Auch wenn Sie Ihr JSON-LD-Markup ohne Vorlage von Grund auf neu erstellen, sollten Sie einen Blick auf die Google-Do­ku­men­ta­ti­ons­sei­te zum je­wei­li­gen Datentyp werfen. Hier gibt der Such­ma­schi­nen­markt­füh­rer für alle un­ter­stütz­ten Da­ten­ty­pen sowohl er­for­der­li­che als auch emp­foh­le­ne Propertys an.

Die in der Google-Do­ku­men­ta­ti­on auf­ge­führ­ten Beispiele be­inhal­ten stets alle er­for­der­li­chen und emp­foh­le­nen Propertys.

Ob Ihrem Markup wichtige Propertys fehlen, testen Sie am besten mit dem von Google zur Verfügung ge­stell­ten Va­li­die­rungs­tool.

Nutzen Sie stets die Do­ku­men­ta­ti­ons­sei­ten von Schema.org und va­li­die­ren Sie Ihren JSON-LD-Code mithilfe des Struc­tu­red Data Testing Tools. Beachten Sie zudem die Struc­tu­red Data General Gui­de­lines sowie die all­ge­mei­nen Webmaster Gui­de­lines von Google, um Re­gel­ver­stö­ße zu vermeiden, die zum Aus­schluss vom Ranking für er­wei­ter­te Such­ergeb­nis­se führen können.