Google Analytics 4 no PrestaShop: como configurá-lo bem
Para ter o Google Analytics 4 no PrestaShop há três caminhos: colar a etiqueta, usar um módulo ou passar pelo Google Tag Manager. Explicamos qual compensa, que eventos de comércio eletrónico importam, como verificar que chegam, os erros típicos (compras duplicadas ou perdidas no gateway de pagamento, consentimento) e porque o GA4 vê menos vendas do que a loja.
Para instalar o Google Analytics 4 no PrestaShop tem três opções: colar a etiqueta da Google no tema, usar um módulo ou carregá-lo com o Google Tag Manager. Mas não basta que o GA4 conte visitas: para medir uma loja têm de chegar os eventos de comércio eletrónico (ver produto, adicionar ao carrinho, iniciar o pagamento e compra) com o seu valor, sem duplicados e respeitando o consentimento de cookies.
Muitas lojas têm o GA4 «instalado» e não confiam no que veem: as compras não batem certo com as encomendas ou o relatório de comércio eletrónico aparece vazio. Quase sempre é configuração, não a ferramenta. Aqui explicamos como deixá-lo bem configurado, como verificá-lo sem ser programador e que limites tem o GA4 mesmo quando está perfeito.
As três formas de pôr o GA4 no PrestaShop
1. A etiqueta da Google colada no tema
O GA4 dá-lhe um fragmento de código (a etiqueta da Google) que se cola no cabeçalho de todas as páginas. É o mais rápido e já mede visitas e visualizações de página.
Mas a etiqueta sozinha não sabe nada da sua loja: nem que produto está a ser visto, nem o que há no carrinho, nem quanto vale uma encomenda. É preciso programar cada evento nos modelos do tema, e esse trabalho perde-se ao mudar ou atualizar o tema.
2. Um módulo do PrestaShop
Um módulo liga-se aos pontos onde a loja já conhece os dados (a página do produto, o carrinho, o checkout, a confirmação da encomenda) e envia os eventos com os produtos, quantidades e valores. É o mais cómodo se não quiser mexer no código.
Antes de instalar um, verifique se é compatível com a sua versão do PrestaShop e com o seu tema, que eventos envia, se respeita o consentimento de cookies e se alguém o mantém. Um módulo de análise abandonado parece funcionar enquanto deixa de enviar dados.
3. Google Tag Manager
Com o Tag Manager instala-se um único contentor na loja e, a partir do seu painel, configuram-se as etiquetas do GA4 e das outras plataformas (Meta, Google Ads, TikTok). É a opção natural se a sua agência já trabalha com ele.
Mas o Tag Manager não inventa os dados: precisa que a loja publique uma camada de dados (dataLayer) com o produto, o carrinho e a encomenda em cada página. Isso tem de ser feito por um módulo ou por um desenvolvimento no tema. E é preciso manter duas coisas em vez de uma: a camada de dados da loja e a configuração do contentor.
Qual escolher
| A sua situação | O que costuma encaixar |
|---|---|
| Só quer saber quantas visitas tem | Etiqueta da Google |
| Quer o comércio eletrónico do GA4 sem mexer no código | Módulo |
| Tem uma agência ou equipa que já gere várias etiquetas com o Tag Manager | Tag Manager com uma camada de dados fiável |
| Além do GA4 faz campanhas no Meta, Google Ads ou TikTok e quer que vejam as compras | Módulo que envie também a partir do servidor |
Os eventos de comércio eletrónico que importam
O GA4 tem uma lista de eventos recomendados para lojas online, com nomes fixos. Se forem enviados com esses nomes e com os seus parâmetros, o GA4 coloca-os nos relatórios de comércio eletrónico e no funil de compra. Se se inventarem outros nomes, os dados chegam mas não aparecem onde deviam. Os imprescindíveis:
| Evento | Quando é enviado | Para que lhe serve |
|---|---|---|
view_item_list | O cliente vê uma categoria ou uma lista de resultados | Que listas geram interesse |
view_item | Abre a página de um produto | Que produtos são vistos e quais são comprados |
add_to_cart | Adiciona um produto ao carrinho | Produtos que interessam mas não se vendem |
begin_checkout | Inicia o processo de compra | Quantos carrinhos chegam ao pagamento |
add_shipping_info e add_payment_info | Escolhe o transporte e a forma de pagamento | Em que passo do checkout se abandona |
purchase | Encomenda confirmada | Vendas, receitas e de que campanhas vêm |
De todos, o que exige mais cuidado é o purchase. Deve levar o identificador da transação (a referência ou o número da encomenda), o valor, a moeda, os impostos e o envio se os quiser ver à parte, e a lista de produtos. Decida também, e mantenha sempre igual, se o valor inclui IVA e portes de envio: se num mês se envia de uma forma e no seguinte de outra, as comparações não servem.
Verifique também que cada produto é identificado com a mesma referência em todos os eventos: se na página do produto se envia um identificador e na compra outro, o GA4 não consegue relacionar o que foi visto com o que foi vendido.
Como verificar que os dados chegam
Não é preciso saber programar para o verificar. Faça-o sempre depois de instalar algo, de mudar de tema ou de atualizar o PrestaShop:
- Relatório em tempo real. Abra o GA4, entre no relatório em tempo real e navegue na sua loja a partir de outro navegador: ver um produto, adicioná-lo ao carrinho, iniciar o pagamento. Em poucos segundos deverão aparecer os eventos com o seu nome.
- DebugView. Na secção de administração do GA4 está o DebugView, que mostra os eventos de um dispositivo um a um, com todos os seus parâmetros. Ativa-se, por exemplo, com a pré-visualização do Tag Manager ou com o Tag Assistant da Google. Aí vê se o
purchaseleva o valor e os produtos corretos. - Uma encomenda de teste real. Faça uma encomenda com a forma de pagamento que os seus clientes mais usam, não só com transferência. Verifique que aparece uma única compra, com o montante exato e com a referência da encomenda.
- No dia seguinte, compare. Os relatórios normais do GA4 demoram a ficar completos. Passadas algumas horas, compare as compras do GA4 desse dia com as encomendas válidas no back-office do PrestaShop.
Repita essa comparação todos os meses. Não vai coincidir (explicamos mais abaixo porquê), mas se a diferença crescer de repente, algo se partiu.
Erros típicos do GA4 no PrestaShop
Compras duplicadas
As causas habituais são três: dois sistemas a enviar o mesmo (módulo e Tag Manager, ou módulo e etiqueta no tema), a página de confirmação que é recarregada ou reaberta a partir do histórico ou de um e-mail e volta a enviar a compra, e compras enviadas sem identificador da transação. Com o identificador, o GA4 consegue reconhecer uma compra repetida; sem ele, conta cada envio como uma nova venda. A solução: uma só via de envio e o identificador sempre presente.
Compras que não chegam por causa do gateway de pagamento
Com muitos gateways o cliente sai da sua loja para pagar no site do banco ou do prestador de pagamentos. Se depois fechar o separador sem voltar à página de «obrigado pela sua encomenda», o evento purchase nunca é enviado, porque normalmente parte dessa página. A encomenda existe no PrestaShop, mas o GA4 não sabe dela.
Há um segundo problema: quando o cliente volta, o GA4 pode atribuir a compra ao site do gateway como se fosse a origem do tráfego, e a venda deixa de aparecer como vinda do Google Ads ou da campanha de e-mail. Para o evitar, na administração do GA4 há uma lista de referências indesejadas onde se adicionam os domínios dos gateways que usa.
O consentimento de cookies
Na Europa, o GA4 não deve guardar cookies de análise se o cliente não o aceitar. Se o banner de cookies não estiver ligado ao GA4, ou se medem todos sem permissão (um problema legal), ou não se mede ninguém mesmo que aceite. O correto é configurar o Consent Mode v2 da Google: o banner comunica a decisão do cliente e o GA4 adapta-se. Verifique-o no DebugView aceitando e rejeitando.
Outras falhas que vemos com frequência
- Um ID de medição errado, por exemplo o de um site de testes ou de uma loja anterior.
- Eventos que deixam de ser enviados após mudar de tema, porque estavam programados nos modelos do tema anterior.
- Encomendas anuladas ou devolvidas que continuam a contar como venda no GA4, enquanto na loja já não o são.
Porque o GA4 vê menos vendas do que a loja, mesmo estando bem configurado
Com tudo configurado corretamente, o GA4 continuará a mostrar menos compras do que o back-office. É normal, e convém perceber porquê antes de procurar uma falha que não existe:
- Bloqueadores de anúncios e de rastreio. Muitos bloqueiam a etiqueta da Google. A compra existe, mas o aviso nunca sai do navegador.
- Cookies rejeitados. Se o cliente não aceitar, o GA4 não o mede com cookies, e essa compra não aparece como tal nos relatórios.
- Navegadores que limitam cookies. Alguns limitam quanto tempo dura um cookie, e o GA4 deixa de reconhecer que quem compra hoje é quem chegou de uma campanha há dias.
- A página de confirmação que não é vista, como no caso dos gateways de pagamento.
E não é só um problema de relatórios: se decidir que campanhas manter com esses dados, decide com uma parte das vendas. Os algoritmos de licitação do Google Ads ou do Meta também aprendem com as conversões que recebem: com menos dados, otimizam pior e cada venda parece mais cara.
A forma de reduzir essa diferença é a análise server side: que seja o servidor da loja, que sabe com certeza quando há uma encomenda, a enviar a compra para o GA4 e para as restantes plataformas, sem depender do navegador. Combina-se com o envio a partir do navegador, com um identificador comum para que cada compra conte uma só vez. Não é um atalho para contornar o consentimento: o que se recupera são as compras perdidas por motivos técnicos.
Como resolvê-lo no PrestaShop
O módulo RKR API Conversions Pro, que na loja aparece como «API de conversões para PrestaShop: Meta, GA4 e Google Ads a partir do servidor», captura os eventos do funil completo, da lista de produtos à compra, e assina-os antes de os enviar. É compatível com o PrestaShop 1.7.8 a 9.2 e envia para o GA4, Meta, Google Ads, TikTok e outras plataformas a partir da mesma instalação. Inclui Consent Mode v2 com adaptadores para vários gestores de cookies habituais, um assistente que o guia plataforma a plataforma com um botão «Guardar e testar» que envia um evento real, semáforos de estado e uma conciliação diária que compara as encomendas com as entregas a cada plataforma.
A entrega a partir do servidor é feita pelo RKR Relay, o nosso serviço de análise server side para PrestaShop: recebe os eventos da loja e entrega-os a cada plataforma com fila cifrada, novas tentativas e o estado de cada entrega, e para o relay só viajam identificadores com hash. Há três planos consoante os eventos por mês, de 19, 39 e 79 € por mês + IVA, sem fidelização, com a instalação e a configuração do módulo incluídas. Se o que precisa é que alguém reveja porque o seu GA4 não bate certo antes de mudar alguma coisa, também o pode pedir com um pacote de horas de suporte PrestaShop.
Perguntas frequentes
Como instalo o Google Analytics 4 no PrestaShop?
Com a etiqueta da Google no tema, com um módulo ou com o Google Tag Manager. Para uma loja, o prático é um módulo que envie os eventos de comércio eletrónico, usando uma só das três vias.
Porque é que o GA4 não regista as compras da minha loja?
As causas mais comuns são não ser enviado o evento purchase, o cliente não voltar do gateway de pagamento à página de confirmação, o consentimento de cookies bloquear a medição ou um bloqueador impedir o carregamento da etiqueta.
Porque é que o GA4 mostra mais compras do que as encomendas que tenho?
Quase sempre por duplicados: dois sistemas a enviar a mesma compra, a página de confirmação que é recarregada ou compras enviadas sem identificador da transação.
Preciso do Google Tag Manager para o GA4 no PrestaShop?
Não. O Tag Manager é útil se já gere várias etiquetas com ele, mas precisa de uma camada de dados da loja. Um módulo pode enviar os eventos diretamente para o GA4.