PrestaShop Google Merchant Feed XML

Documentación de PrestaShop Google Merchant Feed

1. Introducción
2. Instalación y requisitos del sistema
3. Activación del módulo
4. Configuración básica del feed
5. Configuración avanzada
6. Estructura del feed XML
7. Filtros de productos
8. Integración con Google Merchant Center
9. Actualización automática (CRON)
10. Seguridad y tokens
11. Inicio de sesión y depuración
12. Tamaños de las imágenes
13. Resolución de problemas
14. PREGUNTAS FRECUENTES

1. introducción

• Generación automática de feeds XML para Google Merchant Center
• Gestión de todos los campos obligatorios y opcionales de Google Shopping.
• Filtrado avanzado de productos (categorías, fabricantes, cantidad, promociones)
• Soporte para múltiples idiomas y divisas en la tienda
• Imágenes adicionales de los productos (hasta 10 por producto)
• Actualización automática del feed mediante CRON
• Acceso seguro mediante tokens
• Almacenamiento en caché del feed para optimizar el rendimiento
• Normalización de datos: eliminación de HTML, resaltados y espacios
• Validación de URL y formatos de datos
• Compatible con PrestaShop 1.7.x, 8.x y 9.x
• Sistema completo de traducción (polaco, inglés, alemán, español, francés)

2. Instalación y requisitos del sistema

• PrestaShop 1.7.0.0 o superior (probado hasta la versión 9.0)
• PHP 7.4 o posterior
• Acceso al panel de administración de PrestaShop
• Cuenta de Google Merchant Center (gratuita)
• Posibilidad de guardar archivos en el servidor
• Acceso a CRON (opcional, para la actualización automática)

1. Descarga el archivo ZIP del módulo desde la página web oficial. códigos.cocos
2. Inicie sesión en el panel de administración de PrestaShop
3. Ir a: Módulos → Administrador de módulos
4. Haga clic en „Cargar módulo” en la esquina superior derecha.
5. Selecciona el archivo ZIP descargado y haz clic en „Subir este módulo”.”
6. Una vez finalizada la instalación, haga clic en "Configurar".
7. El módulo está listo para configurarse.

3. Activación del módulo

1. Vaya a Módulos → Administrador de módulos
2. Busca el módulo „CC Google Merchant Feed”.”
3. Haga clic en „Configurar”.”
4. Seleccione la pestaña „Configuración”.”
5. Rellene los ajustes básicos del feed.
6. Haga clic en „Guardar y generar feed XML”.”

4. Configuración básica del feed

1. En la configuración del módulo, selecciona „Idioma del feed”.”
2. Seleccione el idioma para los nombres y descripciones de los productos en la lista desplegable.
3. Haga clic en „Guardar y generar feed XML”.”

• Todos los productos del idioma seleccionado se cargan desde la tienda.
• El feed XML se genera y guarda automáticamente.
• El archivo está disponible en la URL que aparece en la pestaña „Instrucciones”.”
• Google Merchant Center puede descargar inmediatamente el nuevo feed.

5. Configuración avanzada

1. Introduzca el nombre de la marca/empresa que desea utilizar para los productos sin fabricante.
2. Si deja el campo vacío, se utilizará el nombre de la tienda de la configuración de PrestaShop.
3. La marca es obligatoria para los productos sin GTIN.

1. Introduzca el prefijo del código MPN (por ejemplo, „MPN-” o „SKU-„).
2. El prefijo se añadirá al número de referencia del producto.
3. Si el producto tiene un número de referencia, se le aplicará el prefijo.
4. Si no hay referencias, se añadirá el prefijo al ID del producto.

• Límite de productos – por defecto 0 (sin límite). Cambia a un número, por ejemplo, 1000, si el feed es demasiado grande.
• Número máximo de imágenes adicionales – por defecto 10. Reducir para reducir el tamaño del feed.

6. Estructura del feed XML

 http://example.com
    Feed de productos para Google Merchant Center  123 Nombre del producto Descripción del producto 

123 Camiseta azul talla L Camiseta de algodón de alta calidad en color azul, talla L
  http://example.com/produkt/niebieski-t-shirt http://example.com/images/tshirt-blue-large.jpg
  http://example.com/images/tshirt-blue-1.jpg 99,99 PLN 79,99 PLN
  en stock nuevo 5901234123457 Marca de moda MPN-123

7. Filtros de productos

1. En la sección „Categorías” verás una lista de todas las categorías de la tienda.
2. Marca las casillas junto a las categorías que deseas exportar.
3. Para seleccionar varias categorías, mantenga pulsada la tecla CTRL (Cmd en Mac) y haga clic en las categorías.
4. Déjelo sin marcar si desea exportar todas las categorías.

