Esta página é destinada aos desenvolvedores que mantêm um banner de consentimento e precisam fazer integração ao framework TCF.
O Transparency & Consent Framework (TCF) do IAB é um framework técnico de padrão aberto que possibilita que sites, anunciantes e agências de publicidade coletem, registrem e atualizem o consentimento dos consumidores em páginas da Web. Os parâmetros do TCF são válidos para cookies do Google Ads fornecidos pelo Google Ads ou Google Analytics. Para controlar os cookies do Google Analytics, faça a integração ao modo de consentimento.
Implementação
Para ativar o suporte ao TCF, defina a propriedade "window" a seguir como true
:
window['gtag_enable_tcf_support'] = true
Essa propriedade window
precisa ser definida antes de qualquer chamada para gtag()
, além de ser configurada em todas as páginas em que você quer ativar o suporte ao TCF, incluindo aquelas carregadas pelo iframe. Se ela for definida como false
ou não for configurada, o suporte ao TCF não será ativado.
Finalidades
Uma "finalidade" no contexto do TCF é uma intenção definida para o processamento de dados. As tags do Google Analytics implementadas pelo Gerenciador de tags do Google ou pela gtag.js com o suporte ao TCF ativado vão processar as solicitações que tiverem a string de consentimento das seguintes maneiras:
Finalidade | Descrição | Impacto no Google Analytics quando a finalidade for negada |
---|---|---|
1 | Armazenar e/ou acessar informações em um dispositivo | Os cookies relacionados à publicidade não serão criados nem usados pelo Google Analytics. Os recursos dos Indicadores do Google, como relatórios de remarketing, informações demográficas e interesses, não vão registrar dados de usuários que não consentiram. |
3 | Criar um perfil de anúncios personalizados | Os hits enviados ao Google Analytics serão marcados com um parâmetro npa=1. Os eventos marcados com "npa=1" não são qualificados para a personalização de anúncios nem usados para avaliar o público-alvo de remarketing. Os usuários já adicionados às listas de público-alvo não são afetados. |
4 | Selecionar anúncios personalizados |
Os hits enviados ao Google Analytics serão marcados com um parâmetro npa=1. Igual à finalidade 3. |
7 | Avaliar a performance do anúncio | allow_google_signals será definido como "false". Os cookies relacionados à publicidade não serão usados pelo Google Analytics. Os recursos dos Indicadores do Google, como relatórios de remarketing, informações demográficas e interesses, não vão registrar dados de usuários que não consentiram. |
9 | Aplicar a pesquisa de mercado para gerar insights sobre público-alvo | allow_google_signals será definido como "false". Igual à finalidade 7. |
10 | Desenvolver e melhorar produtos | allow_google_signals será definido como "false". Igual à finalidade 7. |
Como resolver mensagens de erro
Se a CMP não responder em até 500 milissegundos ou for mostrado o status "error", "stub", ou "loading", a tag vai prosseguir no Modo restrito. Para corrigir isso:
Se você invocar manualmente a função para disparar uma tag de conversão:
Garanta o envio da resposta agetTCData TCData.eventStatus = 'tcloaded'
OU'cmpuishown' + 'useractioncomplete'
em até 500 milissegundos. Isso indica que a CMP está pronta para oferecer ao usuário a opção de consentimento.Se você não invocar manualmente a função para enviar uma tag de conversão:
Implemente o suporte agetTCData and return TCData.eventStatus = 'tcloaded'
OU'cmpuishown' + 'useractioncomplete'
para indicar que o consentimento do usuário está pronto para uso da API em até 500 milissegundos.
Próximas etapas
Se você planeja oferecer aos clientes uma tag para uso no Google Tag Manager, crie um modelo de tag para o banner.