Entender
El JSON-LD que publica este sitio
El JSON-LD que publica este sitio es un Person, una Organization y un WebSite en cada página. Un laboratorio añade un TechArticle. Una nota añade un Article. Las páginas anidadas añaden migas de pan. FAQPage aparece solo donde las preguntas son visibles.
Entender el laboratorioCómo usarlo y por qué querrías hacerlo
Por qué querrías hacerlo
Elige una ruta y esta página arma el grafo del sitio y el de la página, y luego comprueba el contexto, los tipos, las fechas y sameAs. Después de Aceptar encola la ruta, el conteo de scripts y el de avisos.
Cómo usarlo
- Elige una ruta. Los scripts se arman para esa ruta.
- Se espera que un laboratorio o una nota lleven un artículo.
- El contexto, los tipos, las fechas y sameAs se comprueban en la página.
- Después de Aceptar, jsonld_view lleva la ruta y los dos conteos.
Un script, no una metaetiqueta
JSON-LD es un objeto JSON dentro de <script type="application/ld+json">. La página se sigue leyendo como HTML. Un crawler que entiende schema.org puede leer el objeto como una lista de cosas tipadas: una persona, un sitio, un artículo.
@context dice que las palabras vienen de schema.org. @type nombra la cosa. @id es una URL estable de esa cosa, así que otro nodo puede apuntarla con { "@id": "…" } en lugar de repetir el registro entero.
Este sitio imprime los scripts en el cuerpo del documento. Un < dentro del JSON se escribe como \u003c para que el analizador de HTML no lo trate como una etiqueta.
Person
Página acerca de
Solo la página acerca de añade un nodo Person. Su URL es esa página. sameAs lista los perfiles públicos de LinkedIn e Instagram.
Organization
Black Box Personalization
El sitio como editor y autor. parentOrganization apunta a Black Box Site Design. sameAs está vacío en este nodo.
WebSite
Cada página
El nodo del sitio nombra el origen y la descripción. Su publisher es la organización. Un laboratorio añade un TechArticle. Una nota añade un Article. Las páginas anidadas añaden migas de pan.
El grafo de una ruta
Elige una ruta pública. El JSON es el mismo objeto que imprime el layout. Un laboratorio añade un TechArticle. Una nota añade un Article. Las páginas anidadas añaden migas de pan. La portada conserva el grafo del sitio. El laboratorio SEO vuelve a leer estos scripts del HTML.
Análisis
pasa2 scripts se analizan como JSON.
@context
pasaCada script nombra https://schema.org.
Grafo del sitio
pasaOrganization and WebSite are present.
Article
pasaThis path adds a BlogPosting or LearningResource and a BreadcrumbList.
Fechas
pasadatePublished y dateModified son YYYY-MM-DD.
sameAs
pasasameAs es una lista en 1 nodo.
SearchAction
pasaWebSite search opens the labs directory at /lab?q=.
FAQPage
pasaNo hay un nodo FAQPage. Esta ruta no tiene una sección de preguntas.
Sitio
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "Organization",
"@id": "https://www.blackboxsitedesign.com/#organization",
"name": "Black Box Site Design",
"url": "https://www.blackboxsitedesign.com",
"slogan": "Websites engineered to perform",
"description": "Designs and builds fast, accessible, measurable marketing sites."
},
{
"@type": "Organization",
"@id": "https://www.blackboxpersonalization.com/#organization",
"name": "Black Box Personalization",
"url": "https://www.blackboxpersonalization.com",
"sameAs": [],
"parentOrganization": {
"@id": "https://www.blackboxsitedesign.com/#organization"
},
"isAccessibleForFree": true
},
{
"@type": "WebSite",
"@id": "https://www.blackboxpersonalization.com/#website",
"name": "Black Box Personalization",
"url": "https://www.blackboxpersonalization.com",
"description": "Opening the black box of Google Analytics. A free site that shows how a visit is measured, and how those same signals can change the page you see.",
"inLanguage": [
"en",
"es"
],
"publisher": {
"@id": "https://www.blackboxpersonalization.com/#organization"
},
"isAccessibleForFree": true,
"potentialAction": {
"@type": "SearchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://www.blackboxpersonalization.com/lab?q={search_term_string}"
},
"query-input": "required name=search_term_string"
}
}
]
}Esta página
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "LearningResource",
"headline": "JSON-LD this site publishes",
"name": "JSON-LD this site publishes",
"description": "JSON-LD this site publishes: Person, Organization, and WebSite on every page, a TechArticle on each lab, and breadcrumbs on nested pages. Free to inspect.",
"inLanguage": "en",
"isAccessibleForFree": true,
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://www.blackboxpersonalization.com/lab/json-ld"
},
"datePublished": "2026-10-08",
"dateModified": "2026-10-09",
"image": "https://www.blackboxpersonalization.com/og?path=%2Flab%2Fjson-ld",
"author": {
"@type": "Organization",
"@id": "https://www.blackboxpersonalization.com/#organization",
"name": "Black Box Personalization"
},
"publisher": {
"@id": "https://www.blackboxpersonalization.com/#organization"
},
"learningResourceType": "How-to",
"url": "https://www.blackboxpersonalization.com/lab/json-ld"
},
{
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Home",
"item": "https://www.blackboxpersonalization.com"
},
{
"@type": "ListItem",
"position": 2,
"name": "Free Google Analytics labs",
"item": "https://www.blackboxpersonalization.com/lab"
},
{
"@type": "ListItem",
"position": 3,
"name": "JSON-LD this site publishes",
"item": "https://www.blackboxpersonalization.com/lab/json-ld"
}
]
}
]
}RecorridoCómo lo hicimosMostrarOcultar
El ajuste de proveedor de ejemplo está marcado abajo. Los números de eVar y de event son ejemplos. Este laboratorio no llama a Adobe.
El laboratorio de JSON-LD construye el grafo del sitio y el grafo de la página para una ruta que eliges, y luego comprueba el contexto, los tipos, las fechas y sameAs. Después de Aceptar encola jsonld_view con la ruta, el conteo de scripts y el conteo de avisos, y no llama a Adobe.
Construir los scripts de la ruta
pageGraph devuelve el grafo de la ruta elegida, o null cuando esa ruta no tiene un grafo extra. La página siempre incluye siteGraph.
Esperar un artículo en laboratorios y notas
expectsArticle es true para /lab/ y para un slug de /blog/. reviewJsonLd quiere entonces un BlogPosting o LearningResource más un BreadcrumbList.
Comprobar el grafo
La revisión analiza los bloques, exige @context https://schema.org y exige Organization y WebSite. Comprueba las fechas del artículo como YYYY-MM-DD y exige que sameAs sea una lista.
Encolar la vista después de Aceptar
trackLabEvent envía jsonld_view con inspected_path, script_count y warn_count. Con el consentimiento apagado vuelve antes del push. El cuerpo del grafo no es un parámetro.
Del código
Cada script debe nombrar schema.org. Organization y WebSite deben estar presentes.
const contextOk = parsed.every((block) => Boolean(block) && typeof block === "object" && (block as Node)["@context"] === "https://schema.org")
notes.push({
id: "context",
label: "@context",
status: contextOk ? "pass" : "warn",
detail: contextOk ? "Each script names https://schema.org." : "A script is missing @context https://schema.org.",
})
const nodes = parsed.flatMap(nodesOf)
const types = [...new Set(nodes.flatMap(typesOf))]
const siteTypes = ["Organization", "WebSite"]
const hasSite = siteTypes.every((type) => types.includes(type))
notes.push({
id: "site",
label: "Site graph",
status: hasSite ? "pass" : "warn",
detail: hasSite ? "Organization and WebSite are present." : `Missing ${siteTypes.filter((type) => !types.includes(type)).join(", ")}.`,
})La ruta elegida se convierte en los grafos, la revisión y jsonld_view.
const blocks = useMemo(() => {
const page = pageGraph(selected, post)
return page ? [siteGraph(), page] : [siteGraph()]
}, [post, selected])
const notes = reviewJsonLd(blocks, expectsArticle(selected))
const warnCount = notes.filter((note) => note.status === "warn").length
useEffect(() => {
if (consent !== "granted") return
trackLabEvent("jsonld_view", { inspected_path: selected, script_count: blocks.length, warn_count: warnCount })
}, [blocks.length, consent, selected, warnCount])Google y Adobe
Google encola jsonld_view después de Aceptar. Adobe es un ejemplo de los mismos campos.
jsonld_view se encola solo después de Aceptar. inspected_path es la ruta, script_count es cuántos scripts JSON-LD emite esa ruta y warn_count es cuántas comprobaciones avisaron. El cuerpo del grafo no se envía. Registra esos parámetros como dimensiones personalizadas con alcance de evento. Este sitio no llama a Adobe.
Forma simplificada del objeto encolado después de Aceptar. Registra cualquier parámetro nuevo como dimensión personalizada con alcance de evento. Este sitio no llama a gtag('set').
dataLayer.push({
event: "jsonld_view",
inspected_path: "/lab/json-ld",
script_count: 2,
warn_count: 0,
})Implementación de ejemplo. Este sitio no llama a Adobe. eVar82, prop82 y event82 son números de variable de ejemplo. En Launch, un elemento de datos lee el valor y una regla lo envía cuando el valor cambia. En el report suite, habilita eVar82 con asignación Most Recent y haz que expire en el hit. Una processing rule no hace falta si el elemento de datos se mapea directo a esa eVar.
Payload de alloy de ejemplo. _example es un esquema de relleno, no un inquilino real.
alloy("sendEvent", {
xdm: {
eventType: "web.webinteraction.linkClicks",
_example: {
schemaType: "WebSite",
},
},
})Hit de ejemplo. eVar82 tiene alcance de hit en este ejemplo. prop82 muere en el mismo hit.
s.eVar82 = "WebSite"
s.prop82 = "WebSite"
s.events = "event82"
s.linkTrackVars = "eVar82,prop82,events"
s.linkTrackEvents = "event82"
s.tl(true, "o", "jsonld_view")Traducción
Cada campo del laboratorio, el nombre en GA4 y la variable de Adobe de ejemplo. El alcance es la parte que suele perderse en la traducción.
Ruta inspeccionada
GA4. Parámetro inspected_path en jsonld_view.
Adobe. eVar82 de ejemplo, expira en el hit.
Alcance. Evento. Una propiedad de usuario conservaría la última ruta que inspeccionaste.
Conteo de scripts
GA4. Parámetro script_count en jsonld_view.
Adobe. prop82 de ejemplo, que muere en el hit.
Alcance. Evento. Es un conteo de esta inspección, no un total de la visita.
Conteo de avisos
GA4. Parámetro warn_count en jsonld_view.
Adobe. eVar82 de ejemplo si guardaras el conteo en lugar de la ruta.
Alcance. Evento.
Cuerpo del grafo
GA4. No se envía.
Adobe. Ejemplo: no copies el JSON en eVar82.
Alcance. No es un parámetro de hit. El grafo se queda en la página.
Recomendado a continuación
Por qué estas propuestasLeyendo las transiciones de recorrido…