# Gestión de Cookies

session.jsNecesaria

analytics.jsEn esperaBloqueado

ads-pixel.jsEn esperaBloqueado

Usamos cookies analíticas

RechazarAceptar

Decisión registrada

El módulo **Cookies** muestra un banner de preferencias, registra la decisión del visitante y evita que scripts opcionales se ejecuten antes de tener consentimiento.

La integración usa **Google Consent Mode v2 en modo Basic**. Antes de una decisión, Soyio mantiene negadas las señales de analítica y publicidad. Los tags de Google no deben cargar ni enviar datos hasta que el visitante acepte la categoría correspondiente.

## Qué incluye

-   Banner y panel de preferencias administrados desde Soyio
-   Consentimiento validado contra la versión publicada del banner
-   Integración directa con `gtag` o mediante Google Tag Manager
-   Bloqueo explícito de scripts por categoría
-   Actualización de tags y scripts cuando cambia el consentimiento
-   Registro local y sincronización con Soyio
-   Sincronización de preferencias para usuarios identificados

## Cómo funciona

1.  Carga `cookie-loader.js` al inicio del `<head>`
2.  Soyio establece las señales opcionales de Google como `denied`
3.  El SDK valida el consentimiento guardado contra la configuración publicada
4.  Si falta una decisión o cambió la configuración, muestra el banner
5.  Al aceptar, actualiza Consent Mode y activa los scripts permitidos
6.  Al quitar permisos, actualiza Consent Mode y recarga la página después de 500 ms

> **warning**
> Consent Mode no bloquea por sí solo todos los tags. Para conservar el modo Basic, reescribe los scripts opcionales o configura las verificaciones de consentimiento en GTM. Un tag normal que se ejecuta con estado `denied` puede enviar pings sin cookies, lo que corresponde al modo Advanced.

## Antes de empezar

Primero [configura y publica un sitio](https://docs.soyio.id/docs/integration-guide/cookies/setup-and-publish) en el dashboard. Después usa su token `csite_...` para instalar el runtime. Google Consent Mode v2 está incluido en todas las opciones, no es un método de instalación separado.

Después elige dónde vas a instalar Soyio:

-   [HTML o código propio](https://docs.soyio.id/docs/integration-guide/cookies/direct-installation)
-   [Next.js, React con Vite, Webflow o Framer](https://docs.soyio.id/docs/integration-guide/cookies/platform-installation)
-   [Google Tag Manager](https://docs.soyio.id/docs/integration-guide/cookies/google-tag-manager)
-   [HubSpot CMS](https://docs.soyio.id/docs/integration-guide/cookies/hubspot)

Si tu aplicación tiene cuentas, [sincroniza usuarios identificados](https://docs.soyio.id/docs/integration-guide/cookies/subject-sessions) después de instalar el loader.

Si ya integraste el consentimiento con `consent_actions`, revisa [Cookies y tu integración de consentimiento](https://docs.soyio.id/docs/integration-guide/cookies/consent-integration) para reutilizar la misma Entity.

Si el banner o el scanner no se comportan como esperas, revisa [solución de problemas](https://docs.soyio.id/docs/integration-guide/cookies/troubleshooting).