MAGENTO 2 · SCHEMA.ORG · JSON-LD · DATE DESPRE PRODUSE
Kowal SEO Rich Data
Generează JSON-LD pentru produse, oferte, companie și navigație. Folosește recenzii, videoclipuri și FAQ opțional pentru a descrie conținutul magazinului în format schema.org.
Product și Offer · Recenzii și multimedia · Configurare în panou
CUM FUNCȚIONEAZĂ ÎN PRACTICĂ
01 · Completezi datele magazinului
Mapezi atributele și configurezi datele companiei.
02 · Modulul construiește JSON-LD
Generează datele potrivite pentru produs sau pagină.
03 · Verifici publicarea
Verifici conformitatea datelor cu conținutul vizibil al magazinului.
Descoperă funcțiile modulului, utilizarea și modul de configurare.
Modulul adaugă în Magento date structurate schema.org în format JSON-LD. Descrie produsele, categoriile, navigația și compania într-un mod ușor de înțeles pentru sistemele care analizează paginile.
Datele pot susține calificarea conținutului pentru rezultatele extinse acceptate, inclusiv cu preț, disponibilitate sau evaluări. Marcajele corecte nu garantează afișarea acestora, creșterea CTR, pozițiile sau indexarea mai rapidă.
Transmite numele, descrierea, URL-ul, imaginile, SKU și datele de identificare ale produsului. Configurarea permite alegerea surselor pentru marcă, producător și identificatori precum EAN/GTIN.
Descrierea anterioară menționa și MPN. Domeniul identificatorilor emiși trebuie verificat în versiunea specifică a pachetului și în datele produsului, în loc să se presupună disponibilitatea fiecărui câmp.
Oferta poate include prețul, moneda, disponibilitatea, starea produsului și data de valabilitate a prețului. Parametrii corespund datelor Magento și configurației modulului.
Codul actual include și opțiuni pentru datele de livrare și politica de retur: țări, costuri, timpi de procesare și reguli de retur. Completează-le conform condițiilor reale de vânzare.
Datele despre marcă și producător provin din informațiile produsului. În configurare alegi atributele potrivite pentru structura catalogului.
Sursele completate corect permit descrierea legăturilor produsului cu marca și producătorul fără crearea manuală de JSON-LD pentru fiecare fișă.
Descrie compania: nume, site web, logo, descriere, adresă și informații de contact. Configurarea include, printre altele, contactul pentru vânzări, suportul tehnic și serviciul clienți.
Poți completa și linkuri către profilurile sociale. Datele trebuie să corespundă informațiilor publicate în magazin.
Datele breadcrumbs transmit structura paginii și calea către conținutul vizualizat. Ajută sistemele care analizează magazinul să recunoască ierarhia acestuia.
În configurare gestionezi componenta breadcrumbs și opțiunile căii, adaptându-le la navigația catalogului.
Datele WebSite descriu site-ul, iar SearchAction transmite schema de funcționare a motorului intern de căutare al magazinului.
Prezența acestor tipuri schema.org nu înseamnă afișarea automată a unui câmp special de căutare sau a altui element în rezultatele Google.
Lista produselor de pe pagina categoriei poate include numele, imaginea și linkul produsului. Datele structurate transmit contextul colecției prezentate.
Este o descriere a conținutului listei, nu un mecanism de accelerare a indexării. Viteza de indexare depinde și de disponibilitatea paginii, calitatea conținutului și funcționarea motorului de căutare.
Modulul generează date pentru recenzii individuale și pentru evaluarea agregată: nota, numărul de recenzii, conținutul recenziei și autorul. Configurarea include și opțiuni pentru formatul ratingului și sursa recenziilor.
Evaluările pot califica produsul pentru rezultatele acceptate cu stele, dacă îndeplinește cerințele motorului de căutare. Nu există garanția afișării stelelor sau a creșterii numărului de clicuri.
Modulul detectează videoclipurile externe din galeria produsului și generează VideoObject pentru maximum cinci poziții. Datele includ titlul, descrierea, miniatura, URL-ul și data.
În codul verificat, uploadDate provine din data creării produsului. La validare, verifică dacă această valoare corespunde publicării reale a videoclipului.
După instalarea și activarea Kowal Întreabă despre produs, modulul poate construi FAQPage din întrebările și răspunsurile despre produsul respectiv. Codul selectează intrările publicate și limitează rezultatul la 50 de poziții.
Fila cu întrebări, activitatea și titlul acesteia sunt gestionate în modulul Întreabă despre produs. Răspunsurile aprobate ale vânzătorului rămân conținut util pentru clienți și sursă de date structurate.
Google a încetat să afișeze rezultatele extinse FAQ începând cu 7 mai 2026. FAQPage poate descrie în continuare conținutul conform schema.org, dar nu trebuie promisă o secțiune de întrebări și răspunsuri în rezultatele Google.
Aceasta este o clarificare a descrierii anterioare a integrării FAQ. Modificarea este publicată de Google Search Central; nici alte date structurate corecte nu garantează rezultate extinse.
În Stores → Configuration → Kowal → SEO Rich Data setezi componentele disponibile, datele companiei, maparea atributelor și opțiunile pentru datele produsului. JSON-LD este creat automat pentru paginile acceptate.
Descrierea anterioară indica switch-uri separate pentru FAQ și VideoObject. În configurația verificată, aceste procesoare funcționează pe baza datelor și dependențelor disponibile; nu au fost confirmate switch-uri separate pentru ambele. Titlul filei FAQ îl setezi în Întreabă despre produs.
Pachetul actual include și opțiuni HowTo din atributul produsului, SoftwareApplication și proprietăți suplimentare. Integrările cu blogul și TrustedUs sunt opționale.
Adaptorul inclus Kowal_SeoRichDataHyva folosește generatorul principal JSON-LD și ajută la limitarea marcajelor conflictuale în Hyvä. Îl activezi și îl configurezi suplimentar; modulul principal funcționează independent de Hyvä.
Descrierea anterioară indică Magento 2.4.x, testare pe Magento 2.4.7 și PHP 8.1+. Adaptează mediul la cerințele ediției Magento utilizate. Pachetul folosește kowal/base.
Întreabă despre produs este recomandat pentru funcția FAQ, dar nu este necesar pentru datele de bază ale produselor și categoriilor. Verifică și dacă tema sau un alt modul nu emit date contradictorii sau duplicate.
Descrierea ofertei include modulul instalat prin Composer, documentația, cod pregătit conform recomandărilor Magento și suport tehnic la implementare.
Datele structurate pot îmbunătăți modul de descriere a ofertei și pot susține vizibilitatea. Evaluează rezultatele SEO și CTR pe baza măsurătorilor; modulul nu asigură o creștere determinată. Regulile Google privind datele structurate descriu cerințele de calificare pentru rezultatele extinse.
Pachetul kowal/module-seo-rich-data, modulul Kowal_SeoRichData. Configurează accesul la repository-ul Kowal, instalează pachetul, activează modulul, actualizează Magento și golește cache-ul. În producție, include compilarea și deploy-ul conținutului static conform procesului magazinului.
1. Completezi datele magazinului
Mapezi atributele și configurezi datele companiei.
2. Modulul construiește JSON-LD
Generează datele potrivite pentru produs sau pagină.
3. Verifici publicarea
Verifici conformitatea datelor cu conținutul vizibil al magazinului.
Fișa produsului conține preț, disponibilitate și recenzii. SEO Rich Data transmite datele corespunzătoare Product, Offer și AggregateRating în format JSON-LD.
Motorul de căutare primește un context structurat. Afișarea rezultatului extins depinde de regulile și deciziile acestuia.
Vrei să adaptezi modulul la magazinul tău? Întreabă despre implementarea Kowal SEO Rich Data și discută configurarea sau extensiile necesare.
shippingDetails în structura offers pentru datele de produs JSON-LD.hasMerchantReturnPolicy în structura offers pentru datele de produs JSON-LD.shippingDetails,hasMerchantReturnPolicy,gtin8, gtin12, gtin13, gtin14 sau gtin, în funcție de lungimea numărului.ReturnPolicyCategory,ReturnMethod,ReturnFees.brand și manufacturer în JSON-LD.getAttributeText() sau getData() nu returnează valoarea.Block\Product::getResultArray() a fost comutată la logica comună Model\JsonLd\ProductInfo, pentru ca generarea datelor de produs să fie consecventă pe pagina produsului și în listele de categorii.Brand nu apărea în JSON-LD al produsului.shippingDetails,hasMerchantReturnPolicy,Modulul Kowal_SeoRichData adaugă în Magento 2 date structurate schema.org în format JSON-LD. Datele generate pot include produse, oferte, prețuri, disponibilitate, evaluări, recenzii, breadcrumbs, datele organizației, numele site-ului, search box, profiluri sociale, FAQ și video.
Configurarea modulului se află în panoul de administrare Magento:
Stores > Configuration > Kowal > SEO Rich Data
kowal/module-seo-rich-data.kowal/base.bin/magento.Datele de acces la repository-ul Composer (adresa de e-mail a clientului și tokenul de licență) le vei primi prin e-mail după achiziție. Sunt disponibile și în panoul clientului după autentificare pe kowal.store. Înlocuiește TWOJ_EMAIL_KLIENTA cu adresa de e-mail a contului tău, iar TWOJ_TOKEN cu tokenul primit. Execută comenzile în directorul rădăcină Magento.
composer config repositories.kowal composer https://repo.kowal.storecomposer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'composer require kowal/module-seo-rich-dataphp bin/magento module:enable Kowal_SeoRichDataphp bin/magento setup:upgradephp bin/magento setup:di:compilephp bin/magento setup:static-content:deployphp bin/magento cache:flushapp/code/Kowal/SeoRichDataphp bin/magento module:enable Kowal_SeoRichDataphp bin/magento setup:upgradephp bin/magento cache:flushDupă instalare, modulul adaugă atributul de produs:
| Atribut | Semnificație |
|---|---|
offer_item_condition | Starea produsului folosită pentru generarea itemCondition în offers. |
Atributul acceptă valorile:
| Valoare în Magento | Valoare JSON-LD |
|---|---|
DamagedCondition | https://schema.org/DamagedCondition |
NewCondition | https://schema.org/NewCondition |
RefurbishedCondition | https://schema.org/RefurbishedCondition |
UsedCondition | https://schema.org/UsedCondition |
Dacă produsul nu are setată valoarea atributului, modulul îl tratează ca NewCondition.
Toate câmpurile de configurare sunt disponibile pentru domeniile Default, Website și Store View, conform setărilor Magento.
Câmpurile de tip Enabled, Show ... și similare folosesc valorile standard Magento:
| Valoare | Semnificație |
|---|---|
Yes | Funcția este activată și poate genera date JSON-LD. |
No | Funcția este dezactivată. |
Secțiunea răspunde de datele structurate ale traseului de navigare.
| Câmp | Semnificație | Valori |
|---|---|---|
Enabled | Activează generarea datelor BreadcrumbList. | Yes, No |
Fixed Category Path | Pe pagina produsului folosește cea mai detaliată cale a categoriei, atunci când Magento nu furnizează contextul complet al categoriei. | Yes, No |
Type | Definește lungimea căii breadcrumbs generate pentru motorul de căutare. | Default (Long), Short |
Valorile câmpului Type:
| Valoare | Semnificație |
|---|---|
Default (Long) | Cale completă, de ex. Store > Category > Subcategory > Product. |
Short | Cale prescurtată, de ex. Store > Subcategory > Product. |
Secțiunea răspunde de datele de tip WebSite, care pot ajuta Google să recunoască numele site-ului.
| Câmp | Semnificație | Valori |
|---|---|---|
Enabled | Activează generarea datelor WebSite. | Yes, No |
Website Name | Numele site-ului/magazinului transmis în datele structurate. | Text, de ex. numele magazinului. |
Secțiunea răspunde de datele de tip Organization.
| Câmp | Semnificație | Valori |
|---|---|---|
Enabled | Activează generarea datelor organizației. | Yes, No |
Organization Name | Numele companiei sau al magazinului. | Text; câmp obligatoriu după activarea secțiunii. |
Logo Url | URL-ul complet al logo-ului organizației. | URL către fișierul grafic. |
Description | Descrierea organizației. | Text. |
Description Length | Numărul maxim de caractere al descrierii. | Număr; gol înseamnă fără scurtare. |
Country | Țara organizației. | Cod de țară din lista Magento. |
Region/State | Regiune sau județ. | Text. |
ZIP/Postal Code | Cod poștal. | Text. |
City | Oraș. | Text. |
Street Address | Stradă și număr. | Text. |
Sales | Telefonul departamentului de vânzări. | Număr în format internațional, de ex. +48.... |
Technical Support | Telefonul suportului tehnic. | Număr în format internațional. |
Customer Service | Telefonul serviciului clienți. | Număr în format internațional. |
Țara din această secțiune poate fi folosită ca fallback pentru țara de livrare și țara politicii de retur, dacă respectivele câmpuri din secțiunea produsului rămân goale.
Secțiunea adaugă profilurile sociale ale organizației. Pentru ca datele să aibă sens, secțiunea Organization ar trebui să fie activată.
| Câmp | Semnificație | Valori |
|---|---|---|
Enabled | Activează generarea linkurilor către profilurile sociale. | Yes, No |
Facebook | URL-ul profilului Facebook. | URL complet. |
Twitter | URL-ul profilului Twitter / X. | URL complet. |
Google+ | URL-ul profilului Google+. | URL complet; câmp istoric de configurare. |
Instagram | URL-ul profilului Instagram. | URL complet. |
YouTube | URL-ul canalului YouTube. | URL complet. |
LinkedIn | URL-ul profilului LinkedIn. | URL complet. |
Myspace | URL-ul profilului Myspace. | URL complet; câmp istoric de configurare. |
Pinterest | URL-ul profilului Pinterest. | URL complet. |
SoundCloud | URL-ul profilului SoundCloud. | URL complet. |
Tumblr | URL-ul profilului Tumblr. | URL complet. |
Câmpurile goale sunt omise.
Secțiunea răspunde de datele SearchAction, care pot permite afișarea câmpului de căutare al magazinului în rezultatele Google.
| Câmp | Semnificație | Valori |
|---|---|---|
Enabled | Activează generarea datelor motorului de căutare al site-ului. | Yes, No |
Secțiunea răspunde de generarea datelor produselor pe paginile categoriilor.
| Câmp | Semnificație | Valori |
|---|---|---|
Show Products Data | Adaugă date structurate pentru produsele vizibile pe pagina categoriei. | Yes, No |
Activarea acestei opțiuni poate reduce performanța paginilor de categorie, deoarece modulul trebuie să colecteze date pentru mai multe produse.
Secțiunea răspunde de datele principale ale produsului de tip Product și de datele offers.
| Câmp | Semnificație | Valori |
|---|---|---|
Enabled | Activează generarea JSON-LD al produsului pe pagina produsului. | Yes, No |
Show Availability | Adaugă availability în offers. | Yes, No |
priceValidUntil Default Value | Data implicită de valabilitate a prețului. | Dată. |
Use “Special Price To” Value for priceValidUntil Snippet | Dacă produsul are un preț special activ și data Special Price To, această dată înlocuiește valoarea implicită. | Yes, No |
Show Condition | Adaugă itemCondition în offers. | Yes, No |
Description | Definește sursa descrierii produsului în JSON-LD. | None, Product Short Description, Product Full Description, Page Meta Description |
Valorile câmpului Description:
| Valoare | Semnificație |
|---|---|
None | Nu preia descrierea din configurare; codul poate folosi numele produsului ca fallback dacă descrierea este goală. |
Product Short Description | Folosește descrierea scurtă a produsului. |
Product Full Description | Folosește descrierea completă a produsului. |
Page Meta Description | Folosește meta description-ul paginii. |
| Câmp | Semnificație | Valori |
|---|---|---|
Show Configurable Products as | Definește modul de generare a ofertelor pentru produsele configurabile. | Main Offer, List of Associated Products Offers, Aggregate Offer |
Show Grouped Products as | Definește modul de generare a ofertelor pentru produsele grupate. | Main Offer, List of Associated Products Offers, Aggregate Offer |
Valori:
| Valoare | Semnificație |
|---|---|
Main Offer | Generează o singură ofertă pentru produsul principal. |
List of Associated Products Offers | Generează o ofertă separată pentru fiecare produs simplu sau asociat. |
Aggregate Offer | Generează AggregateOffer cu cel mai mic preț, cel mai mare preț și numărul de oferte. |
| Câmp | Semnificație | Valori |
|---|---|---|
Show Rating | Adaugă aggregateRating și review în datele produsului. | Yes, No |
Use Yotpo Reviews instead of Magento Reviews | Preia recenziile din Yotpo în loc de Magento Reviews. | Yes, No |
Rating Format | Definește scala evaluărilor. | Percentage Scale, Numeric Scale |
Number of Reviews | Limita numărului celor mai recente recenzii adăugate în JSON-LD. | Număr; gol înseamnă toate recenziile. |
Valorile câmpului Rating Format:
| Valoare | Semnificație |
|---|---|
Percentage Scale | Evaluările sunt interpretate pe scară procentuală. |
Numeric Scale | Evaluările sunt interpretate pe scară numerică. |
Integrarea cu Yotpo necesită disponibilitatea unui modul care gestionează Yotpo. Dacă modulul nu este instalat, configurarea Yotpo nu ar trebui activată.
| Câmp | Semnificație | Valori |
|---|---|---|
Brand | Atributul produsului folosit pentru generarea proprietății brand. | Orice atribut de produs din listă. |
EAN / GTIN Attribute | Atributul produsului folosit ca identificator global al produsului. | Orice atribut de produs din listă. |
Manufacturer | Atributul produsului folosit pentru generarea proprietății manufacturer. | Orice atribut de produs din listă. |
Câmpul EAN / GTIN Attribute generează proprietatea în funcție de numărul de cifre:
| Număr de cifre | Proprietate JSON-LD |
|---|---|
| 8 | gtin8 |
| 12 | gtin12 |
| 13 | gtin13 |
| 14 | gtin14 |
| Alt număr pozitiv de cifre | gtin |
Modulul elimină caracterele care nu sunt cifre din valoarea EAN / GTIN înainte de generarea JSON-LD.
Secțiunea de livrare răspunde de generarea shippingDetails în offers. Datele sunt adăugate doar atunci când secțiunea este activată și are toate valorile necesare.
| Câmp | Semnificație | Valori |
|---|---|---|
Show Shipping Details | Activează generarea shippingDetails. | Yes, No |
Shipping Country | Țara de livrare. | Cod de țară din lista Magento; dacă este gol, se folosește țara din secțiunea Organization. |
Shipping Price | Costul livrării. | Număr egal sau mai mare decât 0; 0 înseamnă livrare gratuită. |
Handling Time Min Days | Timpul minim de procesare a comenzii. | Număr întreg, zile. |
Handling Time Max Days | Timpul maxim de procesare a comenzii. | Număr întreg, zile. |
Transit Time Min Days | Timpul minim de transport. | Număr întreg, zile. |
Transit Time Max Days | Timpul maxim de transport. | Număr întreg, zile. |
Moneda costului de livrare este preluată din moneda ofertei produsului.
Exemplu privind semnificația valorilor:
| Câmp | Exemplu | Semnificație |
|---|---|---|
Shipping Price | 0 | Livrare gratuită. |
Handling Time Min Days | 0 | Comanda poate fi procesată în aceeași zi. |
Handling Time Max Days | 1 | Procesarea comenzii durează maximum 1 zi. |
Transit Time Min Days | 1 | Livrarea durează cel puțin 1 zi. |
Transit Time Max Days | 5 | Livrarea durează maximum 5 zile. |
Secțiunea politicii de retur răspunde de generarea hasMerchantReturnPolicy în offers. Datele sunt adăugate doar atunci când secțiunea este activată și are valorile necesare.
| Câmp | Semnificație | Valori |
|---|---|---|
Show Merchant Return Policy | Activează generarea hasMerchantReturnPolicy. | Yes, No |
Return Policy Country | Țara în care se aplică politica de retur. | Cod de țară din lista Magento; dacă este gol, se folosește țara din secțiunea Organization. |
Return Policy Category | Tipul politicii de retur. | Finite Return Window, Returns Not Permitted, Unlimited Return Window |
Merchant Return Days | Numărul de zile pentru retur. | Număr întreg; obligatoriu pentru Finite Return Window. |
Return Method | Metoda de retur acceptată. | -- Empty --, Return By Mail, Return In Store, Return At Kiosk |
Return Fees | Informații despre taxele de retur. | -- Empty --, Free Return, Customer Responsibility, Return Shipping Fees |
Return Shipping Fee | Valoarea taxei pentru expedierea de retur. | Număr mai mare decât 0; obligatoriu doar pentru Return Shipping Fees. |
Valorile câmpului Return Policy Category:
| Valoare | Valoare JSON-LD | Semnificație |
|---|---|---|
Finite Return Window | https://schema.org/MerchantReturnFiniteReturnWindow | Retur posibil pentru un număr definit de zile. Necesită Merchant Return Days. |
Returns Not Permitted | https://schema.org/MerchantReturnNotPermitted | Retururile nu sunt permise. |
Unlimited Return Window | https://schema.org/MerchantReturnUnlimitedWindow | Retur fără limită definită de zile. |
Valorile câmpului Return Method:
| Valoare | Valoare JSON-LD | Semnificație |
|---|---|---|
-- Empty -- | fără valoare | Metoda de retur nu este adăugată în JSON-LD. |
Return By Mail | https://schema.org/ReturnByMail | Retur prin expediere poștală/curier. |
Return In Store | https://schema.org/ReturnInStore | Retur în magazin fizic. |
Return At Kiosk | https://schema.org/ReturnAtKiosk | Retur la punct/kiosk. |
Valorile câmpului Return Fees:
| Valoare | Valoare JSON-LD | Semnificație |
|---|---|---|
-- Empty -- | fără valoare | Informația despre taxe nu este adăugată în JSON-LD. |
Free Return | https://schema.org/FreeReturn | Returul este gratuit. |
Customer Responsibility | https://schema.org/ReturnFeesCustomerResponsibility | Costul returului este suportat de client. |
Return Shipping Fees | https://schema.org/ReturnShippingFees | Returul are o taxă definită pentru expedierea de retur. Necesită Return Shipping Fee. |
Moneda câmpului Return Shipping Fee este preluată din moneda ofertei produsului.
Câmpul Custom Properties permite adăugarea de proprietăți proprii în JSON-LD al produsului.
Format:
wlasciwosc_jsonld,kod_atrybutuDacă este introdus un singur element, modulul îl tratează simultan ca nume al proprietății JSON-LD și cod de atribut.
Valoare implicită:
skumpn,skuSemnificația valorii implicite:
| Linie | Efect |
|---|---|
sku | Adaugă sku pe baza atributului sku. |
mpn,sku | Adaugă mpn pe baza atributului sku. |
Exemplu de adăugare a unui atribut propriu:
color,colormaterial,materialPentru a limita avertismentele Google Search Console pentru datele de produs, configurează cel puțin:
| Câmp | Recomandare |
|---|---|
Product Rich Data > Enabled | Yes |
Show Availability | Yes |
Brand | Alege atributul cu marca produsului. |
EAN / GTIN Attribute | Alege atributul cu EAN / GTIN, dacă produsele au un identificator global. |
Show Shipping Details | Yes, dacă magazinul are o politică de livrare uniformă, care poate fi descrisă în configurare. |
Show Merchant Return Policy | Yes, dacă magazinul are o politică de retur uniformă, care poate fi descrisă în configurare. |
Custom Properties | Păstrează cel puțin sku; opțional adaugă mpn, dacă magazinul deține un astfel de identificator. |
După modificarea configurării, execută:
php bin/magento cache:flushDacă magazinul folosește cache HTTP suplimentar, Varnish sau CDN, golește și aceste straturi de cache.
<script type='application/ld+json'>{ '@type': 'Product', 'brand': { '@type': 'Brand', 'name': 'Example Brand' }, 'gtin13': '5901234123457', 'offers': [ { '@type': 'Offer', 'shippingDetails': {}, 'hasMerchantReturnPolicy': {} } ]}shippingDetails sau hasMerchantReturnPolicy dacă valorile din configurare nu corespund politicii reale a magazinului.Brand, Manufacturer sau EAN / GTIN Attribute, merită să reindexezi datele produsului, dacă magazinul folosește cache sau indecși care influențează citirea atributelor.