Documentación de WPConsent

Documentación, Materiales de Referencia y Tutoriales para WPConsent

Compatibilidad con IAB TCF v2.2

¿Desea cumplir con el Marco de Transparencia y Consentimiento (TCF) de IAB para la publicidad digital? WPConsent es una Plataforma de Gestión del Consentimiento (CMP) registrada en IAB e incluye soporte completo para TCF v2.2. Esta guía le guía a través de la activación y configuración de IAB TCF v2.2 en WPConsent.

Característica Pro: Esta característica requiere WPConsent Pro.

Tabla de contenidos

Requisitos previos

Antes de empezar, asegúrate de tener:

  • WPConsent Pro instalado y activado
  • Una comprensión básica de los conceptos de IAB TCF (propósitos, proveedores, interés legítimo)
  • Una lista de los proveedores registrados en IAB con los que trabaja
  • Familiaridad con los requisitos de la política de IAB TCF v2.2

Comprender cuándo usar el modo IAB TCF

Querrá activar IAB TCF v2.2 si:

  • Trabaja con proveedores de publicidad registrados en IAB (Google AdSense, Criteo, etc.)
  • Sirve a audiencias en la UE/EEE que requieren el cumplimiento del RGPD
  • Necesita generar cadenas TC compatibles con IAB para publicidad programática
  • Desea utilizar la interfaz estandarizada __tcfapi()

No necesita el modo TCF si solo utiliza proveedores no IAB o herramientas de análisis generales. Las categorías de cookies estándar de WPConsent funcionan mejor para configuraciones más sencillas. Para el enfoque sin TCF, consulte gestionar categorías de cookies.

Activación del modo TCF

Primero, navegue a WPConsent >> Ajustes en su panel de WordPress. Luego haga clic en la pestaña IAB TCF en la parte superior de la página.

En el metabox Activación de TCF, active el interruptor Activar TCF a la posición ENCENDIDO. Una nota debajo del interruptor explica que esta configuración fuerza ciertos comportamientos del banner.

Conmutador Habilitar TCF

Importante: La activación del modo TCF fuerza comportamientos específicos del banner para garantizar el cumplimiento:

  • El diseño del banner cambia a estilo modal (superposición a pantalla completa). Los diseños de barra y esquina no están disponibles.
  • Los textos de los botones cambian a etiquetas requeridas por IAB: "Aceptar todo", "Rechazar todo", "Gestionar ajustes" y "Guardar ajustes".
  • El mensaje del banner se reemplaza con una versión compatible con IAB. Incluye propósitos de procesamiento de datos, recuento de proveedores y divulgación de interés legítimo.
  • El botón flotante "Preferencias de cookies" se activa automáticamente para la reaparición del consentimiento.
  • Las categorías de cookies estándar (Esenciales, Marketing, Estadísticas, etc.) se conservan como "Categorías No IAB TCF" y se muestran por separado de los propósitos de IAB.
  • Los propósitos de IAB se convierten en el mecanismo de consentimiento principal. No puede editarlos ni eliminarlos.
  • El selector manual para servicios individuales está forzado a ACTIVADO.

Estos cambios son requeridos por la política IAB TCF v2.2. Vuelven a tus configuraciones originales cuando deshabilitas el modo TCF.

Configuración de restricciones globales de proveedores

El metabox Restricciones globales de proveedores te permite aplicar restricciones a nivel de editor a todos los proveedores a la vez.

La configuración clave es Interés legítimo:

  • Permitir Interés Legítimo (Predeterminado): Los proveedores pueden usar el interés legítimo como base legal para ciertos fines.
  • Denegar Interés Legítimo para Todos los Fines: Fuerza a que todos los fines requieran el consentimiento explícito del usuario. La columna de interés legítimo se oculta en la pestaña de proveedores del modal de preferencias.
  • Denegar Interés Legítimo para Fines Específicos: Te permite elegir fines individuales que requieren consentimiento en lugar de interés legítimo.

La mayoría de los editores dejan esta opción en la configuración predeterminada a menos que el asesor legal indique lo contrario. Denegar el interés legítimo globalmente es un enfoque más estricto que prefieren algunos sitios centrados en la privacidad.

Configuración de declaraciones del editor

El metabox Declaraciones del Editor te permite declarar para qué fines tú (el editor) procesas datos directamente, aparte de tus proveedores.

