> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.hoppyapps.com/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # 🔗 Integrar Hoppy Cookie com o Quadro de Transparência e Consentimento v2.3 (TCF) > ℹ️ **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. 🔒 ---