# Instalar el plugin Shopware

> Instalar y configurar el plugin DataFirefly Server-Side en Shopware 6.5, 6.6 y 6.7: subida de la extensión, clave de conexión, cookie de consentimiento.

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

---

Compatible con Shopware 6.5, 6.6 y 6.7. Instalación desde el admin o por línea de comandos. Un envío fallido se pone en cola y se reintenta cada cinco minutos mediante el propio planificador de Shopware: una caída pasajera no cuesta nada.

## Requisitos previos

- Shopware 6.5, 6.6 o 6.7.
- 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 Shopware: **Extensions > My extensions > Upload extension**, luego instale y active el plugin.
2. O por CLI: `bin/console plugin:install --activate DatafireflyServerSide`

## Configuración

1. Abra la configuración del plugin y pegue la clave de conexión `dfss_...`.
2. Active **Enable tracking**.

El módulo reconoce por sí solo las herramientas de consentimiento habituales (DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, tarteaucitron), en el navegador y en el servidor, la misma lista que los módulos de WooCommerce y PrestaShop. Deje **Consent cookie name** vacío para esa detección automática; rellénelo solo para imponer una cookie concreta (por ejemplo `CookieConsent` y `marketing:true`), que pasa entonces a tener prioridad.

## Verificar

1. Ejecute `bin/console datafirefly:serverside:test`.
2. El evento de prueba debe aparecer como **Delivered** en el Monitoring de su área de cliente.

## Cola de reenvío

Se aplica a partir de la versión 1.23.0.

- Un envío fallido se pone en cola y se reenvía cada 5 minutos mediante una tarea programada de Shopware.
- 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

- Registros en `var/log/`, prefijo `[DataFirefly SS]`.
- Si utiliza una versión del plugin anterior a la 1.9.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
