- TCF v2.1: vamos continuar aceitando as strings da TCF v2.1, mas incentivamos as CMPs a prosseguir com a implementação, seguindo as orientações do IAB (link em inglês), à medida que o setor muda para a TCF v2.2.
- Soluções de gestão de consentimento do Google: as soluções disponíveis na guia "Privacidade e mensagens" do Ad Manager, do AdSense e da AdMob são compatíveis com a TCF v2.2 para mensagens das regulamentações europeias, de acordo com os requisitos atualizados do IAB para CMPs.
O IAB Europa finalizou a v2.0 do Transparency and Consent Framework (TCF) desenvolvido com o IAB Tech Lab e outras empresas associadas. Agora o Google está totalmente integrado ao TCF v2.0.
Para dar aos editores tempo suficiente de resolver erros e configurações incorretas de implementação do Transparency & Consent Framework v2.0 do IAB Europa, o Google fornecerá um relatório dos erros detectados e um período de carência de 150 dias.
Neste artigo, você vai encontrar mais informações sobre como resolver erros de implementação da TCF v2.2, incluindo:
Orientações atualizadas
Atualizações
- Lembrete sobre o requisito da TCF referente a novas solicitações de consentimento a cada 13 meses:
De acordo com a política do TCF do IAB, é obrigatório lembrar os usuários sobre as escolhas de consentimento que fizeram pelo menos uma vez a cada 13 meses (390 dias). Se a decisão de consentimento tiver mais de 13 meses, a string de TC não vai ser mais válida e o Google não vai veicular anúncios a esse usuário. Sugerimos que você trabalhe com sua CMP para lembrar os usuários das opções de consentimento que fizeram antes do prazo de 13 meses.
- O tipo de erro 3.2 foi eliminado. As strings de TC atualizadas nos últimos 13 meses continuarão válidas.
Correções de erros comuns
Siga estas etapas para resolver alguns dos erros mais comuns no Ad Manager, no Google AdSense e na AdMob:
Solicite um novo consentimento aos usuários com strings de TC que não vão gerar receita(erros 1.1, 3.1, 4.1, 5.1, 5.2 e 6.1)
Erros relacionados
Orientações atualizadas
Solicite novamente o consentimento dos usuários.
Justificativa
Os editores poderão solicitar um novo consentimento se já tiverem usado strings fora de banda e com escopo global, IDs de CMP inválidos (de testes), IDs de GVL inválidos (de testes) ou se não havia o consentimento adequado do Google como fornecedor durante a implementação.
Erros 1.1, 1.2, 1.3: é importante verificar se esses erros representam um volume significativo de tráfego. Nesse caso, suspeite de um problema na CMP e confirme se o Google recebeu consentimento para os objetivos necessários, além de ser um fornecedor para consentimento E interesse legítimo (ID do fornecedor 755).
Especificação do IAB
De acordo com as especificações do IAB, as CMPs podem armazenar em cache strings de consentimento por até 13 meses.
AddEventHandler em até 500 ms(erros 2.1a, 2.1b, 2.0a, 2.0b e 2.0c)
Erros relacionados
Erro 2.1a. Também é possível seguir essa orientação nos erros 2.1b, 2.0a, 2.0b e 2.0c.
Orientações atualizadas
Embora não haja mais um limite de tempo, sugerimos que as CMPs analisem com atenção as implementações para garantir que retornem as chamadas imediatamente para AddEventListener getTCData.
Se uma CMP não responder, a solicitação não vai gerar receita.
Justificativa
O Google está em conformidade com a especificação do IAB, que determina que uma CMP precisa responder imediatamente à função AddEventListener. Se isso não acontecer, a solicitação pode não gerar receita.
Além disso, as respostas da CMP fazem parte da cadeia de eventos que influenciam o tempo necessário para uma solicitação de anúncio ser feita. A redução do tempo entre o carregamento da página e as solicitações de anúncios resulta em menos impressões perdidas para o editor.
Especificação do IAB
Especificação do IAB aplicável: especificação AddEventListener do IAB (no GitHub)
AddEventListener precisa ser chamado imediatamente após o registro com os dados de TC atuais, mesmo que o status da CMP seja loading e ela tenha dados de TC incompletos. Isso permite que o script de chamada acesse o listenerId registrado. Além disso, em cada mudança de string de TC, o callback precisa ser chamado, a menos que seja removido com RemoveEventListener.Central de políticas
A Central de políticas notifica os editores quando um app ou site não obedece aos requisitos de gestão de consentimento do Google.
Relatório de erros
Quando detectamos um problema na string de TC associada a um ou mais sites ou apps, notificamos os editores na interface do usuário do produto. Na página "Consentimento dos usuários da UE" da própria conta, os editores em questão podem clicar em Fazer download do relatório de erros da TCF para conferir os detalhes do que foi detectado nos últimos sete dias.
- No Ad Manager: clique em Administrador e Consentimento dos usuários da UE.
- Na AdMob e no Google AdSense: clique em Controles de bloqueio e Consentimento dos usuários da UE.
O relatório contém as seguintes informações sobre cada um dos erros detectados:
- Domínio/MobileAppID: o site ou app para dispositivos móveis que está configurado incorretamente.
- Caminho do bloco de anúncios: o bloco associado ao erro.
- Código do erro: o ID atribuído ao problema.
- Número de erros: a quantidade de consultas com o erro em questão na semana anterior.
- Data da última detecção: a última vez em que o erro aconteceu.
Os editores podem usar os códigos listados no relatório para encontrar as ações sugeridas nas tabelas de solução de problemas e resolver os erros.
Solução de problemas
Para ajudar os editores a corrigir integrações da TCF v2.2 do IAB configuradas da maneira errada, montamos as tabelas a seguir com os tipos de erro de string de TC mais comuns e recomendações para solucionar problemas correspondentes.
Veja as tabelas para entender os problemas que ocorrem no nível da solicitação do anúncio e o comportamento correspondente do sistema.
Cenários de consentimento limitado
Estes três cenários sempre são prioritários em relação aos erros de configuração, mesmo que uma determinada solicitação tenha vários problemas.
| Cenário | Descrição | Ação sugerida |
|---|---|---|
| 1.1 | O Google, como fornecedor, não tem permissão por consentimento ou interesse legítimo. | Confirme se o usuário rejeitou intencionalmente o Google como fornecedor, se erros de implementação de CMP ocorreram ou se há restrições para editores. |
| 1.2 | Nenhum consentimento para o Objetivo 1 em países do EEE e Reino Unido. |
Confirme se o usuário não autorizou intencionalmente o Objetivo 1 ou se isso ocorreu por erros de implementação da CMP. Os editores da Suíça devem verificar se estão definindo corretamente os campos
PublisherCC e PurposeOneTreatment caso não tenham solicitem o consentimento dos usuários.A partir de dezembro de 2021, não faremos mais a verificação do tratamento de |
| 1.3 | Tem consentimento para o Objetivo 1, mas não tem base jurídica para os anúncios básicos. |
Confirme se o usuário rejeitou intencionalmente interesses legítimos para outros objetivos ou se isso ocorreu por erros de implementação de CMP. |
Configuração incorreta
As solicitações de anúncios não serão preenchidas enquanto houver problemas de configuração incorreta.
| Erro | Descrição | Ação sugerida |
|---|---|---|
| 2.1a | A tag ou o SDK não está recebendo uma string de TC devido ao status da CMP ser stub, loading ou error. |
Se você estiver invocando manualmente a função para solicitar anúncios, garanta que a resposta seja Se você não tiver invocado manualmente a função para solicitar anúncios, garanta que sua CMP implemente o suporte para |
| 2.1b |
As duas condições são atendidas:
|
Verifique se a CMP implementou as APIs certas com base nas especificações técnicas da TCF do IAB. |
| 2.0a |
Não foi possível analisar a string de TC porque ela não é codificada em base64. Exemplo: |
As CMPs (ou editores) só podem enviar dados codificados em base64 nos parâmetros gdpr_consent=. |
| 2.0b |
Não foi possível analisar a string de TC devido a um erro de decodificação. Exemplo: inclui um número incorreto de bits |
A CMP precisa corrigir os erros de implementação referentes à string de TC. |
| 2.0c |
Não foi possível analisar a string de TC devido a um erro de dados. Exemplo: carimbo de data/hora incorreto, ID do fornecedor muito grande |
A CMP precisa corrigir os erros de implementação referentes à string de TC. |
Problemas com a string de TC
Problemas com a string de TC associada a uma solicitação de anúncio. As solicitações de anúncios serão removidas e não preenchidas.
| Erro | Descrição | Ação sugerida |
|---|---|---|
| 3.1 | ID da CMP inválido. |
Verifique se uma CMP validada pelo IAB está sendo usada e se o ID está definido corretamente nas strings de TC. Se uma CMP era válida quando uma string de TC foi gerada, mas foi excluída posteriormente pelo IAB, é necessário solicitar o consentimento novamente usando uma CMP válida. |
| 3.2 | Não é mais usado. | Nenhum. Significado anterior: a data de criação da string de TC foi há mais de 13 meses. |
O consentimento precisa ser concedido novamente
O usuário precisa dar o consentimento. Se você recebeu o consentimento de um usuário há mais de 13 meses ou está usando uma versão da GVL em que o Google ainda não estava listado, solicite o consentimento novamente. Caso contrário, as solicitações de anúncios serão removidas e eles não serão mostrados.
| Erro | Descrição | Ação sugerida |
|---|---|---|
| 3.3 | A data da última atualização da string de TC foi há mais de 13 meses. |
A CMP precisa excluir a string de TC antiga e receber o consentimento novamente. É normal que alguns desses erros ocorram quando as solicitações de anúncios são enviadas com uma string de TC expirada antes de a CMP invalidar e receber o consentimento do usuário novamente. Se você usa soluções de gestão de consentimento do Google e o SDK da UMP no seu app, confirme que a implementação foi feita da maneira correta e que |
| 4.1 | A string de TC foi gerada usando uma versão da GVL em que o Google ainda não estava listado. | Solicite novamente o consentimento usando uma versão atual da GVL. |
Escopo global e fora de banda
Os problemas a seguir são relacionados ao escopo global e fora de banda (Ad Manager, AdMob, Google AdSense). Os anúncios não serão veiculados se a string de TC indicar "fora de banda" ou "escopo global".
| Erro | Descrição | Ação sugerida |
|---|---|---|
| 5.1 | A string de TC permite o consentimento "fora de banda". | Instrua a CMP a remover sinais fora de banda das strings de TC. |
| 5.2 | String de TC com escopo global. | Instrua a CMP a atualizar as strings de TC para serem específicas de serviços. |
Veiculação de anúncios limitada
Há limite na veiculação de anúncios.
| Erro | Descrição | Ação sugerida |
|---|---|---|
| 6.1 | A versão da string de TC é 1 ou 1.1 (string de v1.0). |
A CMP precisa enviar strings da TCF v2.2. |
O Google vai resolver os problemas
Quando eles ocorrerem, o Google tentará solucioná-los, se necessário, e seguirá com a TCF normalmente.
| Erro | Descrição | Ação sugerida |
|---|---|---|
| 7.1 | gdprApplies é indefinido ou definido como um valor inválido ou indecifrável, mas há 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 atualmente conhecida pela tecnologia de veiculação de anúncios do Google. | N/A |
| 7.3 | Alguns objetivos, recursos e/ou fornecedores estão fora do intervalo (desconhecido). | N/A |
| 7.4 | A string de TC tem uma tcf_policy_version mais antiga que a GVL mais recente. |
A CMP precisa excluir a string de TC antiga e solicitar o consentimento novamente usando a nova GVL. |
| 7.5 |
Uma solicitação tem |
N/A |
| 7.6 | Código de país do editor inválido, mas o consentimento para o Objetivo 1 está presente. | A CMP precisa corrigir os erros de implementação referentes à string de TC. |
| 7.7 | Código de idioma inválido. | A CMP precisa corrigir os erros de implementação da string de TC. |
| 7.8 | O campo de versão da string de TC não é 1 nem 2. |
A CMP precisa corrigir os erros de implementação da string de TC solicitando um novo consentimento se uma string de TC inválida for detectada. Se você usa soluções de gestão de consentimento do Google e o SDK da UMP no seu app, confirme que a implementação foi feita da maneira correta e que |
| 7.9 | A versão da string de consentimento adicional não é 1 nem 2. |
A CMP precisa definir a versão da string de consentimento adicional como 1 ou 2. |
Problemas de string de consentimento adicional
Quando eles ocorrerem, o Google definirá a string de consentimento adicional (AC, na sigla em inglês) como inválida, e nenhum outro fornecedor será considerado além da string de TC.
| Erro | Descrição | Ação sugerida |
|---|---|---|
| 8.1 | A string de consentimento adicional não usa o separador de versão (~). |
A CMP precisa usar "~" como o segundo caractere da string de consentimento adicional para separar o número da versão da lista de fornecedores autorizados. |
| 8.2 | A string de consentimento adicional contém uma lista de fornecedores que não segue a formatação esperada (lista de int64s separada por "."). | A CMP precisa corrigir os erros de implementação da string de consentimento adicional. |