Para cada fin, puedes declarar:

  • Consentimiento: Procesas datos para este fin y solicitas el consentimiento del usuario.
  • Transparencia de Interés Legítimo: Procesas datos para este fin bajo interés legítimo.

Estas declaraciones rellenan la sección publisher de la cadena TC. Deja estas configuraciones sin cambios a menos que proceses directamente datos de usuario para fines específicos más allá de lo que manejan tus proveedores.

Selección de proveedores

Desplázate hacia abajo hasta la sección de la lista de proveedores. Verás una lista clasificable y con capacidad de búsqueda de todos los proveedores registrados en el IAB de la Lista Global de Proveedores.

Lista de editores IAB

Para gestionar proveedores:

  1. Usa la barra de búsqueda para encontrar proveedores específicos por nombre o ID de proveedor.
  2. Usa el filtro de estado para mostrar todos los proveedores, solo los seleccionados o solo los no seleccionados.
  3. Usa el menú desplegable de ordenación para organizar por nombre o ID de proveedor en orden ascendente o descendente.
  4. Marca o desmarca la casilla junto a cada proveedor. También puedes hacer clic en cualquier lugar del encabezado de la fila del proveedor para alternar la selección.
  5. Haz clic en el botón de flecha en la fila de un proveedor para expandir sus detalles. Esto muestra los fines, fines de interés legítimo, fines especiales y enlaces a la política.

Por defecto, todos los proveedores están seleccionados la primera vez que visitas esta página. Querrás desmarcar los proveedores que no uses para reducir la longitud de tu aviso de consentimiento y mejorar la transparencia para tus visitantes.

Cada entrada de proveedor muestra:

  • Nombre e ID del proveedor: El nombre registrado en el IAB y el identificador numérico.
  • Enlace a la Política de Privacidad: Abre la política de privacidad del proveedor en una nueva pestaña.
  • Enlace a la Declaración de Interés Legítimo: Abre la declaración de interés legítimo del proveedor (si está disponible).
  • Restricciones por proveedor: Expanda los detalles del proveedor para configurar restricciones de propósito por proveedor y requerir consentimiento para propósitos específicos de interés legítimo.

Guardar la configuración de TCF

Para aplicar sus cambios, haga clic en Guardar cambios en la parte inferior de la página IAB TCF. El plugin guarda sus proveedores seleccionados, las restricciones del editor, las declaraciones del editor y el estado de activación de TCF. También borra la caché de slugs de preferencias para que el frontend refleje sus cambios de inmediato.

Probar el banner de frontend

Abra su sitio web en una ventana de navegador de incógnito o privada. Verá un banner modal que cumple con TCF.

Banner modal TCF en el frontend

El banner modal incluye:

  • Un mensaje estandarizado que describe el procesamiento de datos y las asociaciones de proveedores, mostrando su recuento real de proveedores seleccionados.
  • Una sección de Propósitos de procesamiento de datos que enumera cada propósito de IAB con recuentos de proveedores (por ejemplo, "3 solicitando consentimiento, 2 usando interés legítimo").
  • Una sección de Funciones especiales si alguno de sus proveedores seleccionados utiliza funciones especiales como la geolocalización precisa.
  • Un aviso de interés legítimo (si algún proveedor seleccionado utiliza interés legítimo).
  • Información sobre el alcance del consentimiento y la retirada.
  • Un enlace Ver lista de proveedores que abre el modal de preferencias directamente en la pestaña de proveedores.
  • 3 botones: Aceptar todo, Rechazar todo y Gestionar configuración.

Revisar el modal de preferencias

Haga clic en Gestionar configuración para abrir el modal de preferencias. Contiene 3 pestañas:

Pestaña Propósitos:

  • Sección de Categorías TCF no IAB (Esencial, Marketing, Estadísticas, etc.) con sus interruptores estándar.
  • Sección de Propósitos TCF de IAB con cada propósito mostrando su descripción, ilustraciones, recuentos de proveedores y un enlace "Ver lista de proveedores".
  • Sección de Propósitos Especiales que muestra actividades de procesamiento que no requieren consentimiento (seguridad, prevención de fraude, entrega técnica).
  • Una divulgación de almacenamiento de cadena TC que explica que las opciones de consentimiento se guardan en localStorage y una cookie hasta por 12 meses.

Propósitos IAB en el modal de preferencias

