Saltar al contenido principal

Propagación de señales

Esta página explica qué pasa entre "pulsas Publicar" y "el storefront en vivo muestra las nuevas señales". Es la parte que más a menudo sorprende a la gente, especialmente sobre qué es automático vs manual, qué se empuja dónde y por qué a veces parece que el JSON-LD desaparece.

El loop principal​

SYNC → ENRICH → PROPAGATE → VERIFY
  • Sync trae el catálogo desde la plataforma (BigCommerce, Shopify, WooCommerce) a Clione.
  • Enrich genera las señales impulsadas por IA — meta title, meta description, JSON-LD, FAQs y keywords en el idioma de tu contenido.
  • Propagate escribe esas señales de vuelta a la plataforma.
  • Verify descarga el HTML del storefront en vivo y confirma que las señales aterrizaron.

Esta página se centra en el tercer paso.

Qué señales se propagan​

Lo que Clione escribe cuando publicas, por plataforma y tipo de entidad.

BigCommerce​

SeñalProductosCategoríasPáginas
Meta titleSíOpcional, desactivado por defectoOpcional, desactivado por defecto
Meta descriptionSíSíSí
meta_keywordsSí (array)Sí (array)Sí (string)
search_keywords—SíSí
URL canónica (custom_url en productos y categorías, url en páginas)SíSíSí
JSON-LD (incluido FAQPage)Sí (widget)Sí (widget)Sí (widget)
OG tagsSíSíSí

meta_keywords es un array para productos y categorías pero un string separado por comas para páginas. Así funciona la API de BigCommerce, y es una fuente frecuente de bugs en integraciones custom.

Shopify​

SeñalProductosColeccionesPáginas
Meta title (el título SEO de Shopify)SíOpcional, desactivado por defectoOpcional, desactivado por defecto
Meta description (la descripción SEO de Shopify)SíSíSí
JSON-LD (incluido FAQPage) — metafield clione.jsonldSíSíSí
Acordeón visible de FAQ — metafield clione.faq_htmlSíSíSí
Descripción enriquecida, añadida a la descripción del productoOpcional, desactivado por defecto——

Clione no escribe meta keywords, URL canónica ni OG tags en Shopify. Shopify renderiza la URL canónica a partir de la URL de la propia entidad.

El JSON-LD y el acordeón de FAQ llegan al storefront a través de los app embeds Clione SEO y Clione FAQ, que vienen con la app de Shopify de Clione. Una tienda conectada con una app que has creado tú (Client ID y Secret) tiene sincronización, enriquecimiento y el meta title y la meta description, que Clione escribe por la Admin API. Los app embeds y los ficheros llms.txt y .md bajo /apps/clione necesitan la app de Clione.

WooCommerce​

SeñalProductosCategorías de productoPáginas
Meta titleSíOpcional, desactivado por defectoOpcional, desactivado por defecto
Meta descriptionSíSíSí
JSON-LD (incluido FAQPage)SíSíSí
Acordeón visible de FAQSíSíSí

Clione guarda estas señales en el post o el término de WordPress, y el plugin de WordPress de Clione las imprime en la página en servidor. Cuando un plugin SEO (Yoast, Rank Math, AIOSEO o SEOPress) ya gestiona el título y la meta description, el plugin de Clione se los deja a él e imprime el JSON-LD.

— significa que Clione no escribe esa señal ahí. Las señales opcionales se activan por tienda en Ajustes de la tienda: Publicar meta_title en categorías, colecciones y páginas y, en Shopify, Descripción de producto enriquecida.

Publicar es manual​

Enriquecer nunca escribe en tu storefront. Las señales enriquecidas se guardan en Clione y nada llega a la plataforma hasta que publicas:

  • Una entidad — la pestaña Publicar de la página de la entidad: Publicar todo en la tienda, o Publicar en una sola señal.
  • Muchas entidades — Publicar todo / Publicar selección en los listados de Productos, Categorías/Colecciones y Contenido, o la página Publicación.

No hay ningún ajuste para publicar automáticamente tras enriquecer: cada escritura en tu storefront es una que puedes ver y auditar.

Por qué el JSON-LD es distinto​

