DataFirefly Server-Side — Guía completa
Instala y conecta el plugin gratuito DataFirefly Server-Side, conecta el seguimiento cliente + servidor de todo el embudo WooCommerce, comprende la deduplicación por event_id, la compra en server-side imposible de bloquear, la gestión del consentimiento (incluido Cookie Consent v2), la cola de reintentos y la suscripción al servicio.
DataFirefly Server-Side es el conector WooCommerce gratuito del servicio DataFirefly Server-Side Tracking. El plugin capta los eventos de tu tienda y los firma; el servicio los difunde en server-side hacia tus plataformas publicitarias y de analítica. Esta guía cubre la instalación, la conexión, el funcionamiento del embudo cliente + servidor, la deduplicación, la compra en server-side, la gestión del consentimiento, la fiabilidad y la suscripción.
Modelo plugin gratuito + servicio de pago. El plugin no cuesta nada y seguirá siendo gratuito. Para enviar realmente tus eventos, necesitas una suscripción al servicio DataFirefly Server-Side (desde 39 €/mes), que se encarga de la ingesta y la difusión server-side.
Requisitos
- WordPress 5.8 o superior
- WooCommerce 5.0 o superior (compatible con HPOS — High-Performance Order Storage)
- PHP 7.4 o superior
- Un cron de WordPress funcional (o un cron de sistema real) para la cola de reintentos y el envío diferido
- Una suscripción a DataFirefly Server-Side para obtener tu clave de conexión
Instalación
- Descarga
datafirefly-serverside-2_0_1.zipdesde tu espacio de cliente DataFirefly. - En el back-office de WordPress, ve a Plugins → Añadir nuevo → Subir plugin, selecciona el ZIP y haz clic en Instalar ahora.
- Activa el plugin. Aparece un nuevo menú DataFirefly Server-Side en la administración.
Conexión con una sola clave
El plugin se configura con una única clave de conexión que activa a la vez el seguimiento de cliente y de servidor.
- Desde tu espacio de cliente DataFirefly, copia la clave de conexión (empieza por
dfss_). - Pégala en el campo previsto de la pantalla Conexión del plugin.
- Haz clic en Conectar. El plugin activa el seguimiento de cliente y de servidor, envía un evento de prueba al dispatcher y coloca las etiquetas de cliente para los destinos configurados.
- Comprueba que el estado pasa a Conectado ✓ y usa el botón Probar el evento para confirmar el envío.
La clave dfss_… codifica tu tenant, un secreto y el endpoint del dispatcher. Está restringida a los hosts datafirefly.com por HTTPS: una clave que apunte a otro dominio se rechaza.
Modo avanzado (introducción manual)
Si prefieres no usar la clave única, el modo avanzado permite introducir manualmente el tenant, el secreto y el endpoint. Resérvalo para configuraciones específicas: el modo de una clave cubre casi todos los casos.
Embudo completo cliente + servidor
El plugin sigue todo el embudo en el navegador, mientras que la conversión de compra parte del servidor.
- En el navegador:
page_view,view_content(vista de producto),add_to_cart,initiate_checkoutyadd_payment_info. - En el servidor:
purchase, disparado desde los hooks de pedido de WooCommerce.
Ambas capas comparten el mismo identificador de evento para permitir la deduplicación.
Deduplicación por event_id
Para cada pedido, el evento de cliente y el evento de servidor llevan el mismo event_id, basado en el identificador de pedido (por ejemplo order_1042). Meta, GA4 y las demás plataformas lo usan para contar cada conversión una sola vez. Así recuperas las conversiones que el navegador deja escapar, sin doble conteo.
Compra en server-side: fiable e infalsificable
La conversión de compra se dispara desde los hooks de pedido de WooCommerce (pago completado, en proceso, completado), de forma idempotente: un bloqueo (_dfss_sent) garantiza que una misma compra nunca se envía dos veces, aunque se disparen varios hooks.
- Como el evento parte del servidor, ningún bloqueador de anuncios ni ITP puede impedirlo.
- A la inversa, el endpoint público de recogida (beacon) excluye deliberadamente el evento
purchase: nadie puede inyectar una compra falsa desde el navegador para inflar tus ingresos de Meta o GA4. - El contexto del evento (valor, moneda, productos) es autoritativo en el servidor: el navegador no adivina nada.
Para mantener la atribución fiable incluso a través de una pasarela de pago con redirección, el plugin captura en el checkout las cookies _fbp, _fbc, _ga, _ttp y las adjunta al pedido, y coloca cookies first-party de click-id (90 días) para transportar fbc, ttclid y gclid hasta la compra.
Gestión del consentimiento
El gate de consentimiento está activado por defecto: nada se envía hasta que se concede el consentimiento de marketing.
Compatibilidad nativa con Cookie Consent v2
El plugin detecta de forma nativa el módulo DataFirefly Cookie Consent — RGPD & Google Consent Mode v2 y lee su cookie de consentimiento (dfcc_consent) directamente en el servidor. Si la categoría marketing se rechaza, el evento se descarta, diga lo que diga el navegador. Es la combinación recomendada: banner, Consent Mode v2 y seguimiento server-side hablan el mismo idioma.
Otras soluciones de consentimiento
A falta de Cookie Consent v2, el plugin también admite WP Consent API, Complianz, Cookiebot e IAB TCF v2. Puedes mantener tu banner actual y conectar el seguimiento a él.
Fiabilidad: cola de reintentos y registro de actividad
Un evento que no se ha podido entregar no se pierde: se pone en cola y se reenvía automáticamente mediante un cron cada 5 minutos.
El registro de actividad muestra en tiempo real, sin jerga, lo que se ha entregado, lo que está en cola y lo que se ha rechazado, con el código HTTP y el número de intentos. Es tu primer reflejo de diagnóstico.
El cron de WordPress solo se ejecuta con tráfico. En una tienda con poco tráfico, configura un cron de sistema real que llame a wp-cron.php para que la cola de reintentos se vacíe con regularidad.
Seguridad
- Ningún secreto en el navegador: solo se exponen identificadores públicos (píxel, measurement id) en el cliente.
- El secreto de firma y tus credenciales de destino permanecen en el servidor.
- Cada evento se firma con HMAC antes de llegar al dispatcher, alojado en la UE (Alemania).
Suscripción al servicio DataFirefly Server-Side
El plugin capta y firma; el servicio DataFirefly Server-Side Tracking ingiere y difunde en server-side hacia cinco destinos: Meta CAPI, GA4 (Measurement Protocol), TikTok Events API, Pinterest Conversions API y Google Ads. El dispatcher está alojado en Alemania, la ingesta se firma con HMAC, los datos personales se enmascaran y el disparo respeta el consentimiento. Una sola integración, una factura consolidada, varios sitios posibles.
Descubre las tarifas y suscríbete en server-side.datafirefly.com:
- Starter — 39 €/mes: 1 sitio, hasta 500 K eventos
- Growth — 119 €/mes: 5 sitios, hasta 2 M eventos
- Scale — 349 €/mes: 20 sitios, hasta 10 M eventos
Resolución de problemas
El estado sigue en «No conectado»
Comprueba que la clave empieza por dfss_ y que se copió entera. Una clave que apunte a un dominio distinto de datafirefly.com (HTTPS) se rechaza. Vuelve a intentar el botón Probar el evento.
La compra no se registra
La compra parte de los hooks de pedido: asegúrate de que el pedido alcanza un estado de pago (completado / en proceso / terminado). Consulta el registro de actividad para ver si el evento está en cola o rechazado, y revisa el cron si se acumulan eventos.
Conversiones contadas dos veces
Comprueba que ningún otro plugin de seguimiento envíe ya una purchase concurrente sin un event_id compartido. Solo con DataFirefly Server-Side, el event_id basado en el pedido garantiza la deduplicación.
No se envía nada aunque el consentimiento parezca concedido
El gate está activo por defecto. Comprueba que la categoría marketing está realmente aceptada en tu solución de consentimiento, y que dicha solución se detecta (Cookie Consent v2, WP Consent API, Complianz, Cookiebot o IAB TCF v2).
¿Necesitas ayuda? Contacta con el soporte de DataFirefly desde tu espacio de cliente, adjuntando una captura del registro de actividad (código HTTP + número de intentos).