Pestaña Funciones:

  • Sección de Funciones que enumera las capacidades técnicas que los proveedores utilizan para admitir el procesamiento de datos. Estas no requieren consentimiento por separado.
  • Sección de Funciones Especiales con interruptores para funciones que requieren consentimiento explícito, como "Usar datos de geolocalización precisa" y "Escanear activamente las características del dispositivo para la identificación".

Pestaña Proveedores:

  • Una barra de búsqueda con un botón de filtro. El menú desplegable de filtro le permite acotar proveedores por propósito, propósito especial o función especial.
  • Interruptores maestros para Consentimiento e Interés legítimo en la parte superior de la lista.
  • Cada fila de proveedor muestra el nombre del proveedor con interruptores de consentimiento e interés legítimo.
  • Expandir un proveedor muestra información detallada: propósitos, propósitos de interés legítimo, propósitos especiales, características, categorías de datos, períodos de retención de datos, duración del almacenamiento de cookies, enlace a la política de privacidad y enlace a la divulgación de interés legítimo.
  • Las etiquetas de filtro activas muestran los criterios de filtro seleccionados actualmente.

Un botón Rechazar todo aparece junto a Guardar configuración en el pie de página del modal de preferencias para el cumplimiento de TCF.

Cómo IAB TCF cambia WPConsent

Cuando el modo TCF está habilitado, varios comportamientos principales cambian. Comprender estos cambios te ayuda a solucionar problemas y a establecer expectativas.

Las categorías de cookies estándar (Marketing, Estadísticas, etc.) se conservan como “Categorías no IAB TCF” y se muestran en una sección separada. Los propósitos IAB se convierten en el mecanismo principal de consentimiento. Los botones de editar y eliminar están ocultos tanto para las categorías de propósitos IAB como para la categoría Esencial. Para saber cómo funcionan las categorías en modo no TCF, consulta gestionar categorías de cookies.

El diseño del banner se fuerza al estilo modal independientemente de tu configuración de diseño del banner. Los diseños de barra y esquina no están permitidos según la política IAB TCF v2.2 porque el aviso de consentimiento debe ser prominente y no ambiguo.

Textos y mensajes de los botones forzados

Las etiquetas de los botones y los mensajes del banner se anulan por texto compatible con IAB. Tus etiquetas de botón y mensaje de banner personalizados se restauran cuando deshabilitas el modo TCF. Los textos forzados son:

ElementoTexto forzado
Botón AceptarAceptar Todo
Botón RechazarRechazar todo
Botón de PreferenciasGestionar configuración
Botón Guardar preferenciasGuardar configuración

Botón flotante siempre activado

El botón flotante "Preferencias de cookies" se fuerza a ACTIVADO cuando TCF está activo. La política C(f) de IAB TCF requiere que la interfaz de usuario de consentimiento se muestre fácilmente para que los usuarios puedan revisar y cambiar sus preferencias en cualquier momento.

WPConsent guarda 2 registros de consentimiento cuando TCF está activo:

  • Preferencias estándar de WPConsent: Almacenadas en la cookie wpconsent_preferences (para categorías no TCF como Esencial, Marketing, Estadísticas).
  • Cadena TC: Almacenada tanto en la cookie wpconsent_tcstring como en localStorage (para proveedores y propósitos IAB). La Cadena TC codifica todas las opciones de consentimiento e interés legítimo en un formato estandarizado que los proveedores IAB pueden leer.

Integración de la API CMP

La función __tcfapi() está disponible globalmente en tu sitio web. Una versión stub se carga temprano en la sección de cada página para que esté disponible antes de que se ejecuten los scripts de cualquier proveedor. La API CMP completa se inicializa después de que se carga el banner.

Los scripts de terceros utilizan __tcfapi() para:

  • Consultar el estado de consentimiento para propósitos y proveedores específicos.
  • Escuchar los cambios de consentimiento a través de callbacks de eventos.
  • Recuperar la Cadena TC codificada.

WPConsent está registrado con el ID de CMP 482. La API de CMP utiliza la versión 2 de la especificación IAB TCF.

Ejemplo: Comprobando el estado del consentimiento desde JavaScript:

__tcfapi('getTCData', 2, function(tcData, success) {
    if (success) {
        console.log('TC String:', tcData.tcString);
        console.log('Purpose 1 consent:', tcData.purpose.consents[1]);
        console.log('Vendor 755 consent:', tcData.vendor.consents[755]);
    }
});

Gestión del interés legítimo

