Capacidades por plataforma
No toda señal que Clione genera puede escribirse en toda plataforma para todo tipo de entidad. Cada API de catálogo de plataforma tiene sus rarezas — qué campos son escribibles, qué tipos acepta, qué es de solo lectura, dónde vive el JSON-LD.
Esta página documenta la matriz de capacidades para que puedas predecir qué esperar cuando enriquezcas una categoría de BigCommerce, una página de Shopify o un producto de WooCommerce.
Matriz señal a señal
Clione trabaja con tres plataformas. Los tipos de entidad se llaman como los llama cada plataforma: BigCommerce tiene productos, categorías y páginas; Shopify, productos, colecciones y páginas; WooCommerce, productos, categorías de producto y páginas.
| Señal | BigCommerce | Shopify | WooCommerce |
|---|---|---|---|
| meta_title | Productos: sí. Categorías y páginas: opcional, desactivado por defecto | Productos: sí. Colecciones y páginas: opcional, desactivado por defecto | Productos: sí. Categorías de producto y páginas: opcional, desactivado por defecto |
| meta_description | Sí, todos los tipos de entidad | Sí, todos los tipos de entidad (la descripción SEO nativa de Shopify) | Sí, todos los tipos de entidad |
| meta_keywords | Sí (array en productos y categorías, string en páginas) | — | — |
| search_keywords (búsqueda interna de BigCommerce) | Categorías y páginas | — | — |
| canonical_url | Sí, todos los tipos de entidad | — | — |
| JSON-LD (incluido FAQPage) | Sí, todos los tipos de entidad (widget) | Sí, todos los tipos de entidad (app embed Clione SEO) | Sí, todos los tipos de entidad (plugin de WordPress de Clione) |
| Acordeón visible de FAQ | Sí (script del Schema Injector) | Sí, todos los tipos de entidad (app embed Clione FAQ) | Sí, todos los tipos de entidad (plugin de WordPress de Clione) |
| OG tags | Productos: campos Open Graph nativos. Categorías y páginas: mediante un widget | — | — |
| Descripción enriquecida añadida a la descripción del producto | — | Solo productos, opcional, desactivada por defecto | — |
— 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.
En Shopify, 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. El JSON-LD (app embed Clione SEO), el acordeón de FAQ (app embed Clione FAQ), llms.txt y los documentos .md bajo /apps/clione solo vienen con la app de Shopify de Clione.
Otras capacidades
| Capacidad | BigCommerce | Shopify | WooCommerce |
|---|---|---|---|
Rangos de precio por variante en el JSON-LD (AggregateOffer con precio mínimo y máximo) | Sí | Sí | Sí |
JSON-LD multidivisa (un Offer por divisa) | — | Sí | — |
| Señales por idioma para cada mercado | — | Sí | — |
llms.txt y documentos .md en tu propio dominio | Sí (un subdominio verificado que apuntas a Clione) | Sí (/apps/clione/, a través de la app de Shopify de Clione) | — |
| Webhooks de producto (un producto creado, actualizado o borrado en tu tienda se sincroniza solo) | Sí | Sí | Sí |
Las categorías, colecciones y páginas se mantienen al día sincronizando.
Rarezas que deberías conocer
Los tipos de meta_keywords difieren dentro de la misma plataforma
En BigCommerce:
- Productos: array de strings.
- Categorías: array de strings.
- Páginas: un único string, separado por comas.
Usar el tipo equivocado devuelve un 422 de la API de la plataforma. Clione lo gestiona internamente, pero quien construye una integración custom debe respetarlo.
En Shopify, meta_keywords no existe como campo. Google lo ignora desde 2009, así que la ausencia no es pérdida para SEO. En Shopify, las keywords de Clione alimentan el JSON-LD y la meta description en vez de una meta tag.
Límites de longitud
- Meta description: Clione la genera dentro de 160 caracteres en todas las plataformas. En Shopify se escribe en la descripción SEO nativa, sin un límite más corto.
meta_keywordsen BigCommerce: tope de 255 caracteres para todo el valor separado por comas. Clione recorta la lista de keywords para que quepa.
Forma de canonical_url
En productos y categorías de BigCommerce, la URL canónica se escribe a través del custom URL de la entidad, que BigCommerce guarda como un objeto — { url: "/path/", is_customized: true } — y no como un string plano. En páginas, es el string url de la página.
En Shopify, Clione no escribe la URL canónica: el storefront de Shopify la renderiza desde la URL primaria de la entidad.
La entrega de JSON-LD es específica por plataforma
| Plataforma | Mecanismo | ¿Server-rendered? |
|---|---|---|
| BC Stencil | Un widget por entidad publicada (Widget API, región header_bottom) | Sí (BigCommerce lo renderiza en servidor) |
| BC Catalyst / headless | SDK @clione/seo o API directa | Sí (controlas el renderizado) |
| Tema Liquid de Shopify | Theme app extension (el app embed Clione SEO) | Sí (renderizado server-side) |
| Hydrogen / headless de Shopify | SDK @clione/seo o API directa | Sí (controlas el renderizado) |
| WooCommerce | Plugin de WordPress de Clione, desde el hook wp_head | Sí (WordPress lo renderiza en servidor) |
El JSON-LD funciona para todos los tipos de entidad en todas las plataformas. Aparece en la página de una entidad cuando publicas esa entidad.
Señales por idioma (Shopify)
Si tu tienda Shopify vende en más de un idioma, activa los idiomas en los que vendes en la tarjeta Mercados de Ajustes de la tienda. Clione escribe un título, una descripción, las FAQs y los datos estructurados traducidos para cada uno, adaptados del texto que ya aprobaste, y tu storefront sirve el idioma correcto en cada mercado. La URL canónica nunca se traduce: la página de cada idioma conserva la suya.
OG tags
En productos de BC, Clione escribe los campos Open Graph nativos (open_graph_type, open_graph_title, open_graph_description, open_graph_use_meta_description, open_graph_use_product_name, open_graph_use_image). Las categorías y las páginas no tienen esos campos, así que sus OG tags llegan mediante un widget.
En Shopify, Clione no escribe OG tags. Los app embeds de Clione renderizan el JSON-LD y el acordeón de FAQ, no OG tags.
Datos a nivel tienda de BC
BC requiere el scope Information & Settings en el token de API para leer la divisa de la tienda y la zona horaria. Sin él, los precios del JSON-LD caen a USD. Mira Conecta BigCommerce.
WooCommerce y los plugins SEO
Cuando Yoast, Rank Math, AIOSEO o SEOPress ya gestionan el título de la página y la meta description, el plugin de WordPress de Clione se los deja a ellos e imprime el JSON-LD, que ningún plugin SEO genera con la forma de Clione.
Guía práctica
- Enriquece y después publica. El enriquecimiento guarda las señales en Clione; nada llega al storefront hasta que publicas la entidad.
- En Shopify, activa los app embeds Clione SEO y Clione FAQ. Sin ellos los metafields se escriben pero nada los renderiza.
- Lanza la verificación después de publicar. Un Verify verde es la única verdad sobre el terreno de que el storefront en vivo tiene las nuevas señales.
Mira también:
- Propagación de señales — qué pasa entre Enrich y el storefront en vivo.
- Verification — cómo confirmar que las señales aterrizaron.
- Schema Injector — el script de FAQ de BigCommerce y los app embeds de Shopify en detalle.