# DataFirefly Server-Side — Guía completa

> Guía completa de instalación, conexión y uso del conector gratuito DataFirefly Server-Side para WooCommerce: seguimiento cliente + servidor, deduplicación, compra en server-side, consentimiento y suscripción al servicio.

- Página: <https://www.datafirefly.com/es/documentation/datafirefly-server-side/>
- Idioma: es
- Actualizado el: 2026-07-07
- Otros idiomas: [fr](https://www.datafirefly.com/documentation/datafirefly-server-side/index.md), [en](https://www.datafirefly.com/en/documentation/datafirefly-server-side/index.md), [de](https://www.datafirefly.com/de/documentation/datafirefly-server-side/index.md), [it](https://www.datafirefly.com/it/documentation/datafirefly-server-side/index.md), [pl](https://www.datafirefly.com/pl/documentation/datafirefly-server-side/index.md), [nl](https://www.datafirefly.com/nl/documentation/datafirefly-server-side/index.md), [pt](https://www.datafirefly.com/pt/documentation/datafirefly-server-side/index.md)
- Índice: <https://www.datafirefly.com/es/documentation/llms.txt>

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 el servidor 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, el purchase del servidor, la elección de los destinos de cliente, 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 en 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

1. Descarga el archivo `datafirefly-serverside-2_2_0.zip` desde tu espacio de cliente DataFirefly.
2. En el back-office de WordPress, ve a **Plugins → Añadir nuevo → Subir plugin**, selecciona el ZIP y haz clic en _Instalar ahora_.
3. Activa el plugin. Aparece un nuevo menú **DataFirefly Server-Side** en la administración.

## Conexión con una clave

El plugin se configura con una sola clave de conexión, que activa a la vez el seguimiento de cliente y de servidor.

1. Desde tu espacio de cliente DataFirefly, copia la **clave de conexión** (empieza por `dfss_`).
2. Pégala en el campo previsto de la pantalla _Conexión_ del plugin.
3. 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.
4. Comprueba que el estado pasa a **Conectado ✓** y usa el botón _Enviar evento de prueba_ para confirmar la entrega.

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 en el servidor.

- **Lado navegador:** `page_view`, `view_content` (vista de producto), `add_to_cart`, `initiate_checkout` y `add_payment_info`.
- **Lado servidor:** `purchase`, disparado desde los hooks de pedido de WooCommerce.

Ambas capas comparten el mismo identificador de evento para permitir la deduplicación.

### Eventos de merchandising (desde la v2.1.1)

El tracker también cubre el merchandising de tu catálogo: `view_item_list` (vista de una lista de productos — categoría, resultados de búsqueda), `select_item` (clic en un producto de una lista), `view_promotion` y `select_promotion` (vista y clic de una promoción). El contexto asociado — identificador y nombre de lista, identificador y nombre de promoción, creativo y ubicación — se transmite al server-side para enriquecer tus análisis de recorrido.

### Deduplicación por event_id

Para cada pedido, el evento de cliente y el evento de servidor llevan el mismo `event_id`, construido sobre el identificador del pedido (por ejemplo `order_1042`). Meta, GA4 y las demás plataformas se apoyan en él para **contar cada conversión una sola vez**. Recuperas así las conversiones que el navegador deja escapar, sin doble conteo.

## Elegir los destinos de cliente (Meta, GA4, TikTok)

Desde la versión 2.2.0, cada etiqueta de cliente se activa o desactiva individualmente en los ajustes del plugin, fila **Destinos de cliente**:

- **Meta** (píxel de Facebook, `fbevents.js`)
- **Google Analytics 4** (`gtag.js`)
- **TikTok** (píxel de TikTok)

Un destino desmarcado **nunca carga su script de terceros** en el navegador de tus visitantes y **nunca coloca sus cookies**. ¿No usas Meta? Desmárcalo: menos JavaScript, menos peticiones, una página más rápida y más ligera. Los destinos no configurados en tu cuenta DataFirefly se señalan en la pantalla de ajustes.

Estas casillas solo afectan a las _etiquetas de cliente_. La difusión server-side hacia Meta CAPI, GA4, TikTok, Pinterest y Google Ads sigue gobernada por la configuración de tu cuenta en el espacio de cliente DataFirefly. Ten en cuenta que al desactivar GA4 el plugin ya no coloca la cookie `_ga`, lo que reduce la calidad de correspondencia de GA4 en el servidor — coherente si no usas GA4.

## Purchase server-side: fiable y no falsificable

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íe 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`: es imposible 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 asegurar la atribución 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 asocia 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 conservar 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).
- El plugin se distribuye bajo licencia GPLv2 o posterior y sigue los estándares de codificación de WordPress.

## Suscripción al servicio DataFirefly Server-Side

El plugin capta y firma; el servicio _DataFirefly Server-Side Tracking_ ingiere y difunde en el servidor 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](https://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 probar el botón _Enviar evento de prueba_.

### El purchase no llega

El purchase parte de los hooks de pedido: asegúrate de que el pedido alcanza un estado de pago (completado / en proceso / completado). Consulta el registro de actividad para ver si el evento está en cola o rechazado, y revisa el cron si hay eventos estancados.

### El script de Meta (o GA4, TikTok) no se carga

Dos causas posibles: el destino está desmarcado en **Destinos de cliente** (comportamiento previsto desde la v2.2.0), o no está configurado en tu cuenta DataFirefly — la pantalla de ajustes lo indica entonces. Tras un cambio en la cuenta, usa el botón _Actualizar identificadores de destino_.

### Conversiones contadas dos veces

Comprueba que ningún otro plugin de seguimiento envíe ya un `purchase` concurrente sin `event_id` compartido. Con DataFirefly Server-Side solo, el `event_id` basado en el pedido garantiza la deduplicación.

### Nada se envía aunque el consentimiento parece concedido

El gate está activo por defecto. Comprueba que la categoría _marketing_ esté realmente aceptada en tu solución de consentimiento, y que esta se detecte (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).