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 PurposeCategoria CookieldDescrição
1 - Store/Access infoNecessarySempre consentido
2 - Basic ad selectionMarketingSeleção básica de anúncios
3 - Ad profilingMarketingCriação de perfil para publicidade
4 - Personalized adsMarketingAnúncios personalizados
5 - Content profilingPerformanceCriação de perfil de conteúdo
6 - Personalized contentPerformanceConteúdo personalizado
7 - Ad performanceStatisticsMedição de performance de anúncios
8 - Content performanceStatisticsMedição de performance de conteúdo
9 - Market researchStatisticsPesquisa de mercado
10 - Product developmentFunctionalDesenvolvimento 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:

  1. Visitante chega no site → Cookield detecta país (EU)
  2. Banner exibido com opções TCF-compliant
  3. Visitante consente → __tcfapi atualizado
  4. Vendors leem sinais via getTCData
  5. 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