- TCF v2.1: vamos continuar a aceitar strings da TCF v2.1 e v2.2 geradas antes de 28 de fevereiro de 2026, de acordo com a política da TCF do IAB.
- Soluções de gestão de consentimento da Google: as soluções de gestão de consentimento da Google, disponíveis no separador Privacidade e mensagens do Ad Manager, AdSense e AdMob, são compatíveis com a TCF v2.3 para as respetivas mensagens sobre os regulamentos europeus, em conformidade com os requisitos atualizados do IAB para as CMPs.
Para ajudar os publicadores a gerir configurações incorretas e erros relacionados com o lançamento da Estrutura de Transparência e Consentimento v2.2 e v2.3 do IAB Europe, disponibilizamos um relatório de erros detetados.
Neste artigo, vai encontrar mais informações sobre a resolução de erros de implementação da TCF v2.2 e v2.3, incluindo:
Orientações atualizadas
Correções para erros comuns
Resolva alguns dos erros mais comuns no Ad Manager, AdSense e AdMob através das seguintes ações:
Pondere obter novamente o consentimento dos utilizadores através de strings de TC que resultem em solicitações de anúncios que não serão rentabilizadas(Erros 1.1, 3.1, 4.1, 5.1, 5.2 e 6.1)
Erros relacionados
Orientações atualizadas
Pondere solicitar novamente o consentimento dos utilizadores.
Fundamentação
Os publicadores irão beneficiar da nova solicitação de consentimento se tiverem usado anteriormente strings fora da banda de âmbito global, IDs de CMP inválidos (dos testes), IDs de GVL inválidos (dos testes) ou que tenham a Google em falta como fornecedor com o consentimento adequado em algum momento da implementação.
Erros 1.1, 1.2, 1.3: é importante verificar se estes erros representam um volume significativo de tráfego. Em caso afirmativo, é possível que exista um problema na CMP. Certifique-se de que é concedido à Google consentimento para os objetivos necessários e de que a Google está indicada como fornecedor com consentimento E interesse legítimo (ID do fornecedor 755).
Especificação do IAB
De acordo com as especificações do IAB, as CMPs podem colocar em cache strings de consentimento durante 13 meses.
AddEventHandler em 500 ms(Erros 2.1a, 2.1b, 2.0a, 2.0b e 2.0c)
Erros relacionados
Erro 2.1a. Esta orientação também pode ser aplicada aos erros 2.1b, 2.0a 2.0b e 2.0c.
Orientações atualizadas
Embora já não exista um requisito de limite de tempo, sugerimos que as CMPs revejam cuidadosamente as respetivas implementações para se assegurarem de que devolvem imediatamente as chamadas para AddEventListener getTCData.
Se uma CMP não responder, a solicitação pode não ser rentabilizada.
Fundamentação
A Google cumpre a especificação do IAB que indica que uma CMP deve responder imediatamente à função AddEventListener. Se uma CMP não responder imediatamente, a solicitação pode não ser rentabilizada.
Além disso, as respostas da CMP fazem parte da cadeia de eventos que influenciam a brevidade com que um pedido de anúncio pode ser feito. A diminuição do tempo entre o carregamento de página e as solicitações de anúncios resulta em menos impressões perdidas para o publicador.
Especificação do IAB
Especificação do IAB aplicável: especificação do AddEventListener (no GitHub)
AddEventListener deve ser chamada imediatamente após o registo com os dados de TC atuais, mesmo que o estado da CMP seja loading e a CMP tenha dados de TC incompletos. Isto permite que o script de chamada aceda ao respetivo listenerId registado. Além disso, após cada alteração da string de TC, a chamada de retorno deve ser chamada, a menos que seja removida através da opção RemoveEventListener.Centro de Políticas
O Centro de Políticas notifica os publicadores se uma app ou um site não estiver em conformidade com os requisitos de gestão de consentimento da Google.
Relatório de erros
Vamos notificar os publicadores na interface do utilizador do produto se detetarmos um problema na string de TC associada a um ou mais dos respetivos sites ou apps. Na página "Consentimento de utilizadores da UE" nas respetivas contas, os publicadores com erros podem clicar em Transferir relatório de erros da TCF para transferir um relatório detalhado dos erros detetados ao longo dos últimos 7 dias.
- Ad Manager: clique em Admin e, de seguida, em Consentimento de utilizadores da UE.
- AdMob: clique em Controlos de bloqueio e, de seguida, em Faça a gestão dos regulamentos europeus.
- AdSense: clique em Segurança da marca. Clique em Conteúdo, Controlos de bloqueio e, de seguida, em Faça a gestão dos regulamentos europeus.
O relatório vai conter as seguintes informações sobre cada um dos erros detetados:
- Domínio/MobileAppID: o site ou a app para dispositivos móveis com configuração incorreta.
- Caminho do bloco de anúncios: o bloco de anúncios associado ao erro.
- Código de erro: o código atribuído ao erro.
- Contagem de erros: o número de consultas que contêm o erro observadas na semana anterior.
- Data da última deteção: a última data em que o erro foi detetado.
Os publicadores podem usar os códigos de erros indicados no relatório para encontrarem as ações sugeridas a efetuar nas seguintes tabelas de resolução de problemas e resolverem os erros.
Resolução de problemas
Para ajudarmos os publicadores a corrigirem integrações da TCF v2.2 e v2.3 do IAB configuradas incorretamente, criámos as seguintes tabelas com os tipos de erros da string de TC mais comuns e as recomendações de resolução de problemas correspondentes.
Use as tabelas para conhecer os problemas que ocorrem ao nível do pedido de anúncio, bem como o comportamento do sistema correspondente.
Cenários de consentimento limitado
Estes três cenários têm sempre precedência sobre os erros de configuração incorreta, mesmo que uma determinada solicitação tenha vários erros.
| Cenário | Descrição | Ação sugerida |
|---|---|---|
| 1.1 | A Google, como fornecedor, não tem permissão por consentimento ou interesse legítimo. | Confirme se o utilizador rejeitou intencionalmente a Google como fornecedor, se ocorreram erros de implementação da CMP ou se existem restrições para publicadores. |
| 1.2 | Sem consentimento para o objetivo 1 para os países no EEE, no Reino Unido e na Suíça. |
Confirme se o utilizador não permitiu intencionalmente o objetivo 1 ou se tal se deve a erros de implementação da CMP. Os publicadores na Suíça devem certificar-se de que estão a definir os campos
PublisherCC e PurposeOneTreatment corretamente se não estiverem a pedir consentimento aos utilizadores. A partir de dezembro de 2021, vamos deixar de verificar o tratamento |
| 1.3 | Tem consentimento para o objetivo 1, mas não tem bases legais para os anúncios básicos. |
Confirme se o utilizador rejeitou intencionalmente interesses legítimos nos outros objetivos ou se tal se deve a erros de implementação da CMP. |
Erro de configuração
Quando estes problemas ocorrem, a Google tenta publicar anúncios limitados.
| Erro | Descrição | Ação sugerida |
|---|---|---|
| 2.1a | A etiqueta ou o SDK não está a receber uma string de TC devido ao estado da CMP ser stub, loading ou error. |
Se estiver a invocar manualmente a função para solicitar anúncios, certifique-se de que a resposta para Se não estiver a invocar manualmente a função para pedir anúncios, colabore com a sua CMP para garantir que esta implementa o suporte para |
| 2.1b |
Ambas as condições são cumpridas:
|
Peça à CMP para se certificar de que as APIs estão implementadas corretamente com base nas especificações técnicas da TCF do IAB. |
| 2.2a |
A string de TC não é analisável porque não está codificada em base64. Exemplo: |
As CMPs (ou os publicadores) devem enviar apenas dados codificados em base64 nos parâmetros gdpr_consent=. |
| 2.2b |
A string de TC não é analisável devido a um erro de descodificação. Exemplo: inclui um número incorreto de bits |
A CMP deve corrigir os erros de implementação da string de TC. |
| 2.2c |
A string de TC não é analisável devido a um erro de dados. Exemplo: data/hora incorreta, o ID do fornecedor é demasiado grande |
A CMP deve corrigir os erros de implementação da string de TC. |
Problemas com a string de TC
Problemas relacionados com a string de TC associada a um pedido de anúncio. Quando estes problemas ocorrem, a Google tenta publicar anúncios limitados.
| Erro | Descrição | Ação sugerida |
|---|---|---|
| 3.1 | ID da CMP inválido. |
Certifique-se de que está a ser usada uma CMP validada pelo IAB e de que o respetivo ID está definido corretamente nas strings de TC. Se uma CMP era válida quando uma string de TC foi gerada, mas foi eliminada posteriormente pelo IAB, tem de obter novamente o consentimento através de uma CMP válida. |
| 3.2 | Já não é usado. | Nenhuma. Significado anterior: a data de criação da string de TC foi há mais de 13 meses. |
O consentimento tem de ser obtido novamente
É necessário obter o consentimento do utilizador. Se estiver a usar uma versão da GVL na qual a Google ainda não está indicada, deve obter novamente o consentimento do utilizador. Caso contrário, a Google tenta publicar anúncios limitados.
| Erro | Descrição | Ação sugerida |
|---|---|---|
| 3.3 | Já não é usado. |
Nenhuma. Significado anterior: a data da última atualização da string de TC foi há mais de 13 meses. |
| 4.1 | A string de TC foi gerada com uma versão da GVL na qual a Google ainda não estava listada. | Obtenha novamente o consentimento com uma versão atual da GVL. |
Âmbito global e âmbito fora da banda
Na tabela abaixo, veja os problemas relacionados com o âmbito global e o âmbito fora da banda (Ad Manager, AdMob e AdSense). Quando estes problemas ocorrem, a Google tenta publicar anúncios limitados.
| Erro | Descrição | Ação sugerida |
|---|---|---|
| 5.1 | A string de TC permite o consentimento fora da banda. | Dê instruções à CMP para remover os sinais fora da banda das strings de TC. |
| 5.2 | String de TC de âmbito global. | Dê instruções à CMP para atualizar as strings de TC para serem específicas do serviço. |
Publicação de anúncios limitada
Serão publicados anúncios limitados.
| Erro | Descrição | Ação sugerida |
|---|---|---|
| 6.1 | A versão da string de TC é 1 ou 1.1 (string v1.0). |
A CMP deve enviar strings da TCF v2.2 ou v2.3. |
A Google trata dos problemas
Quando estes problemas ocorrem, a Google mitiga o problema, quando necessário, e prossegue com o processamento normal da TCF.
| Erro | Descrição | Ação sugerida |
|---|---|---|
| 7.1 | gdprApplies não está definido ou está definido para um valor inválido ou indecifrável, mas está presente uma string de TC válida. |
N/A |
| 7.2 | A string de TC foi gerada com uma versão da GVL mais recente do que a versão atual conhecida pela tecnologia de publicação de anúncios da Google. | N/A |
| 7.3 | Alguns objetivos, funcionalidades e/ou fornecedores estão fora do alcance (são desconhecidos). | N/A |
| 7.4 | A string de TC tem uma tcf_policy_version mais antiga do que a GVL mais recente. |
A CMP deve eliminar a string de TC mais antiga e obter novamente o consentimento com a GVL mais recente. |
| 7.5 |
Uma solicitação tem |
N/A |
| 7.6 | O código do país do publicador é inválido, mas o consentimento para o objetivo 1 está presente. | A CMP deve corrigir os erros de implementação da string de TC. |
| 7.7 | Código do idioma inválido. | A CMP deve corrigir os erros de implementação da string de TC. |
| 7.8 | O campo da versão da string de TC não é 1 nem 2. |
A CMP deve corrigir os erros de implementação da string de TC solicitando um novo consentimento se for detetada uma string de TC inválida. Se usar as soluções de gestão de consentimento da Google e o SDK da UMP na sua app, confirme que o SDK da UMP foi implementado corretamente e que |
| 7.9 | A versão da string de CA não é 1 nem 2. |
A CMP deve definir a versão da string de CA como 1 ou 2. |
Problemas com a string de CA
Quando estes problemas ocorrem, a Google trata a string de Consentimento Adicional (CA) como inválida e não são considerados fornecedores adicionais para além dos indicados na string de TC.
| Erro | Descrição | Ação sugerida |
|---|---|---|
| 8.1 | A string de CA não está a usar o separador de versão (~). |
A CMP deve usar "~" como o segundo caráter da string de CA, para separar o número da versão da lista de fornecedores autorizados. |
| 8.2 | A string de CA contém uma lista de fornecedores que não segue a formatação esperada (lista de int64s separados por ".") | A CMP deve corrigir os erros de implementação da string de CA. |
Certificação da CMP
Quando estes problemas ocorrem, a Google tenta publicar anúncios não personalizados.
| Erro | Descrição | Ação sugerida |
|---|---|---|
| 9.1 | A CMP da TCF presente na solicitação não está certificada pela Google. | A CMP deve obter a certificação junto da Google. |
Nenhum sinal da TCF em pedidos de anúncios
Quando estes problemas ocorrem, a Google tenta publicar anúncios limitados.
| Erro | Descrição | Ação sugerida |
|---|---|---|
| 10.1 | A solicitação é proveniente do EEE, do Reino Unido ou da Suíça, ou foi etiquetada manualmente para aplicação do RGPD através do parâmetro gdpr=1, mas não tem sinais da TCF. |
O publicador deve fazer a integração com uma CMP da TCF que esteja certificada pela Google e/ou garantir que o parâmetro gdpr=1 só está a ser definido para utilizadores no âmbito da aplicação do RGPD. |