Zum Inhalt springen

Schema.org strukturierte Daten

WP-ImmoMakler ergänzt jede Immobilien-Listenansicht und jede Detailseite automatisch um JSON-LD nach schema.org. Damit erkennen Suchmaschinen, Antwortmaschinen und KI-Assistenten Ihre Objekte als Immobilienangebote – mit Preis, Lage, Energiedaten, Ansprechpartner und Verfügbarkeit. PLUS

Diese Seite beschreibt, welche Schemas WP-ImmoMakler ausgibt, wo Sie sie ein- und ausschalten und welchen Nutzen das für SEO, AEO und GEO hat.

Ein HTML-Dokument enthält Text, Bilder und Layout – aber keine maschinenlesbare Aussage darüber, dass auf dieser Seite eine Wohnung in Hamburg-Eppendorf für 749.000 € zum Kauf angeboten wird. Genau dafür gibt es schema.org: ein gemeinsames Vokabular, das Google, Bing, Apple, ChatGPT, Perplexity, Gemini und Claude gleichermaßen verstehen.

WP-ImmoMakler liefert dieses Vokabular für Ihre Immobilien direkt mit. Sie müssen nichts manuell pflegen – die Daten kommen aus Ihrer OpenImmo-Schnittstelle, dem Maklersoftware-Import oder den Eingaben in den Objektmasken.

Suchmaschinen nutzen die strukturierten Daten, um Ihre Suchergebnisse anzureichern: Preis und Verfügbarkeit direkt im Snippet, Bilder neben dem Treffer, Breadcrumb-Pfad statt nackter URL. Bei Listenansichten kann Google die Preisspanne aller passenden Objekte ausweisen. Das erhöht die Klickrate spürbar, ohne das Ranking selbst zu verändern.

So sieht die schema.org Preis-Auszeichnung in den Google-Suchergebnissen aus: Auf der Immobilien-Detailseite zeigt Google den Einzelpreis des Objekts.

Google-Suchergebnis einer WP-ImmoMakler Immobilien-Detailseite mit ausgezeichnetem Einzelpreis

In der Listenansicht zeigt Google stattdessen die Preisspanne aller passenden Objekte aus dem AggregateOffer-Schema.

Google-Suchergebnis einer WP-ImmoMakler Immobilien-Listenansicht mit ausgezeichneter Preisspanne

Antwortmaschinen wie Google AI Overviews, Bing Copilot oder Perplexity formulieren direkte Antworten auf Suchanfragen. Auf “Welche Häuser in Lübeck gibt es zu kaufen?” greift die Antwortmaschine bevorzugt auf Seiten zurück, deren Inhalte sie strukturiert lesen kann. Ein ItemList-Schema mit den auf der Seite sichtbaren Objekten ist genau das, was diese Systeme erwarten.

Generative KI-Modelle (ChatGPT, Claude, Gemini) zitieren bevorzugt Quellen, deren Aussagen sich klar zuordnen lassen. Ein RealEstateListing mit Adresse, Wohnfläche, Baujahr und Energiekennwert ist eine klare, zitierfähige Aussage. Eine reine HTML-Seite mit denselben Informationen bleibt für das Modell mehrdeutig.

In Listenansichten (Archiv, Suchergebnisse, Kategorien)

