Cum testezi și depanezi datele structurate pas cu pas

Marcajul de date structurate se strică ușor și tăcut. O virgulă în plus, o temă actualizată sau un plugin care adaugă încă un bloc, iar pagina arată la fel pentru vizitatori, dar motorul de căutare citește altceva decât ai vrut. Din această cauză, testarea nu este un pas de făcut o singură dată, la lansare, ci un obicei: testezi la implementare, după modificări mari și periodic, cât timp site-ul trăiește.

Ghidul de mai jos arată ce instrumente oficiale ai la dispoziție, ce înseamnă fiecare tip de mesaj, cum depanezi cele mai frecvente probleme și cum urmărești rezultatele în timp. Totul este descris fără presupuneri de cunoștințe de programare.

Ce înseamnă „corect" în cazul datelor structurate

Un marcaj poate fi „corect" în trei sensuri diferite, iar testarea ar trebui să le verifice pe toate:

Corect sintactic. Codul este scris după regulile formatului. În JSON-LD înseamnă JSON valid, cu ghilimele, acolade și virgule la locul lor.
Corect semantic. Tipurile și proprietățile există în schema.org și sunt folosite potrivit (un preț este număr, o dată are formatul cerut).
Corect față de cerințele motorului de căutare. Pentru un anumit rezultat îmbogățit, Google cere proprietăți anume. Un marcaj valid schema.org poate totuși să nu fie eligibil pentru un format special dacă lipsește o proprietate obligatorie.

Un al patrulea sens, adesea uitat: marcajul trebuie să fie corect față de pagină, adică să descrie ce se vede acolo. Niciun instrument automat nu poate verifica asta pentru tine; trebuie să te uiți tu.

Instrumentele oficiale

Ai câteva instrumente gratuite, fiecare cu rolul lui.

Testul pentru rezultate îmbogățite (Rich Results Test)

Este instrumentul Google care primește o adresă sau o bucată de cod și arată ce tipuri de rezultate îmbogățite au fost detectate și dacă îndeplinesc cerințele. Poți testa o pagină publică sau poți lipi cod, ceea ce e util înainte de publicare. Instrumentul afișează erorile și avertismentele pentru fiecare element detectat.

Limită importantă: testul se uită la tipurile pentru care Google are formate îmbogățite. Un tip valid în schema.org, dar fără format îmbogățit, poate să nu apară deloc în rezultat.

Validatorul Schema Markup Validator

Este instrumentul asociat vocabularului schema.org. Verifică dacă marcajul respectă vocabularul, indiferent dacă Google are sau nu un rezultat îmbogățit pentru tipul respectiv. Îl folosești când vrei să verifici corectitudinea generală a structurii, nu eligibilitatea pentru un anumit format.

Pe scurt: Rich Results Test răspunde la „e eligibil pentru Google?", iar validatorul schema.org la „e scris corect?". De multe ori îți trebuie ambele.

Google Search Console

Search Console este instrumentul pe care îl folosești după publicare. Include:

Rapoarte de rezultate îmbogățite (în secțiunea de îmbunătățiri), unde vezi, pe tip, câte pagini sunt valide, câte au avertismente și câte au erori.
Inspectarea adresei URL, care arată cum a văzut Google o pagină anume, inclusiv elementele detectate, și permite cererea unei reindexări după corecții.

Rapoartele se actualizează cu întârziere, iar disponibilitatea lor depinde de tipurile detectate pe site. Nu te aștepta la rezultat imediat după o modificare.

Instrumentele browserului

Pentru depanare rapidă ai la îndemână și browserul. Poți vedea codul sursă al paginii (în mod obișnuit, clic dreapta și vizualizare sursă) și poți căuta textul application/ld+json pentru a vedea ce blocuri sunt prezente și câte. Panoul pentru dezvoltatori din browser te ajută să verifici ce se încarcă efectiv pe pagină, nu doar ce se află în fișierele temei.

Cum citești mesajele: eroare, avertisment, informație

Terminologia diferă puțin între instrumente, dar logica este similară:

Eroare. Lipsește ceva obligatoriu sau o valoare este invalidă. Elementul nu este eligibil pentru rezultatul îmbogățit respectiv. Se corectează cu prioritate.
Avertisment. Lipsește o proprietate recomandată sau o valoare este neobișnuită. Elementul poate rămâne eligibil, dar informația e mai săracă. Merită corectat dacă ai datele.
Element detectat fără probleme. Ai marcajul, nu sunt probleme raportate. Nu înseamnă garanția afișării.