1. En la sección „Fabricantes” verás una lista de todos los fabricantes/marcas.
2. Marca las casillas junto a los fabricantes cuyos productos deseas exportar.
3. Para seleccionar varios fabricantes, mantenga pulsada la tecla CTRL (Cmd en Mac) y haga clic.
4. Déjelo sin marcar si desea exportar todos los fabricantes.

1. Introduzca la cantidad mínima de productos en stock.
2. Los productos con menos cantidad se omitirán en el feed.
3. Introduce 0 para no filtrar por cantidad (por defecto).
4. Útil para exportar solo los productos disponibles

1. Marca la opción „Solo productos en promoción” si deseas exportar solo las promociones.
2. Marque esta casilla si desea exportar todos los productos independientemente de las promociones.
3. El módulo añade automáticamente el campo «sale_price» para los productos con descuentos.

8. Integración con Google Merchant Center

1. En el panel de administración de PrestaShop, vaya a Módulos → Administrador de módulos.
2. Haga clic en „Configurar” junto al módulo CC Google Merchant Feed.
3. Vaya a la pestaña „Instrucciones”.”
4. En la sección „Enlace al feed XML”, verás la URL completa del feed.
5. Haga clic en el botón „Copiar” para copiar la URL al portapapeles.

1. Iniciar sesión en Google Merchant Center
2. Vaya a la sección „Productos” → „Canales”.”
3. Haga clic en „Nuevo canal”.”
4. Seleccione „Anuncios de compras” o el tipo de canal adecuado.
5. Introduce el nombre del canal (por ejemplo, „Feed XML PrestaShop”).
6. En la sección „Productos”, selecciona „URL del feed”.”
7. Pega la URL copiada en el feed.
8. Haga clic en „Siguiente” y complete la configuración del canal.

1. Una vez añadido el feed, Google lo descargará y validará automáticamente.
2. Vaya a „Productos” → „Diagnóstico”.”
3. Comprueba si el feed se ha indexado correctamente.
4. Si hay errores, el módulo mostrará qué productos tienen problemas.

1. Google Merchant Center descarga automáticamente el feed a veces.
2. Para forzar una actualización inmediata, haz clic en el icono de actualización junto al canal.
3. O configure la actualización automática mediante CRON (descrito más abajo).

9. Actualización automática (CRON)

• Herramienta para la ejecución automática de tareas en el servidor
• Permite planificar actividades regulares (cada 6 horas, cada día, etc.).
• Ideal para actualizar el feed de Google Merchant Center.
• Requiere acceso al panel de alojamiento/servidor.

1. En la configuración del módulo, seleccione la opción „Actualización automática”.”
2. Si desmarcas esta opción, el feed se almacenará en caché durante un número determinado de horas.
3. Deja marcada la opción para regenerar el feed cada vez que se solicite.

0 */6 * * * curl -s "http://example.com/modules/cc_ps_google_merchant/feed.xml?token=WYGENEROWANY_TOKEN" > /dev/null 2>&1

• 0 */6 * * * – inicia la tarea cada 6 horas, a la hora en punto
• curl -s – descarga la URL en modo silencioso (sin mensajes)
• http://example.com – cámbielo por la dirección de su tienda
• TOKEN_GENERADO – token de seguridad de la configuración del módulo
• > /dev/null 2>&1 – oculta mensajes y errores

0 */6 * * * wget -q -O - "http://example.com/modules/cc_ps_google_merchant/feed.xml?token=WYGENEROWANY_TOKEN" > /dev/null 2>&1

• 0 * * * * – cada hora
• 0 */6 * * * – cada 6 horas (recomendado)
• 0 0 * * * – todos los días a medianoche
• 0 */12 * * * – cada 12 horas

10. Seguridad y tokens

• Código único generado aleatoriamente al instalar el módulo.
• Requerido cada vez que CRON llama al feed.
• Impide que personas no autorizadas actualicen el feed.
• Cambia con cada regeneración.

1. En el panel de administración de PrestaShop, vaya a Módulos → Administrador de módulos.
2. Haga clic en „Configurar” junto a CC Google Merchant Feed.
3. Vaya a la pestaña „Instrucciones”.”
4. En la sección „Regeneración automática (CRON)” verás el token.
5. Un token es una cadena larga de caracteres alfanuméricos.

http://example.com/modules/cc_ps_google_merchant/feed.xml http://example.com/modules/cc_ps_google_merchant/feed.xml?token=abc123def456ghi789jkl