Algunos fines de IAB admiten el interés legítimo como base legal. Estos son fines para los que los proveedores pueden procesar datos sin consentimiento explícito, a menos que el usuario se oponga. En la ventana modal de preferencias:

  • La pestaña Fines muestra recuentos de proveedores tanto para “solicitar consentimiento” como para “utilizar interés legítimo” por fin.
  • La pestaña Proveedores muestra interruptores separados de Consentimiento e Interés Legítimo para cada proveedor.
  • Los interruptores de interés legítimo están activados por defecto (marcados). Los proveedores procesan datos bajo interés legítimo a menos que el usuario se oponga activamente.
  • Los interruptores maestros en la parte superior de la lista de proveedores permiten a los usuarios aceptar o rechazar todas las opciones de consentimiento o interés legítimo a la vez.

Puedes restringir el interés legítimo globalmente o por proveedor utilizando las Restricciones Globales de Proveedores y la configuración individual de restricciones de proveedor en el panel de administración.

Carga y caché de GVL

El plugin descarga la Lista Global de Proveedores (GVL) del servidor de IAB Europe en https://vendor-list.consensu.org/v3/vendor-list.json. La GVL contiene todos los proveedores registrados, sus fines, características y detalles de procesamiento de datos.

La GVL se almacena en caché localmente en el directorio /wp-content/uploads/wpconsent/cache/. La duración de la caché sigue las cabeceras de caché HTTP del servidor de IAB (normalmente 24 horas). Si el servidor no está disponible, WPConsent utiliza la versión cacheada previamente como respaldo. Si no existe una versión cacheada, la lista de proveedores muestra un estado de error y reintenta después de 1 hora.

En el frontend, la URL base de la GVL apunta a la caché local para que los datos del proveedor se carguen desde tu propio servidor. El JavaScript del frontend utiliza la clase GVL de la biblioteca @iabtechlabtcf/core para analizar los datos del proveedor y limitarlos solo a tus proveedores seleccionados.

Restricciones del editor en la cadena TC

Las restricciones del editor se codifican directamente en la Cadena TC utilizando la clase PurposeRestriction de @iabtechlabtcf/core. Se admiten 2 tipos de restricciones:

  • NO PERMITIDO (0): El fin no está permitido para un proveedor específico. El proveedor no puede procesar datos para este fin independientemente del consentimiento del usuario.
  • REQUIERE CONSENTIMIENTO (1): El fin requiere consentimiento explícito en lugar de interés legítimo. El proveedor no puede basarse en el interés legítimo para este fin.

Estas restricciones comunican tus políticas de procesamiento de datos a los proveedores cuando decodifican la Cadena TC.

Verificar su configuración

Después de habilitar IAB TCF v2.2, confirma que está funcionando correctamente.

Comprobando la generación de la cadena TC

  1. Abre la consola de desarrollador de tu navegador (F12).
  2. Escribe __tcfapi('getTCData', 2, console.log) y presiona Enter.
  3. Busca tcString en la salida registrada.
  4. La cadena contiene datos de consentimiento codificados.
  5. Verifica que cmpId sea 482 en la salida.

Comprobando la disponibilidad de la API de CMP

La función __tcfapi() está disponible inmediatamente al cargar la página, antes de que se ejecuten otros scripts. Para verificar esto, comprueba typeof __tcfapi en la consola. Devuelve "function".

  1. Abre las Herramientas para desarrolladores y ve a la pestaña Aplicación.
  2. Busca wpconsent_tcstring tanto en Almacenamiento local como en Cookies.
  3. Después de aceptar o rechazar el consentimiento, la Cadena TC se actualiza en ambas ubicaciones.

Validando con el validador de la IAB

Utiliza la Herramienta Validadora TCF de la IAB para comprobar el cumplimiento:

  1. Visita el sitio web del validador.
  2. Introduce la URL de tu sitio.
  3. Revisa el informe de validación para detectar cualquier infracción de la política.

Solución de problemas

Propósitos no visibles

Síntoma: La página de Configuración no muestra ningún propósito de la IAB después de habilitar el modo TCF.

Solución: La Lista Global de Proveedores (GVL) aún no se ha cargado. Verifica que:

  • Tu servidor pueda realizar solicitudes HTTPS salientes a vendor-list.consensu.org.
  • El directorio /wp-content/uploads/wpconsent/cache/ sea escribible por tu servidor web.
  • Intenta actualizar la página TCF de la IAB para activar una nueva descarga de GVL.

