Docs → TCF 2.2
IAB TCF 2.2
Transparência e Consentimento Framework — integração com o ecossistema de publicidade digital.
O que é o TCF 2.2?
O Transparency and Consent Framework (TCF) é um padrão da IAB Europe que permite que CMPs como o Cookield comuniquem as preferências de consentimento dos usuários para vendors de publicidade (ad exchanges, DSPs, SSPs) de forma padronizada.
Quando é ativado?
O Cookield ativa automaticamente o TCF 2.2 quando detecta que o visitante está em um país onde o GDPR ou UK-GDPR se aplica (via geolocalização). Não requer configuração manual.
Países onde o TCF é ativado:
Todos os países da União Europeia + Reino Unido
Mapeamento de Categorias → Purposes
O Cookield mapeia automaticamente suas categorias de cookies para os TCF Purposes:
| TCF Purpose | Categoria Cookield | Descrição |
|---|---|---|
| 1 - Store/Access info | Necessary | Sempre consentido |
| 2 - Basic ad selection | Marketing | Seleção básica de anúncios |
| 3 - Ad profiling | Marketing | Criação de perfil para publicidade |
| 4 - Personalized ads | Marketing | Anúncios personalizados |
| 5 - Content profiling | Performance | Criação de perfil de conteúdo |
| 6 - Personalized content | Performance | Conteúdo personalizado |
| 7 - Ad performance | Statistics | Medição de performance de anúncios |
| 8 - Content performance | Statistics | Medição de performance de conteúdo |
| 9 - Market research | Statistics | Pesquisa de mercado |
| 10 - Product development | Functional | Desenvolvimento de produto |
__tcfapi Commands
O Cookield instala automaticamente a API __tcfapi no window global:
// Verificar se TCF está ativo
window.__tcfapi('ping', 2, (data) => {
console.log(data.cmpLoaded); // true
console.log(data.gdprApplies); // true
});
// Obter dados de consentimento TCF
window.__tcfapi('getTCData', 2, (data, success) => {
if (success) {
console.log(data.purpose.consents); // {1: true, 2: false, ...}
console.log(data.tcString); // TC String encoded
}
});
// Escutar mudanças
window.__tcfapi('addEventListener', 2, (data, success) => {
if (data.eventStatus === 'useractioncomplete') {
// Usuário fez uma escolha
}
});CMP ID
Para uso em produção com vendors IAB, o Cookield precisa ser registrado na IAB Europe com um CMP ID oficial. Atualmente usa um ID placeholder (300). O registro oficial está em andamento. Vendors que verificam o CMP ID na Global Vendor List reconhecerão o Cookield após o registro.
Integração com Ad Tech
Vendors de publicidade (Google Ads, Meta, DV360, etc.) leem automaticamente os sinais TCF via __tcfapi. Não é necessário configuração adicional.
Fluxo:
- Visitante chega no site → Cookield detecta país (EU)
- Banner exibido com opções TCF-compliant
- Visitante consente → __tcfapi atualizado
- Vendors leem sinais via getTCData
- Ads carregam apenas se purposes consentidos
Compatibilidade
- ✓ Google Ad Manager / AdSense
- ✓ Google Ads (via Consent Mode v2 + TCF)
- ✓ Meta Audience Network
- ✓ Amazon Publisher Services
- ✓ Prebid.js
- ✓ Qualquer vendor IAB TCF 2.2 registrado