DataFirefly Google Shopping — Guía completa

Presentación

DataFirefly Google Shopping es un módulo para PrestaShop 8 y 9 que genera feeds de Merchant Center conformes con la spec Google Shopping 2025 y los adapta automáticamente a 6 canales (Google, Bing, Meta Catalog, Kelkoo, Idealo, LeGuide). Incluye 5 asistentes IA (Anthropic Claude, OpenAI GPT-4o o Mistral AI a elegir), una puntuación de calidad 0-100, un editor masivo AJAX, auditoría de imágenes por Visión IA y herramientas premium (test A/B de títulos, forecaster estacional, export Google Ads Editor).

El módulo crea 12 tablas con prefijo dfgs_ y 9 pestañas de back-office bajo el menú «Google Shopping». Sin overrides de core, sin archivos de PrestaShop modificados.

Instalación

1. En el back-office de PrestaShop, ve a Módulos → Gestor de módulos → Subir un módulo.
2. Sube el archivo dfexportgoogleshopping.zip.
3. Haz clic en Instalar. El módulo crea sus tablas, sus pestañas admin y sus valores de configuración por defecto.

Requisitos: PrestaShop 8.0 a 9.x, PHP 8.1+, MySQL 5.7+ o MariaDB 10.3+, extensión cURL activada. Multitienda y multilingüe soportados nativamente.

Crear tu primer feed

1. Ve a Google Shopping → Feeds y haz clic en Añadir un feed.
2. Rellena el nombre, el tipo de feed (Productos, Local Inventory Ads o Promociones), la tienda, el idioma, la divisa y el país objetivo.
3. Elige el canal destino: Google Shopping (por defecto), Bing, Meta Catalog, Kelkoo, Idealo o LeGuide. El formato XML se adapta automáticamente al canal (namespaces, renames de atributos, límites de longitud).
4. Configura los filtros de inclusión: categorías, fabricantes, exclusión de productos sin stock.
5. Guarda y haz clic en Generar. La URL pública del feed (securizada por token) aparece en la lista — es la que declaras en Merchant Center.

Mapeo de categorías Google

En Google Shopping → Mapeo de categorías, asocia cada categoría de tu tienda con una categoría de la taxonomía de Google (unas 6.000 entradas, caché 30 días). Dos métodos:

• Manual: búsqueda con autocompletado en la taxonomía.
• Auto-mapeo IA: el botón «Mapear automáticamente» envía tus categorías sin mapear al asistente IA, que propone la mejor correspondencia. Las propuestas de alta confianza se aplican; el resto queda pendiente de validación.

El mapeo se propaga a las subcategorías sin mapear. El atributo google_product_category y el product_type se rellenan automáticamente en el feed.

Overrides de producto

La pestaña Overrides de producto permite forzar, producto a producto (y por idioma/tienda), los valores del feed: título, marca, GTIN, MPN, condición, color, talla, material, custom labels 0-4, categoría Google, exclusión del feed, etc. Los overrides siempre priman sobre los valores del catálogo.

Edición masiva

La pestaña Edición masiva muestra una rejilla AJAX de 50 productos por página con búsqueda por nombre, referencia o ID:

• Edición inline: haz clic en una celda, escribe el valor, Enter — el guardado es inmediato (fondo verde = éxito).
• Acción masiva: marca varios productos, elige un campo y un valor, pulsa Aplicar. El botón «Eliminar overrides» retira los overrides de los productos seleccionados.

Import / Export CSV y previsualización

La pestaña Import / Export / Preview agrupa tres herramientas:

• Export CSV de overrides o mapeos de categoría (UTF-8 con BOM, separador punto y coma, compatible Excel).
• Import CSV con semántica clara: celda vacía = sin cambio, asterisco (*) = vaciar el campo.
• Previsualización XML: introduce un ID de producto y un feed, obtén el XML exacto de ese producto con los problemas de validación detectados. Ideal para depurar un producto rechazado.

Asistentes IA

Configura primero el proveedor en Google Shopping → Ajustes: Anthropic (Claude), OpenAI (ChatGPT/GPT-4o) o Mistral AI, con tu clave API y el modelo. Modelos recomendados: claude-haiku-4-5-20251001 o gpt-4o-mini (rápidos, baratos); claude-sonnet-4-6 o gpt-4o para máxima calidad.

La pestaña Asistentes IA pilota los 5 asistentes:

