Documentación FitConsent CMP
Guía completa de instalación y configuración de FitConsent CMP. Instale banners de consentimiento de cookies, configure Google Consent Mode V2 y Microsoft UET, y cumpla con el RGPD, CCPA y más de 15 normativas de privacidad globales.
Introducción
Bienvenido a la documentación de la Plataforma de gestión del consentimiento (CMP) FitConsent. Esta guía cubre todo lo que necesita para instalar, configurar y aprovechar al máximo FitConsent — desde su primera etiqueta de script hasta el manejo avanzado de datos de consentimiento.
¿Qué es una Plataforma de gestión del consentimiento (CMP)?
Una Plataforma de gestión del consentimiento (CMP) es una herramienta que ayuda a los sitios web a recopilar y gestionar legalmente el consentimiento del usuario para el procesamiento de datos, un requisito bajo leyes de privacidad como el RGPD en Europa y el CCPA/CPRA en California. Es la tecnología detrás de los banners de cookies que ve en sitios web de todo el mundo.
FitConsent va más allá de un banner básico. Proporciona las herramientas para cumplir con la ley y generar confianza en los usuarios optimizando la experiencia de consentimiento. Nuestro servicio incluye soporte completo y automático para Google Consent Mode V2 y Microsoft UET Consent Mode.
Características Principales
Integración automática de Google Consent Mode V2 y Microsoft UET Consent Mode
Soporte para 16 marcos regulatorios globales: RGPD, CCPA, TCF, ePrivacy, UCPA, VCDPA, CTDPA, LGPD, PIPEDA, APPI, PDPA, APA-NZPA, FADP, POPIA y más
Más de 100 idiomas con detección automática de idioma
Optimizador de banners impulsado por IA (planes Pro+)
Declaración de almacenamiento (tabla de cookies) para páginas de política de privacidad
Botón flotante disparador para que los usuarios actualicen su consentimiento en cualquier momento
Vista previa en tiempo real en el panel de control
Herramienta de diagnóstico integrada para verificar la instalación correcta
Instalación y Configuración
La integración de FitConsent está diseñada para ser rápida y sencilla. Elija el método que mejor se adapte a su plataforma.
Prerrequisitos
Antes de comenzar, asegúrese de tener:
Creado una cuenta FitConsent y registrado su sitio web en el panel de control
Su ID de sitio web único (disponible en la página de configuración de su sitio)
Decidido qué marco regulatorio aplica a su audiencia
Integración Directa
Para sitios HTML estándar, copie el siguiente código y péguelo en la sección <head> lo más alto posible — antes de cualquier script de Google Analytics, Google Ads o Microsoft UET.
<!-- FitConsent CMP: Establecer consentimientos predeterminados ANTES de todos los demás scripts -->
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
window.uetq = window.uetq || [];
// Consentimiento predeterminado: denegado hasta la interacción del usuario
gtag('consent', 'default', {
'ad_storage': 'denied',
'ad_user_data': 'denied',
'ad_personalization': 'denied',
'analytics_storage': 'denied'
});
window.uetq.push('consent', 'default', { 'ad_storage': 'denied' });
</script>
<!-- Cargue aquí sus otros scripts (Google Analytics, UET, etc.) -->
<!-- Banner FitConsent: actualiza el consentimiento según la interacción del usuario -->
<script async defer src="https://app.fitconsent.com/api/banner?websiteId=SU_WEBSITE_ID"></script>Reemplace SU_WEBSITE_ID con su ID de sitio web real del panel de control. Este script debe aparecer antes que cualquier etiqueta que lea o establezca cookies.
Google Tag Manager (Recomendado)
El uso de la plantilla comunitaria oficial de GTM de FitConsent es el método de instalación recomendado.
Paso 1: Activar la Descripción General del Consentimiento
1. En su espacio de trabajo de GTM, haga clic en la pestaña "Administrador".
2. En la columna "Contenedor", haga clic en "Configuración del contenedor".
3. Marque "Activar descripción general del consentimiento" y haga clic en "Guardar".
Paso 2: Agregar la Plantilla FitConsent
1. Vaya a "Plantillas" > "Plantillas de etiquetas" > "Buscar galería".
2. Busque "FitConsent" y haga clic en "Agregar al espacio de trabajo".
3. Acepte el aviso de permisos.
Paso 3: Crear la Etiqueta "Consentimiento Predeterminado de Google"
1. Vaya a "Etiquetas" > "Nueva", nómbrela "FitConsent – Consentimiento predeterminado".
2. Elija "FitConsent" como tipo de etiqueta.
3. En el menú desplegable "Tipo de etiqueta", seleccione "Google Consent Default".
4. Ingrese su ID de sitio web en el campo "FitConsent Website ID".
5. Configure el activador como "Inicialización del consentimiento – Todas las páginas".
6. Guarde la etiqueta.
Paso 4: Crear la Etiqueta "Cargador del Banner"
1. Cree una nueva etiqueta llamada "FitConsent – Cargador del banner".
2. Elija "FitConsent" como tipo de etiqueta.
3. Ingrese su ID de sitio web y configure el activador como "Inicialización del consentimiento – Todas las páginas".
4. Guarde la etiqueta.
Paso 5: Configurar su Etiqueta de Google
Si ya tiene una Etiqueta de Google (GA4): edite la etiqueta > "Configuración avanzada" > "Configuración del consentimiento" > seleccione "No se requiere consentimiento adicional".
Paso 6: Gestionar Scripts de Terceros
Para scripts como Microsoft Clarity o Meta Pixel: edite la etiqueta > "Configuración avanzada" > "Configuración del consentimiento" > "Requerir consentimiento adicional para activar la etiqueta" > agregue analytics_storage o ad_storage.
Haga clic en "Enviar" y "Publicar" su contenedor de GTM.
Plugin de WordPress
FitConsent está disponible como plugin oficial en WordPress.org. Proporciona compatibilidad automática con la WP Consent API, el estándar utilizado por Google Site Kit.
Instalación a través del Panel de WordPress
1. Vaya a "Plugins" > "Añadir nuevo".
2. Busque "FitConsent CMP" y haga clic en "Instalar ahora", luego "Activar".
Configuración Post-instalación
1. Vaya a "Ajustes" > "FitConsent".
2. Ingrese su ID de sitio web de FitConsent.
3. Haga clic en "Guardar cambios".
Si usa Google Site Kit, active el "Modo de consentimiento" en su configuración. FitConsent se comunica automáticamente con Site Kit a través de la WP Consent API.
Otras Plataformas
FitConsent funciona con cualquier plataforma que permita HTML o JavaScript personalizado (Shopify, Drupal, Webflow, etc.). Use la integración GTM si está disponible, o el método de integración directa.
Configurar su Banner
Toda la configuración se gestiona desde el panel de control de FitConsent. Abra la página de configuración de su sitio web para acceder a todos los ajustes. Los cambios se previsualizan en tiempo real en el panel derecho.
Configuración General
Dominio: El dominio de su sitio web (ej.: example.com).
ID de Google Analytics: Ingrese su ID de GA4 (ej.: G-XXXXXXXXXX).
Marco regulatorio: Elija el marco de privacidad aplicable a sus visitantes.
| Marco | Mejor Para | Región |
|---|---|---|
| Auto | Aplica automáticamente RGPD o CCPA según la ubicación del visitante | Global |
| RGPD | Reglamento General de Protección de Datos de la UE | Unión Europea / EEE |
| CCPA | Ley de Privacidad del Consumidor de California | California, EE.UU. |
| ePrivacy | Directiva ePrivacy de la UE (ley de cookies) | Unión Europea |
| TCF | Marco de Transparencia y Consentimiento de IAB | Editores y redes publicitarias |
| UCPA | Ley de Privacidad del Consumidor de Utah | Utah, EE.UU. |
| VCDPA | Ley de Protección de Datos del Consumidor de Virginia | Virginia, EE.UU. |
| CTDPA | Ley de Privacidad de Datos de Connecticut | Connecticut, EE.UU. |
| LGPD | Ley General de Protección de Datos de Brasil | Brasil |
| PIPEDA | Ley de Protección de Información Personal de Canadá | Canadá |
| APPI | Ley de Protección de Información Personal de Japón | Japón |
| PDPA | Ley de Protección de Datos Personales de Tailandia | Tailandia |
| APA-NZPA | Leyes de Privacidad de Australia y Nueva Zelanda | Australia / Nueva Zelanda |
| FADP | Ley Federal Suiza de Protección de Datos | Suiza |
| POPIA | Ley de Protección de Información Personal de Sudáfrica | Sudáfrica |
| Ninguno | Sin marco automático — control completamente manual | Cualquiera |
Para sitios web con audiencia internacional, seleccione "Auto". FitConsent mostrará automáticamente el banner RGPD para visitantes europeos y CCPA para visitantes de California.
Segmentación geográfica: Elija quién ve el banner:
Ninguna — Todos los visitantes ven el banner
RGPD — Solo los visitantes de países de la UE/EEE ven el banner
Dominios Adicionales
Disponible en los planes Pro Large y Business. Los dominios adicionales le permiten cargar el mismo banner en hasta 5 dominios adicionales de su propiedad — útil para entornos de staging, dominios regionales o configuraciones multimarca.
Para añadir un dominio adicional:
1. Abra la página de configuración de su sitio web en el panel de control.
2. Vaya a la pestaña Configuración General.
3. Desplácese hasta la tarjeta Dominios Adicionales.
4. Haga clic en Añadir dominio e introduzca el nombre de host sin formato (p. ej., staging.example.com o mimarca.es) — sin prefijo https:// ni barras finales.
5. Repita para hasta 5 dominios y luego guarde su configuración.
Si la sección Dominios Adicionales aparece bloqueada a pesar de tener un plan Pro Large o Business, contacte con el soporte — es posible que su suscripción no se haya aplicado correctamente a este sitio web.
Modo de Consentimiento
Modo Avanzado (Recomendado)
Las etiquetas de Google se cargan inmediatamente pero operan con recopilación de datos restringida hasta que se otorga el consentimiento.
Antes del consentimiento: Las etiquetas envían "pings anónimos sin cookies" — no se establecen cookies de identificación.
Después del consentimiento: Se habilita la recopilación completa de datos según las elecciones del usuario.
Beneficio clave: Habilita el Modelado de conversiones de Google, que recupera datos de atribución perdidos.
Modo Básico (Bloqueo Estricto)
Todos los scripts de seguimiento están completamente bloqueados hasta que el usuario otorga consentimiento.
<!-- Script bloqueado para el Modo Básico -->
<script
type="text/plain"
data-cookieconsent="analytics"
async
src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXX">
</script>Mapeo de categorías:
analytics → Google Analytics (GA4), Microsoft Clarity
marketing → Google Ads, Meta Pixel, LinkedIn
functional → Chatbots, herramientas de personalización
| Función | Modo Básico | Modo Avanzado |
|---|---|---|
| Etiquetas de Google | Bloqueadas hasta consentimiento | Se cargan inmediatamente (restringidas) |
| Datos antes del consentimiento | Cero datos | Pings sin cookies (modelado) |
| Nivel de privacidad | Más estricto | Conforme RGPD / DMA |
| Modelado de conversiones | No disponible | Disponible |
Apariencia
Diseño y Animación
Tipo: Banner (barra horizontal) o Diálogo (superposición centrada)
Posición: Abajo, Arriba, Abajo-Izquierda, Abajo-Derecha, Arriba-Izquierda, Arriba-Derecha, Centro
Estilo de animación: Spring (elástico), Slide (deslizamiento), Fade (desvanecimiento), Ninguno
Acento de borde: Ninguno, Superior, Izquierdo (franja de color), Degradado
Tipografía
Fuente: Inter, DM Sans, Plus Jakarta Sans, Nunito, Outfit, Lato, Poppins, Raleway, Merriweather, Playfair Display, Source Code Pro
Alineación del título: Izquierda, Centro, Derecha
Forma y Elevación
Radio de borde: Ninguno, SM, MD, LG, XL, 2XL
Radio de borde de botones: Ninguno, SM, MD, LG, XL, Completo
Elevación (sombra): Ninguna, SM, MD, LG, XL
Colores
Cada campo de color soporta modos claro y oscuro de forma independiente:
Color de texto, Color de título, Color de fondo
Color de botones, Color de texto de botones, Color de borde de botones
Color de divisor, Color de pestaña activa, Color de pestaña inactiva
Logo e Imagen de Fondo
URL del logo: Muestre el logo de su empresa en el banner.
Imagen de fondo: Imágenes separadas para Escritorio Claro, Escritorio Oscuro, Móvil Claro y Móvil Oscuro.
Contenido e Idiomas
Campos de texto configurables:
Encabezado del banner
Mensaje del banner (soporta Markdown: negrita, *cursiva*, [enlace](url))
Etiqueta del botón "Aceptar todo"
Etiqueta del botón "Rechazar"
Etiqueta del botón "Gestionar preferencias"
Título y descripción del modal de preferencias
Etiqueta del botón "Guardar preferencias"
Etiquetas de pestañas: Consentimiento, Preferencias, Declaración de almacenamiento
Configuración de Comportamiento
Botones
Habilitar botón Rechazar: Mostrar u ocultar la opción "Rechazar".
Habilitar botón Gestionar: Mostrar u ocultar la opción "Gestionar preferencias".
Categorías de Consentimiento
Necesario (siempre activo): Cookies esenciales para el funcionamiento del sitio
Analytics: Análisis y rendimiento del sitio web
Marketing: Publicidad y remarketing
Funcional: Personalización y funcionalidad mejorada
Venta de datos (CCPA/LGPD/UCPA/CTDPA): Se agrega automáticamente cuando "Venta de datos" está habilitado
Botón Flotante Disparador
Habilitar: Activar o desactivar el botón flotante.
Posición: Abajo-Izquierda o Abajo-Derecha.
Colores: Color de fondo y color de icono para modos claro y oscuro.
Configuración Específica de CCPA
Enlace "No vender": URL a su página "No vender mi información personal".
Enlace "Limitar uso": URL a su página "Limitar el uso de mi información personal sensible".
Venta de datos: Indica si su sitio vende o comparte datos personales con terceros.
Optimizador de IA
Disponible en planes Pro+. El optimizador de IA analiza el contenido, la marca y la audiencia objetivo de su sitio para sugerir combinaciones de colores óptimas, texto de banner recomendado y mejoras de diseño.
Declaración de Almacenamiento
FitConsent puede mostrar una tabla actualizada automáticamente de todas las cookies y elementos de almacenamiento que usa su sitio web.
HTML Estándar
<div id="fitconsent-declaration"></div>
<script async defer src="https://app.fitconsent.com/api/declaration?websiteId=SU_WEBSITE_ID"></script>React & Next.js
Para evitar errores de hidratación, cargue el script del lado del cliente usando un hook useEffect.
'use client';
import { useEffect } from 'react';
type Props = {
websiteId: string;
};
export function StorageDeclarationEmbed({ websiteId }: Props) {
useEffect(() => {
const script = document.createElement('script');
script.src = `https://app.fitconsent.com/api/declaration.js?websiteId=${websiteId}`;
script.async = true;
script.defer = true;
const container = document.getElementById('fitconsent-declaration');
if (container) {
container.appendChild(script);
}
return () => {
if (container && container.contains(script)) {
container.removeChild(script);
}
};
}, [websiteId]);
return <div id="fitconsent-declaration"></div>;
}Este enfoque garantiza que el script se cargue y ejecute de forma segura en el lado del cliente, evitando conflictos con el ciclo de renderizado de React.
Uso Avanzado
Usar Datos de Consentimiento en su Sitio Web
Después de la interacción del usuario, FitConsent almacena sus elecciones en una cookie llamada fitconsent_given.
Estructura de la Cookie
{
"choices": {
"necessary": true,
"analytics": true,
"marketing": false
},
"geo": {
"country": "ES",
"state": null
}
}choices: Un objeto donde cada clave es una categoría de consentimiento y el valor es true (aceptado) o false (rechazado).
geo: Contiene la ubicación geográfica del usuario en el momento del consentimiento.
Leer el Consentimiento en el Cliente
function getFitConsentChoices() {
const cookie = document.cookie
.split('; ')
.find(row => row.startsWith('fitconsent_given='));
if (!cookie) return null;
try {
return JSON.parse(decodeURIComponent(cookie.split('=')[1]));
} catch {
return null;
}
}
const consent = getFitConsentChoices();
if (consent?.choices?.analytics) {
// Inicializar su script de análisis
}Detección Automática de Idioma
El banner de FitConsent detecta automáticamente el idioma preferido del usuario en este orden:
1. El atributo lang de la etiqueta <html> (ej.: <html lang="es">). Este es el método más fiable.
2. La configuración navigator.language del navegador.
3. Vuelve al inglés (en) o al primer idioma en su lista configurada.
Herramienta de Diagnóstico
Use la herramienta de diagnóstico integrada para verificar que el banner está correctamente instalado. Verifica: detección del script del banner, estado de los valores predeterminados del modo de consentimiento, estado de integración de etiquetas de Google, y problemas detectados con recomendaciones.
Migración: Modo Avanzado → Modo Básico
1. Cambie su configuración de FitConsent a "basic".
2. Elimine el bloque de script "Consent Default" de su <head>.
3. Agregue type="text/plain" y data-cookieconsent="..." a todas sus etiquetas de script de seguimiento.
4. Borre las cookies del navegador y vuelva a probar.
Después de cambiar al Modo Básico, perderá todos los datos previos al consentimiento, incluidos los datos de modelado anónimo. Esto no se puede recuperar de forma retroactiva.
Ready to simplify your compliance?
Implement a reliable Consent Management Platform (CMP) today and ensure you stay compliant with all global regulations.
Start Your Free Trial