SEO Rich Data - Installation und Konfiguration
Zweck des Moduls
Das Modul Kowal_SeoRichData fügt Magento 2 strukturierte Daten nach schema.org im JSON-LD-Format hinzu. Die generierten Daten können Produkte, Angebote, Preise, Verfügbarkeit, Bewertungen, Rezensionen, Breadcrumbs, Organisationsdaten, Seitennamen, Suchfeld, Social-Media-Profile, FAQ und Videos umfassen.
Die Modulkonfiguration befindet sich im Magento-Admin-Panel:
Stores > Configuration > Kowal > SEO Rich Data
Anforderungen
- Magento 2.
- Zugriff auf Magento CLI.
- Zugriff auf das Composer Repository mit dem Paket
kowal/module-seo-rich-data. - Erforderliches Basispaket:
kowal/base. - Berechtigungen zum Ausführen von
bin/magento-Befehlen.
Installation über Composer
- Fügen Sie das Paket-Repository hinzu:
composer config repositories.seo.rich.data vcs https://github.com/kowalco/magento-2-seo-rich-data
- Wenn das Repository privat ist, fügen Sie ein GitHub-Zugriffstoken hinzu:
composer config --global --auth github-oauth.github.com
- Installieren Sie das Modul:
composer require kowal/module-seo-rich-data
- Aktivieren Sie das Modul:
php bin/magento module:enable Kowal_SeoRichData
- Führen Sie das Magento-Update aus:
php bin/magento setup:upgrade
- Führen Sie in der Produktionsumgebung die DI-Kompilierung aus:
php bin/magento setup:di:compile
- Generieren Sie in der Produktionsumgebung, falls das Projekt dies erfordert, statische Dateien:
php bin/magento setup:static-content:deploy
- Leeren Sie den Cache:
php bin/magento cache:flush
Manuelle Installation
- Kopieren Sie das Modul in das Verzeichnis:
app/code/Kowal/SeoRichData
- Aktivieren Sie das Modul:
php bin/magento module:enable Kowal_SeoRichData
- Führen Sie das Magento-Update aus:
php bin/magento setup:upgrade
- Leeren Sie den Cache:
php bin/magento cache:flush
Schritte nach der Installation
Nach der Installation fügt das Modul ein Produktattribut hinzu:
| Attribut | Bedeutung |
|---|
offer_item_condition | Produktzustand, der zum Generieren von itemCondition in offers verwendet wird. |
Das Attribut unterstützt folgende Werte:
| Wert in Magento | JSON-LD-Wert |
|---|
DamagedCondition | https://schema.org/DamagedCondition |
NewCondition | https://schema.org/NewCondition |
RefurbishedCondition | https://schema.org/RefurbishedCondition |
UsedCondition | https://schema.org/UsedCondition |
Wenn für das Produkt kein Attributwert festgelegt ist, behandelt das Modul es als NewCondition.
Konfigurationsumfang
Alle Konfigurationsfelder sind für die Bereiche Default, Website und Store View gemäß den Magento-Einstellungen verfügbar.
Felder vom Typ Enabled, Show ... und ähnliche verwenden die Standardwerte von Magento:
| Wert | Bedeutung |
|---|
Yes | Die Funktion ist aktiviert und kann JSON-LD-Daten generieren. |
No | Die Funktion ist deaktiviert. |
Breadcrumbs
Der Abschnitt ist für strukturierte Daten des Navigationspfads zuständig.
| Feld | Bedeutung | Werte |
|---|
Enabled | Aktiviert die Generierung von BreadcrumbList-Daten. | Yes, No |
Fixed Category Path | Verwendet auf der Produktseite den detailliertesten Kategoriepfad, wenn Magento keinen vollständigen Kategoriekontext liefert. | Yes, No |
Type | Legt die Länge des für die Suchmaschine generierten Breadcrumb-Pfads fest. | Default (Long), Short |
Werte des Feldes Type:
| Wert | Bedeutung |
|---|
Default (Long) | Vollständiger Pfad, z. B. Store > Category > Subcategory > Product. |
Short | Verkürzter Pfad, z. B. Store > Subcategory > Product. |
Include Your Site Name in Search Results
Der Abschnitt ist für Daten vom Typ WebSite zuständig, die Google helfen können, den Namen der Website zu erkennen.
| Feld | Bedeutung | Werte |
|---|
Enabled | Aktiviert die Generierung von WebSite-Daten. | Yes, No |
Website Name | Name der Website/des Shops, der in den strukturierten Daten übergeben wird. | Text, z. B. Shopname. |
Organization
Der Abschnitt ist für Daten vom Typ Organization zuständig.
| Feld | Bedeutung | Werte |
|---|
Enabled | Aktiviert die Generierung von Organisationsdaten. | Yes, No |
Organization Name | Name des Unternehmens oder Shops. | Text; Pflichtfeld nach Aktivierung des Abschnitts. |
Logo Url | Vollständige URL des Organisationslogos. | URL zur Bilddatei. |
Description | Beschreibung der Organisation. | Text. |
Description Length | Maximale Anzahl von Zeichen der Beschreibung. | Zahl; leer bedeutet keine Kürzung. |
Country | Land der Organisation. | Ländercode aus der Magento-Liste. |
Region/State | Region oder Bundesland. | Text. |
ZIP/Postal Code | Postleitzahl. | Text. |
City | Stadt. | Text. |
Street Address | Straße und Hausnummer. | Text. |
Sales | Telefon des Vertriebs. | Nummer im internationalen Format, z. B. +48.... |
Technical Support | Telefon des technischen Supports. | Nummer im internationalen Format. |
Customer Service | Telefon des Kundendienstes. | Nummer im internationalen Format. |
Das Land aus diesem Abschnitt kann als Fallback für das Versandland und das Land der Rückgabebedingungen verwendet werden, wenn die entsprechenden Felder im Produktabschnitt leer bleiben.
Social Profiles
Der Abschnitt fügt die Social-Media-Profile der Organisation hinzu. Damit die Daten sinnvoll sind, sollte der Abschnitt Organization aktiviert sein.
| Feld | Bedeutung | Werte |
|---|
Enabled | Aktiviert die Generierung von Links zu Social-Media-Profilen. | Yes, No |
Facebook | URL des Facebook-Profils. | Vollständige URL. |
Twitter | URL des Twitter-/X-Profils. | Vollständige URL. |
Google+ | URL des Google+-Profils. | Vollständige URL; historisches Konfigurationsfeld. |
Instagram | URL des Instagram-Profils. | Vollständige URL. |
YouTube | URL des YouTube-Kanals. | Vollständige URL. |
LinkedIn | URL des LinkedIn-Profils. | Vollständige URL. |
Myspace | URL des Myspace-Profils. | Vollständige URL; historisches Konfigurationsfeld. |
Pinterest | URL des Pinterest-Profils. | Vollständige URL. |
SoundCloud | URL des SoundCloud-Profils. | Vollständige URL. |
Tumblr | URL des Tumblr-Profils. | Vollständige URL. |
Leere Felder werden übersprungen.
Search Box
Der Abschnitt ist für SearchAction-Daten zuständig, die die Anzeige des Shop-Suchfelds in den Google-Ergebnissen ermöglichen können.
| Feld | Bedeutung | Werte |
|---|
Enabled | Aktiviert die Generierung von Daten für die Website-Suche. | Yes, No |
Category Rich Data
Der Abschnitt ist für die Generierung von Produktdaten auf Kategorieseiten zuständig.
| Feld | Bedeutung | Werte |
|---|
Show Products Data | Fügt strukturierte Daten für Produkte hinzu, die auf der Kategorieseite sichtbar sind. | Yes, No |
Die Aktivierung dieser Option kann die Performance von Kategorieseiten verschlechtern, da das Modul Daten für viele Produkte sammeln muss.
Product Rich Data
Der Abschnitt ist für die wichtigsten Produktdaten vom Typ Product sowie für offers-Daten zuständig.
Grundlegende Produktfelder
| Feld | Bedeutung | Werte |
|---|
Enabled | Aktiviert die Generierung von Produkt-JSON-LD auf der Produktseite. | Yes, No |
Show Availability | Fügt availability in offers hinzu. | Yes, No |
priceValidUntil Default Value | Standard-Ablaufdatum des Preises. | Datum. |
Use “Special Price To” Value for priceValidUntil Snippet | Wenn das Produkt einen aktiven Sonderpreis und ein Datum Special Price To hat, ersetzt dieses Datum den Standardwert. | Yes, No |
Show Condition | Fügt itemCondition in offers hinzu. | Yes, No |
Description | Legt die Quelle der Produktbeschreibung in JSON-LD fest. | None, Product Short Description, Product Full Description, Page Meta Description |
Werte des Feldes Description:
| Wert | Bedeutung |
|---|
None | Ruft keine Beschreibung aus der Konfiguration ab; der Code kann den Produktnamen als Fallback verwenden, wenn die Beschreibung leer ist. |
Product Short Description | Verwendet die Kurzbeschreibung des Produkts. |
Product Full Description | Verwendet die vollständige Produktbeschreibung. |
Page Meta Description | Verwendet die Meta Description der Seite. |
Konfigurierbare und gruppierte Produkte
| Feld | Bedeutung | Werte |
|---|
Show Configurable Products as | Legt fest, wie Angebote für konfigurierbare Produkte generiert werden. | Main Offer, List of Associated Products Offers, Aggregate Offer |
Show Grouped Products as | Legt fest, wie Angebote für gruppierte Produkte generiert werden. | Main Offer, List of Associated Products Offers, Aggregate Offer |
Werte:
| Wert | Bedeutung |
|---|
Main Offer | Generiert ein Angebot für das Hauptprodukt. |
List of Associated Products Offers | Generiert ein separates Angebot für jedes einfache oder verknüpfte Produkt. |
Aggregate Offer | Generiert AggregateOffer mit dem niedrigsten Preis, dem höchsten Preis und der Anzahl der Angebote. |
Bewertungen und Rezensionen
| Feld | Bedeutung | Werte |
|---|
Show Rating | Fügt aggregateRating und review zu den Produktdaten hinzu. | Yes, No |
Use Yotpo Reviews instead of Magento Reviews | Ruft Rezensionen aus Yotpo statt aus Magento Reviews ab. | Yes, No |
Rating Format | Legt die Bewertungsskala fest. | Percentage Scale, Numeric Scale |
Number of Reviews | Limit der Anzahl der neuesten Rezensionen, die zu JSON-LD hinzugefügt werden. | Zahl; leer bedeutet alle Rezensionen. |
Werte des Feldes Rating Format:
| Wert | Bedeutung |
|---|
Percentage Scale | Bewertungen werden als Prozentskala interpretiert. |
Numeric Scale | Bewertungen werden als numerische Skala interpretiert. |
Die Integration mit Yotpo erfordert die Verfügbarkeit eines Moduls, das Yotpo unterstützt. Wenn das Modul nicht installiert ist, sollte die Yotpo-Konfiguration nicht aktiviert werden.
Brand, Manufacturer und Produktkennungen
| Feld | Bedeutung | Werte |
|---|
Brand | Produktattribut, das zum Generieren der Eigenschaft brand verwendet wird. | Beliebiges Produktattribut aus der Liste. |
EAN / GTIN Attribute | Produktattribut, das als globale Produktkennung verwendet wird. | Beliebiges Produktattribut aus der Liste. |
Manufacturer | Produktattribut, das zum Generieren der Eigenschaft manufacturer verwendet wird. | Beliebiges Produktattribut aus der Liste. |
Das Feld EAN / GTIN Attribute generiert die Eigenschaft abhängig von der Anzahl der Ziffern:
| Anzahl der Ziffern | JSON-LD-Eigenschaft |
|---|
| 8 | gtin8 |
| 12 | gtin12 |
| 13 | gtin13 |
| 14 | gtin14 |
| Andere positive Anzahl von Ziffern | gtin |
Das Modul entfernt Zeichen, die keine Ziffern sind, aus dem EAN-/GTIN-Wert, bevor JSON-LD generiert wird.
Shipping details
Der Versandabschnitt ist für die Generierung von shippingDetails in offers zuständig. Die Daten werden nur hinzugefügt, wenn der Abschnitt aktiviert ist und alle erforderlichen Werte enthält.
| Feld | Bedeutung | Werte |
|---|
Show Shipping Details | Aktiviert die Generierung von shippingDetails. | Yes, No |
Shipping Country | Lieferland. | Ländercode aus der Magento-Liste; wenn leer, wird das Land aus dem Abschnitt Organization verwendet. |
Shipping Price | Versandkosten. | Zahl gleich oder größer als 0; 0 bedeutet kostenloser Versand. |
Handling Time Min Days | Minimale Bearbeitungszeit der Bestellung. | Ganzzahl, Tage. |
Handling Time Max Days | Maximale Bearbeitungszeit der Bestellung. | Ganzzahl, Tage. |
Transit Time Min Days | Minimale Transportzeit. | Ganzzahl, Tage. |
Transit Time Max Days | Maximale Transportzeit. | Ganzzahl, Tage. |
Die Währung der Versandkosten wird aus der Währung des Produktangebots übernommen.
Beispiel für die Bedeutung der Werte:
| Feld | Beispiel | Bedeutung |
|---|
Shipping Price | 0 | Kostenloser Versand. |
Handling Time Min Days | 0 | Die Bestellung kann noch am selben Tag bearbeitet werden. |
Handling Time Max Days | 1 | Die Bearbeitung der Bestellung dauert maximal 1 Tag. |
Transit Time Min Days | 1 | Die Lieferung dauert mindestens 1 Tag. |
Transit Time Max Days | 5 | Die Lieferung dauert maximal 5 Tage. |
Merchant return policy
Der Abschnitt für Rückgabebedingungen ist für die Generierung von hasMerchantReturnPolicy in offers zuständig. Die Daten werden nur hinzugefügt, wenn der Abschnitt aktiviert ist und die erforderlichen Werte enthält.
| Feld | Bedeutung | Werte |
|---|
Show Merchant Return Policy | Aktiviert die Generierung von hasMerchantReturnPolicy. | Yes, No |
Return Policy Country | Land, in dem die Rückgabebedingungen gelten. | Ländercode aus der Magento-Liste; wenn leer, wird das Land aus dem Abschnitt Organization verwendet. |
Return Policy Category | Art der Rückgabebedingungen. | Finite Return Window, Returns Not Permitted, Unlimited Return Window |
Merchant Return Days | Anzahl der Tage für die Rückgabe. | Ganzzahl; erforderlich für Finite Return Window. |
Return Method | Unterstützte Rückgabemethode. | -- Empty --, Return By Mail, Return In Store, Return At Kiosk |
Return Fees | Informationen zu Rückgabegebühren. | -- Empty --, Free Return, Customer Responsibility, Return Shipping Fees |
Return Shipping Fee | Betrag der Gebühr für die Rücksendung. | Zahl größer als 0; nur erforderlich für Return Shipping Fees. |
Werte des Feldes Return Policy Category:
| Wert | JSON-LD-Wert | Bedeutung |
|---|
Finite Return Window | https://schema.org/MerchantReturnFiniteReturnWindow | Rückgabe für eine bestimmte Anzahl von Tagen möglich. Erfordert Merchant Return Days. |
Returns Not Permitted | https://schema.org/MerchantReturnNotPermitted | Rückgaben sind nicht erlaubt. |
Unlimited Return Window | https://schema.org/MerchantReturnUnlimitedWindow | Rückgabe ohne festgelegtes Tageslimit. |
Werte des Feldes Return Method:
| Wert | JSON-LD-Wert | Bedeutung |
|---|
-- Empty -- | kein Wert | Die Rückgabemethode wird nicht zu JSON-LD hinzugefügt. |
Return By Mail | https://schema.org/ReturnByMail | Rückgabe per Versand. |
Return In Store | https://schema.org/ReturnInStore | Rückgabe im stationären Geschäft. |
Return At Kiosk | https://schema.org/ReturnAtKiosk | Rückgabe an einem Punkt/Kiosk. |
Werte des Feldes Return Fees:
| Wert | JSON-LD-Wert | Bedeutung |
|---|
-- Empty -- | kein Wert | Informationen zu Gebühren werden nicht zu JSON-LD hinzugefügt. |
Free Return | https://schema.org/FreeReturn | Die Rückgabe ist kostenlos. |
Customer Responsibility | https://schema.org/ReturnFeesCustomerResponsibility | Die Kosten der Rückgabe trägt der Kunde. |
Return Shipping Fees | https://schema.org/ReturnShippingFees | Für die Rückgabe fällt eine festgelegte Rücksendegebühr an. Erfordert Return Shipping Fee. |
Die Währung des Feldes Return Shipping Fee wird aus der Währung des Produktangebots übernommen.
Custom Properties
Das Feld Custom Properties ermöglicht das Hinzufügen eigener Eigenschaften zum Produkt-JSON-LD.
Format:
wlasciwosc_jsonld,kod_atrybutu
Wenn nur ein Element angegeben ist, behandelt das Modul es gleichzeitig als Namen der JSON-LD-Eigenschaft und als Attributcode.
Standardwert:
skumpn,sku
Bedeutung des Standardwerts:
| Zeile | Effekt |
|---|
sku | Fügt sku auf Basis des Attributs sku hinzu. |
mpn,sku | Fügt mpn auf Basis des Attributs sku hinzu. |
Beispiel für das Hinzufügen eines eigenen Attributs:
color,colormaterial,material
Empfohlene Mindestkonfiguration für Produkte
Um Warnungen in Google Search Console für Produktdaten zu begrenzen, konfigurieren Sie mindestens:
| Feld | Empfehlung |
|---|
Product Rich Data > Enabled | Yes |
Show Availability | Yes |
Brand | Wählen Sie das Attribut mit der Produktmarke. |
EAN / GTIN Attribute | Wählen Sie das Attribut mit EAN / GTIN, wenn die Produkte eine globale Kennung haben. |
Show Shipping Details | Yes, wenn der Shop eine einheitliche Versandrichtlinie hat, die in der Konfiguration beschrieben werden kann. |
Show Merchant Return Policy | Yes, wenn der Shop eine einheitliche Rückgaberichtlinie hat, die in der Konfiguration beschrieben werden kann. |
Custom Properties | Behalten Sie mindestens sku bei; optional fügen Sie mpn hinzu, wenn der Shop über eine solche Kennung verfügt. |
Cache nach Konfigurationsänderungen leeren
Führen Sie nach einer Konfigurationsänderung aus:
php bin/magento cache:flush
Wenn der Shop zusätzlichen HTTP-Cache, Varnish oder CDN verwendet, leeren Sie auch diese Cache-Ebenen.
Funktionsprüfung
- Öffnen Sie eine Produktseite im Frontend.
- Prüfen Sie den Quellcode der Seite und suchen Sie nach:
We found other products you might like!
WhatsApp
+48608012047
