« 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
Antes de enviar um evento para uma plataforma, a DataFirefly verifica a sua idade. A regra é a mesma para um evento em direto, para um evento repetido por um módulo e para um evento libertado após uma pausa de quota do plano gratuito.
- Meta, ChatGPT Ads (OpenAI) e Microsoft Advertising: 7 dias.
- GA4: nenhum limite do nosso lado. O GA4 aceita eventos mais antigos e atribui-lhes uma nova data; é uma escolha deliberada.
- Google Ads, TikTok e Pinterest: nenhum limite do nosso lado, a plataforma decide.
Um evento que ultrapassou a janela de um destino não é enviado para esse destino. O Inspector mostra-o como Not sent: too late: no momento do envio, o evento já era mais antigo do que a janela de aceitação dessa plataforma.
A fila do módulo
Quando a loja não consegue contactar a DataFirefly, o módulo coloca os eventos em fila e repete o envio (veja os guias de PrestaShop, WooCommerce e Shopware). A página do seu site na área de cliente mostra esta fila: eventos em espera, idade do mais antigo e hora do último relatório do módulo.
| Estado | Significado |
|---|---|
| Ainda sem relatório | O módulo ainda não comunicou nada. As versões anteriores a PrestaShop 1.29.0, WooCommerce 2.30.0 e Shopware 1.23.0 ficam neste estado: atualize o módulo para ver a fila. |
| OK | Nada a assinalar. |
| Atrasado | O evento mais antigo está em espera há mais de uma hora. |
| Silencioso | Havia eventos em espera e o módulo não envia nenhum relatório há 2 horas. |
Quando a fila precisa de atenção, recebe um e-mail, no máximo um a cada 24 horas. Se muitos sites ficarem atrasados ao mesmo tempo, o incidente está provavelmente do lado da DataFirefly: os e-mails aos clientes ficam retidos e só a nossa equipa de operações é alertada.
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