Documentação FitConsent CMP
Guia completo de instalação e configuração do FitConsent CMP. Instale banners de consentimento de cookies, configure o Google Consent Mode V2 e o Microsoft UET, e cumpra o GDPR, CCPA e mais de 15 regulamentos globais de privacidade.
Introdução
Bem-vindo à documentação da Plataforma de gestão de consentimento (CMP) FitConsent. Este guia cobre tudo o que precisa para instalar, configurar e tirar o máximo partido do FitConsent — desde a primeira tag de script até ao manuseamento avançado de dados de consentimento.
O que é uma Plataforma de gestão de consentimento (CMP)?
Uma Plataforma de gestão de consentimento (CMP) é uma ferramenta que ajuda os sites a recolher e gerir legalmente o consentimento dos utilizadores para o tratamento de dados, um requisito ao abrigo de leis de privacidade como o GDPR na Europa e o CCPA/CPRA na Califórnia. É a tecnologia por trás dos banners de cookies que vê em sites de todo o mundo.
O FitConsent vai além de um banner básico. Fornece as ferramentas para cumprir a lei e construir a confiança dos utilizadores, otimizando a experiência de consentimento. O nosso serviço inclui suporte completo e automático para o Google Consent Mode V2 e o Microsoft UET Consent Mode.
Funcionalidades Principais
Integração automática do Google Consent Mode V2 e Microsoft UET Consent Mode
Suporte para 16 estruturas regulatórias globais: GDPR, CCPA, TCF, ePrivacy, UCPA, VCDPA, CTDPA, LGPD, PIPEDA, APPI, PDPA, APA-NZPA, FADP, POPIA e mais
Mais de 100 idiomas com deteção automática de idioma
Otimizador de banner com IA (planos Pro+)
Declaração de armazenamento (tabela de cookies) para páginas de política de privacidade
Botão gatilho flutuante para os utilizadores atualizarem o consentimento a qualquer momento
Pré-visualização em tempo real no painel de controlo
Ferramenta de diagnóstico integrada para verificar a instalação correta
Instalação e Configuração
A integração do FitConsent foi concebida para ser rápida e simples. Escolha o método que melhor se adapta à sua plataforma.
Pré-requisitos
Antes de começar, certifique-se de que tem:
Criado uma conta FitConsent e registado o seu site no painel de controlo
O seu ID de site único (disponível na página de configuração do seu site)
Decidido qual o quadro regulatório aplicável ao seu público
Incorporação Direta
Para sites HTML padrão, copie o código abaixo e cole-o na secção <head> o mais alto possível — antes de qualquer script do Google Analytics, Google Ads ou Microsoft UET.
<!-- FitConsent CMP: Definir consentimentos padrão ANTES de todos os outros scripts -->
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
window.uetq = window.uetq || [];
// Consentimento padrão: recusado até à interação do utilizador
gtag('consent', 'default', {
'ad_storage': 'denied',
'ad_user_data': 'denied',
'ad_personalization': 'denied',
'analytics_storage': 'denied'
});
window.uetq.push('consent', 'default', { 'ad_storage': 'denied' });
</script>
<!-- Carregue aqui os seus outros scripts (Google Analytics, UET, etc.) -->
<!-- Banner FitConsent: atualiza o consentimento com base na interação do utilizador -->
<script async defer src="https://app.fitconsent.com/api/banner?websiteId=O_SEU_WEBSITE_ID"></script>Substitua O_SEU_WEBSITE_ID pelo seu ID de site real do painel de controlo. Este script deve aparecer antes de qualquer tag que leia ou defina cookies.
Google Tag Manager (Recomendado)
A utilização do template oficial da comunidade GTM do FitConsent é o método de instalação recomendado.
Passo 1: Ativar a Visão Geral do Consentimento
1. No seu espaço de trabalho GTM, clique no separador "Administrador".
2. Na coluna "Contentor", clique em "Definições do contentor".
3. Marque "Ativar visão geral do consentimento" e clique em "Guardar".
Passo 2: Adicionar o Template FitConsent
1. Aceda a "Modelos" > "Modelos de tags" > "Pesquisar galeria".
2. Pesquise "FitConsent" e clique em "Adicionar ao espaço de trabalho".
3. Aceite o pedido de permissões.
Passo 3: Criar a Tag "Consentimento Padrão Google"
1. Aceda a "Tags" > "Nova", nomeie-a "FitConsent – Consentimento padrão".
2. Escolha "FitConsent" como tipo de tag.
3. No menu suspenso "Tipo de tag", selecione "Google Consent Default".
4. Introduza o seu ID de site no campo "FitConsent Website ID".
5. Defina o acionador como "Inicialização do consentimento – Todas as páginas".
6. Guarde a tag.
Passo 4: Criar a Tag "Carregador de Banner"
1. Crie uma nova tag denominada "FitConsent – Carregador de banner".
2. Escolha "FitConsent" como tipo de tag.
3. Introduza o seu ID de site e defina o acionador como "Inicialização do consentimento – Todas as páginas".
4. Guarde a tag.
Passo 5: Configurar a sua Tag Google
Se já tiver uma Tag Google (GA4): edite a tag > "Definições avançadas" > "Definições de consentimento" > selecione "Não é necessário consentimento adicional".
Passo 6: Gerir Scripts de Terceiros
Para scripts como o Microsoft Clarity ou o Meta Pixel: edite a tag > "Definições avançadas" > "Definições de consentimento" > "Exigir consentimento adicional para acionar a tag" > adicione analytics_storage ou ad_storage.
Clique em "Enviar" e "Publicar" o seu contentor GTM.
Plugin WordPress
O FitConsent está disponível como plugin oficial em WordPress.org. Fornece compatibilidade automática com a WP Consent API, o padrão utilizado pelo Google Site Kit.
Instalação através do Painel WordPress
1. Aceda a "Plugins" > "Adicionar novo".
2. Pesquise "FitConsent CMP" e clique em "Instalar agora", depois "Ativar".
Configuração Pós-instalação
1. Aceda a "Definições" > "FitConsent".
2. Introduza o seu ID de site FitConsent.
3. Clique em "Guardar alterações".
Se utilizar o Google Site Kit, ative o "Modo de consentimento" nas suas definições. O FitConsent comunica automaticamente com o Site Kit através da WP Consent API.
Outras Plataformas
O FitConsent funciona com qualquer plataforma que permita HTML ou JavaScript personalizado (Shopify, Drupal, Webflow, etc.). Utilize a integração GTM se disponível, caso contrário o método de incorporação direta.
Configurar o seu Banner
Toda a configuração é gerida a partir do painel de controlo do FitConsent. Abra a página de configuração do seu site para aceder a todas as definições. As alterações são pré-visualizadas em tempo real no painel direito.
Definições Gerais
Domínio: O domínio do seu site (ex.: example.com).
ID do Google Analytics: Introduza o seu ID GA4 (ex.: G-XXXXXXXXXX).
Estrutura: Escolha a estrutura regulatória de privacidade aplicável aos seus visitantes.
| Estrutura | Ideal Para | Região |
|---|---|---|
| Auto | Aplica automaticamente GDPR ou CCPA com base na localização do visitante | Global |
| GDPR | Regulamento Geral sobre a Proteção de Dados da UE | União Europeia / EEE |
| CCPA | Lei de Privacidade do Consumidor da Califórnia | Califórnia, EUA |
| ePrivacy | Diretiva ePrivacy da UE (lei dos cookies) | União Europeia |
| TCF | Estrutura de Transparência e Consentimento do IAB | Editores e redes publicitárias |
| UCPA | Lei de Privacidade do Consumidor de Utah | Utah, EUA |
| VCDPA | Lei de Proteção de Dados do Consumidor da Virgínia | Virgínia, EUA |
| CTDPA | Lei de Privacidade de Dados de Connecticut | Connecticut, EUA |
| LGPD | Lei Geral de Proteção de Dados do Brasil | Brasil |
| PIPEDA | Lei Canadiana de Proteção de Informações Pessoais | Canadá |
| APPI | Lei Japonesa de Proteção de Informações Pessoais | Japão |
| PDPA | Lei Tailandesa de Proteção de Dados Pessoais | Tailândia |
| APA-NZPA | Leis de Privacidade da Austrália e Nova Zelândia | Austrália / Nova Zelândia |
| FADP | Lei Federal Suíça sobre Proteção de Dados | Suíça |
| POPIA | Lei Sul-Africana de Proteção de Informações Pessoais | África do Sul |
| Nenhum | Sem estrutura automática — controlo totalmente manual | Qualquer |
Para sites com público internacional, selecione "Auto". O FitConsent mostrará automaticamente o banner GDPR para visitantes europeus e o banner CCPA para visitantes da Califórnia.
Segmentação geográfica: Escolha quem vê o banner:
Nenhuma — Todos os visitantes veem o banner
GDPR — Apenas os visitantes de países da UE/EEE veem o banner
Domínios Adicionais
Disponível nos planos Pro Large e Business. Os domínios adicionais permitem carregar o mesmo banner em até 5 domínios adicionais de sua propriedade — útil para ambientes de staging, domínios regionais ou configurações multi-marca.
Para adicionar um domínio adicional:
1. Abra a página de configuração do seu site no painel de controle.
2. Vá para a aba Configurações Gerais.
3. Role até o cartão Domínios Adicionais.
4. Clique em Adicionar domínio e insira o nome do host simples (ex.: staging.example.com ou minhamarca.com.br) — sem prefixo https:// ou barras finais.
5. Repita para até 5 domínios e, em seguida, salve sua configuração.
Se a seção Domínios Adicionais aparecer bloqueada apesar de ter um plano Pro Large ou Business, entre em contato com o suporte — sua assinatura pode não ter sido aplicada corretamente a este site.
Modo de Consentimento
Modo Avançado (Recomendado)
As tags Google carregam imediatamente, mas operam com recolha de dados restrita até que o consentimento seja concedido.
Antes do consentimento: As tags enviam "pings anónimos sem cookies" — não são definidos cookies de identificação.
Após o consentimento: A recolha completa de dados é ativada com base nas escolhas do utilizador.
Benefício principal: Ativa a Modelagem de conversões do Google, que recupera dados de atribuição perdidos.
Modo Básico (Bloqueio Estrito)
Todos os scripts de rastreamento ficam completamente bloqueados até o utilizador conceder consentimento.
<!-- Script bloqueado para o Modo Básico -->
<script
type="text/plain"
data-cookieconsent="analytics"
async
src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXX">
</script>Mapeamento de categorias:
analytics → Google Analytics (GA4), Microsoft Clarity
marketing → Google Ads, Meta Pixel, LinkedIn
functional → Chatbots, ferramentas de personalização
| Funcionalidade | Modo Básico | Modo Avançado |
|---|---|---|
| Tags Google | Bloqueadas até consentimento | Carregam imediatamente (restritas) |
| Dados antes do consentimento | Zero dados | Pings sem cookies (modelagem) |
| Nível de privacidade | Mais estrito | Compatível com GDPR / DMA |
| Modelagem de conversões | Não disponível | Disponível |
Aparência
Layout e Animação
Tipo: Banner (barra horizontal) ou Diálogo (sobreposição centrada)
Posição: Baixo, Cima, Baixo-Esquerda, Baixo-Direita, Cima-Esquerda, Cima-Direita, Centro
Estilo de animação: Spring (elástico), Slide (deslizamento), Fade (desvanecer), Nenhuma
Acento de borda: Nenhum, Superior, Esquerdo (faixa colorida), Gradiente
Tipografia
Fonte: Inter, DM Sans, Plus Jakarta Sans, Nunito, Outfit, Lato, Poppins, Raleway, Merriweather, Playfair Display, Source Code Pro
Alinhamento do título: Esquerda, Centro, Direita
Forma e Elevação
Raio de borda: Nenhum, SM, MD, LG, XL, 2XL
Raio de borda dos botões: Nenhum, SM, MD, LG, XL, Completo
Elevação (sombra): Nenhuma, SM, MD, LG, XL
Cores
Cada campo de cor suporta independentemente o modo claro e modo escuro:
Cor do texto, Cor do título, Cor de fundo
Cor dos botões, Cor do texto dos botões, Cor da borda dos botões
Cor do divisor, Cor do separador ativo, Cor do separador inativo
Logótipo e Imagem de Fundo
URL do logótipo: Mostra o logótipo da sua empresa no banner.
Imagem de fundo: Imagens separadas para Desktop Claro, Desktop Escuro, Mobile Claro e Mobile Escuro.
Conteúdo e Idiomas
Campos de texto configuráveis:
Cabeçalho do banner
Mensagem do banner (suporta Markdown: negrito, *itálico*, [link](url))
Etiqueta do botão "Aceitar tudo"
Etiqueta do botão "Recusar"
Etiqueta do botão "Gerir preferências"
Título e descrição do modal de preferências
Etiqueta do botão "Guardar preferências"
Etiquetas dos separadores: Consentimento, Preferências, Declaração de armazenamento
Definições de Comportamento
Botões
Ativar botão Recusar: Mostrar ou ocultar a opção "Recusar".
Ativar botão Gerir: Mostrar ou ocultar a opção "Gerir preferências".
Categorias de Consentimento
Necessário (sempre ativo): Cookies essenciais para o funcionamento do site
Analytics: Análise e monitorização do desempenho do site
Marketing: Publicidade e remarketing
Funcional: Personalização e funcionalidade avançada
Venda de dados (CCPA/LGPD/UCPA/CTDPA): Adicionada automaticamente quando "Venda de dados" está ativada
Botão Gatilho Flutuante
Ativar: Ativar ou desativar o botão flutuante.
Posição: Baixo-Esquerda ou Baixo-Direita.
Cores: Cor de fundo e cor do ícone para modos claro e escuro.
Definições Específicas CCPA
Link "Não vender": URL para a sua página "Não vender as minhas informações pessoais".
Link "Limitar uso": URL para a sua página "Limitar o uso das minhas informações pessoais sensíveis".
Venda de dados: Indica se o seu site vende ou partilha dados pessoais com terceiros.
Otimizador de IA
Disponível nos planos Pro+. O otimizador de IA analisa o conteúdo, a marca e o público-alvo do seu site para sugerir combinações de cores ótimas, textos de banner recomendados e melhorias de layout.
Declaração de Armazenamento
O FitConsent pode exibir uma tabela atualizada automaticamente de todos os cookies e elementos de armazenamento utilizados pelo seu site.
HTML Padrão
<div id="fitconsent-declaration"></div>
<script async defer src="https://app.fitconsent.com/api/declaration?websiteId=O_SEU_WEBSITE_ID"></script>React & Next.js
Para evitar erros de hidratação, carregue o script do lado do cliente usando um hook useEffect.
'use client';
import { useEffect } from 'react';
type Props = {
websiteId: string;
};
export function StorageDeclarationEmbed({ websiteId }: Props) {
useEffect(() => {
const script = document.createElement('script');
script.src = `https://app.fitconsent.com/api/declaration.js?websiteId=${websiteId}`;
script.async = true;
script.defer = true;
const container = document.getElementById('fitconsent-declaration');
if (container) {
container.appendChild(script);
}
return () => {
if (container && container.contains(script)) {
container.removeChild(script);
}
};
}, [websiteId]);
return <div id="fitconsent-declaration"></div>;
}Esta abordagem garante que o script seja carregado e executado de forma segura do lado do cliente, evitando conflitos com o ciclo de renderização do React.
Uso Avançado
Usar Dados de Consentimento no seu Site
Após a interação do utilizador, o FitConsent armazena as suas escolhas num cookie denominado fitconsent_given.
Estrutura do Cookie
{
"choices": {
"necessary": true,
"analytics": true,
"marketing": false
},
"geo": {
"country": "PT",
"state": null
}
}choices: Um objeto onde cada chave é uma categoria de consentimento e o valor é true (aceite) ou false (recusado).
geo: Contém a localização geográfica do utilizador no momento do consentimento.
Leitura do Consentimento no Cliente
function getFitConsentChoices() {
const cookie = document.cookie
.split('; ')
.find(row => row.startsWith('fitconsent_given='));
if (!cookie) return null;
try {
return JSON.parse(decodeURIComponent(cookie.split('=')[1]));
} catch {
return null;
}
}
const consent = getFitConsentChoices();
if (consent?.choices?.analytics) {
// Inicializar o seu script de análise
}Deteção Automática de Idioma
O banner FitConsent deteta automaticamente o idioma preferido do utilizador nesta ordem:
1. O atributo lang da tag <html> (ex.: <html lang="pt">). Este é o método mais fiável.
2. A definição navigator.language do browser.
3. Recorre ao inglês (en) ou ao primeiro idioma na sua lista configurada.
Ferramenta de Diagnóstico
Utilize a ferramenta de diagnóstico integrada na sua página de configuração FitConsent para verificar que o banner está corretamente instalado. A ferramenta verifica: deteção do script do banner, estado dos valores padrão do modo de consentimento, estado da integração das tags Google, e problemas detetados com recomendações.
Migração: Modo Avançado → Modo Básico
1. Altere a sua configuração FitConsent para "basic".
2. Remova o bloco de script "Consent Default" do seu <head>.
3. Adicione type="text/plain" e data-cookieconsent="..." a todas as suas tags de script de rastreamento.
4. Limpe os cookies do browser e volte a testar.
Após mudar para o Modo Básico, perderá todos os dados pré-consentimento, incluindo dados de modelagem anónima. Isto não pode ser recuperado retroativamente.
Ready to simplify your compliance?
Implement a reliable Consent Management Platform (CMP) today and ensure you stay compliant with all global regulations.
Start Your Free Trial