ℹ️ Note: Este artigo foi traduzido automaticamente utilizando IA e pode conter imprecisões. Se algo parecer errado, entre em contato com nossa equipe de suporte.

A integração Transparência & Consentimento Framework v2.3 (TCF) ajuda sua loja a comunicar sinais de consentimento aos fornecedores registrados pelo IAB de forma padronizada.

Quando activado, Hoppy Cookie gera e gerencia uma string de consentimento TCF válida (TC String), expõe o oficial __tcfapi interface e compartilha preferências de consentimento do visitante com fornecedores participantes de publicidade e análise.

Hoppy Cookie já está registrado como uma Plataforma de Gerenciamento de Consentimento do IAB (CMP ID: 454), portanto não é necessário nenhum registro adicional ou configuração externa.

⚠️ Antes de começar

Antes de activar o TCF, certifique- se:

• Hoppy GDPR EU Cookie Banner está instalado e ativo
• Seu Banner de Cookies é publicado
• A incorporação da aplicação está activada dentro da sua Shopify tema

💡 Não são necessárias chaves de API, credenciais ou contas externas.

⚠️ O TCF aplica-se apenas aos visitantes localizados nas regiões do GDPR.

Se planeia utilizar Modo de consentimento do Google V2 Para o tráfego do GDPR, o TCF deve ser ativado primeiro.

🛠️ Passo 1 — Abra a seção Integração

Dentro do seu Shopify Administrador:

→ Abrir Hoppy GDPR EU Cookie Banner

→ Clique Integração

Localização:

Quadro de Transparência e Consentimento v2.3 (TCF)

e abrir a página de integração.

🚀 Passo 2 — Habilitar o TCF

No topo da página:

→ Clique Ligar

Uma vez habilitada:

• O estado de integração muda para Ligado
• O aplicativo carrega a Lista Global de Fornecedor IAB (GVL)
• A loja começa a expor o __tcfapi interface
• Visitantes do GDPR recebem uma experiência de consentimento compatível com TCF

💡 O popup de banner e preferências se adaptam automaticamente à estrutura TCF quando necessário.

🧩 Etapa 3 — Selecione fornecedores colaborantes (opcional)

Abaixo da opção de integração, você encontrará o:

Procurar os Fornecedores

Campo.

Isso permite que você escolha quais fornecedores da Lista Global de Fornecedores da IAB podem receber sinais de consentimento.

Como adicionar fornecedores

→ Comece a digitar o nome de um fornecedor

→ Selecione o fornecedor dos resultados

→ Repita se necessário

Como remover fornecedores

→ Clique no × ao lado do nome do fornecedor

para removê- lo da lista selecionada.

Comportamento Importante

Se nenhum fornecedor estiver seleccionado:

→ Todos os fornecedores da Lista Global de Fornecedores são permitidos por padrão.

Para a maioria dos comerciantes, é recomendável selecionar apenas os fornecedores usados ativamente na loja.

Isso ajuda a manter a comunicação de consentimento mais precisa e mais fácil de gerenciar.

💾 Passo 4 — salve suas mudanças

Depois de habilitar o TCF e selecionar seus fornecedores preferidos:

→ Clique Gravar

A aplicação:

• Armazenar sua configuração TCF
• Atualizar as configurações do storefront
• Republicar a configuração necessária do banner

Uma vez salvo, o storefront começa a usar as configurações TCF atualizadas automaticamente.

🔄 Como TCF Obras

Após a ativação, o fluxo de consentimento funciona automaticamente para os visitantes do GDPR.

O que acontece por trás das cenas

1. O aplicativo carrega a mais recente Lista Global de Fornecedores IAB
2. Os visitantes interagem com o banner de consentimento compatível com TCF
3. As escolhas de consentimento são convertidas em uma string TC
4. O CT String é armazenado na frente da loja
5. Os sinais de consentimento são partilhados através da __tcfapi interface
6. Os fornecedores participantes ajustam o comportamento com base nas permissões concedidas

Este processo acontece automaticamente sem exigir qualquer intervenção manual.

🧪 Passo 5 — Verificar a Integração

