JSON-LD
Cunoscut și ca: marcaj JSON-LD, date structurate JSON-LD, JavaScript Object Notation for Linked Data
Ce este JSON-LD?
Pe scurt
JSON-LD este un format pentru includerea datelor structurate într-o pagină web. Marcajul este introdus într-un element `<script type="application/ld+json">` și descrie explicit conținutul paginii prin tipuri și proprietăți, de regulă din vocabularul schema.org. Google recomandă JSON-LD deoarece este, în general, ușor de implementat și întreținut.
JSON-LD înseamnă „JavaScript Object Notation for Linked Data”. Este unul dintre formatele acceptate de Google pentru date structurate, alături de Microdata și RDFa.
Cum funcționează
Marcajul JSON-LD este inclus într-un element <script> din secțiunea <head> sau <body> a paginii HTML. El nu este intercalat cu textul vizibil. Din acest motiv, obiectele și proprietățile imbricate pot fi exprimate mai ușor decât în formatele care folosesc atribute HTML.
Prin tipuri și proprietăți, JSON-LD oferă indicii explicite despre semnificația conținutului. De exemplu, o pagină poate fi descrisă ca rețetă, iar marcajul poate identifica numele, autorul, ingredientele și instrucțiunile. Vocabularul schema.org include tipuri precum Recipe, Person, Organization, Product, Event și LocalBusiness.
Google poate folosi aceste informații pentru a înțelege conținutul și, când sunt respectate cerințele aplicabile, pentru afișări îmbunătățite în rezultatele căutării. Includerea marcajului nu garantează însă apariția unui rich result.
Reguli de implementare
Datele structurate trebuie să descrie pagina pe care sunt publicate. Informațiile marcate trebuie să fie vizibile utilizatorilor, complete și corecte. Nu trebuie create pagini goale doar pentru a găzdui date structurate.
Pentru funcțiile Google Search trebuie consultată documentația Google Search Central. schema.org conține și proprietăți care nu sunt cerute de Google, deși pot fi utile altor motoare, servicii sau platforme.
Google poate citi și JSON-LD introdus dinamic în pagină prin JavaScript sau prin componentele unui CMS. Implementarea trebuie totuși validată după publicare, deoarece erorile de șablon sau de servire pot afecta marcajul.
De ce contează în SEO?
JSON-LD ajută Google să primească indicii explicite despre semnificația unei pagini. În SEO, un marcaj valid și relevant poate contribui la eligibilitatea paginii pentru anumite rich results. Aceste afișări pot prezenta informațiile într-o formă mai utilă în rezultatele căutării, dar eligibilitatea nu garantează că Google va afișa rezultatul îmbunătățit.
Marcajul susține clasificarea coerentă a conținutului. Tipurile și proprietățile pot descrie persoane, organizații, produse, rețete, evenimente sau alte elemente. Pentru Google, proprietățile obligatorii, recomandate și opționale trebuie alese conform documentației funcției vizate. Este preferabil un set mai restrâns de proprietăți complete și exacte decât un marcaj extins, dar incorect.
JSON-LD oferă informații într-un format care poate fi procesat automat. Extrasele furnizate nu stabilesc însă că folosirea JSON-LD determină vizibilitatea, includerea sau citarea în AI Overviews, AI Mode, ChatGPT, Perplexity ori Gemini.
Prin urmare, JSON-LD trebuie tratat ca un marcaj tehnic descriptiv, nu ca o garanție GEO. Conținutul vizibil trebuie să rămână complet și corect. Marcajul nu trebuie să introducă afirmații care lipsesc din pagină și nu înlocuiește informația destinată utilizatorului.
Exemplu
Un site românesc cu rețete publică o pagină despre plăcintă cu mere. Pagina afișează numele rețetei, autorul, descrierea și ingredientele. Același conținut poate fi descris prin JSON-LD:
<script type="application/ld+json">
{
"@context": "https://schema.org/",
"@type": "Recipe",
"name": "Plăcintă cu mere",
"author": {
"@type": "Person",
"name": "Ana Popescu"
},
"description": "Rețetă de plăcintă cu mere și scorțișoară.",
"recipeIngredient": [
"mere",
"făină",
"scorțișoară"
]
}
</script>
Exemplul descrie conținutul paginii, dar nu reprezintă singur o confirmare a eligibilității pentru un rich result. Proprietățile necesare trebuie verificate în documentația Google aferentă tipului Recipe.
Cum verifici?
- Deschide pagina în Rich Results Test pentru a valida datele structurate și pentru a vedea dacă este detectat un tip acceptat.
- Verifică problemele raportate pentru proprietățile implementate.
- Compară marcajul cu informațiile vizibile pe pagină. Numele, descrierile și celelalte valori trebuie să corespundă conținutului afișat.
- Consultă documentația Google Search Central pentru proprietățile obligatorii și recomandate ale funcției urmărite.
- După publicare, urmărește rapoartele pentru rich results din Google Search Console. Acestea pot semnala probleme apărute din cauza șabloanelor sau a modului de servire a paginii.
Ce trebuie să faci?
- Alege tipul schema.org care descrie corect conținutul principal al paginii.
- Include toate proprietățile obligatorii documentate de Google pentru funcția urmărită.
- Adaugă numai proprietăți corecte, complete și susținute de conținutul vizibil.
- Folosește JSON-LD dacă este formatul cel mai simplu de implementat și întreținut în site sau CMS.
- Validează marcajul în timpul dezvoltării și verifică rapoartele relevante după publicare.
- Corectează șabloanele care generează valori goale, incorecte sau diferite de conținutul paginii.
Greșeli frecvente
- Marcajul descrie informații care nu sunt vizibile utilizatorilor pe pagină.
- Lipsesc proprietăți obligatorii pentru tipul de rezultat îmbunătățit urmărit.
- Sunt adăugate multe proprietăți incomplete sau inexacte doar pentru a extinde marcajul.
- Este folosită documentația schema.org ca autoritate pentru comportamentul Google, fără verificarea cerințelor Google Search Central.
- Implementarea este testată înainte de publicare, dar nu mai este monitorizată pentru erori produse de șabloane sau servire.
Perspectiva SEO 365
În practica SEO 365, definim mai întâi conținutul real al paginii și abia apoi marcajul JSON-LD corespunzător. Punem accentul pe proprietăți complete, exacte și conforme cu documentația Google. Evităm folosirea datelor structurate pentru informații care nu apar în conținutul vizibil.