La cadena TC no se guarda

Síntoma: Los usuarios ven el banner en cada visita a la página a pesar de haber dado su consentimiento.

Solución: Comprueba el almacenamiento del navegador:

  • Abre las Herramientas para desarrolladores, ve a Aplicación, luego a Almacenamiento local y busca una entrada wpconsent_tcstring.
  • Comprueba las Herramientas para desarrolladores, luego Aplicación, y después Cookies para una cookie wpconsent_tcstring.
  • Si falta, verifica que las cookies y el almacenamiento local no estén bloqueados por la configuración del navegador, bloqueadores de anuncios o extensiones de privacidad.

Síntoma: Los proveedores de la IAB no se cargan después de que se otorga el consentimiento.

Solución: El modo TCF de la IAB genera la Cadena TC y expone la interfaz __tcfapi(), pero no carga automáticamente los scripts o etiquetas de los proveedores. Necesitas integrar los scripts de los proveedores por separado utilizando su documentación. Los scripts de los proveedores suelen llamar a __tcfapi('addEventListener', 2, callback) para escuchar los cambios de consentimiento y activarse según la Cadena TC.

Síntoma: El banner modal no se muestra correctamente o se superpone al contenido.

Solución: El modo TCF aplica un diseño modal para cumplir con la política. Si ocurren conflictos de CSS:

  • El banner WPConsent se renderiza dentro de un Shadow DOM, que aísla sus estilos de tu tema y otros plugins por diseño. Las reglas CSS externas que apuntan a .wpconsent-banner no pueden alcanzar los elementos dentro del Shadow DOM. Para personalizar los estilos del banner, utiliza la configuración de estilo del banner en WPConsent o añade variables CSS que el Shadow DOM herede.
  • Verifica que ningún JavaScript interfiera con la visualización del modal.
  • El diseño del modal TCF no se puede cambiar a estilo de barra o esquina mientras TCF está activo.

Pestañas del modal de preferencias no cargan

Síntoma: La pestaña Características o Proveedores en el modal de preferencias muestra contenido vacío.

Solución: Estas pestañas se completan dinámicamente utilizando datos GVL cargados a través de JavaScript. Verifique que:

  • El script iab-tcf.js se carga correctamente (verifique la pestaña Red en DevTools para ver errores).
  • El archivo de caché GVL es accesible en /wp-content/uploads/wpconsent/cache/vendor-list.json.
  • No aparecen errores de JavaScript en la consola relacionados con la carga de GVL.

Preguntas frecuentes

¿Necesito IAB TCF si solo uso Google Analytics?

No. Si solo utiliza proveedores no IAB o herramientas de análisis generales, las categorías de cookies estándar de WPConsent son más adecuadas. El modo TCF está diseñado para editores que trabajan con proveedores de publicidad registrados en IAB.

¿Se perderán la configuración de mi banner personalizado cuando active TCF?

No. Las etiquetas de sus botones personalizados, el mensaje del banner y la configuración del diseño se conservan. El modo TCF los anula temporalmente mientras está activo. Cuando desactive el modo TCF, se restaurará su configuración original.

¿Puedo cambiar el diseño del banner mientras TCF está activo?

No. La política IAB TCF v2.2 requiere que el banner se muestre como una superposición modal de pantalla completa. No se permiten los diseños de barra y esquina. El diseño vuelve a su configuración preferida cuando desactiva TCF.

¿Por qué todos los proveedores están seleccionados por defecto?

Todos los proveedores se seleccionan la primera vez que visita la página IAB TCF para asegurarse de que no se pierda nada. Recomendamos desmarcar los proveedores que no utilice para acortar su aviso de consentimiento y mejorar la transparencia.

¿Cuál es el ID de CMP para WPConsent?

WPConsent está registrado con el ID de CMP 482 en el sistema IAB TCF.

Conclusión

Ahora ha configurado el soporte de IAB TCF v2.2 en WPConsent. Su sitio genera cadenas TC compatibles y proporciona a los visitantes controles de consentimiento granulares para los proveedores registrados en IAB. Recuerde verificar su configuración utilizando la Herramienta de Validación IAB TCF y revisar la selección de sus proveedores periódicamente a medida que cambian sus asociaciones publicitarias.

Para obtener más información sobre las opciones de visualización del banner que se aplican fuera del modo TCF, consulte opciones de diseño del banner.

¿Te ha resultado útil este artículo?

Artículos relacionados