Instala el Schema Injector
Planes: Starter ✓ · Growth ✓ · Pro ✓ · Agency ✓
La pestaña Inyector de Schema de Ajustes de la tienda es donde conectas las piezas de Clione para el storefront con tu tema y compruebas que están funcionando. Lo que instala depende de tu plataforma.
Tu JSON-LD no depende de ningún script. En BigCommerce se renderiza en el servidor a partir de un placement de la Widget API; en Shopify, lo pinta el app embed Clione SEO. En los dos casos llega a la página cuando publicas la entidad. Si has llegado aquí preguntándote "¿por qué no está mi schema en la tienda?", lo normal es que esa entidad todavía no se haya publicado: mira Publicar.
¿Qué camino te toca?
| Tu montaje | Qué configuras | Cómo |
|---|---|---|
| BigCommerce, tema Stencil | El script del Schema Injector, que Clione instala con la Scripts API de BigCommerce. Pinta el acordeón de FAQs y los enlaces de descubrimiento para agentes. | Con un clic: mira abajo. |
| BigCommerce, headless / Catalyst | El SDK @clione/seo o la API de señales SEO, en tu frontend. | Tarea de desarrollo: mira Headless con Next.js. |
| Shopify, tema de Online Store (cualquier tema Liquid) | Los app embeds Clione SEO y Clione FAQ de la app de Shopify de Clione. Sin script. | Se activan en el editor de temas: mira abajo. |
| Shopify, Hydrogen / headless | El SDK @clione/seo o la API de señales SEO. | Tarea de desarrollo: mira Headless con Hydrogen. |
Si no lo tienes claro, casi seguro que no eres headless: headless significa un frontend propio que tu equipo de desarrollo ha construido y despliega por separado.
BigCommerce — Stencil (storefront clásico)
Qué hace el script
El script aparece en el Script Manager de BigCommerce como Clione FAQ Renderer. En cada página del storefront:
- pinta el acordeón de FAQs visible del producto, la categoría o la página de contenido;
- aplica tu CSS propio de FAQs;
- añade dos etiquetas
<link>que llevan a los agentes de IA a tullms.txty a tu fichero de descubrimiento para agentes (rel="llms-txt"yrel="agents-json").
No emite JSON-LD. Cuando publicas una entidad, Clione instala para ella un placement de la Widget API de BigCommerce, y Stencil renderiza el @graph en el HTML en el servidor, así que un crawler que no ejecuta JavaScript lo ve en la primera petición. Instalar el script no pone schema en tu tienda y desinstalarlo no lo quita: eso lo hace publicar.
Paso 1 — Abre la pestaña
Abre la tienda → Ajustes de la tienda → pestaña Inyector de Schema. Verás Instalado o No instalado.
Paso 2 — Instalar
Haz clic en Instalar. Clione entonces:
- Busca un embed de Clione que hayas puesto a mano. Si lo encuentra, muestra Embed manual de Clione detectado con Descartar o Instalar igualmente (forzar): dos scripts de Clione en la misma página pintarían todo dos veces.
- Lee tus canales para saber si la tienda es Stencil, headless o las dos cosas. Una tienda solo headless recibe las instrucciones de
@clione/seoy no se instala nada. Una tienda con Stencil y además un canal headless recibe el script en Stencil y un aviso de que el storefront headless necesita@clione/seo. - Crea una API key de solo lectura para este storefront, restringida al hostname de tu storefront. No tienes que gestionarla.
- Registra el script con la Scripts API de BigCommerce:
location: head,load_method: async,visibility: storefront,consent_category: essential, cargándolo desdehttps://api.clione.ai/api/v1/public/embed/schema-injector/<id-de-tu-tienda>.js. Como se carga de forma asíncrona, nunca frena tu página.
La pestaña pasa a mostrar el UUID del script, la ubicación, el método de carga, la visibilidad y la última modificación. Refrescar estado lo vuelve a leer y Abrir escaparate abre tu tienda.
Paso 3 — Comprobar
- Abre una página de producto publicada en una ventana de incógnito y mira el código fuente (
Ctrl/Cmd + U). - Busca
data-clione="schema-graph": es el@graphrenderizado en el servidor por la Widget API. Puedes desactivar JavaScript para demostrar que no depende del navegador. - En una página con FAQs aprobadas, el acordeón aparece cuando la página termina de cargar.
Previsualizar JSON-LD, en la misma pestaña, enseña el JSON-LD de la tienda sin salir del dashboard.
Paso 4 — Desinstalar
Haz clic en Desinstalar y confirma (Sí, desinstalar). Clione revoca la API key del script y lo quita de BigCommerce. En Clione no se borra ningún dato; puedes volver a instalarlo cuando quieras.
Desinstala siempre desde esta pestaña, no borrando el script en el Script Manager, para que los registros de Clione sigan cuadrando.
BigCommerce — headless / Catalyst
No hay nada que instalar: tu frontend pinta su propio <head>. Usa el SDK @clione/seo o la API de señales SEO para traer las señales y renderizarlas en el servidor. La pestaña Inyector de Schema detecta el canal headless y te enseña un snippet listo para tu framework (Copiar snippet).
Mira Headless con Next.js y el SDK @clione/seo.
Shopify — Online Store (temas Liquid)
En Shopify, lo que llega al storefront viene con la app de Shopify de Clione, la que instalas al conectar Shopify. Añade dos app embeds a tu tema:
| App embed | Qué pinta |
|---|---|
| Clione SEO | El @graph de JSON-LD en el <head> de la página, renderizado por Liquid en el servidor: Product en las páginas de producto, un grafo de colección en las colecciones, WebPage en las páginas, y además FAQPage cuando la entidad tiene FAQs aprobadas. |
| Clione FAQ | El acordeón de FAQs visible, a partir del HTML de FAQs publicado de la entidad. |
El meta title y la meta description no necesitan ninguno de los dos: Shopify los pinta de serie a partir de los campos SEO en los que publica Clione.
Paso 1 — Activa los app embeds
- Admin de Shopify → Tienda online → Temas.
- En tu tema publicado, haz clic en Personalizar.
- En el editor de temas, abre Incrustaciones de aplicaciones (App embeds), en la barra de la izquierda.
- Activa Clione SEO y Clione FAQ.
- Haz clic en Guardar.
Los app embeds van por tema: si cambias de tema, vuelve a activarlos en el nuevo.
Paso 2 — Comprueba que funciona
En Shopify, la pestaña Inyector de Schema muestra Estado del Schema: visita tu storefront real igual que un crawler y te dice Verificado — activo en el storefront o No detectado, con la URL comprobada, los nodos de schema encontrados y si el acordeón de FAQ está presente.
- Recomprobar homepage comprueba la página de inicio; escribe una ruta (por ejemplo
/products/tu-handle) y pulsa Comprobar esta página para comprobar una página concreta. - Ver JSON-LD enseña lo que ha encontrado.
- Si dice No detectado, Activar en el editor de temas te lleva al sitio exacto.
Un storefront con contraseña no se puede comprobar: la comprobación se topa con la página de contraseña. Quita la contraseña en Tienda online → Preferencias, o comprueba una tienda que sea pública.
Si una entidad no se ha publicado, los embeds no tienen nada que pintar en su página: no se genera ningún script vacío.
Shopify — Hydrogen / headless
No hay tema donde activar los embeds. Usa el SDK @clione/seo o la API de señales SEO desde tu frontend. Mira Headless con Hydrogen.
Problemas frecuentes
BigCommerce
Falla la instalación: el scope Content de tu API account de BigCommerce está en Read-only o None. Ponlo en Modify (mira Conectar BigCommerce — Paso 3) y vuelve a pulsar Instalar.
La pestaña dice que el script está en tu storefront pero se añadió fuera de Clione: alguien lo puso a mano en el Script Manager, o lo creó otra API account de BigCommerce. Clione no puede gestionar esa copia. Bórrala en el Script Manager e instala desde esta pestaña.
No hay JSON-LD en el código fuente: la entidad no se ha publicado. Ábrela en Clione → pestaña Publicar y publícala. Después busca data-clione="schema-graph" en el código fuente.
No aparece el acordeón de FAQs: comprueba que la entidad tiene FAQs aprobadas y está publicada, y que el script sale como Instalado.
Shopify
Clione SEO o Clione FAQ no aparecen en App embeds: la app de Shopify de Clione no está instalada en esta tienda. Instálala desde Conectar Shopify y recarga el editor de temas.
Estado del Schema dice No detectado: comprueba que Clione SEO está activado y guardado en tu tema publicado, y que la página comprobada es de una entidad publicada.
El JSON-LD está pero parece antiguo: el storefront enseña lo último que se publicó. Vuelve a publicar la entidad después de enriquecerla o editarla.
Resumen
| Plataforma | Qué se instala | Dónde | Cómo se quita |
|---|---|---|---|
| BigCommerce Stencil | Un script (Clione FAQ Renderer) por la Scripts API | Todas las páginas del storefront | Desinstalar en la pestaña Inyector de Schema |
| BigCommerce headless | Nada: usa el SDK | Tu frontend | — |
| Shopify Online Store | Los app embeds Clione SEO y Clione FAQ de la app de Clione | Todas las páginas del tema donde están activados | Desactivándolos en el editor de temas |
| Shopify Hydrogen / headless | Nada: usa el SDK | Tu frontend | — |