Abschnitt betitelt „In Listenansichten (Archiv, Suchergebnisse, Kategorien)“
SchemaInhalt
ItemListDie auf der aktuellen Seite sichtbaren Objekte mit Position, URL und Titel; insgesamt die Anzahl aller passenden Objekte.
AggregateOfferMindest- und Höchstpreis sowie Anzahl der Angebote der aktuellen Liste. Optional erweitert um RealEstateListing, Residence sowie House oder Apartment, wenn die Liste auf einen Objekttyp gefiltert ist.
SchemaInhalt
ProductTitel, Beschreibung, Objektnummer (SKU), Bild und Offer mit Preis, Währung und Verfügbarkeit (InStock oder SoldOut).
RealEstateListingErweitert das Product-Schema um RealEstateListing und Residence. Bei Häusern und Wohnungen wird zusätzlich House bzw. Apartment ergänzt.
AccommodationEigenes Schema mit Wohn- und Nutzungsdaten: Zimmer- und Badanzahl, Etage, Wohnfläche (m²), Baujahr, Tierhaltung, Adresse mit Stadtteil, Geokoordinaten und Energiekennwerte als LocationFeatureSpecification. Konkrete Typen: SingleFamilyResidence, House, Apartment, Room – mit Fallback auf Accommodation.
PlaceFallback für Gewerbeimmobilien (Büro, Einzelhandel, Gastgewerbe, Lager, Parken). Mit additionalType auf den passenden Untertyp wie OfficeBuilding oder Warehouse, inklusive Fläche, Baujahr, Adresse und Geokoordinaten.
RealEstateAgentWird als seller in Product und als performer/organizer in Event eingebettet: Name, Firma, Telefon, E-Mail, Anschrift und Bild der Kontaktperson.
Event “Besichtigung vereinbaren”Markiert die Detailseite als buchbaren Termin am Standort der Immobilie.
Event “360° Rundgang online”Wird zusätzlich ausgegeben, wenn die Immobilie eine 360°-Tour-URL hat. Markiert als OnlineEventAttendanceMode mit VirtualLocation.
VideoObjectEin Eintrag je Video der Immobilie (YouTube, Vimeo, Videodatei) mit Name, Beschreibung, Vorschaubild, Upload-Datum und – soweit verfügbar – Laufzeit und Player- bzw. Datei-URL. Siehe Videos.

Sofern für eine Immobilie ein Excerpt (Kurzzusammenfassung) hinterlegt ist, ergänzen die Detailansicht-Schemas Product, Accommodation und Place zusätzlich das Feld disambiguatingDescription mit dieser Kurzfassung – getrennt von der ausführlichen description (die aus Titel und SEO-Meta-Description gebildet wird – deren Aufbau legen Sie unter SEO-Titel und SEO-Description fest). So erhalten Such- und Antwortmaschinen eine kompakte, eigenständig zitierfähige Aussage zum Objekt, ergänzend zu den strukturierten Eckdaten.

disambiguatingDescription ist ein Feld der schema.org-Basisklasse Thing und damit auf allen drei Detailansicht-Schemas gültig (anders als abstract, das nur auf CreativeWork-Typen erlaubt wäre). Das Excerpt pflegen Sie manuell oder lassen es über die KI-Funktionen automatisch erzeugen; derselbe Text erscheint auf der Detailseite als hervorgehobene Zusammenfassung unter dem Untertitel.

Hat eine Immobilie Videos, gibt die Detailansicht für jedes Video einen eigenen VideoObject-Eintrag aus. Die Werte stammen aus Daten, die WP-ImmoMakler ohnehin für die Video-Kacheln bereithält:

FeldHerkunft
name“Video: ” und der Titel der Immobilie; bei mehreren Videos nummeriert (“Video 1: …”).
descriptionTitel und SEO-Description der Immobilie, wie bei den übrigen Schemas.
thumbnailUrlDas Vorschaubild, das WP-ImmoMakler auf Ihrem Server zwischenspeichert. Bei Videodateien hat ein Beitragsbild der Datei Vorrang.
uploadDateBei Videodateien Datum und Uhrzeit des Uploads in die Mediathek, bei Vimeo das Datum, das Vimeo angibt – ohne Uhrzeit, weil Vimeo keine Zeitzone dazu nennt. YouTube nennt kein Datum; dann wird das Veröffentlichungsdatum der Immobilie angegeben.
durationBei Videodateien die Laufzeit aus der Mediathek, bei Vimeo die Laufzeit, die Vimeo angibt. Für YouTube-Videos entfällt das Feld.
embedUrl / contentUrlBei YouTube die youtube-nocookie-Player-URL, bei Vimeo die Player-URL, bei Videodateien die Adresse der Datei.

Videos, für die noch kein Vorschaubild vorliegt, werden ausgelassen, weil Google thumbnailUrl zwingend verlangt. Das betrifft vor allem frisch importierte Videodateien, deren Vorschaubild erst erzeugt wird. Reine Download-Dateien ohne Player erscheinen nicht in den strukturierten Daten.

Die Angabe im JSON-LD lädt das Video nicht. Wann das Video für Ihre Besucher lädt, bestimmt weiterhin die Einwilligung – über die Consent-Abfrage von WP-ImmoMakler oder über Ihr Consent-Plugin. Consent-Plugins wie Complianz lassen JSON-LD-Blöcke unangetastet, auch wenn sie YouTube- oder Vimeo-Adressen enthalten.

