Codificador de Consent String TCF
Monte uma string TCF v2.2 Transparency & Consent (TC) da IAB a partir de configurações do CMP, purpose consents, special features e ids de vendor — codificada no seu navegador.
O Codificador de Consent String TCF roda inteiramente no seu navegador. Suas configurações do CMP, seleções de purpose e ids de vendor são codificadas no seu dispositivo, nenhuma Global Vendor List é buscada, e nada é enviado à ArrayKit.
Abrir o Decodificador de Consent TCF
Sobre Codificador TCF
O Codificador de Consent String TCF monta uma string TCF v2.2 Transparency & Consent (TC) da IAB a partir de um formulário: defina seu CMP ID, versão do CMP, tela de consentimento, idioma de consentimento, versão da vendor list e versão da política TCF, depois alterne purpose consents (1-11), purpose legitimate interests, opt-ins de special feature e uma lista de ids de vendor consent. Ele monta um TCModel válido e produz a TC string base64url que você pode colar em um fixture de CMP, uma config Prebid, um ad request ou um teste de QA. É útil quando engenheiros de ad-ops e desenvolvedores de CMP precisam de uma string determinística para reproduzir um cenário de consentimento ou depurar por que um parceiro de demanda está sendo descartado. Cada campo é codificado no seu dispositivo — nenhuma API de CMP é chamada e nenhuma global vendor list é buscada na rede, então dados de consentimento de teste nunca saem do seu navegador.
Recursos
- Defina CMP ID, versão do CMP, tela de consentimento e idioma de consentimento a partir de campos simples
- Escolha a versão da vendor list, a versão da política TCF e o escopo service-specific vs global
- Alterne todos os 11 purposes registrados para consent e para legitimate interest
- Faça opt-in nas duas special features (geolocalização precisa, varredura de dispositivo)
- Codifique uma lista separada por vírgulas de ids de vendor consent na seção de vendor
- Gera uma TC string base64url que você copia com um clique
- Codificação determinística, então as mesmas seleções sempre geram a mesma string
- Roda inteiramente no seu navegador sem nenhuma vendor list buscada na rede
Como usar Codificador TCF
- Insira seu CMP ID, versão do CMP, tela de consentimento e o idioma de consentimento de duas letras
- Defina a versão da vendor list, a versão da política TCF e o toggle de escopo de armazenamento
- Marque os purposes, legitimate interests e special features que o usuário fez opt-in
- Digite os ids de vendor consent como uma lista separada por vírgulas
- Copie a TC string codificada e coloque-a no seu CMP, ad request ou fixture de teste
Exemplo
Entrada
cmpId: 300, cmpVersion: 1, lang: EN
purposeConsents: 1,2,3,4,7
vendorConsents: 1,8,755
Saída
COzTVhaOzTVhaGvAAAENAiCIAP_AAH_AAAAAAAAA... (base64url TC string)
Os purposes e ids de vendor selecionados são empacotados em uma string core TCF v2.2.
Erros comuns e solução de problemas
- Um id de vendor que você adicionou está faltando quando a string é decodificada. — O codificador TCF valida vendor consents contra uma vendor list. Esta ferramenta declara cada id que você insere para que ele sobreviva — decodifique a saída aqui ou no Decodificador de Consent TCF para confirmar que o bit do vendor está definido.
- O idioma de consentimento decodificado não é o que você digitou. — O TCF v2.2 força o idioma de consentimento a duas letras maiúsculas (EN, FR, DE). Insira exatamente duas letras; a ferramenta as coloca em maiúsculas antes de codificar.
- Um CMP subsequente rejeita a string com um erro de cmpId. — Os CMP IDs 0 e 1 são reservados e muitos decodificadores os rejeitam. Use o CMP ID real atribuído pela IAB (um inteiro maior que 1).
- A versão da vendor list na string decodificada difere da sua entrada. — A versão da vendor list codificada e a versão da política TCF vêm dos valores que você insere nos campos de metadados — defina-os para corresponder à GVL que seu CMP está executando.
Perguntas frequentes
- O que é um codificador de consent string TCF?
- É uma ferramenta que transforma configurações do CMP e escolhas de consentimento do usuário — purposes, legitimate interests, special features e ids de vendor — em uma string TCF v2.2 Transparency & Consent (TC), o valor base64url que CMPs passam a vendors e ad requests.
- Qual versão do TCF este codificador produz?
- Ele monta strings core TCF v2.2. Você controla os campos de versão da política TCF e versão da vendor list, e a saída é uma TC string base64url padrão que CMPs e decodificadores compatíveis com TCF conseguem ler.
- Como adiciono vendor consents à string?
- Digite os ids de vendor da IAB no campo de vendor consent como uma lista separada por vírgulas ou espaços (por exemplo 1, 8, 755). Cada id é codificado na seção de vendor consent da TC string.
- Por que o idioma de consentimento deve ter duas letras?
- A especificação TCF armazena o idioma de consentimento como um código ISO-639-1 de dois caracteres. O codificador coloca em maiúsculas e valida sua entrada, então insira códigos como EN, FR ou DE em vez de nomes completos de idiomas.
- A codificação busca a Global Vendor List de um servidor?
- Não. Para permanecer totalmente no seu navegador, a ferramenta monta uma vendor list mínima em memória a partir dos ids que você insere em vez de baixar a GVL. Suas configurações do CMP e ids de vendor nunca são enviados a lugar nenhum.
- Posso decodificar uma string que montei aqui?
- Sim. Cole a saída codificada no Decodificador de Consent TCF para inspecionar os campos do CMP, purposes e vendors e confirmar que a string faz o ciclo de ida e volta como esperado.
Ferramentas relacionadas
Todas as ferramentas de ArrayKit