JSON-LD strukturált adatok: használatra kész példák és PHP generátor

JSON-LD strukturált adatok segítségével a keresőmotorok géppel olvasható formában elmondhatják, mi az oldal: cikk, termék árral, cég elérhetőségeivel, kérdések és válaszok listája. Láthatatlan a látogatók számára, nem helyettesíti a jó tartalmat, és önmagában nem emel helyezést. Ez azt jelenti, hogy egy oldalt alkalmassá tesz a bővített találatok megjelenítésére, segít a motoroknak az oldalait a megfelelő entitáshoz kapcsolni, és az AI-alapú keresésnek tisztább olvasnivalót biztosít. Az integrono.com és más oldalaink minden oldalán előállítjuk, és ez az útmutató ennek a munkának a gyakorlati változata.

JSON-LD vs Microdata vs RDFa

A Schema.org szókincse három szintaxisba ágyazható be. Microdata és RDFa attribútumokat helyez el a HTML-címkékbe, ami összekuszálja a jelölést sablonokkal. JSON-LD egyetlen szkriptblokkban él, külön az elrendezéstől, így könnyebb generálni, tesztelni és módosítani. A Google azt állítja, hogy JSON-LD ajánlja, és mindenhol ezt használjuk.

Elvek a példák előtt

• Ismertesse a látható tartalmat. Ha az ár, az értékelés vagy a GYIK nem szerepel az oldalon, ne írja be a jelölésbe.
• Használjon abszolút URL-eket és az oldal gyűjtő URL-jét.
• Legyen teljes a szükséges tulajdonságok, és adja hozzá az ajánlottakat, ha valódi adatokkal rendelkezik.
• Az entitások összekapcsolásához használja @id. A cikk szerzője az a szervezet, amelyet egyszer definiáltunk @id-vel, nem pedig minden alkalommal új példányt.
• Használja az ISO 8601 szerinti dátumokat (2026-10-28 vagy idővel és zónával).
• Ne találj ki véleményeket vagy értékeléseket. A hamis AggregateRating adatok gyakori okai a kézi műveleteknek.

1. példa: Szervezet (és webhely)

Tedd ezt a kezdőlapra vagy egy webhelyszintű grafikonra. Meghatározza azt az entitást, amelyre a többi jelölés hivatkozik.

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://example.com/#organization",
  "name": "Example Studio",
  "url": "https://example.com/",
  "logo": "https://example.com/images/logo.png",
  "email": "[email protected]",
  "sameAs": [
    "https://github.com/example",
    "https://www.linkedin.com/company/example"
  ]
}

2. példa: BreadcrumbList

A navigációs útvonal-jelölés lehetővé teszi, hogy a Google a nyers URL helyett az oldal elérési útját jelenítse meg az eredményekben. Egyeznie kell a látható zsemlemorzsával.

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {"@type": "ListItem", "position": 1, "name": "Home", "item": "https://example.com/"},
    {"@type": "ListItem", "position": 2, "name": "Blog", "item": "https://example.com/blog"},
    {"@type": "ListItem", "position": 3, "name": "JSON-LD guide", "item": "https://example.com/blog/json-ld-guide"}
  ]
}

3. példa Cikk

Blogbejegyzésekhez és útmutatókhoz. A fontos tulajdonságok: címsor, dátumok, szerző, kiadó, kép és az oldal URL-je.

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "JSON-LD structured data: examples",
  "description": "Short summary of the article.",
  "url": "https://example.com/blog/json-ld-guide",
  "mainEntityOfPage": "https://example.com/blog/json-ld-guide",
  "inLanguage": "en",
  "datePublished": "2026-08-23",
  "dateModified": "2026-10-28",
  "author": {"@id": "https://example.com/#organization"},
  "publisher": {"@id": "https://example.com/#organization"},
  "image": {"@type": "ImageObject", "url": "https://example.com/images/blog/json-ld.webp", "width": 1200, "height": 630}
}

dateModified módosítása Csak akkor módosítható, ha a tartalom valóban megváltozik. A bizalom elvesztésének csendes módja, ha minden telepítéskor megüti.

4. példa: Termék ajánlattal

Látható árú termékoldalakhoz. Tartalmazza a rendelkezésre állást és a pénznemet; csak akkor adjon hozzá aggregateRating vagy review, ha valódi értékelések jelennek meg az oldalon.

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Example product",
  "description": "What it is and who it is for.",
  "image": ["https://example.com/images/product.webp"],
  "sku": "EX-001",
  "brand": {"@type": "Brand", "name": "Example"},
  "offers": {
    "@type": "Offer",
    "url": "https://example.com/product/ex-001",
    "priceCurrency": "EUR",
    "price": "49.00",
    "availability": "https://schema.org/InStock",
    "itemCondition": "https://schema.org/NewCondition"
  }
}

5. példa: Szolgáltatás ajánlattal

Fizetős szolgáltatásokra, például fix árú auditra vagy óránkénti konzultációra. Ezt a mintát használjuk saját szervizoldalainkon.