Aus dem Energieausweis übernimmt WP-ImmoMakler folgende Werte als LocationFeatureSpecification in das Accommodation-Schema:

  • Endenergiebedarf (kWh/(m²·a))
  • Endenergieverbrauch (kWh/(m²·a))
  • Energieeffizienzklasse (A+ bis H)

Wenn der Energieausweis-Status auf “ohne”, “nicht nötig” oder “bei Besichtigung” gesetzt ist, werden keine Energiedaten ausgegeben – analog zur GEG-konformen Anzeige im Frontend.

Schema.org-Daten werden nur für Immobilien mit dem Status offen ausgegeben. Referenzen, Reservierungen und verkaufte Objekte sind in den strukturierten Daten nicht enthalten und werden daher von Suchmaschinen auch nicht als verfügbar gemeldet.

Alle Schema-Ausgaben lassen sich einzeln aktivieren oder abschalten. Die Optionen finden Sie im Backend Ihrer Website (wp-admin) unter WP-ImmoMakler → Einstellungen → SEO/AEO/GEO.

Tab SEO/AEO/GEO mit den Checkboxen für alle schema.org-Ausgaben von ItemList bis VideoObject
OptionWirkung
schema.org/ItemListJSON-LD ItemList in Listenansichten.
schema.org/AggregateOfferJSON-LD AggregateOffer in Listenansichten (Preisspanne und Angebotsanzahl).
schema.org/ProductJSON-LD Product in Detailansichten.
schema.org/RealEstateListingErweitert das Product-Schema um RealEstateListing, Residence und ggf. House/Apartment.
schema.org/RealEstateAgentBettet die Kontaktperson als seller ins Product-Schema und als performer/organizer ins Event-Schema ein.
schema.org/AccomodationJSON-LD Accommodation mit Wohn- und Nutzungsdaten in Detailansichten; bei Gewerbeobjekten Fallback auf Place.
schema.org/Event “Besichtigung vereinbaren”JSON-LD Event für Besichtigungsanfragen.
schema.org/Event “360° Rundgang online”JSON-LD Event für virtuelle Rundgänge bei Objekten mit 360°-Tour.
schema.org/VideoObjectJSON-LD VideoObject für jedes Video in Detailansichten von Objekten mit Video.

Alle Optionen sind ab Werk aktiviert. Ist eine der Optionen ItemList, RealEstateListing, RealEstateAgent, Accomodation oder eine der beiden Event-Optionen abgeschaltet, blendet WP-ImmoMakler im WordPress-Backend einen Hinweis ein, der empfiehlt, alle Schema.org-Optionen zu aktivieren, und auf den Tab SEO/AEO/GEO verlinkt. Den Hinweis können Sie schließen.

Admin-Hinweis WP-ImmoMakler: Neue Schema.org-Empfehlung für AEO/GEO mit Link zum Tab SEO/AEO/GEO

Sie können das ausgegebene JSON-LD direkt im Quelltext jeder Detail- oder Listenseite sehen. Die <script>-Tags sind als HTML-Kommentar markiert:

<!-- BEGIN schema.org section generated by WP-ImmoMakler RealEstate Plugin ... -->
<script type="application/ld+json" class="immomakler-schema-product">…</script>
<script type="application/ld+json" class="immomakler-schema-accomodation">…</script>
<script type="application/ld+json" class="immomakler-schema-video">…</script>
<!-- END schema.org section ... -->

Für eine strukturierte Validierung empfehlen sich diese externen Tools:

Ergebnis des Google Rich Results Tests für eine Immobilien-Detailseite mit 10 gültigen Elementen, darunter Produkt-Snippets und Händlereinträge

Jedes Schema ist über einen Filter-Hook erreichbar, sodass Sie Felder ergänzen, ändern oder entfernen können – update-sicher in Ihrem WP-ImmoMakler Child-Skin-Plugin:

  • immomakler_schema_item_list
  • immomakler_schema_aggregate_offer
  • immomakler_schema_product
  • immomakler_schema_accomodation
  • immomakler_schema_commercial_property
  • immomakler_schema_event
  • immomakler_schema_video_object

Die Signaturen und Standardwerte finden Sie in der Hooks-Referenz für SEO.