Resolução de problemas

As causas reais das avarias, pela ordem em que se encontram. Comece sempre pelo botão « Diagnose my connection » da página do seu site.

« Nada chega »

As três causas, por ordem de probabilidade:

  1. 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.
  2. O site nunca foi ativado. Destinos não guardados, ou botão « Activate my tracking » nunca clicado: o módulo recebe 401.
  3. O tracking está desativado no módulo. No PrestaShop e no Shopware, « Enable tracking » vem OFF por predefinição.

Os erros 401

ErroCausa e solução
unknown_tenantSite a aguardar ativação, ou Site ID errado
invalid_signatureO corpo foi recodificado entre a assinatura e o envio: assine exatamente os bytes enviados
timestamp_out_of_windowTimestamp 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

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

« 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.

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.

EstadoSignificado
Ainda sem relatórioO 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.
OKNada a assinalar.
AtrasadoO evento mais antigo está em espera há mais de uma hora.
SilenciosoHavia 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