SEO Rich Data – Installation und Konfiguration
Zweck des Moduls
Das ModulKowal_SeoRichDatafügt Magento 2 strukturierte Datenschema.orgim JSON-LD-Format hinzu. Die generierten Daten können Produkte, Angebote, Preise, Verfügbarkeit, Bewertungen, Rezensionen, Breadcrumbs, Organisationsdaten, den Seitennamen, eine Search Box, Social-Media-Profile, FAQ und Videos umfassen.
Die Konfiguration des Moduls befindet sich im Magento-Admin-Panel:
Stores > Configuration > Kowal > SEO Rich Data
Anforderungen
- Magento 2.
- Zugriff auf die Magento CLI.
- Zugriff auf das Composer repository mit dem Paket
kowal/module-seo-rich-dataverwendet.
- Erforderliches Basispaket:
kowal/baseverwendet.
- Berechtigungen zum Ausführen von
bin/magentoverwendet.
Installation über Composer
- Fügen Sie das Paket-Repository hinzu:
Die Zugangsdaten für das Composer-Repository, also die E-Mail-Adresse des Kunden und der Lizenz-Token, erhalten Sie nach dem Kauf per E-Mail. Sie sind nach der Anmeldung unter kowal.storeauch im Kundenkonto verfügbar. Ersetzen Sie TWOJ_EMAIL_KLIENTA durch die E-Mail-Adresse Ihres Kontos und TWOJ_TOKEN durch den erhaltenen Token. Führen Sie die Befehle im Magento-Stammverzeichnis aus.
composer config repositories.kowal composer https://repo.kowal.store
2. Konfigurieren Sie die Zugangsdaten zum Composer-Repository von Kowal:
composer config http-basic.repo.kowal.store "TWOJ_EMAIL_KLIENTA" "TWOJ_TOKEN"
3. Installieren Sie das Modul:
composer require kowal/module-seo-rich-data
4. Aktivieren Sie das Modul:
php bin/magento module:enable Kowal_SeoRichData
5. Führen Sie das Magento-Update aus:
php bin/magento setup:upgrade
6. Führen Sie in der Produktionsumgebung die DI-Kompilierung aus:
php bin/magento setup:di:compile
7. Generieren Sie in der Produktionsumgebung, falls das Projekt dies erfordert, statische Dateien:
php bin/magento setup:static-content:deploy
php bin/magento cache:flush
Manuelle Installation
- Kopieren Sie das Modul in das Verzeichnis:
app/code/Kowal/SeoRichData
2. Aktivieren Sie das Modul:
php bin/magento module:enable Kowal_SeoRichData
3. Führen Sie das Magento-Update aus:
php bin/magento setup:upgrade
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 zur Generierung vonitemConditioninoffersverwendet. |
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 alsNewConditionverwendet.
Konfigurationsumfang
Alle Konfigurationsfelder sind gemäß den Magento-Einstellungen für die BereicheDefault,WebsiteundStore Viewverfügbar.
Felder vom TypEnabled,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
Dieser Abschnitt ist für die strukturierten Daten des Navigationspfads zuständig.
| Feld |
Bedeutung |
Werte |
Enabled |
Aktiviert die Generierung vonBreadcrumbListverwendet. |
Yes,No |
Fixed Category Path |
Verwendet auf der Produktseite den detailliertesten Kategoriepfad, wenn Magento keinen vollständigen Kategoriekontext bereitstellt. |
Yes,No |
Type |
Bestimmt die Länge des für die Suchmaschine generierten Breadcrumb-Pfads. |
Default (Long),Short |
Werte des FeldesType:
| Wert |
Bedeutung |
Default (Long) |
Vollständiger Pfad, z. B.Store > Category > Subcategory > Productverwendet. |
Short |
Verkürzter Pfad, z. B.Store > Subcategory > Productverwendet. |
Seitennamen in Suchergebnissen anzeigen
Dieser Abschnitt ist für Daten vom TypWebSitezuständig, die Google dabei helfen können, den Namen der Website zu erkennen.
| Feld |
Bedeutung |
Werte |
Enabled |
Aktiviert die Generierung vonWebSiteverwendet. |
Yes,No |
Website Name |
Name der Website/des Shops, der in den strukturierten Daten übergeben wird. |
Text, z. B. der Shopname. |
Organization
Dieser Abschnitt ist für Daten vom TypOrganizationverwendet.
| Feld |
Bedeutung |
Werte |
Enabled |
Aktiviert die Generierung von Organisationsdaten. |
Yes,No |
Organization Name |
Name des Unternehmens oder Shops. |
Text; nach Aktivierung des Abschnitts erforderlich. |
Logo Url |
Vollständige URL des Organisationslogos. |
URL zur Bilddatei. |
Description |
Beschreibung der Organisation. |
Text. |
Description Length |
Maximale Anzahl der 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 |
Telefonnummer der Vertriebsabteilung. |
Nummer im internationalen Format, z. B.+48...verwendet. |
Technical Support |
Telefonnummer des technischen Supports. |
Nummer im internationalen Format. |
Customer Service |
Telefonnummer des Kundenservice. |
Nummer im internationalen Format. |
Das Land aus diesem Abschnitt kann als Fallback für das Versandland und das Land der Rückgaberichtlinie verwendet werden, wenn die entsprechenden Felder im Produktabschnitt leer bleiben.
Social Profiles
Dieser Abschnitt fügt die Social-Media-Profile der Organisation hinzu. Damit die Daten sinnvoll sind, sollte der AbschnittOrganizationaktiviert 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
Dieser Abschnitt ist fürSearchAction-Daten zuständig, die die Anzeige eines Shop-Suchfelds in 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
Dieser 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 erfassen muss.
Product Rich Data
Dieser Abschnitt ist für die wichtigsten Produktdaten vom TypProductsowie füroffersverwendet.
Grundlegende Produktfelder
| Feld |
Bedeutung |
Werte |
Enabled |
Aktiviert die Generierung von Produkt-JSON-LD auf der Produktseite. |
Yes,No |
Show Availability |
Fügtavailabilityinoffersverwendet. |
Yes,No |
priceValidUntil Default Value |
Standarddatum für die Preisgültigkeit. |
Datum. |
Use “Special Price To” Value for priceValidUntil Snippet |
Wenn das Produkt einen aktiven Sonderpreis und einSpecial Price To-Datum hat, ersetzt dieses Datum den Standardwert. |
Yes,No |
Show Condition |
FügtitemConditioninoffersverwendet. |
Yes,No |
Description |
Bestimmt die Quelle der Produktbeschreibung in JSON-LD. |
None,Product Short Description,Product Full Description,Page Meta Description |
Werte des FeldesDescription:
| 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 |
Bestimmt die Art der Angebotsgenerierung für konfigurierbare Produkte. |
Main Offer,List of Associated Products Offers,Aggregate Offer |
Show Grouped Products as |
Bestimmt die Art der Angebotsgenerierung für gruppierte Produkte. |
Main Offer,List of Associated Products Offers,Aggregate Offer |
Werte:
| Wert |
Bedeutung |
Main Offer |
Generiert ein einzelnes Angebot für das Hauptprodukt. |
List of Associated Products Offers |
Generiert ein separates Angebot für jedes einfache oder verknüpfte Produkt. |
Aggregate Offer |
GeneriertAggregateOffermit dem niedrigsten Preis, dem höchsten Preis und der Anzahl der Angebote. |
Bewertungen und Rezensionen
| Feld |
Bedeutung |
Werte |
Show Rating |
FügtaggregateRatingundreviewzu 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 |
Bestimmt die Bewertungsskala. |
Percentage Scale,Numeric Scale |
Number of Reviews |
Limit für die Anzahl der neuesten Rezensionen, die zu JSON-LD hinzugefügt werden. |
Zahl; leer bedeutet alle Rezensionen. |
Werte des FeldesRating 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 Produktkennzeichnungen
| Feld |
Bedeutung |
Werte |
Brand |
Produktattribut, das zur Generierung der Eigenschaftbrandverwendet. |
Beliebiges Produktattribut aus der Liste. |
EAN / GTIN Attribute |
Produktattribut, das als globale Produktkennzeichnung verwendet wird. |
Beliebiges Produktattribut aus der Liste. |
Manufacturer |
Produktattribut, das zur Generierung der Eigenschaftmanufacturerverwendet. |
Beliebiges Produktattribut aus der Liste. |
FeldEAN / GTIN Attributegeneriert 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 vor der Generierung von JSON-LD alle Nicht-Ziffern aus dem EAN-/GTIN-Wert.
Shipping details
Der Versandabschnitt ist für die Generierung vonshippingDetailsinofferszuständig. Die Daten werden nur hinzugefügt, wenn der Abschnitt aktiviert ist und alle erforderlichen Werte vollständig vorhanden sind.
| Feld |
Bedeutung |
Werte |
Show Shipping Details |
Aktiviert die Generierung vonshippingDetailsverwendet. |
Yes,No |
Shipping Country |
Lieferland. |
Ländercode aus der Magento-Liste; wenn leer, wird das Land aus dem AbschnittOrganizationverwendet. |
Shipping Price |
Versandkosten. |
Zahl gleich oder größer als0;0bedeutet kostenlosen 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 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 zur Rückgaberichtlinie ist für die Generierung vonhasMerchantReturnPolicyinofferszuständig. Die Daten werden nur hinzugefügt, wenn der Abschnitt aktiviert ist und die erforderlichen Werte vorhanden sind.
| Feld |
Bedeutung |
Werte |
Show Merchant Return Policy |
Aktiviert die Generierung vonhasMerchantReturnPolicyverwendet. |
Yes,No |
Return Policy Country |
Land, in dem die Rückgaberichtlinie gilt. |
Ländercode aus der Magento-Liste; wenn leer, wird das Land aus dem AbschnittOrganizationverwendet. |
Return Policy Category |
Typ der Rückgaberichtlinie. |
Finite Return Window,Returns Not Permitted,Unlimited Return Window |
Merchant Return Days |
Anzahl der Tage für die Rückgabe. |
Ganzzahl; erforderlich fürFinite Return Windowverwendet. |
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 als0; nur erforderlich fürReturn Shipping Feesverwendet. |
Werte des FeldesReturn Policy Category:
| Wert |
JSON-LD-Wert |
Bedeutung |
Finite Return Window |
https://schema.org/MerchantReturnFiniteReturnWindow |
Rückgabe für eine festgelegte Anzahl von Tagen möglich. ErfordertMerchant Return Daysverwendet. |
Returns Not Permitted |
https://schema.org/MerchantReturnNotPermitted |
Rückgaben sind nicht erlaubt. |
Unlimited Return Window |
https://schema.org/MerchantReturnUnlimitedWindow |
Rückgabe ohne festgelegte Tagesbegrenzung. |
Werte des FeldesReturn 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 FeldesReturn 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. ErfordertReturn Shipping Feeverwendet. |
Die Währung des FeldesReturn Shipping Feewird aus der Währung des Produktangebots übernommen.
Custom Properties
FeldCustom Propertiesermö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:
sku
mpn,sku
Bedeutung des Standardwerts:
| Zeile |
Effekt |
sku |
Fügtskuauf Basis des Attributsskuverwendet. |
mpn,sku |
Fügtmpnauf Basis des Attributsskuverwendet. |
Beispiel für das Hinzufügen eines eigenen Attributs:
color,color
material,material
Empfohlene Mindestkonfiguration für Produkte
Um Warnungen in der Google Search Console für Produktdaten zu reduzieren, konfigurieren Sie mindestens:
| Feld |
Empfehlung |
Product Rich Data > Enabled |
Yes |
Show Availability |
Yes |
Brand |
Wählen Sie das Attribut mit der Produktmarke aus. |
EAN / GTIN Attribute |
Wählen Sie das Attribut mit EAN/GTIN aus, wenn die Produkte eine globale Kennzeichnung 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 mindestensskubei; fügen Sie optionalmpnhinzu, wenn der Shop über eine solche Kennzeichnung 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-Schichten.
Funktionsprüfung
- Öffnen Sie die Produktseite im Frontend.
- Prüfen Sie den Quellcode der Seite und suchen Sie nach:
<script type="application/ld+json">
3. Überprüfen Sie, ob JSON-LD die erwarteten Felder enthält, z. B.:
{
"@type": "Product",
"brand": {
"@type": "Brand",
"name": "Example Brand"
},
"gtin13": "5901234123457",
"offers": [
{
"@type": "Offer",
"shippingDetails": {},
"hasMerchantReturnPolicy": {}
}
]
}
4. Testen Sie die Produkt-URL im Tool Google Rich Results Test oder in der Google Search Console.
Implementierungshinweise
- Aktivieren Sie
shippingDetailsoderhasMerchantReturnPolicynicht, wenn die Werte in der Konfiguration nicht der tatsächlichen Richtlinie des Shops entsprechen.
- Wenn sich Versand- oder Rückgaberichtlinien je Produkt, Region, Versandmethode oder Warenkorb unterscheiden, reicht eine globale Konfiguration möglicherweise nicht aus.
- Nach einer Änderung der Attribute
Brand,ManufactureroderEAN / GTIN Attributeempfiehlt es sich, die Produktdaten neu zu indexieren, wenn der Shop Cache oder Indizes verwendet, die das Auslesen von Attributen beeinflussen.
- Prüfen Sie in mehrsprachigen und mehrwährungsfähigen Shops die Konfiguration separat für jeden Store View.
