Decodificador de String GPP
Decodifique uma consent string GPP da IAB no seu navegador — header, gpp_sid e cada seção embutida, expandidos em campos legíveis. A string fica no seu dispositivo.
O Decodificador de String GPP roda inteiramente no seu navegador. A consent string que você cola — e tudo o que ela decodifica — fica no seu dispositivo e nunca é enviada a um CMP, ad server ou à ArrayKit.
Abrir o Decodificador de Consent String TCF
Sobre Decodificador GPP
O Decodificador de String GPP desmonta uma consent string do IAB Global Privacy Platform em algo que você consegue de fato ler. Cole o valor codificado de um CMP, do campo regs.gpp de um bid request OpenRTB ou de um cookie armazenado, e a ferramenta decodifica o header — a versão GPP e a lista gpp_sid — mais cada seção embutida, do TCF Europe v2 ao US Privacy (uspv1) e sinais de estados dos EUA como usnat e usca. Cada seção é expandida em campos nomeados como CmpId, purpose consents, opt-outs de venda e flags de MSPA. Foi feito para engenheiros de ad-ops, times de privacidade e QA que depuram o encanamento de consentimento em toda a supply programática. Toda a decodificação roda no seu dispositivo — a string GPP que você cola nunca é enviada a um CMP, ad server ou qualquer endpoint.
Recursos
- Decodifica o header GPP — a versão de codificação e a lista de ids de seção gpp_sid
- Expande cada seção embutida: TCF Europe v2, TCF Canada, US Privacy (uspv1), usnat, usca e outras seções de estados dos EUA
- Mostra os campos de cada seção pelo nome — CmpId, purpose consents, opt-outs e flags de MSPA
- Visões JSON legível e bruta, com cópia de um clique para a decodificação inteira ou uma única seção
- Resume vetores de bits booleanos como os índices habilitados para que flags longas de consentimento TCF fiquem legíveis
- Trata strings multi-seção e reporta exatamente onde uma string malformada falha ao decodificar
- Carrega uma string GPP de exemplo para você ver o formato da saída decodificada na hora
- Roda inteiramente no seu navegador — a consent string nunca sai do seu dispositivo
Como usar Decodificador GPP
- Copie uma string GPP do seu CMP, de um campo regs.gpp do OpenRTB ou de um valor __gpp armazenado
- Cole-a na caixa de entrada, ou clique em Sample para carregar uma string de exemplo
- Leia o header decodificado e os campos de cada seção, ou mude para a visão JSON
- Copie a decodificação completa ou uma seção para anexar a um relatório de bug ou chamado
Exemplo
Entrada
DBABTC~1YNN
Saída
header: { version: 1, gpp_sid: [6] }
uspv1: { Version: 1, Notice: "Y", OptOutSale: "N", LspaCovered: "N" }
Uma string US Privacy (uspv1): aviso dado, sem opt-out de venda, não coberta por LSPA.
Erros comuns e solução de problemas
- O decodificador diz que o valor 'não parece uma string GPP.' — Strings GPP começam com um segmento de header base64url (geralmente 'DB…'). Uma string TCF pura começando com 'C' pertence ao Decodificador de Consent String TCF.
- Erro 'The number of sections does not match the header'. — Você provavelmente colou só o header ou perdeu um bloco '~'. Copie a string completa — o header mais uma seção separada por '~' para cada id em gpp_sid.
- Uma seção mostra menos campos do que você esperava. — Segmentos TCF opcionais, como publisher restrictions ou vendors-disclosed, só aparecem quando a string os carrega; sua ausência é esperada, não uma falha de decodificação.
- Você só se importa com o sinal de estado dos EUA, não com o TCF. — A lista gpp_sid diz quais seções estão presentes — leia só o card usnat ou usca e ignore o resto da decodificação.
Perguntas frequentes
- O que é uma string GPP da IAB?
- A string do Global Privacy Platform (GPP) é um único valor codificado que empacota múltiplos sinais de privacidade — TCF Europe, US Privacy e seções de estados dos EUA — atrás de um header. A lista gpp_sid do header nomeia quais seções estão dentro.
- O que é gpp_sid em uma string GPP?
- gpp_sid é o array de ids de seção no header GPP. Cada id mapeia para uma seção — 2 é TCF EU v2, 6 é US Privacy, 7 é usnat, 8 é usca — dizendo a um decodificador quais blocos seguem o header.
- Quais seções GPP este decodificador consegue ler?
- Ele decodifica o header mais TCF Europe v2, TCF Canada v1, US Privacy (uspv1), a seção nacional dos EUA (usnat) e as seções de estados dos EUA como usca, usva, usco e as demais, expandindo cada uma em campos nomeados.
- Posso colar uma string TCF pura ou US Privacy legada aqui?
- Esta ferramenta espera uma string GPP completa com um header. Uma string TCF isolada que começa com 'C', ou um valor US Privacy legado, deve ir para os decodificadores dedicados de TCF ou US Privacy.
- Decodificar uma string GPP me diz se um vendor é permitido?
- Não. O decodificador mostra o que a string codifica — opt-outs, purpose consents, flags de MSPA — mas não julga se um vendor específico pode processar dados; isso depende da sua política e das regras de cada seção.
- Onde encontro uma string GPP para decodificar?
- Procure no valor armazenado de um CMP, no campo regs.gpp de um bid request OpenRTB, no cookie __gpp ou entrada de localStorage, ou no gppString retornado pela chamada getGPPData da API do CMP.
Ferramentas relacionadas
Todas as ferramentas de ArrayKit