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 de la IAB para la publicidad digital? WPConsent es una plataforma de gestión del consentimiento (CMP) registrada en la IAB e incluye compatibilidad total con TCF v2.2. Esta guía le explica cómo habilitar y configurar IAB TCF v2.2 en WPConsent.

Función Pro: Esta función requiere WPConsent Pro.

Índice

Requisitos previos

Antes de comenzar, asegúrese de tener:

  • WPConsent Pro instalado y activado
  • Conocimientos básicos sobre los conceptos del IAB TCF (finalidades, proveedores, interés legítimo).
  • Una lista de los proveedores registrados en la IAB con los que trabajas.
  • Familiaridad con los requisitos de la política IAB TCF v2.2

Comprender cuándo utilizar el modo TCF de la IAB

Deberá habilitar IAB TCF v2.2 si:

  • Trabaja con proveedores de publicidad registrados en la IAB (Google AdSense, Criteo, etc.).
  • Prestar servicio a clientes de la UE/EEE que exigen el cumplimiento del RGPD.
  • Necesidad de generar cadenas TC compatibles con IAB para publicidad programática.
  • ¿Quieres utilizar el estándar? __tcfapi() interfaz

No necesitas el modo TCF si solo utilizas proveedores que no pertenecen a la 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, consulta la gestión de categorías de cookies.

Habilitar el modo TCF

En primer lugar, vaya a WPConsent >> Configuración en su panel de control de WordPress. A continuación, 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 Habilitar TCF. Una nota debajo del interruptor explica que esta configuración fuerza ciertos comportamientos de los banners.

Habilitar alternancia TCF

Importante: Al habilitar el modo TCF, se fuerzan comportamientos específicos de los banners 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 las etiquetas requeridas por la IAB: «Aceptar todo», «Rechazar todo», «Gestionar configuración» y «Guardar configuración».
  • El mensaje del banner se sustituye por una versión que cumple con las normas de la IAB. Incluye los fines del tratamiento de datos, el recuento de proveedores y la divulgación de intereses legítimos.
  • El botón flotante «Preferencias de cookies» se activa automáticamente para volver a solicitar el consentimiento.
  • Las categorías estándar de cookies (esenciales, de marketing, estadísticas, etc.) se conservan como «categorías no TCF de la IAB» y se muestran por separado de los fines de la IAB.
  • Los propósitos de IAB se convierten en el mecanismo de consentimiento principal. No se pueden editar ni eliminar.
  • El interruptor manual para servicios individuales se fuerza a la posición ON.

Estos cambios son obligatorios según la política IAB TCF v2.2. Se restablecerán los ajustes originales cuando desactive el modo TCF.

Configuración de restricciones globales para proveedores

El metabox Restricciones globales de proveedores le permite aplicar restricciones a todos los proveedores a la vez en toda la editorial.

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

  • Permitir interés legítimo (predeterminado): los proveedores pueden utilizar el interés legítimo como base jurídica para determinados fines.
  • No permitir el interés legítimo para todos los fines: obliga 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.
  • No permitir el interés legítimo para fines específicos: le 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 su asesor legal les aconseje lo contrario. Desactivar los intereses legítimos de forma global es un enfoque más estricto que prefieren algunos sitios web centrados en la privacidad.

Configuración de declaraciones de editor

El metabox «Declaraciones del editor» le permite declarar para qué fines usted (el editor) procesa los datos directamente, independientemente de sus proveedores.

Para cada propósito, puedes declarar:

  • Consentimiento: Usted procesa datos para este fin y solicita el consentimiento del usuario.
  • Transparencia del interés legítimo: Usted procesa los datos para este fin en virtud de un interés legítimo.

Estas declaraciones rellenan el publisher sección de la cadena TC. No modifique estos ajustes a menos que procese directamente datos de usuario con fines específicos que vayan más allá de lo que gestionan sus proveedores.

Selección de proveedores

Desplácese hacia abajo hasta la sección de la lista de proveedores. Verá una lista en la que puede buscar y ordenar todos los proveedores registrados en la IAB de la Lista global de proveedores.

Lista de selección de proveedores de IAB

