Të dhëna të strukturuara

Të dhëna të strukturuara (Schema.org)

A përmban faqja shënime të lexueshme nga makina për llojin e përmbajtjes; mjeti kërkon JSON-LD dhe Microdata.

Çfarë është

Të dhënat e strukturuara janë shënime që i thonë makinës çfarë lloji është përmbajtja e faqes: një artikull, një produkt, një recetë, një ngjarje, një organizatë.

Fjalori standard është Schema.org, i mbajtur bashkërisht nga motorët kryesorë. Formati i preferuar sot është JSON-LD — një bllok JSON brenda <script type="application/ld+json">, i ndarë nga pamja e faqes. Formatet e vjetra Microdata dhe RDFa i ndërthurin shënimet me atributet e HTML-së dhe janë më të vështira për t'u mirëmbajtur.

Shënimet nuk ndryshojnë asgjë për vizitorin. Ato lexohen vetëm nga makina.

Pse ka rëndësi

Përfitimi kryesor janë rezultatet e pasuruara: yje vlerësimi, çmime, kohë gatimi, data ngjarjesh, hapa receте. Ato e bëjnë rezultatin të zërë më shumë hapësirë dhe të marrë më shumë klikime, pa e ndryshuar pozicionin.

Përfitimi i dytë është qartësia: një shënim Organization me emër, adresë dhe profile sociale e ndihmon motorin ta lidhë sajtin me entitetin e duhur. Kjo ka rëndësi kur ka emra të ngjashëm.

Duhet thënë edhe kufiri: shënimet nuk janë faktor renditjeje dhe nuk e ngrenë pozicionin. Ato ndikojnë vetëm te paraqitja.

Dhe ka rrezik: shënime që nuk përputhen me atë që sheh vizitori — çmime të rreme, vlerësime të shpikura — trajtohen si manipulim dhe mund të sjellin heqjen e të gjitha rezultateve të pasuruara për sajtin.

Si rregullohet

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Servisi Alfa",
  "url": "https://shembull.com",
  "address": {
    "@type": "PostalAddress",
    "addressLocality": "Prishtinë",
    "addressCountry": "XK"
  }
}
</script>

Hapat:

Përdor JSON-LD, jo Microdata, për kod të ri.
Shëno vetëm atë që është vërtet në faqe. Kjo është rregull, jo këshillë.
Zgjidh llojin e saktë dhe plotëso fushat e detyrueshme të tij.
Përdor `@graph` kur një faqe ka disa entitete të lidhura.
Validoje me mjetin zyrtar të testimit të rezultateve të pasuruara para se ta publikosh.
Mos shëno vlerësime që nuk i ke marrë dhe mos shto FAQ që nuk ekzistojnë në faqe.

Si e mat ky mjet

SchemaAnalyzer::analyze() (services/SchemaAnalyzer.php:12) mbledh dy burime: detectJsonLd() (:39) merr çdo <script type="application/ld+json">, e dekodon dhe e shpaketon @graph-in nëse ekziston; detectMicrodata() (:84) merr çdo element me atribut itemtype.

Nëse lista del bosh, jepet paralajmërim (:25); përndryshe një konstatim i kaluar me numrin e njësive (:27).

Çfarë NUK e mat

Pikësimi është binar dhe i gabuar: score = boshatisur ? 0 : 100 (services/SchemaAnalyzer.php:30). Ky numërim përfshin edhe njësitë e pavlefshme, sepse çdo bllok me JSON të prishur shtohet gjithsesi në listë si njësi me llojin Invalid JSON-LD (:49).

Pasoja e matur: një faqe me tre blloqe JSON-LD, të gjitha të prishura, merr 100 nga 100 për të dhëna të strukturuara — bashkë me dy paralajmërime që thonë se janë të pavlefshme. Detajet te MASTER_PLAN/audits/61-ANALIZUESIT-INVENTAR.md §4.4, fikstura 09-jsonld-i-prishur.html.

RDFa nuk zbulohet fare. Përputhja midis shënimeve dhe përmbajtjes së dukshme nuk kontrollohet — pikërisht rregulli më i rëndësishëm i Schema.org nuk matet dot nga asnjë analizues statik.

Kodi që e kryen matjen

services/SchemaAnalyzer.php:12 — SchemaAnalyzer::analyze
services/SchemaAnalyzer.php:30 — score