PS PrestaShop Intermedio

DataFirefly Google Shopping — Guía completa

Instalación, feeds por país / idioma / moneda, categorías de Google, reglas, sustituciones, problemas, Merchant API y sugerencias de IA opcionales, cron y resolución de problemas del módulo Google Shopping para PrestaShop 1.7.8, 8 y 9.

Actualizado Versión del módulo 2.0.0

Presentación general

DataFirefly Google Shopping genera sus feeds de Google Merchant Center desde PrestaShop: productos, inventario local y promociones, un feed por tienda, país, idioma y moneda. Comprueba cada artículo con respecto a la especificación de datos de productos de Google, muestra lo que ha encontrado y le permite corregirlo con categorías, reglas y sustituciones antes de que Google lea el feed. La Merchant API y las sugerencias de IA son opcionales.

El módulo añade un menú Google Shopping en Mejorar con 10 páginas: Panel, Feeds, Categorías de Google, Reglas, Productos, Incidencias, Sugerencias IA, Análisis, Importar / exportar y Ajustes. Crea 18 tablas con el prefijo dfgs_, no sobrescribe ninguna clase de PrestaShop y no modifica ningún archivo del núcleo.

El módulo sigue la especificación de Google, pero solo Google decide sobre la aprobación y la visualización de sus productos. El indicador de calidad del panel de control es una comprobación de completitud interna, no una puntuación de Google.

Requisitos

  • PrestaShop 1.7.8, 8.x o 9.x.
  • PHP 7.4 a 8.5 con las extensiones xmlwriter y zlib (openssl y curl para la Merchant API y la IA).
  • Una cuenta de Google Merchant Center.

Instalación

  1. En el back office, abra Módulos → Gestor de módulos y haga clic en Subir un módulo.
  2. Seleccione dfexportgoogleshopping-2.0.0.zip. PrestaShop instala el módulo.
  3. Abra Mejorar → Google Shopping. El asistente de configuración se inicia en la primera visita.

Actualizar desde la versión 1.x

Suba el zip de la 2.0.0 sobre el módulo instalado (mismo procedimiento que para la instalación). La actualización:

  • conserva sus feeds, su URL pública, su token y los ID de artículo de la versión 1.x, por lo que Merchant Center conserva sus productos;
  • traslada las asignaciones de categorías, las sustituciones de productos y la configuración;
  • cifra las claves API guardadas por la versión 1.x;
  • deja desactivada la sincronización con la Merchant API hasta que usted la configure (Google ha cerrado la Content API for Shopping que usaba la 1.x);
  • elimina los archivos antiguos de la 1.x, incluida la carpeta feeds/.

La versión 2.0.0 solo produce feeds de Google. Si un feed de la 1.x estaba configurado para Bing, Meta, Kelkoo, Idealo o LeGuide, su URL sirve ahora el formato de Google: compruébelo antes de mantenerlo en ese canal.

Después de la actualización, abra el Panel: los feeds se vuelven a generar en la primera ejecución del cron o cuando hace clic en Generar.

Asistente de configuración

Cuatro pasos: países, idioma y moneda, envío y, por último, las categorías de Google de sus categorías principales. El asistente crea un feed por cada país seleccionado. Todo puede cambiarse más adelante en Feeds y Categorías de Google.

Feeds

En Feeds, cada ficha muestra el país, el idioma, la moneda, los artículos enviados y excluidos, el indicador de calidad y la URL del feed (oculta; Copiar URL la copia). Acciones: Generar, Vista previa, Historial, Configuración, Desactivar, Duplicar.

La configuración del feed tiene cinco pestañas:

  • Destino: tipo de feed (productos, inventario local, promociones), nombre, tienda, país de destino, idioma, moneda, precios (automático: sin impuestos para Estados Unidos y Canadá, con IVA en los demás países), formato del ID de artículo, destinos y destinos excluidos. Conserve el formato del ID de artículo de un feed existente: si lo cambia, Merchant Center ve productos nuevos.
  • Productos: solo algunas categorías y marcas o todas salvo algunas, precio mínimo y máximo, ID de productos excluidos, productos sin stock.
  • Títulos y textos: patrón de título con los tokens {name}, {brand}, {attributes}, {color}, {size}, {material}, {category}, {reference}, {feature:Name} y una vista previa en directo con los productos del feed; valores de la combinación en el título; eliminación de palabras promocionales y mayúsculas de énfasis; origen de la descripción, aspectos destacados a partir de las listas con viñetas de la descripción, detalles del producto a partir de las características, marca utilizada cuando un producto no tiene ninguna.
  • Envío: ninguno, un precio fijo con un umbral de envío gratuito, o un transportista de PrestaShop; nombre del servicio y plazos de entrega opcionales.
  • Avanzado: tamaño de imagen enviado, parámetros de seguimiento añadidos a los enlaces, y Cambiar la URL pública.