Para gestionar proveedores:

  1. Utilice la barra de búsqueda para encontrar proveedores específicos por nombre o ID de proveedor.
  2. Utilice el filtro de estado para mostrar todos los proveedores, solo los seleccionados o solo los no seleccionados.
  3. Utilice el menú desplegable de clasificación para organizar por nombre o ID de proveedor en orden ascendente o descendente.
  4. Marque o desmarque la casilla situada junto a cada proveedor. También puede hacer clic en cualquier parte del encabezado de la fila del proveedor para alternar la selección.
  5. Haga clic en el botón de flecha de una fila de proveedor para ampliar sus detalles. Esto muestra los fines, los fines de interés legítimo, los fines especiales y los enlaces a las políticas.

De forma predeterminada, todos los proveedores están seleccionados la primera vez que visitas esta página. Te recomendamos desmarcar los proveedores que no utilizas para reducir la longitud de tu aviso de consentimiento y mejorar la transparencia para tus visitantes.

Cada entrada de proveedor muestra:

  • Nombre e identificación del proveedor: el nombre registrado en la 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 reclamación por interés legítimo: abre la reclamación por interés legítimo del proveedor (si está disponible).
  • Restricciones por proveedor: amplíe los detalles del proveedor para configurar restricciones por proveedor y solicitar el consentimiento para fines específicos de interés legítimo.

Guardar la configuración de TCF

Para aplicar los cambios, haz clic en Guardar cambios en la parte inferior de la página IAB TCF. El complemento guarda los proveedores seleccionados, las restricciones de los editores, las declaraciones de los editores y el estado de habilitación del TCF. También borra la caché de las preferencias para que el frontend refleje los cambios inmediatamente.

Probando el banner frontal

Abre tu sitio web en una ventana de navegador privada o de incógnito. Verás un banner modal que cumple con el TCF.

Banner modal TCF en la interfaz de usuario

El banner modal incluye:

  • Un mensaje estandarizado que describe el procesamiento de datos y las asociaciones con proveedores, mostrando el número real de proveedores seleccionados.
  • Una sección sobre fines del tratamiento de datos en la que se enumeran todos los fines de la IAB con el número de proveedores (por ejemplo, «3 solicitan consentimiento, 2 utilizan interés legítimo»).
  • Una sección de Funciones especiales si alguno de los proveedores seleccionados utiliza funciones especiales, como la geolocalización precisa.
  • Aviso sobre intereses legítimos (si alguno de los proveedores seleccionados utiliza intereses legítimos).
  • Ámbito del consentimiento e información sobre su retirada.
  • Un enlace «Ver lista de proveedores » que abre la ventana modal de preferencias directamente en la pestaña «Proveedores».
  • 3 botones: Aceptar todo, Rechazar todo y Administrar configuración.

Revisión del modal de preferencias

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

Pestaña «Propósitos»:

  • Sección de categorías TCF no IAB (esenciales, marketing, estadísticas, etc.) con sus botones de activación/desactivación estándar.
  • Sección «Objetivos» del TCF de la IAB, en la que se muestra la descripción, ilustraciones, recuento de proveedores y un enlace «Ver lista de proveedores» para cada objetivo.
  • Sección «Fines especiales» que muestra las actividades de tratamiento que no requieren consentimiento (seguridad, prevención del fraude, entrega técnica).
  • Una declaración sobre el almacenamiento de cadenas TC que explica que las opciones de consentimiento se guardan en localStorage y en una cookie durante un máximo de 12 meses.

Objetivos de IAB en el modal de preferencias

Pestaña Características:

  • Sección de características que enumera las capacidades técnicas que los proveedores utilizan para respaldar el procesamiento de datos. Estas no requieren consentimiento por separado.
  • Sección de funciones especiales con botones para activar o desactivar funciones que requieren consentimiento explícito, como «Usar datos de geolocalización precisos» y «Escanear activamente las características del dispositivo para su identificación».

Pestaña Proveedores:

  • Una barra de búsqueda con un botón de filtro. El menú desplegable del filtro te permite limitar los proveedores por finalidad, finalidad especial o característica especial.
  • Alternar maestro para Consentimiento e Interés legítimo en la parte superior de la lista.
  • Cada fila de proveedores muestra el nombre del proveedor con botones de consentimiento e interés legítimo.
  • Al ampliar un proveedor, se muestra información detallada: fines, fines de interés legítimo, fines especiales, características, categorías de datos, períodos de conservación de datos, duración del almacenamiento de cookies, enlace a la política de privacidad y enlace a la divulgación de intereses legítimos.
  • Los chips de filtro activo muestran los criterios de filtro seleccionados actualmente.