{
  "@context": "https://schema.org",
  "@type": "Service",
  "name": "Architecture review",
  "serviceType": "Software architecture analysis",
  "provider": {"@id": "https://example.com/#organization"},
  "areaServed": "Worldwide",
  "offers": {
    "@type": "Offer",
    "price": "200",
    "priceCurrency": "EUR",
    "url": "https://example.com/services/architecture-review"
  }
}

6. példa: GYIK oldal

A GYIK jelölés az oldalon látható kérdések és válaszok listáját írja le. Ne feledje, hogy 2023 óta a Google csak korlátozott számú mérvadó webhely esetén jeleníti meg a GYIK gazdag találatokat, ezért ne várjon bővíthető válaszokat az eredményekben. A jelölés továbbra is érvényes, továbbra is olvasható más keresőmotorok és AI-rendszerek számára, és a GYIK-ot úgy strukturálja, hogy a gépek idézni tudják.

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Do I need structured data to rank?",
      "acceptedAnswer": {"@type": "Answer", "text": "No. It is not a ranking requirement, but it can make pages eligible for rich results."}
    }
  ]
}

Kombináljon mindent egy @grafikonban

Egy oldal ritkán csak egy entitást tartalmaz. Helyezze mindegyiket egy szkriptbe @graph használatával, és hivatkozzon a megosztott entitásokra @id segítségével:

{
  "@context": "https://schema.org",
  "@graph": [
    {"@type": "Organization", "@id": "https://example.com/#organization", "name": "Example Studio"},
    {"@type": "Article", "headline": "...", "author": {"@id": "https://example.com/#organization"}},
    {"@type": "BreadcrumbList", "itemListElement": []},
    {"@type": "FAQPage", "mainEntity": []}
  ]
}

JSON-LD biztonságos generálása PHP-ben

Ne fűzze össze kézzel a JSON-t. A címben szereplő idézet megtöri az egész szkriptet, és a kereső csendesen figyelmen kívül hagyja. Hozz létre egy PHP tömböt, és kódold. Két jelző számít: a Unicode olvashatóságának megőrzése és a HTML-környezet védelme a perjelek és a címkék elkerülésével.

function jsonLdScript(array $graph): string
{
    $data = ['@context' => 'https://schema.org', '@graph' => $graph];
    $json = json_encode(
        $data,
        JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_HEX_TAG | JSON_HEX_AMP | JSON_THROW_ON_ERROR
    );
    return '<script type="application/ld+json">' . $json . '</script>';
}

$graph = [
    ['@type' => 'Organization', '@id' => $site . '/#organization', 'name' => 'Example Studio', 'url' => $site . '/'],
    [
        '@type'         => 'Article',
        'headline'      => $title,
        'url'           => $canonical,
        'datePublished' => $published,
        'dateModified'  => $modified,
        'author'        => ['@id' => $site . '/#organization'],
    ],
];
echo jsonLdScript($graph);

JSON_HEX_TAG < és a > jelet escape szekvenciákká változtatja, így a felhasználói tartalom soha nem tudja korán bezárni a szkriptcímkét. Táplálja a generátort ugyanazokból az adatokból, amelyek az oldalt megjelenítik (cím, ár, dátumok), így a jelölés és a látható tartalom nem távolodik el egymástól. Többnyelvű webhelyen fordítsa le a szövegmezőket, és állítsa be inLanguage per locale; így készülnek ennek a blognak a cikkei és a GYIK jelölések.

Érvényesítés és monitorozás

1. Rich Results Test a Google bővített találattípusainak alkalmasságára.
2. Schema Markup Validator bármilyen típusú általános schema.org szintaxishoz.
3. Search Console továbbfejlesztési jelentései (morzsa, termékek, GYIK és így tovább) a hibákról és a nagyszabású figyelmeztetésekről, miután a Google feltérképezte az oldalakat.
4. Egy egységteszt, amely az egyes sablonokat rendereli, és ellenőrzi, hogy a JSON-LD elemzi-e, és tartalmazza-e a szükséges kulcsokat, megakadályozza a regressziókat az újrafaktorok után.

Hibák, amelyekbe kerül

• Az oldalon nem szereplő tartalom jelölése (rejtett GYIK, kitalált értékelések, a látható ártól eltérő árak).
• Több ütköző blokk egy beépülő modulból és egy sablonból, mindegyik más Organization.
• Relatív URL-ek, rossz dátumok vagy hiányzó @id.
• Törött JSON a kézi karakterlánc-építésből és a nem megtisztított idézőjelekből.
• A séma rangsorolási trükkként való kezelése. Ez egy egyértelmű eszköz; az oldalnak még mindig meg kell érdemelnie a rangot.

Hogyan segíthetünk

A strukturált adatok a műszaki keresőoptimalizálási munkánk egyik részét képezik: megtervezzük a sémát a sablonokhoz, implementáljuk a generátort a verembe, és beállítjuk az érvényesítést, hogy azok a kiadások után is helyesek maradjanak. Ha áttekintést szeretne kapni arról, hogy mi a hiba webhelyén, kezdje technikai SEO audit ellenőrzőlistánkkal, vagy foglaljon konzultációt.