# Instalar el plugin WooCommerce

> Instalar y configurar el plugin DataFirefly Server-Side en WooCommerce: clave de conexión dfss\_, embudo completo, deduplicación de pedidos, CMP compatibles.

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

---

Embudo completo, de la vista de producto a la compra, con deduplicación automática y cola de reenvío. Compatible con HPOS.

## Requisitos previos

- WordPress 5.8+, WooCommerce 5.0+, PHP 7.4+. Compatible con HPOS.
- El zip del plugin, para descargar desde la página [**Modules**](https://admin.datafirefly.com/app/connectors) de su área de cliente.
- La [clave de conexión de su sitio](https://server-side.datafirefly.com/es/docs/connect-your-site.html).

## Instalación

1. Admin de WordPress: **Plugins > Add New > Upload Plugin**.
2. Suba el zip y haga clic en **Activate**.

## Configuración

1. Abra **Settings > DataFirefly Server-Side**.
2. Pegue la clave de conexión `dfss_...` y haga clic en **Connect**: el botón activa el tracking completo y la opción de consentimiento, y lanza un evento de prueba al momento.

El plugin detecta automáticamente las siguientes herramientas de consentimiento, sin configuración: WP Consent API, Complianz, DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, tarteaucitron. Los módulos de PrestaShop y Shopware usan la misma detección: una herramienta reconocida aquí lo es en todas partes.

## Lo que cubre el plugin

- Todo el embudo: navegación, vista de producto, carrito, checkout, compra.
- Deduplicación por identificador de pedido: sin doble conteo entre navegador y servidor.
- Cola de reenvío automática: los envíos fallidos se reenvían, con las compras primero (detalles más abajo).
- El panel **DataFirefly Activity** del admin muestra los últimos eventos enviados.

## Verificar

1. El evento de prueba debe aparecer como **Delivered** en el Monitoring de su área de cliente.
2. Realice un pedido de prueba y localícelo en el panel DataFirefly Activity.

## Cola de reenvío

Se aplica a partir de la versión 2.30.0.

- Un envío fallido se pone en cola y se reenvía cada 5 minutos mediante WP-Cron.
- Las compras y los reembolsos van primero; después, los eventos más recientes.
- Un evento solo sale de la cola cuando tiene más de 7 días **y** lleva más de 7 días esperando. Entonces se contabiliza como caducado: nada desaparece sin dejar rastro.
- Si DataFirefly no responde (fallo de red, HTTP 429 o 5xx), la tienda deja de enviar directamente durante 60 segundos y pone los eventos directamente en la cola. Así, una caída de nuestro lado nunca ralentiza su tienda ni el checkout. El reenvío sigue intentándolo y, en cuanto lo consigue, se reanuda el envío directo.
- La página de su sitio en el área de cliente muestra el estado de esta cola. Los estados se explican en la guía de [resolución de problemas](https://server-side.datafirefly.com/es/docs/troubleshooting.html).

## Si algo falla

- Tras cualquier cambio de configuración, **purgue la caché** de su sitio: de lo contrario, LiteSpeed Cache y similares seguirán sirviendo el antiguo JavaScript.
- Si utiliza una versión del plugin anterior a la 2.8.0, actualice: las versiones recientes corrigen un posible doble conteo de las compras en GA4.
- Las demás causas frecuentes están en la [guía de resolución de problemas](https://server-side.datafirefly.com/es/docs/troubleshooting.html).

Actualizado: 1 de septiembre de 2026
