# Resolución de problemas

> Resolver problemas de DataFirefly Server-Side: nada llega, errores 401, webhook de Shopify desaparecido, duplicados en GA4, conversiones Unassigned.

- Página original: https://server-side.datafirefly.com/es/docs/troubleshooting.html
- Idioma: es
- Actualizado el: 2026-09-01
- Editor: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/es/

---

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

| Error | Causa y remedio |
| --- | --- |
| `unknown_tenant` | Sitio pendiente de activación, o Site ID erróneo |
| `invalid_signature` | El cuerpo se recodificó entre la firma y el envío: firme exactamente los bytes enviados |
| `timestamp_out_of_window` | Timestamp 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

- **Webhook desaparecido**: eliminado por Shopify tras unas 48 horas de fallos. Verifique el Site ID de la URL y vuelva a crear el webhook.
- **Pedidos duplicados**: queda un webhook «Order creation» junto al «Order payment». Elimínelo.

## 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

- **Compras duplicadas**: actualice el módulo (PrestaShop 1.8.0+, WooCommerce 2.8.0+, Shopware 1.9.0+). GA4 solo deduplica `purchase`, y únicamente por `transaction_id`: las versiones recientes ya no envían la compra desde el navegador.
- **Conversiones «Unassigned»**: los eventos enviados llevan el identificador de sesión y el referente, lo que asocia las conversiones a su canal. El histórico ya registrado por GA4 no se reclasifica: la asociación vale para el tráfico futuro.

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

- **Meta, ChatGPT Ads (OpenAI) y Microsoft Advertising**: 7 días.
- **GA4**: ningún límite por nuestra parte. GA4 acepta eventos más antiguos y les asigna una nueva fecha; es una decisión deliberada.
- **Google Ads, TikTok y Pinterest**: ningún límite por nuestra parte, decide la plataforma.

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](https://server-side.datafirefly.com/es/docs/prestashop.html), [WooCommerce](https://server-side.datafirefly.com/es/docs/woocommerce.html) y [Shopware](https://server-side.datafirefly.com/es/docs/shopware.html)). 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.

| Estado | Significado |
| --- | --- |
| Sin informe todavía | El 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. |
| OK | Nada que señalar. |
| Con retraso | El evento más antiguo lleva más de una hora esperando. |
| En silencio | Habí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: [support@datafirefly.com](https://server-side.datafirefly.com/es/contact.html), adjuntando el resultado del botón «Diagnose my connection». Respondemos en un día laborable.

Actualizado: 1 de septiembre de 2026
