SEO Rich Data - instalación y configuración
Objetivo del módulo
El móduloKowal_SeoRichDataañade a Magento 2 datos estructuradosschema.orgen formato JSON-LD. Los datos generados pueden incluir productos, ofertas, precios, disponibilidad, valoraciones, reseñas, breadcrumbs, datos de organización, nombre del sitio, search box, perfiles sociales, FAQ y vídeo.
La configuración del módulo se encuentra en el panel de administración de Magento:
Stores > Configuration > Kowal > SEO Rich Data
Requisitos
- Magento 2.
- Acceso a CLI de Magento.
- Acceso al Composer repository con el paquete
kowal/module-seo-rich-data.
- Paquete base requerido:
kowal/base.
- Permisos para ejecutar comandos
bin/magento.
Instalación mediante Composer
- Añade el repositorio del paquete:
Recibirás por correo electrónico los datos de acceso al repositorio Composer (dirección de e-mail del cliente y token de licencia) después de la compra. También están disponibles en el panel de cliente tras iniciar sesión en kowal.store. Sustituye TWOJ_EMAIL_KLIENTA por la dirección de e-mail de tu cuenta y TWOJ_TOKEN por el token recibido. Ejecuta los comandos en el directorio raíz de Magento.
composer config repositories.kowal composer https://repo.kowal.store
2. Configura los datos de acceso al repositorio Composer de Kowal:
composer config http-basic.repo.kowal.store "TWOJ_EMAIL_KLIENTA" "TWOJ_TOKEN"
composer require kowal/module-seo-rich-data
php bin/magento module:enable Kowal_SeoRichData
5. Ejecuta la actualización de Magento:
php bin/magento setup:upgrade
6. En el entorno de producción, ejecuta la compilación DI:
php bin/magento setup:di:compile
7. En el entorno de producción, si el proyecto lo requiere, genera los archivos estáticos:
php bin/magento setup:static-content:deploy
php bin/magento cache:flush
Instalación manual
- Copia el módulo en el directorio:
app/code/Kowal/SeoRichData
php bin/magento module:enable Kowal_SeoRichData
3. Ejecuta la actualización de Magento:
php bin/magento setup:upgrade
php bin/magento cache:flush
Acciones posteriores a la instalación
Tras la instalación, el módulo añade el atributo de producto:
| Atributo |
Significado |
offer_item_condition |
Estado del producto utilizado para generaritemConditionenoffers. |
El atributo admite los valores:
| Valor en Magento |
Valor JSON-LD |
DamagedCondition |
https://schema.org/DamagedCondition |
NewCondition |
https://schema.org/NewCondition |
RefurbishedCondition |
https://schema.org/RefurbishedCondition |
UsedCondition |
https://schema.org/UsedCondition |
Si el producto no tiene establecido el valor del atributo, el módulo lo trata comoNewCondition.
Alcance de la configuración
Todos los campos de configuración están disponibles para los ámbitosDefault,WebsiteyStore View, de acuerdo con la configuración de Magento.
Los campos de tipoEnabled,Show ...y similares utilizan los valores estándar de Magento:
| Valor |
Significado |
Yes |
La función está activada y puede generar datos JSON-LD. |
No |
La función está desactivada. |
Breadcrumbs
La sección se encarga de los datos estructurados de la ruta de navegación.
| Campo |
Significado |
Valores |
Enabled |
Activa la generación de datosBreadcrumbList. |
Yes,No |
Fixed Category Path |
En la página de producto, utiliza la ruta de categoría más específica cuando Magento no proporciona el contexto completo de la categoría. |
Yes,No |
Type |
Define la longitud de la ruta breadcrumbs generada para el buscador. |
Default (Long),Short |
Valores del campoType:
| Valor |
Significado |
Default (Long) |
Ruta completa, p. ej.Store > Category > Subcategory > Product. |
Short |
Ruta abreviada, p. ej.Store > Subcategory > Product. |
Include Your Site Name in Search Results
La sección se encarga de los datos de tipoWebSite, que pueden ayudar a Google a reconocer el nombre del sitio.
| Campo |
Significado |
Valores |
Enabled |
Activa la generación de datosWebSite. |
Yes,No |
Website Name |
Nombre de la página/tienda transmitido en los datos estructurados. |
Texto, p. ej. nombre de la tienda. |
Organization
La sección se encarga de los datos de tipoOrganization.
| Campo |
Significado |
Valores |
Enabled |
Activa la generación de datos de la organización. |
Yes,No |
Organization Name |
Nombre de la empresa o de la tienda. |
Texto; campo obligatorio tras activar la sección. |
Logo Url |
URL completa del logotipo de la organización. |
URL del archivo gráfico. |
Description |
Descripción de la organización. |
Texto. |
Description Length |
Número máximo de caracteres de la descripción. |
Número; vacío significa que no se recorta. |
Country |
País de la organización. |
Código de país de la lista de Magento. |
Region/State |
Región o provincia. |
Texto. |
ZIP/Postal Code |
Código postal. |
Texto. |
City |
Ciudad. |
Texto. |
Street Address |
Calle y número. |
Texto. |
Sales |
Teléfono del departamento comercial. |
Número en formato internacional, p. ej.+48.... |
Technical Support |
Teléfono de soporte técnico. |
Número en formato internacional. |
Customer Service |
Teléfono de atención al cliente. |
Número en formato internacional. |
El país de esta sección puede utilizarse como fallback para el país de envío y el país de la política de devoluciones, si los campos correspondientes de la sección de producto permanecen vacíos.
Social Profiles
La sección añade los perfiles sociales de la organización. Para que los datos tengan sentido, la secciónOrganizationdebe estar activada.
| Campo |
Significado |
Valores |
Enabled |
Activa la generación de enlaces de perfiles sociales. |
Yes,No |
Facebook |
URL del perfil de Facebook. |
URL completa. |
Twitter |
URL del perfil de Twitter / X. |
URL completa. |
Google+ |
URL del perfil de Google+. |
URL completa; campo de configuración histórico. |
Instagram |
URL del perfil de Instagram. |
URL completa. |
YouTube |
URL del canal de YouTube. |
URL completa. |
LinkedIn |
URL del perfil de LinkedIn. |
URL completa. |
Myspace |
URL del perfil de Myspace. |
URL completa; campo de configuración histórico. |
Pinterest |
URL del perfil de Pinterest. |
URL completa. |
SoundCloud |
URL del perfil de SoundCloud. |
URL completa. |
Tumblr |
URL del perfil de Tumblr. |
URL completa. |
Los campos vacíos se omiten.
Search Box
La sección se encarga de los datosSearchAction, que pueden permitir mostrar el campo de búsqueda de la tienda en los resultados de Google.
| Campo |
Significado |
Valores |
Enabled |
Activa la generación de datos del buscador del sitio. |
Yes,No |
Category Rich Data
La sección se encarga de generar datos de productos en las páginas de categoría.
| Campo |
Significado |
Valores |
Show Products Data |
Añade datos estructurados para los productos visibles en la página de categoría. |
Yes,No |
Activar esta opción puede empeorar el rendimiento de las páginas de categoría, ya que el módulo debe recopilar datos de muchos productos.
Product Rich Data
La sección se encarga de los datos principales de producto de tipoProducty de los datosoffers.
Campos básicos del producto
| Campo |
Significado |
Valores |
Enabled |
Activa la generación de JSON-LD del producto en la página de producto. |
Yes,No |
Show Availability |
Añadeavailabilityenoffers. |
Yes,No |
priceValidUntil Default Value |
Fecha predeterminada de validez del precio. |
Fecha. |
Use “Special Price To” Value for priceValidUntil Snippet |
Si el producto tiene un precio especial activo y una fechaSpecial Price To, esta fecha sustituye el valor predeterminado. |
Yes,No |
Show Condition |
AñadeitemConditionenoffers. |
Yes,No |
Description |
Define la fuente de la descripción del producto en JSON-LD. |
None,Product Short Description,Product Full Description,Page Meta Description |
Valores del campoDescription:
| Valor |
Significado |
None |
No toma la descripción de la configuración; el código puede usar el nombre del producto como fallback si la descripción está vacía. |
Product Short Description |
Utiliza la descripción corta del producto. |
Product Full Description |
Utiliza la descripción completa del producto. |
Page Meta Description |
Utiliza la meta description de la página. |
Productos configurables y agrupados
| Campo |
Significado |
Valores |
Show Configurable Products as |
Define cómo se generan las ofertas para productos configurables. |
Main Offer,List of Associated Products Offers,Aggregate Offer |
Show Grouped Products as |
Define cómo se generan las ofertas para productos agrupados. |
Main Offer,List of Associated Products Offers,Aggregate Offer |
Valores:
| Valor |
Significado |
Main Offer |
Genera una oferta para el producto principal. |
List of Associated Products Offers |
Genera una oferta separada para cada producto simple o asociado. |
Aggregate Offer |
GeneraAggregateOffercon el precio más bajo, el precio más alto y el número de ofertas. |
Valoraciones y reseñas
| Campo |
Significado |
Valores |
Show Rating |
AñadeaggregateRatingyreviewa los datos del producto. |
Yes,No |
Use Yotpo Reviews instead of Magento Reviews |
Obtiene reseñas de Yotpo en lugar de Magento Reviews. |
Yes,No |
Rating Format |
Define la escala de valoraciones. |
Percentage Scale,Numeric Scale |
Number of Reviews |
Límite del número de reseñas más recientes añadidas a JSON-LD. |
Número; vacío significa todas las reseñas. |
Valores del campoRating Format:
| Valor |
Significado |
Percentage Scale |
Las valoraciones se interpretan en escala porcentual. |
Numeric Scale |
Las valoraciones se interpretan en escala numérica. |
La integración con Yotpo requiere la disponibilidad de un módulo compatible con Yotpo. Si el módulo no está instalado, la configuración de Yotpo no debe activarse.
Brand, manufacturer e identificadores de producto
| Campo |
Significado |
Valores |
Brand |
Atributo de producto utilizado para generar la propiedadbrand. |
Cualquier atributo de producto de la lista. |
EAN / GTIN Attribute |
Atributo de producto utilizado como identificador global del producto. |
Cualquier atributo de producto de la lista. |
Manufacturer |
Atributo de producto utilizado para generar la propiedadmanufacturer. |
Cualquier atributo de producto de la lista. |
CampoEAN / GTIN Attributegenera la propiedad según el número de dígitos:
| Número de dígitos |
Propiedad JSON-LD |
| 8 |
gtin8 |
| 12 |
gtin12 |
| 13 |
gtin13 |
| 14 |
gtin14 |
| Otro número positivo de dígitos |
gtin |
El módulo elimina de los valores EAN / GTIN los caracteres que no sean dígitos antes de generar JSON-LD.
Shipping details
La sección de envío se encarga de generarshippingDetailsenoffers. Los datos solo se añaden cuando la sección está activada y cuenta con todos los valores requeridos.
| Campo |
Significado |
Valores |
Show Shipping Details |
Activa la generación deshippingDetails. |
Yes,No |
Shipping Country |
País de entrega. |
Código de país de la lista de Magento; si está vacío, se utiliza el país de la secciónOrganization. |
Shipping Price |
Coste de entrega. |
Número igual o superior a0;0significa entrega gratuita. |
Handling Time Min Days |
Tiempo mínimo de gestión del pedido. |
Número entero, días. |
Handling Time Max Days |
Tiempo máximo de gestión del pedido. |
Número entero, días. |
Transit Time Min Days |
Tiempo mínimo de transporte. |
Número entero, días. |
Transit Time Max Days |
Tiempo máximo de transporte. |
Número entero, días. |
La moneda del coste de envío se toma de la moneda de la oferta del producto.
Ejemplo del significado de los valores:
| Campo |
Ejemplo |
Significado |
Shipping Price |
0 |
Envío gratuito. |
Handling Time Min Days |
0 |
El pedido puede gestionarse el mismo día. |
Handling Time Max Days |
1 |
La gestión del pedido dura como máximo 1 día. |
Transit Time Min Days |
1 |
La entrega dura al menos 1 día. |
Transit Time Max Days |
5 |
La entrega dura como máximo 5 días. |
Merchant return policy
La sección de política de devoluciones se encarga de generarhasMerchantReturnPolicyenoffers. Los datos solo se añaden cuando la sección está activada y cuenta con los valores requeridos.
| Campo |
Significado |
Valores |
Show Merchant Return Policy |
Activa la generación dehasMerchantReturnPolicy. |
Yes,No |
Return Policy Country |
País de aplicación de la política de devoluciones. |
Código de país de la lista de Magento; si está vacío, se utiliza el país de la secciónOrganization. |
Return Policy Category |
Tipo de política de devolución. |
Finite Return Window,Returns Not Permitted,Unlimited Return Window |
Merchant Return Days |
Número de días para la devolución. |
Número entero; obligatorio paraFinite Return Window. |
Return Method |
Método de devolución admitido. |
-- Empty --,Return By Mail,Return In Store,Return At Kiosk |
Return Fees |
Información sobre los costes de devolución. |
-- Empty --,Free Return,Customer Responsibility,Return Shipping Fees |
Return Shipping Fee |
Importe de la tarifa por envío de devolución. |
Número mayor que0; obligatorio solo paraReturn Shipping Fees. |
Valores del campoReturn Policy Category:
| Valor |
Valor JSON-LD |
Significado |
Finite Return Window |
https://schema.org/MerchantReturnFiniteReturnWindow |
Devolución posible durante un número determinado de días. RequiereMerchant Return Days. |
Returns Not Permitted |
https://schema.org/MerchantReturnNotPermitted |
No se permiten devoluciones. |
Unlimited Return Window |
https://schema.org/MerchantReturnUnlimitedWindow |
Devolución sin límite de días determinado. |
Valores del campoReturn Method:
| Valor |
Valor JSON-LD |
Significado |
-- Empty -- |
sin valor |
El método de devolución no se añade a JSON-LD. |
Return By Mail |
https://schema.org/ReturnByMail |
Devolución por correo. |
Return In Store |
https://schema.org/ReturnInStore |
Devolución en tienda física. |
Return At Kiosk |
https://schema.org/ReturnAtKiosk |
Devolución en punto/kiosco. |
Valores del campoReturn Fees:
| Valor |
Valor JSON-LD |
Significado |
-- Empty -- |
sin valor |
La información sobre costes no se añade a JSON-LD. |
Free Return |
https://schema.org/FreeReturn |
La devolución es gratuita. |
Customer Responsibility |
https://schema.org/ReturnFeesCustomerResponsibility |
El coste de devolución corre a cargo del cliente. |
Return Shipping Fees |
https://schema.org/ReturnShippingFees |
La devolución tiene una tarifa determinada por envío de devolución. RequiereReturn Shipping Fee. |
La moneda del campoReturn Shipping Feese toma de la moneda de la oferta del producto.
Custom Properties
CampoCustom Propertiespermite añadir propiedades propias al JSON-LD del producto.
Formato:
wlasciwosc_jsonld,kod_atrybutu
Si se indica un solo elemento, el módulo lo trata a la vez como nombre de propiedad JSON-LD y como código de atributo.
Valor predeterminado:
sku
mpn,sku
Significado del valor predeterminado:
| Línea |
Efecto |
sku |
Añadeskua partir del atributosku. |
mpn,sku |
Añadempna partir del atributosku. |
Ejemplo de adición de un atributo propio:
color,color
material,material
Configuración mínima recomendada para productos
Para limitar las advertencias de Google Search Console para datos de producto, configura al menos:
| Campo |
Recomendación |
Product Rich Data > Enabled |
Yes |
Show Availability |
Yes |
Brand |
Selecciona el atributo con la marca del producto. |
EAN / GTIN Attribute |
Selecciona el atributo con EAN / GTIN si los productos tienen un identificador global. |
Show Shipping Details |
Yes, si la tienda tiene una política de envío uniforme que pueda describirse en la configuración. |
Show Merchant Return Policy |
Yes, si la tienda tiene una política de devoluciones uniforme que pueda describirse en la configuración. |
Custom Properties |
Mantén al menossku; opcionalmente añadempnsi la tienda dispone de dicho identificador. |
Limpieza de caché tras cambios de configuración
Después de cambiar la configuración, ejecuta:
php bin/magento cache:flush
Si la tienda utiliza una caché HTTP adicional, Varnish o CDN, limpia también esas capas de caché.
Verificación del funcionamiento
- Abre la página de producto en el frontend.
- Comprueba el código fuente de la página y busca:
<script type="application/ld+json">
3. Verifica que JSON-LD contenga los campos esperados, p. ej.:
{
"@type": "Product",
"brand": {
"@type": "Brand",
"name": "Example Brand"
},
"gtin13": "5901234123457",
"offers": [
{
"@type": "Offer",
"shippingDetails": {},
"hasMerchantReturnPolicy": {}
}
]
}
4. Prueba la URL del producto en la herramienta Google Rich Results Test o en Google Search Console.
Notas de implantación
- No actives
shippingDetailsnihasMerchantReturnPolicysi los valores de la configuración no corresponden a la política real de la tienda.
- Si las políticas de envío o devoluciones difieren por producto, región, método de entrega o carrito, una configuración global única puede no ser suficiente.
- Tras cambiar los atributos
Brand,ManufactureroEAN / GTIN Attribute, conviene reindexar los datos de producto si la tienda utiliza caché o índices que influyen en la lectura de atributos.
- En tiendas multilingües y multidivisa, comprueba la configuración por separado para cada Store View.
