JSON-LD sau Microdata: ce format alegi pentru marcaj

Ai decis să descrii paginile site-ului pentru motoarele de căutare și ai descoperit că există mai multe moduri de a o face: JSON-LD, Microdata și RDFa. Toate transmit aceeași informație, dar o așază în locuri diferite și o scriu diferit. Alegerea nu schimbă ce înțelege motorul de căutare, însă schimbă cât de ușor întreții marcajul peste un an, când ai de modificat un preț sau de adăugat o pagină.

Ghidul de mai jos compară cele trei formate cu exemple pe aceleași date, explică de ce Google spune în documentația sa că preferă JSON-LD și arată cum treci de la un format la altul fără să rămâi cu marcaj dublat sau stricat.

Ideea comună: aceleași date, trei „ambalaje"

Toate cele trei formate folosesc vocabularul schema.org (tipuri precum Product sau Organization și proprietăți precum name sau price). Diferența este doar modul în care atașezi aceste informații paginii:

• Microdata adaugă atribute direct în etichetele HTML existente, în jurul textului vizibil.
• RDFa funcționează asemănător, tot prin atribute HTML, dar pornește dintr-o familie de standarde mai largă.
• JSON-LD (JSON for Linked Data) pune informațiile într-un bloc separat de cod, care nu atinge HTML-ul vizibil.

Pentru un vizitator, pagina arată identic în toate cazurile. Diferența se simte doar în codul sursă și în munca de întreținere.

Același exemplu în Microdata

Presupunem un produs fictiv. În Microdata, atributele se lipesc de elementele din pagină:

<div itemscope itemtype="https://schema.org/Product">
  <h1 itemprop="name">Cană ceramică albastră</h1>
  <img itemprop="image" src="/img/cana-albastra.jpg" alt="Cană ceramică albastră">
  <p itemprop="description">Cană de 300 ml, lucrată manual.</p>
  <div itemprop="offers" itemscope itemtype="https://schema.org/Offer">
    <span itemprop="price" content="49.00">49 lei</span>
    <meta itemprop="priceCurrency" content="RON">
    <link itemprop="availability" href="https://schema.org/InStock">În stoc
  </div>
</div>

Observă cum informația structurată este amestecată cu structura vizuală: itemscope, itemtype și itemprop apar peste tot în HTML. Dacă un designer mută elementele sau schimbă tema, marcajul poate fi rupt fără ca cineva să observe.

Același exemplu în JSON-LD

Aceleași informații, într-un bloc separat, de obicei plasat în <head> sau la finalul paginii:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Cană ceramică albastră",
  "image": "https://www.exemplu.ro/img/cana-albastra.jpg",
  "description": "Cană de 300 ml, lucrată manual.",
  "offers": {
    "@type": "Offer",
    "price": "49.00",
    "priceCurrency": "RON",
    "availability": "https://schema.org/InStock"
  }
}

Blocul se pune în pagină într-o etichetă <script type="application/ld+json">. HTML-ul vizibil rămâne neatins. Produsul, prețul și moneda sunt citibile dintr-o privire, iar o modificare se face într-un singur loc.

Numele și valorile din ambele exemple sunt inventate, doar pentru comparație.

Ce recomandă Google și de ce

În documentația Google Search Central despre datele structurate, JSON-LD este formatul recomandat. Motivele sunt practice, nu doctrinare:

• Google poate citi toate cele trei formate, dar JSON-LD este cel pe care îl indică drept preferat.
• Este mai ușor de implementat și de întreținut la scară, fiindcă nu trebuie să modifici șabloanele HTML.
• Este mai puțin predispus la erori de imbricare, adică situația în care atributele se încurcă între elementele HTML.
• Poate fi generat dinamic de un script sau de un plugin, pe baza datelor din baza de date a site-ului.

Asta nu înseamnă că Microdata sau RDFa sunt „interzise". Un site care le folosește corect poate continua să funcționeze. Însă pentru un marcaj nou, JSON-LD este alegerea obișnuită. Verifică întotdeauna pagina oficială actuală, pentru că recomandările pot fi reformulate.

Comparație rapidă

Când poate fi încă util Microdata sau RDFa

Cazurile sunt rare, dar există:

• Un sistem vechi care generează deja Microdata corectă și pe care nu îl poți modifica ușor.
• Un șablon dintr-o temă care leagă marcajul de elemente anume, iar migrarea ar cere o refacere mai amplă.
• Un context editorial în care textul din pagină trebuie să rămână strict legat de proprietatea marcată, de pildă când cineva editează conținutul direct în HTML și vrea ca marcajul să se miște odată cu el.

În aceste situații, întrebarea nu este „care format e mai bun în abstract", ci „cât mă costă să le schimb și ce risc iau dacă o fac". Dacă răspunsul e „mult", rămâi cu ce funcționează și migrezi când ai ocazia.

Ce să nu faci: să amesteci formatele pe aceeași informație

Unele site-uri ajung, fără să vrea, cu același produs marcat de două ori: o dată în Microdata, de teme sau de plugin-uri mai vechi, și o dată în JSON-LD, de un instrument nou. Rezultatul este duplicat, uneori cu valori diferite (un preț într-un bloc, altul în celălalt). Motorul de căutare poate alege oricare variantă sau poate ignora ambele.

