El marcatge de dades estructurades és un component fonamental del desenvolupament web modern i de l'optimització per a motors de cerca (SEO). Mitjançant l'ús del vocabulari de Schema.org, els webmasters, operadors de contingut i desenvolupadors poden descriure de manera precisa el significat del contingut d'una pàgina web. Aquesta eina facilita la creació de codi en format JSON-LD (JavaScript Object Notation for Linked Data), que és el format preferit pels principals motors de cerca per processar i entendre la informació d'un lloc web.
La integració de dades estructurades ajuda els motors de cerca a interpretar el context de la informació, la qual cosa pot influir en la manera com es presenta la pàgina als usuaris, incloent-hi la possibilitat de generar resultats de cerca enriquits. Amb aquest generador, podeu estructurar la informació de manera local i segura, ja que les vostres entrades es queden al navegador i no es puja res a BroBroGo.
El propòsit de JSON-LD per al contingut web
JSON-LD és un format de serialització que permet estructurar dades utilitzant JSON. A diferència d'altres mètodes de marcatge com els microdades o les RDFa, que s'insereixen directament dins del codi HTML dels elements visibles, el JSON-LD s'implementa com un bloc de script independent. Això facilita la seva creació, manteniment i lectura, tant per als desenvolupadors com per als rastrejadors dels motors de cerca.
El generador automatitza la creació d'aquest script. A mesura que s'omplen els camps del formulari, l'eina valida les dades en temps real i genera el codi corresponent. El script complet apareixerà quan tots els camps obligatoris siguin vàlids. Un cop generat, el codi es pot copiar i enganxar directament a la capçalera o al cos del document HTML de la pàgina web corresponent.
Estructuració de dades per a PMF (FAQPage)
El tipus d'esquema FAQPage s'utilitza quan una pàgina web presenta una llista de preguntes freqüents amb les seves respectives respostes. Perquè el marcatge sigui vàlid, cada element de la llista ha de contenir tant la pregunta com la resposta.
L'editor valida que es compleixin les condicions següents durant la introducció de dades:
- S'ha d'afegir com a mínim una pregunta i una resposta completes. Si no es fa, es mostrarà l'error: "Afegiu almenys una pregunta i resposta completes.".
- Cada element individual de la llista requereix ambdós camps. Si falta algun d'ells, l'eina mostrarà "L'element
{index}necessita una pregunta." o "L'element{index}necessita una resposta.".
Els camps opcionals que es deixin buits s'exclouen automàticament del codi final per mantenir el script net i lliure d'atributs nuls.
Estructuració de dades per a Producte (Product)
El marcatge de tipus Producte permet descriure un producte comercial, incloent-hi detalls sobre la seva marca, identificadors i les condicions de la seva oferta comercial (preu, divisa i disponibilitat).
| Camp al formulari | Tipus de dada / Regla de validació | Requisit |
|---|---|---|
| Nom del producte | Text lliure | Obligatori (Error: "Afegiu el nom del producte.") |
| Descripció | Text lliure | Opcional |
| URL de la imatge | Adreça completa http:// o https:// |
Opcional (Error: "La URL de la imatge ha de ser una adreça completa http:// o https://.") |
| Marca | Text lliure | Opcional |
| SKU | Text lliure | Opcional |
| Preu | Nombre no negatiu amb dígits i un punt decimal opcional | Obligatori (Errors: "Afegiu el preu de l'oferta." o "Utilitzeu un preu no negatiu amb dígits i un punt decimal opcional.") |
| Codi de divisa | Codi de tres lletres (ex: USD, EUR, CNY) | Obligatori (Error: "Utilitzeu un codi de divisa de tres lletres com ara USD, EUR o CNY.") |
| Disponibilitat | Selecció d'una llista d'opcions | Obligatori |
| URL del producte | Adreça completa http:// o https:// |
Opcional (Error: "La URL del producte ha de ser una adreça completa http:// o https://.") |
Estructuració de dades per a Guies (HowTo)
L'esquema HowTo s'utilitza per descriure de manera seqüencial els passos necessaris per dur a terme una tasca específica. Aquest tipus de marcatge pot incloure llistes de materials, eines i el temps total necessari per completar l'activitat.
Les regles de validació per a aquest esquema inclouen:
- Títol de la guia: És un camp obligatori. Si es deixa buit, es mostra l'error: "Afegiu el títol de la guia.".
- Minuts totals: És un camp opcional. Si s'omple, ha de ser un nombre sencer de l'1 al 100.000 minuts. En cas contrari, es mostrarà l'error: "El temps total ha de ser un nombre sencer de l'1 al 100.000 minuts.".
- Subministraments i Eines: S'introdueixen com a llistes de text on s'ha d'escriure un element per línia. Són camps opcionals.
- Passos: S'ha d'afegir almenys un pas complet. Si no n'hi ha cap, es mostra l'error: "Afegiu almenys un pas complet.". Cada pas disposa d'un títol opcional i d'unes instruccions obligatòries. Si un pas no té instruccions, es mostra l'error: "L'element
{index}necessita instruccions per al pas.".
Regles generals de l'editor i límits
L'editor compta amb mecanismes de control per garantir la integritat de les dades abans de generar el JSON-LD. A més de les validacions de format de preus, monedes i adreces web, s'apliquen els següents límits de seguretat:
- Límit de caràcters: Si un text introduït supera la capacitat permesa, es mostrarà l'error: "El camp
{field}és massa llarg per a aquest editor. Mantingueu-lo per sota de{max}caràcters.". - Límit d'elements: Per garantir el rendiment del navegador, l'eina limita la quantitat d'elements repetitius (com preguntes o passos) que es poden gestionar simultàniament. Si se supera aquest límit, es mostrarà l'error: "Aquest editor admet fins a
{max}elements alhora.".
Preguntes freqüents
Quins tipus d'esquema puc crear?
Els formularis guiats cobreixen FAQPage, Product amb una Offer, i HowTo amb passos ordenats, subministraments i eines. Els camps opcionals buits es deixen fora del codi.
On col·loco el JSON-LD generat?
Enganxeu el script complet dins de la capçalera <head> o del cos <body> de la pàgina el contingut visible de la qual descriu. Mantingueu el marcatge coherent amb el que els visitants realment poden veure.
Un marcatge vàlid garanteix un resultat de cerca enriquid?
No. Un marcatge vàlid de schema.org ajuda els serveis a entendre la pàgina, però mai es garanteixen visualitzacions de cerca especials. Google ja no mostra resultats enriquits de tipus FAQ o HowTo.