Aparece un botón Rechazar todo junto a Guardar configuración en el pie de página modal de preferencias para el cumplimiento de la TCF.

Cómo cambia el TCF de la IAB el WPConsent

Cuando se habilita el modo TCF, cambian varios comportamientos básicos. Comprender estos cambios le ayudará a solucionar problemas y establecer expectativas.

Las categorías de cookies estándar (marketing, estadísticas, etc.) se conservan como «Categorías no TCF de la IAB» y se muestran en una sección separada. Los fines de la IAB se convierten en el mecanismo de consentimiento principal. Los botones de edición y eliminación están ocultos tanto para las categorías de fines de la IAB como para la categoría Esencial. Para saber cómo funcionan las categorías en el modo no TCF, consulte la gestión de categorías de cookies.

El diseño del banner se fuerza al estilo modal independientemente de la configuración del diseño del banner. Los diseños de barra y esquina no están permitidos según la política IAB TCF v2.2, ya que el mensaje de consentimiento debe ser destacado y claro.

Textos y mensajes de los botones aplicados

Las etiquetas de los botones y los mensajes de los banners se sustituyen por texto que cumple con las normas de la IAB. Las etiquetas personalizadas de los botones y los mensajes de los banners se restauran cuando se desactiva el modo TCF. Los textos aplicados son:

ElementoTexto impuesto
Botón AceptarAceptar todo
Botón RechazarRechazar todo
Botón PreferenciasGestionar ajustes
Botón Guardar preferenciasGuardar configuración

Botón flotante siempre habilitado

El botón flotante «Preferencias de cookies» se activa de forma obligatoria cuando TCF está activo. La política C(f) de IAB TCF exige que la interfaz de usuario de consentimiento sea fácil de volver a mostrar para que los usuarios puedan revisar y cambiar sus preferencias en cualquier momento.

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

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

Integración de la API de CMP

El __tcfapi() La función estará disponible globalmente en su sitio web. Una versión stub se carga al principio del sección de cada página para que esté disponible antes de que se ejecuten los scripts de los proveedores. La API CMP completa se inicializa después de que se cargue el banner.

Uso de scripts de terceros __tcfapi() a:

  • Consultar el estado del consentimiento para fines y proveedores específicos.
  • Escucha los cambios de consentimiento a través de las devoluciones de llamada de eventos.
  • Recuperar la cadena TC codificada.

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

Ejemplo: Comprobación del 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]);
    }
});

Tratamiento basado en el interés legítimo

Algunos fines de la IAB respaldan el interés legítimo como base jurídica. Se trata de fines en los que los proveedores pueden tratar datos sin consentimiento explícito, a menos que el usuario se oponga. En el modal de preferencias:

  • La pestaña «Finalidades» muestra el número de proveedores que «solicitan el consentimiento» y «utilizan el interés legítimo» por finalidad.
  • La pestaña Proveedores muestra botones separados para Consentimiento e Interés legítimo para cada proveedor.
  • El interés legítimo está activado por defecto (marcado). Los proveedores procesan los datos bajo interés legítimo a menos que el usuario se oponga activamente.
  • Las opciones principales situadas 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 de una sola vez.

Puede restringir el interés legítimo de forma global o por proveedor utilizando las restricciones globales para proveedores y la configuración de restricciones individuales para proveedores en el panel de administración.

Carga y almacenamiento en caché de GVL

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

El GVL se almacena en caché localmente en el /wp-content/uploads/wpconsent/cache/ directorio. La duración de la caché sigue los encabezados de caché HTTP del servidor IAB (normalmente 24 horas). Si el servidor no está disponible, WPConsent utiliza la versión almacenada previamente en la caché como alternativa. Si no existe ninguna versión almacenada en la caché, la lista de proveedores muestra un estado de error y vuelve a intentarlo después de 1 hora.

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

Restricciones del editor en la cadena TC

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

  • NOT_ALLOWED (0): El propósito no está permitido para un proveedor específico. El proveedor no puede procesar datos para este propósito, independientemente del consentimiento del usuario.
  • REQUIRE_CONSENT (1): El propósito requiere consentimiento explícito en lugar de interés legítimo. El proveedor no puede basarse en el interés legítimo para este propósito.