• Mapeo de categorías: asocia tus categorías a la taxonomía de Google.
• Reescritura de títulos: optimiza los títulos según el vertical detectado (apparel, electronics, books, home, beauty, food) siguiendo los patrones recomendados por Google.
• Extracción de atributos: deduce color, size, material, pattern, age_group, gender desde las descripciones (confianza ≥ 0.80).
• Búsqueda de GTIN: recupera el GTIN a partir de marca + MPN + nombre, con validación módulo 10 (confianza ≥ 0.85).
• Corrección de rechazos: analiza cada rechazo de Merchant Center y propone (o aplica automáticamente con confianza ≥ 0.85) una corrección estructurada.

Cada llamada se registra en la tabla dfgs_ai_log (proveedor, modelo, tokens de entrada/salida, duración): sigues tu presupuesto IA al céntimo.

Puntuación de calidad 0-100

En cada generación de un feed de productos, el módulo muestrea 500 items y calcula 9 sub-puntuaciones ponderadas: cobertura GTIN (15 pts), cobertura de imágenes (10), calidad de imágenes (10), calidad de títulos (15), calidad de descripciones (10), mapeo de categorías (15), cobertura de highlights (10), sin rechazos críticos abiertos (10), envío presente (5). El total da una nota de A+ a F en el dashboard, con las 5 recomendaciones de mayor impacto arriba.

Alertas Slack y email

En Ajustes, indica un webhook Slack entrante y/o una dirección de email. Tres disparadores: nuevos rechazos críticos detectados durante una generación, caída de la puntuación ≥ 10 puntos respecto a la generación anterior, fallo de generación. Anti-spam: máximo 1 alerta por tipo cada 6 horas.

Funcionalidades premium

La pestaña Premium agrupa 5 herramientas:

• Análisis Search Console: sube el export CSV de consultas (Search Console → Resultados de búsqueda → Exportar). El módulo cruza cada consulta con tus títulos de producto y calcula una puntuación de oportunidad (impresiones × palabras clave ausentes del título × multiplicador de posición). Las 20 mejores oportunidades se muestran con el producto sugerido.
• Test A/B de títulos: dos variantes alternan en ciclos de 7 días en el feed. El ganador se declara cuando cada variante alcanza ≥ 500 impresiones con un delta de CTR ≥ 5%; entonces se aplica automáticamente como override.
• Forecaster estacional: analiza 24 meses de histórico de pedidos y etiqueta los productos en custom_label_4 — upcoming_season (índice estacional > 1.5 en los 2 próximos meses), bestseller (top 10% de la facturación 30 días), declining_trend (caída ≥ 20% en 6 meses).
• Auditoría de calidad de imágenes: por lotes de 25, la Visión IA (Claude Vision o GPT-4o — Mistral no soportado) detecta marcas de agua, textos promocionales, tipo de fondo y productos múltiples. Puntuación 0-10 por imagen, caché 30 días.
• Export Google Ads Editor: CSV directamente importable, con grupos de anuncios jerarquizados por custom labels y multiplicadores de puja por tag (bestseller ×1.5, upcoming_season ×1.3, on_sale ×1.2, declining_trend ×0.5).

Automatización por cron

Cada feed expone una URL de generación securizada por token, mostrada en la lista de feeds. Ejemplo de crontab para regenerar cada 6 horas:

0 */6 * * * curl -s "https://tutienda.com/module/dfexportgoogleshopping/cron?token=TU_TOKEN&id_feed=1" > /dev/null

La generación es en streaming: los catálogos de 100.000+ productos pasan sin saturación de memoria.

Resolución de problemas

• El feed está vacío: verifica los filtros del feed (categorías, stock) y que los productos estén activos y visibles en la tienda vinculada al feed.
• Productos excluidos en la generación: consulta la pestaña Diagnóstico — cada exclusión tiene su motivo (GTIN inválido, imagen ausente, precio a cero…). Usa la previsualización XML para el detalle de un producto concreto.
• Error de llamada IA: verifica la clave API y el modelo en Ajustes. El registro dfgs_ai_log guarda los fallos con su causa.
• La auditoría de imágenes falla con Mistral: es lo esperado — la visión requiere Anthropic u OpenAI.
• Una pestaña desaparece tras actualizar PrestaShop: reinicializa el módulo (Módulos → dfexportgoogleshopping → Restablecer) para recrear las pestañas admin sin perder tus datos.

Desinstalación

La desinstalación elimina las 12 tablas dfgs_, las pestañas admin y los valores de configuración DFGS_. Exporta tus overrides y mapeos a CSV antes si quieres conservarlos.