« Nada chega »
As três causas, por ordem de probabilidade:
- O consentimento. Se a opção « Require consent » estiver ativa e o seu site não tiver banner CMP, ou se o visitante não tiver consentido, nenhum evento parte: é o comportamento esperado, não uma avaria. O indício que não engana: o botão Send test event funciona (ignora o consentimento) mas mais nada chega.
- O site nunca foi ativado. Destinos não guardados, ou botão « Activate my tracking » nunca clicado: o módulo recebe 401.
- O tracking está desativado no módulo. No PrestaShop e no Shopware, « Enable tracking » vem OFF por predefinição.
Os erros 401
| Erro | Causa e solução |
|---|---|
unknown_tenant | Site a aguardar ativação, ou Site ID errado |
invalid_signature | O corpo foi recodificado entre a assinatura e o envio: assine exatamente os bytes enviados |
timestamp_out_of_window | Timestamp em milissegundos em vez de segundos, ou relógio do servidor não sincronizado (NTP) |
Depois de uma rotação da chave HMAC
A recolha fica cortada enquanto a nova chave não for colada no módulo. É intencional: a rotação serve precisamente para invalidar a chave antiga.
Shopify
- Webhook desaparecido: eliminado pelo Shopify após cerca de 48 horas de falhas. Verifique o Site ID no URL, recrie o webhook.
- Encomendas em duplicado: um webhook « Order creation » subsiste ao lado do « Order payment ». Elimine-o.
WordPress / WooCommerce
Depois de qualquer alteração de configuração, limpe a cache do site: caso contrário, o LiteSpeed Cache e as outras extensões de cache continuam a servir o JavaScript antigo.
GA4
- Compras em duplicado: atualize o módulo (PrestaShop 1.8.0+, WooCommerce 2.8.0+, Shopware 1.9.0+). O GA4 só desduplica
purchase, e apenas portransaction_id: as versões recentes já não enviam a compra do lado do navegador. - Conversões « Unassigned »: os eventos enviados transportam o identificador de sessão e o referrer, o que liga as conversões ao seu canal. O histórico já registado pelo GA4 não é reclassificado: a correção vale para o tráfego futuro.
« Delivered » mas pouca atribuição
Um evento entregue não é forçosamente atribuído: a atribuição depende da qualidade de correspondência. Enriqueça os dados de utilizador enviados: e-mail, telefone, IP e user agent, cookies fbp e gclid. Os módulos DataFirefly transmitem-nos automaticamente quando estão disponíveis e o consentimento o permite.
Janelas de recuperação
Depois de uma pausa de entrega (quota do plano gratuito ultrapassada), os eventos armazenados são reenviados dentro do que as plataformas aceitam: 72 horas para o GA4, 7 dias para a Meta, 72 horas por predefinição nos restantes. Para lá dessas janelas, o evento é conservado mas a plataforma já não o aceita.
Continua bloqueado?
Escreva-nos: [email protected], anexando o resultado do botão « Diagnose my connection ». Respondemos no prazo de um dia útil.
Atualizado: 1 de setembro de 2026