1. En la pestaña „Instrucciones”, haz clic en el botón „Generar nuevo token de seguridad”.”
2. Aparecerá una ventana de confirmación: haga clic en Aceptar.
3. Se generará y mostrará un nuevo token.
4. El token antiguo dejará de funcionar inmediatamente.
5. Si utilizas CRON, debes actualizar el comando con el token antiguo.

11. Inicio de sesión y depuración

1. Abre la URL del feed en tu navegador web.
2. Deberías ver el código XML sin formato con los productos.
3. Haga clic con el botón derecho del ratón y seleccione „Mostrar código fuente”.”
4. Comprueba que la estructura XML sea correcta.
5. Comprueba que todos los campos obligatorios estén rellenados para cada producto.

1. Ir a Validador XML
2. Copie el contenido del feed y péguelo en el validador.
3. El validador mostrará si el XML tiene una sintaxis correcta.
4. Si hay errores, fíjate en el número de línea donde está el problema.

1. Ir a Google Merchant Center
2. Abrir canal con feed
3. Vaya a „Diagnóstico”.”
4. Comprueba „Errores” y „Advertencias”.”
5. Google mostrará qué productos tienen problemas y qué es lo que falla.

• Si el feed no se genera, comprueba los registros de errores PHP en el servidor.
• Buscar errores relacionados con el módulo cc_ps_google_merchant
• Comprueba si el servidor tiene permisos para escribir en el directorio del módulo.
• Comprueba si PHP tiene instalada la extensión SimpleXML.

12. Tamaños de las imágenes

1. En la configuración del módulo, vaya a „Tamaño de las imágenes”.”
2. Seleccione el tamaño que prefiera en la lista desplegable.
3. Haga clic en „Guardar y generar feed XML”.”

• Tamaño mínimo: 100 x 100 píxeles
• Tamaño recomendado: 800 x 800 píxeles o superior.
• Tamaño máximo del archivo: sin límite, pero Google solo descarga los primeros 10 MB.
• Formatos: JPG, PNG, GIF, BMP, TIFF, ICO, CUR, SVG, WEBP

• El módulo puede añadir hasta 10 fotos adicionales a cada producto.
• Aumenta las posibilidades de que el producto aparezca en el buscador Google Images.
• Se puede desactivar la opción para reducir el tamaño del feed.
• La opción „Número máximo de imágenes adicionales” permite controlar la cantidad.

13 Solución de problemas

1. Comprueba si el módulo está activo en el Administrador de módulos.
2. Comprueba si el servidor tiene permisos de escritura en el directorio. /módulos/cc_ps_google_merchant/
3. Inicie sesión en el panel de administración e intente hacer clic en „Guardar y generar feed XML”.”
4. Comprueba los registros de errores del servidor (error.log PHP).
5. Asegúrate de que PHP tiene la extensión SimpleXML instalada.
6. Intenta desactivar el módulo y volver a activarlo.

1. Comprueba si los productos están activos en PrestaShop.
2. Comprueba si los productos tienen asignada una categoría.
3. Si utilizas filtros, comprueba que los productos cumplan los requisitos del filtro.
4. Comprueba la cantidad mínima en stock: los productos agotados pueden omitirse.
5. Abre el feed XML en el navegador y busca los productos manualmente (CTRL+F).

1. Ve a Google Merchant Center y abre la pestaña „Diagnóstico”.”
2. Lea el mensaje de error completo.
3. Comprueba qué campos faltan: Google exige determinados campos.
4. El módulo omite automáticamente los productos que carecen de los datos requeridos.
5. Asegúrate de que los productos tengan: título, descripción, enlace, foto, precio, disponibilidad, GTIN o marca.

1. Comprueba si el precio en PrestaShop está correctamente configurado.
2. Comprueba que la moneda de la tienda esté configurada correctamente.
3. Si hay descuentos, el módulo debe seleccionar el precio con descuento.
4. Comprueba que el IVA se haya aplicado correctamente (el precio debe incluir el IVA).

1. Comprueba si la opción „Imágenes adicionales” está activada en la configuración.
2. Asegúrate de que los productos tengan fotos adicionales asignadas en PrestaShop.
3. Comprueba que el número máximo de imágenes adicionales no esté establecido en 0.
4. Abre el feed XML y comprueba si hay elementos g:additional_image_link.

1. Comprueba si la tarea CRON está correctamente añadida en el panel de alojamiento.
2. Comprueba que la URL en el comando CRON sea correcta.
3. Comprueba si el token de la URL está actualizado (a veces cambia con las actualizaciones).
4. Intenta introducir manualmente la URL en el navegador para comprobar si funciona.
5. Comprueba los registros CRON en el panel de alojamiento; pueden contener información sobre errores.

14. PREGUNTAS FRECUENTES