Declarar el feed en Merchant Center

  1. Haga clic en Copiar URL en la ficha del feed.
  2. En Merchant Center, añada una fuente de productos a partir de un archivo con obtención programada y pegue la URL.
  3. Elija el mismo país y el mismo idioma que el feed.

La URL contiene un token de 40 caracteres. Si se ha filtrado, use Cambiar la URL pública en la pestaña Avanzado: la URL antigua deja de funcionar de inmediato y debe sustituirse en Merchant Center. Los archivos de los feeds se guardan en var/dfgs_feeds/ con un nombre imposible de adivinar y solo se sirven a través de esta URL, tanto en Apache como en nginx.

Vista previa del artículo

Vista previa en un feed calcula, para el producto que elija, lo que este feed enviaría ahora: una ficha al estilo de Shopping, el precio y el precio de oferta, los problemas encontrados y todos los atributos. Úsela para comprobar un producto antes o después de un cambio.

Generación, historial y cron

La generación se ejecuta por lotes. Si se interrumpe, la siguiente ejecución se reanuda donde se detuvo; un bloqueo impide dos ejecuciones del mismo feed al mismo tiempo. Al final, el módulo comprueba que el XML esté bien formado, escribe una copia gzip y compara los artículos con la generación anterior.

Historial lista las 30 últimas generaciones (origen, artículos enviados y excluidos, indicador, diferencias, tiempo, memoria, tamaño, comprobación del XML) y las diferencias campo por campo de un artículo.

Para regenerar los feeds automáticamente, llame a la URL del cron que aparece en Ajustes (por ejemplo, cada hora); Regenerar cada feed como máximo cada define con qué frecuencia toca generar un feed (de 1 a 24 horas). Cada llamada genera los feeds pendientes en un plazo de unos 25 segundos y continúa en la siguiente llamada si es necesario; cuando la Merchant API está activada, también envía los cambios de productos en cola.

0 * * * * curl -s "https://www.example.com/index.php?fc=module&module=dfexportgoogleshopping&controller=cron&token=YOUR_CRON_TOKEN" > /dev/null

Categorías de Google

La taxonomía de productos de Google (versión 2021-09-21) se incluye en 8 idiomas: la búsqueda se realiza localmente, sin ninguna llamada a Google. Para cada categoría de la tienda, escriba unas palabras y elija la categoría de Google. Una subcategoría hereda la elección de su categoría padre hasta que usted le asigne la suya. Para la ropa, defina el género y el grupo de edad: son obligatorios en varios países.

Reglas

Una regla tiene condiciones (categoría, marca, precio, cantidad, título, referencia, estado, GTIN presente, categoría de Google presente, en oferta, disponibilidad) y una acción: excluir el artículo, definir una etiqueta personalizada de 0 a 4, añadir un prefijo o un sufijo al título, reemplazar o eliminar palabras. Las reglas se aplican de arriba abajo en cada generación, para todos los feeds o para un feed. Vista previa muestra los artículos afectados antes y después de la regla.

Productos y sustituciones

Productos lista sus productos con el título enviado, GTIN, marca, MPN, estado, categoría de Google y situación. Haga doble clic en una celda para editarla; seleccione productos para aplicar una acción de forma masiva (excluir de Google, incluir, estado, género, grupo de edad, marca, categoría de Google, etiqueta personalizada, quitar las sustituciones).

Detalles abre las sustituciones de un producto, para todo el producto o para una combinación, y para cada idioma: título, descripción, aspectos destacados, color, talla, material, tipo de producto, GTIN, MPN, marca, categoría de Google, etiquetas personalizadas. A la derecha, la vista previa muestra lo que Google recibirá. Las sustituciones solo cambian el feed, nunca su catálogo. Un GTIN se rechaza si su longitud, su dígito de control o su prefijo no son válidos.

Problemas

Incidencias lista lo que el módulo detectó en la última generación, por tipo (excluido, advertencia, información), con lo que hay que hacer y los artículos afectados. La Auditoría de GTIN comprueba todos los GTIN del catálogo. Cuando la Merchant API está activada, los problemas indicados por Google aparecen en su propia sección.