Nu ignora avertismentele pe motiv că „nu blochează". De multe ori îți arată informații ușor de completat, care fac marcajul mai complet.

Un flux de depanare pe care îl poți repeta

Când ceva nu merge, un traseu fix te scutește de ghicit:

Alege o pagină-test reprezentativă pentru tipul cu probleme (un articol, un produs, pagina principală).
Rulează Rich Results Test pe adresa publică. Notează tipurile detectate, erorile și avertismentele.
Compară cu ce te așteptai. Lipsește un tip? Apare de două ori? Are valori vechi?
Verifică sursa paginii și caută application/ld+json. Numără blocurile și citește-le.
Identifică de unde vine fiecare bloc: temă, plugin SEO, plugin dedicat, cod manual. Dezactivează pe rând sursele suspecte, pe o copie de lucru dacă e posibil.
Corectează o singură problemă o dată și retestează. Dacă schimbi mai multe lucruri deodată, nu mai știi ce a funcționat.
După corecție, cere reindexarea paginii din Search Console (inspectarea adresei URL) și urmărește raportul în zilele următoare.
Notează ce ai găsit. O mică listă cu cauzele întâlnite te ajută la următoarea depanare.

Erori și probleme frecvente, cu cauze probabile

Marcaj care nu este detectat deloc

Cauze posibile: blocul este în pagină doar după încărcarea dinamică și instrumentul nu îl vede; există o eroare de sintaxă care face blocul ilizibil; pagina este blocată de robots.txt sau cere autentificare; ai verificat o versiune în cache. Verifică mai întâi sursa paginii și faptul că pagina este accesibilă public.

Eroare de sintaxă JSON

Cel mai des: virgulă după ultimul element dintr-un obiect, ghilimele curbe (copiate din editoare de text) în loc de ghilimele drepte, ghilimele neescapate în interiorul unui text, acolade lipsă. Un exemplu corect, simplu:

{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "Atelier Exemplu",
  "telephone": "+40 700 000 000",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Strada Exemplului 1",
    "addressLocality": "București",
    "addressCountry": "RO"
  }
}

Dacă ștergi, de pildă, ghilimelele de la "telephone" sau adaugi o virgulă după ultima proprietate, întregul bloc devine invalid. Datele din exemplu sunt fictive.

Câmp obligatoriu lipsă

Pentru un anumit tip de rezultat îmbogățit, documentația cere proprietăți anume. Testul îți spune care lipsește. Completează-l numai dacă ai informația reală; nu inventa valori ca să dispară eroarea.

Valori în format greșit