Estas restricciones comunican sus políticas de procesamiento de datos a los proveedores cuando descodifican la cadena TC.

Verificación de la configuración

Después de habilitar IAB TCF v2.2, confirme que funciona correctamente.

Comprobación de la generación de cadenas TC

  1. Abre la consola de desarrollador de tu navegador (F12).
  2. Tipo __tcfapi('getTCData', 2, console.log) y pulse Intro.
  3. Buscar tcString en la salida registrada.
  4. La cadena contiene datos de consentimiento codificados.
  5. Verificar cmpId es 482 en la salida.

Comprobación de la disponibilidad de la API de CMP

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

  1. Abre DevTools y ve a la pestaña Aplicación.
  2. Buscar wpconsent_tcstring en ambos Almacenamiento local y Cookies.
  3. Después de aceptar o rechazar el consentimiento, la cadena TC se actualiza en ambas ubicaciones.

Validación con el validador de IAB

Utilice la herramienta de validación TCF de la IAB para comprobar el cumplimiento:

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

Solución de problemas

Propósitos que no aparecen

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

Solución: La Lista global de proveedores (GVL) aún no se ha cargado. Compruebe que:

  • Su servidor puede realizar solicitudes HTTPS salientes a vendor-list.consensu.org.
  • El /wp-content/uploads/wpconsent/cache/ El directorio es escribible por su servidor web.
  • Intenta actualizar la página IAB TCF 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 DevTools, ve a Aplicación, luego a Almacenamiento local y busca un wpconsent_tcstring entrada.
  • Comprueba DevTools, luego Aplicación, luego Cookies para un wpconsent_tcstring cookie.
  • Si no aparecen, comprueba que las cookies y el almacenamiento local no estén bloqueados por la configuración del navegador, los bloqueadores de anuncios o las extensiones de privacidad.

Síntoma: los proveedores de IAB no se cargan después de que se concede el consentimiento.

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

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

Solución: El modo TCF impone el diseño modal para el cumplimiento de las políticas. Si se producen conflictos CSS:

  • El banner de WPConsent se muestra dentro de un Shadow DOM, que aísla sus estilos de tu tema y otros plugins por diseño. Reglas CSS externas dirigidas a .wpconsent-banner No se puede acceder a los elementos dentro del Shadow DOM. Para personalizar los estilos de los banners, utilice la configuración de estilo de banners en WPConsent o añada variables CSS que el Shadow DOM herede.
  • Verifica que JavaScript no interfiera con la visualización modal.
  • El diseño modal de TCF no se puede cambiar al estilo de barra o esquina mientras TCF está activo.

Las pestañas modales de preferencias no se cargan.

Síntoma: La pestaña «Funciones» o «Proveedores» del modal de preferencias muestra contenido vacío.

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

  • El iab-tcf.js El script se carga correctamente (comprueba si hay errores en la pestaña Red de DevTools).
  • El archivo de caché GVL está disponible 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 utilizo Google Analytics?

No. Si solo utiliza proveedores que no pertenecen a la 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 la IAB.

¿Se perderán mis ajustes personalizados del banner cuando active TCF?

No. Las etiquetas personalizadas de los botones, el mensaje del banner y la configuración del diseño se conservan. El modo TCF los anula temporalmente mientras está activo. Cuando desactivas el modo TCF, se restauran los ajustes originales.

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

No. La política IAB TCF v2.2 exige que el banner se muestre como una superposición modal a pantalla completa. No se permiten diseños en barra ni en esquina. El diseño vuelve a la configuración preferida cuando se 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 garantizar que no se pase nada por alto. Le recomendamos que desmarque los proveedores que no utiliza para acortar su solicitud de consentimiento y mejorar la transparencia.

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

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

Conclusión

Ya ha configurado la compatibilidad con IAB TCF v2.2 en WPConsent. Su sitio genera cadenas TC compatibles y proporciona a los visitantes controles de consentimiento detallados para los proveedores registrados en IAB. Recuerde verificar su configuración con la herramienta de validación IAB TCF y revisar periódicamente su selección de proveedores a medida que cambien sus asociaciones publicitarias.

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

¿Le ha resultado útil este artículo?

Artículos relacionados