Merchant API (opcional)

  1. En Google Cloud, cree un proyecto, active la Merchant API y cree una cuenta de servicio con una clave JSON.
  2. En Merchant Center, añada el correo electrónico de la cuenta de servicio como usuario.
  3. En Ajustes → Merchant API, introduzca el ID de su cuenta de Merchant Center y la clave JSON (guardada cifrada, nunca se vuelve a mostrar) y, a continuación, haga clic en Probar la conexión, Registrar el proyecto (una vez) y Crear la fuente de datos API.
  4. Active Enviar los cambios de productos mediante la Merchant API (con el cron).

Al guardar un producto, solo se añade a una cola; el cron envía la cola y lee los estados de los artículos. Los errores de cuota se reintentan más tarde con un intervalo creciente.

Sugerencias de IA (opcional)

En Ajustes → IA, elija el proveedor (Anthropic, OpenAI o Mistral) e introduzca su clave API (guardada cifrada), el modelo y un límite mensual. En Sugerencias IA, elija títulos, categorías de Google o atributos, los productos y el idioma: el coste se estima antes de la ejecución.

Cada sugerencia pasa a Pendiente de validación con el valor actual y el valor sugerido, que puede editar antes de hacer clic en Aplicar. No se aplica nada sin su clic. Los títulos de IA se envían como contenido generado por IA, tal como pide Google. Nunca se pide un GTIN a la IA.

Análisis

  • Pruebas de títulos: dos títulos se alternan por periodo para un producto. Introduzca las impresiones y los clics de sus informes de Merchant Center o Google Ads. Un resultado solo se considera significativo con al menos 1.000 impresiones por título, 30 clics en total y p < 0,05; aun así, otros factores (temporada, competencia, pujas) pueden explicar la diferencia.
  • Consultas de búsqueda: importe el CSV de sus consultas de Search Console; el módulo asocia cada consulta con un producto y muestra las consultas cuyas palabras faltan en el título.
  • Estacionalidad: productos cuyas ventas pasadas se concentran en los dos próximos meses, que puede marcar con una etiqueta personalizada.
  • Auditoría de imágenes: imágenes de producto demasiado pequeñas (menos de 100 o 500 píxeles en el lado corto), demasiado alargadas o de más de 16 MB.

Alertas

En Ajustes → Alertas, introduzca una dirección de correo electrónico y/o un webhook de Slack y elija los eventos: generación fallida, bajada del indicador de calidad, nuevos problemas indicados por Google.

Importar / exportar

Exporte e importe las sustituciones en CSV (punto y coma, UTF-8). Las celdas que empiezan por =, +, - o @ se neutralizan en la exportación. Esta página también contiene la lista de tiendas del feed de inventario local y las promociones del feed de promociones.

Datos estructurados (JSON-LD)

Desactivado por defecto. En Ajustes, Datos estructurados en las páginas de producto en modo automático añade un bloque Product a la página de producto solo cuando la página no tiene ninguno (tema, módulo de SEO o de opiniones), con el precio que se muestra en la página. Si su tema ya genera uno, déjelo desactivado.

Otros módulos de DataFirefly

Cuando están instalados, el feed tiene en cuenta: el producto de envoltorio de regalo (nunca se envía), los productos bloqueados por una subasta, los lotes con la fecha de consumo preferente superada, el estado reacondicionado y su grado, el precio unitario y los grupos de productos del vinculador de productos (item_group_id).

Multitienda y permisos

Cada feed pertenece a una tienda y solo ve sus productos y sustituciones; en un contexto de tienda, no se pueden abrir los feeds de otras tiendas. Las acciones de escritura requieren el permiso de edición en la página: un empleado con permiso de solo lectura puede consultar pero no cambiar nada.

Resolución de problemas

  • El feed está vacío: compruebe las categorías y los filtros del feed, y que los productos estén activados, visibles y disponibles para pedido en la tienda del feed. La página Problemas indica el motivo de cada exclusión.
  • La URL devuelve 404: el feed está desactivado, el token se ha renovado o el módulo está desactivado.
  • Los precios difieren de los de la tienda: compruebe el país y la moneda del feed y la opción de impuestos en Avanzado; Google espera precios sin impuestos para Estados Unidos y Canadá.
  • Merchant API: error de autenticación: compruebe que la cuenta de servicio es usuario de la cuenta de Merchant Center y que el proyecto está registrado.
  • IA: no pasa nada: compruebe la clave, el modelo y el límite mensual en Configuración → IA; el registro muestra la causa de cada llamada fallida.

Desinstalación

La desinstalación elimina las 18 tablas dfgs_, los ajustes DFGS_, las páginas de administración y los archivos de feed generados. Exporte antes sus sustituciones si desea conservarlas.

¿Te ha resultado útil esta página?

¿Sigues atascado? Contacta con soporte