Preț scris cu text („49 lei" în loc de 49.00 și monedă separată), date calendaristice în format local în loc de formatul standard (de exemplu 2026-03-10), adrese de imagini relative în loc de absolute. Fiecare proprietate are formatul ei așteptat; verifică-l în documentație.

Mai multe blocuri care se contrazic

Tema generează un bloc, un plugin SEO altul, iar un plugin de recenzii un al treilea. Fiecare declară, de pildă, o organizație cu date ușor diferite. Soluția este să alegi o singură sursă pentru fiecare entitate și să oprești celelalte opțiuni.

Marcaj care nu corespunde paginii

Instrumentul nu detectează asta. Dacă în marcaj apare o evaluare sau un preț pe care vizitatorul nu le vede, rezolvarea este să afișezi informația onest sau să o scoți din marcaj.

Marcaj bun, dar fără rezultat îmbogățit

Nu e neapărat o problemă tehnică. Poate fi o politică (tipul este restrâns sau retras), calitatea paginii sau pur și simplu decizia motorului de căutare. Citește și ghidul despre rezultatele îmbogățite pentru contextul schimbărilor.

Lista de verificare înainte de publicare

Poți copia lista asta și o poți reutiliza de fiecare dată:

Blocul este JSON valid (ghilimele drepte, fără virgule în plus).
Tipul ales descrie fidel pagina.
Toate proprietățile obligatorii pentru rezultatul vizat sunt completate cu date reale.
Informațiile din marcaj apar și în conținutul vizibil.
Prețurile, datele și adresele sunt actuale.
Pe pagină nu există blocuri duplicate pentru aceeași entitate.
Imaginile menționate există la adresele indicate și sunt accesibile public.
Ai testat cel puțin o pagină din fiecare tip (articol, produs, categorie, pagină principală).
Ai notat data testului și ce ai schimbat.

Ce testezi după modificări mari ale site-ului

Marcajul se poate strica indirect, din motive care nu țin de el:

Schimbarea temei poate elimina sau dubla blocurile generate de șabloane.
Actualizarea unui plugin poate modifica ce date produce.
Migrarea pe alt domeniu sau trecerea de la HTTP la HTTPS poate lăsa în marcaj adrese vechi.
Restructurarea adreselor poate strica BreadcrumbList sau @id-urile.
Schimbarea prețurilor sau a stocurilor în masă poate lăsa date vechi, dacă marcajul nu se actualizează automat.

După fiecare asemenea eveniment, testează câte o pagină din tipurile principale. Pentru un cadru de bază despre ce sunt aceste date, vezi ce sunt datele structurate.

Cum urmărești rezultatele în timp

Testul făcut o dată îți spune cum e situația azi. Pentru monitorizare:

Verifică periodic rapoartele din Search Console, de exemplu o dată pe lună, și compară numărul de elemente valide cu cel anterior.
Configurează notificările pe email din Search Console, dacă sunt disponibile, ca să afli de apariția unor noi probleme.
Retestează paginile-cheie după fiecare lansare importantă.
Păstrează un jurnal simplu (o foaie de calcul sau un document) cu data, pagina, problema și soluția.

Reține că și o scădere a numărului de elemente valide poate veni dintr-o schimbare de politică, nu doar dintr-o greșeală a ta.

Greșeli frecvente

Testarea doar a paginii principale. Fiecare tip de pagină are propriul marcaj și propriile probleme.
Corectarea mai multor lucruri odată. Pierzi legătura dintre cauză și efect.
Ignorarea avertismentelor și a marcajului dublat, pe motiv că „nu apare eroare".
Completarea câmpurilor cu valori inventate doar pentru a elimina mesajele din instrument.
Verificarea unei versiuni din cache sau a unei pagini nepublicate și tragerea de concluzii greșite.
Așteptarea unui rezultat imediat în Search Console. Rapoartele se actualizează cu întârziere.
Confundarea validării cu afișarea. Un marcaj fără erori nu garantează un rezultat îmbogățit.

Întrebări frecvente

Care instrument să folosesc primul?

Rich Results Test este un bun punct de plecare dacă vizezi un rezultat îmbogățit Google. Dacă vrei să verifici structura generală față de vocabular, folosește și validatorul schema.org. Ambele sunt gratuite.

De ce Search Console arată alte lucruri decât testul?

Testul analizează pagina în momentul rulării, iar Search Console reflectă ce a procesat Google în trecut, cu întârziere. Diferențele sunt normale, mai ales imediat după o corecție. Cere reindexarea paginii și urmărește raportul în zilele următoare.

Pot testa o pagină înainte să o public?

Da, dacă lipești codul direct în Rich Results Test sau în validatorul schema.org. Pentru o pagină nepublicată, instrumentul nu poate încărca adresa, dar poate analiza codul copiat.

Cât de des ar trebui să testez?

La fiecare modificare relevantă (temă, plugin, structură, produse noi) și, ca regulă generală, periodic, de pildă o dată pe trimestru. Politicile Google se schimbă, deci o verificare regulată merită.

Cum te ajută Leono Schema & Structured Data

Leono Schema & Structured Data include validare și testare în interfața WordPress, ca să vezi problemele înainte de publicare. Detaliile despre verificări sunt în pagina despre validarea datelor structurate, iar pentru site-uri gestionate pentru clienți există pagina despre schema markup pentru agenții.

Concluzie

Testarea datelor structurate înseamnă mai mult decât o rulare a unui instrument: verifici sintaxa, vocabularul, cerințele motorului de căutare și, nu în ultimul rând, potrivirea cu pagina reală. Instrumentele oficiale (testul pentru rezultate îmbogățite, validatorul schema.org și Search Console) se completează, iar un flux fix de depanare te ajută să găsești cauza fără să ghicești.

Fă din testare un obicei: la implementare, după modificări mari și periodic. Iar dacă vrei să înțelegi mai bine ce alegi să marchezi, vezi și JSON-LD sau Microdata.

#testare#depanare#Rich Results Test#Search Console