Regula simplă: pentru fiecare entitate de pe o pagină, alege o singură sursă de marcaj.

Cum migrezi de la Microdata la JSON-LD, pas cu pas

Dacă ai decis să treci la JSON-LD, urmează o ordine sigură:

1. Inventariază ce există. Deschide codul sursă al câtorva pagini reprezentative (pagina principală, un articol, o pagină de produs) și caută itemscope, itemtype și itemprop. Notează ce tipuri și ce proprietăți sunt marcate.
2. Identifică sursa. Află dacă marcajul vine din tema activă, dintr-un plugin sau din cod scris manual. Fără asta, riști să dezactivezi un lucru și să-l regăsești în altă parte.
3. Scrie echivalentul în JSON-LD pentru fiecare tip, cu aceleași valori. Păstrează aceleași nume de proprietăți, acolo unde există.
4. Testează noul marcaj separat, înainte să elimini ceva, cu instrumentele oficiale. Verifică dacă tipurile și proprietățile obligatorii sunt prezente. Vezi și ghidul despre testare și depanare.
5. Elimină Microdata veche din șabloane sau dezactivează opțiunea din plugin, ca să nu ai dublură.
6. Retestează aceleași pagini și compară rezultatul cu cel de la pasul 1.
7. Urmărește în Search Console rapoartele de rezultate îmbogățite pentru câteva săptămâni, ca să observi eventuale scăderi ale paginilor valide.

Dacă site-ul e mare, migrează pe tipuri de pagini, nu totul deodată: începe cu un tip, verifică, apoi continuă.

Unde pui blocul JSON-LD

Poziția în pagină contează mai puțin decât corectitudinea. Practic, blocul poate sta în <head> sau în <body>. Cele mai multe sisteme îl pun în <head>. Reguli utile:

• Un bloc cu @graph poate grupa mai multe entități (organizație, site, pagină, articol), în loc de mai multe blocuri separate.
• Evită scripturile inutile. Un bloc mare, generat cu date repetate, încarcă pagina fără să aducă ceva.
• Nu încerca să ascunzi informații în blocul JSON-LD care lipsesc din pagina vizibilă. Marcajul trebuie să reflecte conținutul real.

Greșeli frecvente

• Virgulă în plus sau ghilimele greșite. JSON-ul este strict: o virgulă după ultimul element sau ghilimele tipografice (curbe) în loc de cele drepte îl fac invalid.
• Valori numerice puse ca text cu unități. La preț, scrie 49.00, nu 49 lei; moneda se trece separat în priceCurrency.
• Dubluri de marcaj. Același produs în Microdata și în JSON-LD, uneori cu valori diferite.
• Marcaj lipsă din conținutul vizibil. Proprietăți prezente în cod, dar care nu apar deloc pe pagină.
• Date copiate între pagini. Aceeași descriere sau același preț repetat pe pagini diferite, fiindcă un șablon a fost copiat fără actualizare.
• Rularea doar a unui test pe pagina principală. Fiecare tip de pagină (articol, produs, categorie) are propriile probleme; testează câte una din fiecare.
• Credința că formatul decide clasamentul. Alegerea dintre JSON-LD și Microdata nu schimbă pozițiile; contează conținutul și corectitudinea datelor.

Întrebări frecvente

Pot folosi JSON-LD și Microdata pe același site?

Tehnic da, dar este mai sigur să nu le combini pentru aceeași entitate. Poți avea un format pe un anumit tip de pagină și altul pe alt tip, atâta timp cât nu duplici aceeași informație pe aceeași pagină.

Dacă am Microdata funcțională, trebuie să migrez neapărat?

Nu. Dacă marcajul este corect, complet și trece testele, poate rămâne. Migrarea are sens când întreținerea devine greoaie, când schimbi tema sau când adaugi tipuri noi pe care le este mai simplu să le scrii în JSON-LD.

JSON-LD încetinește site-ul?

Blocul este text și are, de regulă, o greutate mică în raport cu restul paginii. Devine o problemă doar dacă este foarte mare sau duplicat de mai multe ori. Păstrează-l concis.

Cum verific că formatul ales este citit corect?

Rulează pagina prin instrumentele oficiale: testul pentru rezultate îmbogățite al Google și validatorul schema.org. Apoi urmărește rapoartele din Search Console. Pașii sunt detaliați în ghidul despre testarea datelor structurate.

Cum te ajută Leono Schema & Structured Data

Leono Schema & Structured Data este conceput să genereze marcajul în format JSON-LD, pornind de la datele site-ului tău, ca să nu editezi manual șabloane HTML. Dacă ai un magazin, vezi cum se aplică pe schema Product pentru WooCommerce, iar pentru verificare există pagina despre validarea datelor structurate.

Concluzie

Cele trei formate descriu aceleași lucruri, dar JSON-LD le descrie separat de HTML, ceea ce îl face mai simplu de generat, de verificat și de întreținut. De aceea documentația Google îl indică drept format preferat. Microdata și RDFa rămân valide, mai ales în sisteme vechi, dar pentru marcaj nou JSON-LD este alegerea obișnuită.

Dacă migrezi, fă-o pe etape, testează înainte să ștergi și evită duplicatele. Pentru bazele conceptului, recitește ce sunt datele structurate, iar pentru ce poți aștepta în căutări, consultă ghidul despre rezultatele îmbogățite.