DataFirefly Google Shopping: guia completo

Apresentação

O DataFirefly Google Shopping é um módulo para PrestaShop 8 e 9 que gera feeds do Merchant Center conformes com a especificação Google Shopping 2025 e os declina automaticamente em 6 canais (Google, Bing, Meta Catalog, Kelkoo, Idealo, LeGuide). Inclui 5 assistentes de IA (Anthropic Claude, OpenAI GPT-4o ou Mistral AI, à escolha), uma pontuação de qualidade de 0 a 100, um editor em massa por AJAX, uma auditoria de imagens por visão de IA e ferramentas premium (teste A/B de títulos, previsão sazonal, exportação para o Google Ads Editor).

O módulo cria 12 tabelas com o prefixo dfgs_ e 9 separadores de back-office no menu «Google Shopping». Sem qualquer override do núcleo e sem ficheiros do PrestaShop alterados.

Instalação

1. No back-office do PrestaShop, vá a Módulos → Gestor de módulos → Instalar um módulo.
2. Carregue o ficheiro dfexportgoogleshopping.zip.
3. Clique em Instalar. O módulo cria as suas tabelas, os seus separadores de administração e os seus valores de configuração predefinidos.

Pré-requisitos: PrestaShop 8.0 a 9.x, PHP 8.1+, MySQL 5.7+ ou MariaDB 10.3+, extensão cURL ativada. O multiloja e o multilingue são suportados nativamente.

Criar o seu primeiro feed

1. Vá a Google Shopping → Feeds e clique em Adicionar um feed.
2. Indique o nome, o tipo de feed (Produtos, Local Inventory Ads ou Promoções), a loja, o idioma, a moeda e o país de destino.
3. Escolha o canal de destino: Google Shopping (predefinição), Bing, Meta Catalog, Kelkoo, Idealo ou LeGuide. O formato XML é adaptado automaticamente ao canal (namespaces, mudanças de nome de atributos, limites de comprimento).
4. Configure os filtros de inclusão: categorias, fabricantes, exclusão dos produtos esgotados.
5. Grave e clique depois em Gerar. O URL público do feed (protegido por token) aparece na lista: é esse que declara no Merchant Center.

Mapeamento das categorias da Google

Em Google Shopping → Mapeamento de categorias, associe cada categoria da sua loja a uma categoria da taxonomia da Google (cerca de 6000 entradas, em cache durante 30 dias). Dois métodos:

• Manual: pesquisa com preenchimento automático na taxonomia.
• Mapeamento automático por IA: o botão «Mapear automaticamente» envia as suas categorias por mapear ao assistente de IA, que propõe a melhor correspondência. As propostas com confiança elevada são aplicadas, as restantes ficam a aguardar validação.

O mapeamento propaga-se às subcategorias por mapear. O atributo google_product_category e o product_type são preenchidos automaticamente no feed.

Substituições de produto

O separador Substituições de produtos permite forçar, produto a produto (e por idioma e loja), os valores do feed: título, marca, GTIN, MPN, condição, cor, tamanho, material, custom labels 0-4, categoria da Google, exclusão do feed, etc. As substituições prevalecem sempre sobre os valores extraídos do catálogo.

Edição em massa

O separador Edição em massa apresenta uma grelha AJAX de 50 produtos por página, com pesquisa por nome, referência ou ID. Funcionamento:

• Edição inline: clique numa célula, escreva o valor e prima Enter; a gravação é imediata (fundo verde = sucesso).
• Ação em massa: assinale vários produtos, escolha um campo e um valor e clique em Aplicar. O botão «Eliminar substituições» retira as substituições dos produtos selecionados.

Importação/exportação CSV e pré-visualização

O separador Importação / Exportação / Pré-visualização reúne três ferramentas:

• Exportação CSV das substituições ou dos mapeamentos de categoria (UTF-8 com BOM, separador ponto e vírgula, compatível com o Excel).
• Importação CSV com semântica clara: célula vazia = sem alteração, asterisco (*) = esvaziar o campo.
• Pré-visualização XML: indique um ID de produto e um feed e obtenha o XML exato desse produto, com os problemas de validação detetados. Ideal para depurar um produto recusado.

Assistentes de IA

Configure primeiro o fornecedor em Google Shopping → Definições: Anthropic (Claude), OpenAI (ChatGPT/GPT-4o) ou Mistral AI, com a sua chave de API e o modelo. Modelos recomendados: claude-haiku-4-5-20251001 ou gpt-4o-mini (rápidos e baratos); claude-sonnet-4-6 ou gpt-4o para a qualidade máxima.

O separador Assistentes de IA comanda os 5 assistentes:

• Mapeamento de categorias: associa as suas categorias à taxonomia da Google.
• Reescrita de títulos: otimiza os títulos segundo o setor detetado (vestuário, eletrónica, livros, casa, beleza, alimentação) e os padrões recomendados pela Google.
• Extração de atributos: deduz color, size, material, pattern, age_group e gender a partir das descrições (confiança ≥ 0,80).
• Pesquisa de GTIN: encontra o GTIN a partir da marca, do MPN e do nome, com validação módulo 10 (confiança ≥ 0,85).
• Correção das recusas: analisa cada recusa do Merchant Center e propõe (ou aplica automaticamente, com confiança ≥ 0,85) uma correção estruturada.

Cada chamada fica registada na tabela dfgs_ai_log (fornecedor, modelo, tokens de entrada e de saída, duração): acompanha o seu orçamento de IA ao cêntimo.

Pontuação de qualidade de 0 a 100

Em cada geração de um feed de produtos, o módulo recolhe uma amostra de 500 itens e calcula 9 subpontuações ponderadas: cobertura de GTIN (15 pontos), cobertura de imagens (10), qualidade das imagens (10), qualidade dos títulos (15), qualidade das descrições (10), mapeamento de categoria (15), cobertura dos destaques (10), ausência de recusas críticas em aberto (10) e presença dos portes (5). O total dá uma nota de A+ a F, apresentada no painel, com as 5 recomendações de maior impacto em destaque.

Alertas no Slack e por e-mail

Em Definições, indique um webhook de entrada do Slack e/ou um endereço de e-mail. Três acionadores: novas recusas críticas detetadas durante uma geração, queda da pontuação de qualidade igual ou superior a 10 pontos face à geração anterior, e falha de geração. Proteção antispam: no máximo 1 alerta por tipo em cada 6 horas.

Funcionalidades premium

O separador Premium reúne 5 ferramentas:

• Análise da Search Console: carregue a exportação CSV das consultas (Search Console → Resultados da pesquisa → Exportar). O módulo cruza cada consulta com os seus títulos de produto e calcula uma pontuação de oportunidade (impressões × palavras-chave ausentes do título × multiplicador de posição). As 20 melhores oportunidades aparecem com o produto sugerido.
• Teste A/B de títulos: duas variantes alternam em ciclos de 7 dias no feed. O vencedor é declarado quando cada variante atinge 500 ou mais impressões, com uma diferença de CTR igual ou superior a 5 %; é então aplicado automaticamente como substituição.
• Previsão sazonal: analisa 24 meses de histórico de encomendas e etiqueta os produtos em custom_label_4 — upcoming_season (índice sazonal superior a 1,5 nos 2 meses seguintes), bestseller (10 % de topo do volume de negócios a 30 dias), declining_trend (queda igual ou superior a 20 % em 6 meses).
• Auditoria da qualidade das imagens: em lotes de 25, a visão por IA (Claude Vision ou GPT-4o; a Mistral não é suportada) deteta marcas de água, textos promocionais, tipo de fundo e produtos múltiplos. Nota de 0 a 10 por imagem, com cache de 30 dias.
• Exportação para o Google Ads Editor: CSV importável diretamente, com grupos de anúncios hierarquizados por custom labels e multiplicadores de licitação por etiqueta (bestseller ×1,5, upcoming_season ×1,3, on_sale ×1,2, declining_trend ×0,5).

Automatização por cron

Cada feed expõe um URL de geração protegido por token, apresentado na lista de feeds. Exemplo de crontab para regenerar de 6 em 6 horas:

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

A geração é feita em streaming: catálogos com mais de 100 000 produtos passam sem saturar a memória.

Resolução de problemas

• O feed está vazio: verifique os filtros do feed (categorias, stock) e se os produtos estão ativos e visíveis na loja associada ao feed.
• Produtos excluídos na geração: consulte o separador Diagnóstico; cada exclusão vem justificada (GTIN inválido, imagem em falta, preço a zero…). Use a pré-visualização XML para ver o detalhe de um produto específico.
• Erro de chamada à IA: verifique a chave de API e o modelo em Definições. O registo dfgs_ai_log guarda as falhas com a respetiva causa.
• A auditoria de imagens falha com a Mistral: é o comportamento esperado; a visão exige a Anthropic ou a OpenAI.
• Depois de uma atualização do PrestaShop, um separador deixou de aparecer: reinicialize o módulo (Módulos → dfexportgoogleshopping → Reinicializar) para recriar os separadores de administração sem perder os seus dados.

Desinstalação

A desinstalação elimina as 12 tabelas dfgs_, os separadores de administração e os valores de configuração DFGS_. Exporte previamente as suas substituições e mapeamentos em CSV se os quiser conservar.