Após salvar, é recomendável verificar se TCF está funcionando corretamente.

Verificar o estado de integração

Voltar para:

Integração → Quadro de Transparência e Consentimento v2.3 (TCF)

O crachá de status deve ser exibido:

Ligado

Teste de uma região do GDPR

Porque o TCF só se aplica aos visitantes do GDPR:

→ Teste usando uma localização VPN da UE

ou

→ Usar disponível Shopify ferramentas de teste para o comportamento regional da loja

A experiência de consentimento TCF deve aparecer automaticamente.

Verificar o String TC

Após enviar as preferências de consentimento:

→ Abra as ferramentas de desenvolvimento do seu navegador

→ Verificar cookies do navegador

Procurar por:

euconsent-v2

Você também pode encontrar o mesmo valor armazenado no localStorage.

Sua presença confirma que uma string TC válida foi gerada e armazenada.

Verificar o Comportamento do Fornecedor

Se forem selecionados fornecedores específicos:

→ Confirme que os scripts do fornecedor carregam corretamente

→ Verifique se respondem adequadamente às seleções de consentimento

Se usar o Modo de Consentimento do Google V2 ao lado do TCF, teste ambas as integrações juntas para garantir que os sinais de consentimento estejam fluindo como esperado.

⚠️ Solução comum de problemas

O TCF Banner não está aparecendo

Verificar:

• O visitante está localizado em uma região do GDPR
• A Banner de Cookies é publicada
• A incorporação da aplicação está habilitada

A funcionalidade TCF só ativa quando os requisitos do GDPR se aplicam.

A lista de fornecedores não está a carregar

A Lista Global de Fornecedores é armazenada temporariamente para desempenho.

Se os fornecedores não aparecerem:

→ Atualizar a página

→ Espere alguns minutos e tente novamente

→ Verifique sua storefront pode acessar o serviço de lista de fornecedores

Os fornecedores ignoram o consentimento

Verificar:

• Foram selecionados os fornecedores corretos
• O fornecedor suporta o __tcfapi interface
• O vendedor está registado no quadro IAB

O TCF afeta apenas os vendedores que participam do framework.

Modo de consentimento do Google V2 não está funcionando

O TCF é necessário para o Modo de Consentimento do Google V2 nas regiões do GDPR, mas não configura o Modo de Consentimento do Google automaticamente.

Após activar o TCF:

→ Configure o Modo de Consentimento do Google V2 separadamente da seção Integrações.

⚠️ Notas Importantes

Apenas Regiões do GDPR

O TCF aplica-se apenas aos visitantes localizados nas regiões cobertas pelo GDPR.

Visitantes fora dessas regiões continuam usando a experiência de consentimento padrão.

Lista de fornecedores vazios permite todos os fornecedores

Se nenhum fornecedor for seleccionado manualmente:

→ Todos os fornecedores da Lista Global de Fornecedores são permitidos por padrão.

O consentimento é armazenado automaticamente

O CT String gerado é armazenado automaticamente e reutilizado de acordo com os requisitos de consentimento.

Não é necessária nenhuma configuração manual de cookies.

TCF É necessário para o modo de consentimento do Google V2

Para os visitantes do GDPR, o Modo de Consentimento do Google V2 depende do TCF estar ativo.

O TCF deve sempre ser configurado antes de habilitar o Modo de Consentimento do Google V2.

🎉 Resultado Final

Uma vez configurado com sucesso:

✅ Visitantes do GDPR recebem uma experiência de consentimento conforme ao TCF

✅ As escolhas de consentimento são convertidas em uma string TC válida

✅ A __tcfapi interface fica disponível na frente da loja

✅ Os fornecedores registados no IAB recebem sinais de consentimento padronizados

✅ As permissões do fornecedor podem ser controladas diretamente do aplicativo

✅ Sua loja está pronta para o Modo de Consentimento do Google V2 e outros serviços compatíveis com TCF

A integração Transparência & Consentimento Framework v2.3 ajuda a garantir que as informações de consentimento sejam comunicadas em um formato padronizado que os principais fornecedores de publicidade e análise possam entender e respeitar. 🔒

Actualizado em: 10/09/2026