Cómo leer una cadena de consentimiento TCF: guía de campo para desarrolladores

Qué es realmente la TC string

El IAB Transparency & Consent Framework produce un único token compacto — la TC string — que viaja con cada solicitud de anuncio y le dice a los proveedores exactamente con qué ha aceptado y con qué no ha aceptado un usuario. Está codificada en Base64-URL y empaquetada a nivel de bits, por lo que parece un galimatías (CPxy...AAA) pero codifica un registro preciso y auditable.

Los segmentos

Una TC string completa son varios segmentos separados por puntos. El primero es la cadena central; los demás son opcionales:

Los campos de bits son el núcleo: el bit N puesto a 1 significa consentimiento para el propósito N o el proveedor N. El propósito 1 es “almacenar/acceder a información en un dispositivo,” los propósitos 3 y 4 cubren los anuncios personalizados, y así sucesivamente.

Decodificar una en la práctica

Rara vez decodificas bits a mano. Usa las bibliotecas proporcionadas por IAB o un decodificador público:

En JavaScript, la llamada __tcfapi('getTCData', 2, cb) devuelve el objeto ya analizado — tcData.purpose.consents y tcData.vendor.consents son mapas de id → booleano. Esa es tu verdad de referencia en tiempo de ejecución.

Los errores que matan los ingresos

Cuando la demanda personalizada desaparece silenciosamente, la TC string suele ser el motivo:

Un flujo de depuración

Reproduce el consentimiento del usuario, captura la TC string en vivo desde __tcfapi o la solicitud de anuncio, pásala por un validador y compara los propósitos/proveedores decodificados con lo que requieren tus socios. Nueve de cada diez veces la brecha es un único bit de proveedor o un propósito 1 ausente.

Dónde encaja FlexyConsent

FlexyConsent genera TC strings válidas según la especificación con un ID de CMP registrado, las mantiene frescas, expone el estado decodificado para depuración e informa de qué propósitos y proveedores están realmente concedidos en todo tu tráfico — para que puedas ver, no adivinar, dónde se está fugando el consentimiento (y los ingresos).

Puntos clave

← Blog Leer todo →