Resolución de problemas

Las causas reales de las averías, en el orden en que se encuentran. Empiece siempre por el botón «Diagnose my connection» de la página de su sitio.

«No llega nada»

Las tres causas, por orden de probabilidad:

  1. El consentimiento. Si la opción «Require consent» está activa y su sitio no tiene banner CMP, o el visitante no ha consentido, no sale ningún evento: es el comportamiento esperado, no una avería. La pista inequívoca: el botón Send test event funciona (ignora el consentimiento) pero no llega nada más.
  2. El sitio nunca se activó. Destinos sin guardar, o botón «Activate my tracking» nunca pulsado: el módulo recibe errores 401.
  3. El tracking está desactivado en el módulo. En PrestaShop y Shopware, «Enable tracking» viene OFF por defecto.

Los errores 401

ErrorCausa y remedio
unknown_tenantSitio pendiente de activación, o Site ID erróneo
invalid_signatureEl cuerpo se recodificó entre la firma y el envío: firme exactamente los bytes enviados
timestamp_out_of_windowTimestamp en milisegundos en lugar de segundos, o reloj del servidor no sincronizado (NTP)

Tras una rotación de la clave HMAC

La recogida queda cortada hasta que la nueva clave se pegue en el módulo. Es intencionado: la rotación sirve precisamente para invalidar la clave antigua.

Shopify

WordPress / WooCommerce

Tras cualquier modificación de la configuración, purgue la caché del sitio: de lo contrario, LiteSpeed Cache y las demás extensiones de caché seguirán sirviendo el antiguo JavaScript.

GA4

«Delivered» pero poca atribución

Un evento entregado no está necesariamente atribuido: la atribución depende de la calidad de correspondencia. Enriquezca los datos de usuario enviados: correo electrónico, teléfono, IP y user agent, cookies fbp y gclid. Los módulos DataFirefly los transmiten automáticamente cuando están disponibles y el consentimiento lo permite.

Ventanas de recuperación

Antes de enviar un evento a una plataforma, DataFirefly comprueba su antigüedad. La regla es la misma para un evento en directo, para uno reenviado por un módulo y para uno liberado tras una pausa por cuota del plan gratuito.

Un evento que ha superado la ventana de un destino no se envía a ese destino. El Inspector lo muestra como Not sent: too late: en el momento del envío, el evento ya era más antiguo que la ventana de aceptación de esa plataforma.

La cola del módulo

Cuando la tienda no consigue contactar con DataFirefly, el módulo pone los eventos en cola y los reenvía (consulte las guías de PrestaShop, WooCommerce y Shopware). La página de su sitio en el área de cliente muestra esta cola: eventos en espera, antigüedad del más antiguo y hora del último informe del módulo.

EstadoSignificado
Sin informe todavíaEl módulo aún no ha informado de nada. Las versiones anteriores a PrestaShop 1.29.0, WooCommerce 2.30.0 y Shopware 1.23.0 se quedan en este estado: actualice para ver la cola.
OKNada que señalar.
Con retrasoEl evento más antiguo lleva más de una hora esperando.
En silencioHabía eventos en espera y el módulo no ha enviado ningún informe en 2 horas.

Cuando la cola requiere atención, recibe un correo, como máximo uno cada 24 horas. Si muchos sitios se retrasan a la vez, lo más probable es que el incidente esté en DataFirefly: los correos a los clientes se retienen y solo se avisa a nuestro equipo de operaciones.

¿Sigue bloqueado?

Escríbanos: [email protected], adjuntando el resultado del botón «Diagnose my connection». Respondemos en un día laborable.

Actualizado: 1 de septiembre de 2026