Codificador de cadenas de consentimiento TCF
Construye una cadena IAB TCF v2.2 Transparency & Consent (TC) a partir de la configuración del CMP, consentimientos de propósito, special features e ids de vendor, codificada en tu navegador.
El Codificador de cadenas de consentimiento TCF funciona por completo en tu navegador. Tu configuración del CMP, tus selecciones de propósito y tus ids de vendor se codifican en tu dispositivo, no se descarga ninguna Global Vendor List, y nada se sube a ArrayKit.
Abre el Decodificador de consentimiento TCF
Acerca de Codificador de consentimiento TCF
El Codificador de cadenas de consentimiento TCF construye una cadena IAB TCF v2.2 Transparency & Consent (TC) a partir de un formulario: establece tu CMP ID, versión del CMP, pantalla de consentimiento, idioma del consentimiento, versión de la lista de vendors y versión de la política TCF, luego alterna los consentimientos de propósito (1-11), los intereses legítimos de propósito, los opt-ins de special feature y una lista de ids de consentimiento de vendor. Ensambla un TCModel válido y produce la cadena TC base64url que puedes pegar en un fixture de CMP, una configuración de Prebid, una solicitud de anuncio o una prueba de QA. Es útil cuando ingenieros de ad-ops y desarrolladores de CMP necesitan una cadena determinista para reproducir un escenario de consentimiento o depurar por qué se está descartando un partner de demanda. Cada campo se codifica en tu dispositivo: no se llama a ninguna API de CMP y no se descarga ninguna global vendor list de la red, así que los datos de consentimiento de prueba nunca salen de tu navegador.
Características
- Establece el CMP ID, la versión del CMP, la pantalla de consentimiento y el idioma del consentimiento desde campos simples
- Elige la versión de la lista de vendors, la versión de la política TCF y el ámbito service-specific frente a global
- Alterna los 11 propósitos registrados para consentimiento y para interés legítimo
- Opta por las dos special features (geolocalización precisa, escaneo de dispositivo)
- Codifica una lista separada por comas de ids de consentimiento de vendor en la sección de vendors
- Produce una cadena TC base64url que puedes copiar con un clic
- Codificación determinista para que las mismas selecciones siempre den la misma cadena
- Funciona por completo en tu navegador sin descargar ninguna lista de vendors de la red
Cómo usar Codificador de consentimiento TCF
- Introduce tu CMP ID, la versión del CMP, la pantalla de consentimiento y el idioma del consentimiento de dos letras
- Establece la versión de la lista de vendors, la versión de la política TCF y el interruptor de ámbito de almacenamiento
- Marca los propósitos, intereses legítimos y special features que el usuario aceptó
- Escribe los ids de consentimiento de vendor como una lista separada por comas
- Copia la cadena TC codificada y pégala en tu CMP, solicitud de anuncio o fixture de prueba
Ejemplo
Entrada
cmpId: 300, cmpVersion: 1, lang: EN
purposeConsents: 1,2,3,4,7
vendorConsents: 1,8,755
Salida
COzTVhaOzTVhaGvAAAENAiCIAP_AAH_AAAAAAAAA... (base64url TC string)
Los propósitos seleccionados y los ids de vendor se empaquetan en una cadena core de TCF v2.2.
Errores comunes y solución de problemas
- Un id de vendor que añadiste falta cuando se decodifica la cadena. — El codificador TCF valida los consentimientos de vendor contra una lista de vendors. Esta herramienta declara cada id que introduces para que sobreviva: decodifica la salida aquí o en el Decodificador de consentimiento TCF para confirmar que el bit del vendor está activado.
- El idioma del consentimiento decodificado no es el que escribiste. — TCF v2.2 fuerza el idioma del consentimiento a dos letras mayúsculas (EN, FR, DE). Introduce exactamente dos letras; la herramienta las pone en mayúscula antes de codificar.
- Un CMP posterior rechaza la cadena con un error de cmpId. — Los CMP ID de 0 y 1 están reservados y muchos decodificadores los rechazan. Usa el CMP ID real asignado por el IAB (un entero mayor que 1).
- La versión de la lista de vendors en la cadena decodificada difiere de tu entrada. — La versión de la lista de vendors y la versión de la política TCF codificadas provienen de los valores que introduces en los campos de metadatos: ajústalos para que coincidan con la GVL que ejecuta tu CMP.
Preguntas frecuentes
- ¿Qué es un codificador de cadenas de consentimiento TCF?
- Es una herramienta que convierte la configuración del CMP y las elecciones de consentimiento del usuario —propósitos, intereses legítimos, special features e ids de vendor— en una cadena IAB TCF v2.2 Transparency & Consent (TC), el valor base64url que los CMP pasan a los vendors y las solicitudes de anuncios.
- ¿Qué versión de TCF produce este codificador?
- Construye cadenas core de TCF v2.2. Tú controlas los campos de versión de la política TCF y versión de la lista de vendors, y la salida es una cadena TC base64url estándar que los CMP y decodificadores compatibles con TCF pueden leer.
- ¿Cómo añado consentimientos de vendor a la cadena?
- Escribe los ids de vendor del IAB en el campo de consentimiento de vendor como una lista separada por comas o espacios (por ejemplo 1, 8, 755). Cada id se codifica en la sección de consentimiento de vendor de la cadena TC.
- ¿Por qué el idioma del consentimiento debe ser de dos letras?
- La especificación TCF almacena el idioma del consentimiento como un código ISO-639-1 de dos caracteres. El codificador pone en mayúscula y valida tu entrada, así que introduce códigos como EN, FR o DE en lugar de nombres de idioma completos.
- ¿La codificación descarga la Global Vendor List de un servidor?
- No. Para quedarse por completo en tu navegador, la herramienta construye una lista de vendors mínima en memoria a partir de los ids que introduces en lugar de descargar la GVL. Tu configuración del CMP y tus ids de vendor nunca se envían a ninguna parte.
- ¿Puedo decodificar una cadena que construí aquí?
- Sí. Pega la salida codificada en el Decodificador de consentimiento TCF para inspeccionar los campos del CMP, los propósitos y los vendors y confirmar que la cadena da la vuelta completa como se esperaba.
Herramientas relacionadas
Todas las herramientas de ArrayKit