Decodificador de Consent String TCF
Decodifique uma consent string TCF v2.2 da IAB no seu navegador para ver os metadados do CMP, as grades de purpose e vendor e as restrições de publisher.
O Decodificador de Consent String TCF roda inteiramente no seu navegador. A consent string que você cola é decodificada no seu dispositivo, nunca é enviada à ArrayKit, e nenhuma Global Vendor List ou endpoint remoto é contatado.
Abrir o Codificador de Consent String TCF
Sobre Decodificador TCF
O Decodificador de Consent String TCF desmonta uma string TCF Transparency & Consent (TC) para que times de ad-ops e engenheiros de privacidade vejam exatamente o que um CMP registrou. Cole a string base64url e ele decodifica o segmento core localmente: o id e a versão do CMP, a tela e o idioma em que a escolha foi capturada, os timestamps de criação e última atualização, a versão da Global Vendor List e a versão da política TCF. Depois expande cada bitfield em listas legíveis de ids — purpose consents, purpose legitimate interests, opt-ins de special feature, vendor consents, vendor legitimate interests e quaisquer restrições de publisher. Use-o para depurar um handshake de consentimento com falha, auditar o que uma tag de fato armazenou ou confirmar um valor antes que ele chegue ao seu ad server. A string é decodificada no seu navegador e nunca sai do seu dispositivo.
Recursos
- Decodifica os metadados do segmento core do TCF v2.2: id, versão, tela e idioma de consentimento do CMP
- Expande purpose consents e purpose legitimate interests em listas de ids legíveis
- Mostra opt-ins de special feature ao lado das grades de vendor consent e legitimate interest
- Expõe restrições de purpose de publisher com seu tipo de restrição e vendors afetados
- Exibe timestamps de criação e última atualização mais a versão da Global Vendor List
- Sinaliza escopo service-specific vs global, textos não padronizados e suporte a OOB
- Copie qualquer lista de ids como string separada por vírgulas para um relatório de bug ou chamado
- Roda inteiramente no seu navegador — a consent string nunca é enviada
Como usar Decodificador TCF
- Copie a TC string de um cookie de CMP, um callback __tcfapi ou um campo user.ext.consent do OpenRTB
- Cole-a no decodificador, ou clique em Sample para carregar uma TC string de exemplo
- Leia os metadados do CMP, depois percorra as grades de purpose, special feature e vendor
- Copie qualquer lista de ids para compartilhar o estado exato de consentimento com sua equipe
Exemplo
Entrada
COvFyGBOvFyGBAbAAAENAPCAAOAAAAAAAAAAAEEUACCKAAA
Saída
CMP 27 · policy v2 · language EN · GVL 15
purposeConsents: 1, 2, 3
vendorConsents: 2, 6, 8
Uma TC string apenas de core decodificada em seus metadados de CMP e grades de consentimento.
Erros comuns e solução de problemas
- O decodificador informa que a string não é uma TC string válida. — Cole a TC string base64url inteira sem aspas ao redor nem quebras de linha. Um segmento core truncado ou uma cópia com URL-encoding (%3D no lugar de =) falha na decodificação.
- As listas de purpose ou vendor parecem mais curtas do que o esperado. — Uma TC string só armazena ids que o CMP definiu explicitamente. Ids ausentes não foram consentidos. Confirme que você colou a string completa e não só o segmento antes do primeiro ponto.
- Os timestamps parecem defasados em várias horas. — Timestamps do TCF são armazenados com precisão de dia em UTC. O decodificador os mostra em UTC, então converta para o seu fuso local antes de compará-los com um log local.
- Você esperava nomes de vendor mas só vê números. — Nomes de vendor e purpose vêm da Global Vendor List da IAB, que esta ferramenta não busca. Compare o id numérico com a versão da Global Vendor List mostrada nos metadados.
Perguntas frequentes
- O que é uma consent string TCF da IAB?
- Uma string TCF (Transparency & Consent Framework) é um registro compacto base64url que uma Consent Management Platform grava para armazenar as escolhas de consentimento de ad-tech de um usuário — quais purposes, special features e vendors ele permitiu. Tags de anúncio e requests OpenRTB a carregam para que vendors subsequentes saibam o que podem fazer.
- Por que o decodificador mostra números de vendor e purpose em vez de nomes?
- Nomes de vendor e purpose ficam na Global Vendor List da IAB, que é carregada pela rede. Esta ferramenta decodifica apenas a string que você cola e não faz chamadas de rede, então mostra os ids numéricos exatamente como codificados. Consulte um id na Global Vendor List atual para obter o nome do vendor.
- Onde encontro a TC string para colar?
- Ela fica armazenada no cookie euconsent-v2, é retornada pela chamada __tcfapi('getTCData', ...) do CMP e é passada em um bid request OpenRTB como user.ext.consent. Copie qualquer um desses valores base64url e cole-o no decodificador.
- Qual a diferença entre escopo service-specific e global?
- O bit isServiceSpecific registra se o consentimento foi armazenado para um site ou serviço (true) ou no escopo global compartilhado consensu.org (false). O decodificador expõe esse bit para você saber quão portátil o sinal é entre propriedades.
- Decodificar uma TC string altera ou a re-assina?
- Não. A decodificação é somente leitura — ela interpreta os bits existentes sem recodificar, re-assinar ou alterar a string. Sua TC string original permanece inalterada e é sempre apenas lida localmente no seu navegador.
- Ele consegue ler restrições de publisher e segmentos extras?
- Sim. Ele decodifica completamente o segmento core e lista as restrições de purpose de publisher com seu tipo de restrição e vendors afetados. Campos que uma string não inclui — como segmentos opcionais ausentes — simplesmente aparecem vazios.
Ferramentas relacionadas
Todas as ferramentas de ArrayKit