Meta title, meta description, URL canónica y campos nativos de plataforma se escriben vía la API de catálogo de la plataforma. La plataforma los guarda y los renderiza en cada petición de página del storefront.

El JSON-LD es más enrevesado — ninguna plataforma renderiza JSON-LD arbitrario por defecto. Necesita un mecanismo de entrega:

BigCommerce — un widget por entidad​

Cuando publicas una entidad, Clione escribe su JSON-LD en un widget de BigCommerce colocado en la página de esa entidad (Widget API, región header_bottom). BigCommerce renderiza el widget en servidor, así que el JSON-LD está en el HTML del primer fetch y lo ve cualquier crawler, incluidos los crawlers de IA que no ejecutan JavaScript.

El JSON-LD aparece en las páginas que has publicado, y solo en esas. El script del Schema Injector es otra cosa: renderiza el acordeón visible de FAQ, no el JSON-LD.

Shopify — los theme app embeds​

La app de Shopify de Clione añade dos app embeds a tu tema:

  • Clione SEO lee el metafield clione.jsonld del producto, la colección o la página y lo renderiza en <head> como <script type="application/ld+json">.
  • Clione FAQ lee el metafield clione.faq_html y renderiza el acordeón visible de FAQ en la página.

Los dos son Liquid renderizado en servidor, así que funcionan para cualquier crawler de inmediato. Pero solo se renderizan si los embeds están activados en el editor de tema.

Si el embed no está activado, el metafield existe pero es invisible. Es la razón más común de "falta el JSON-LD en Shopify" — mira Schema Injector.

WooCommerce — el plugin de WordPress​

El plugin de WordPress de Clione imprime el JSON-LD y las meta tags en <head> desde el hook wp_head de WordPress, e imprime el acordeón visible de FAQ en la página. Las dos cosas van en el HTML de la primera respuesta.

Qué pasa cuando publicas​

  1. Clione resuelve las credenciales de la tienda a la que pertenece la entidad.
  2. Para cada señal, escribe en la plataforma vía su API. Los errores se capturan por señal, así que un fallo parcial no bloquea el resto.
  3. Se guarda en Clione un registro de publicación con qué se empujó, cuándo y la respuesta de la plataforma.

Publicar no lanza una verificación. La verificación corre con su programación diaria, o cuando la lanzas desde la página Verificación.

La pestaña Publicar​

Desde la pestaña Publicar de cualquier entidad:

  • Publicar todo en la tienda envía todas las señales a la plataforma.
  • Publicar solo FAQs envía las señales de FAQ y deja el resto como está.
  • Publicar en una sola señal envía solo esa.
  • El panel de historial muestra cada push anterior, con la respuesta de la plataforma y los errores que haya devuelto.

Úsala cuando:

  • Has enriquecido o editado una entidad y quieres que el storefront lo muestre.
  • La verificación marca un Fail en una entidad que ya publicaste.
  • La CDN del storefront muestra una versión vieja y quieres forzar una escritura.

Rollback​

Hay dos rollbacks distintos, y hacen cosas distintas:

  • Restaurar una versión desde la pestaña Historial de la entidad restaura los campos enriquecidos en Clione y crea un nuevo snapshot de versión. No toca tu storefront. Publica después si quieres que el storefront muestre la versión restaurada.
  • Hacer rollback de un push desde la pestaña Publicar devuelve el valor que la plataforma tenía antes del push de Clione, para esa señal. En un widget de JSON-LD eso significa eliminar el widget.

Por qué una propagación puede fallar en silencio​

Aun cuando la plataforma devuelve 200 OK, una señal puede no aparecer en el storefront si:

  • En Shopify, el app embed Clione SEO o Clione FAQ no está activado en el tema. El metafield se escribe, pero nada lo renderiza.
  • En BigCommerce, meta_keywords tiene un tope de 255 caracteres en total. Clione recorta la lista de keywords para que quepa, así que el storefront puede llevar menos keywords de las que generó Clione.
  • En productos y categorías de BigCommerce, custom_url requiere la forma de objeto { url, is_customized }; un string malformado se rechaza.

En todos estos casos, la página de verificación es el sitio canónico para detectar la discrepancia. Mira Verification.