Getting Started
Integre a Cookield ao seu site em 5 minutos. Um único script, sem configurações client-side — tudo é gerenciado pelo servidor.
💡 Abordagem single-script: A Cookield utiliza uma abordagem de script único. Toda a configuração (cores, textos, categorias, legislação) é resolvida no servidor e entregue dinamicamente. Você só precisa adicionar uma linha de código ao seu site.
Passo 1: Crie sua conta
Acesse cookield.io e crie sua conta gratuitamente. Você receberá acesso imediato ao dashboard com um plano gratuito que suporta até 5.000 pageviews/mês.
Após confirmar seu e-mail, você será redirecionado para o dashboard onde poderá criar sua organização e começar a configurar seus banners.
Passo 2: Crie um banner
No dashboard, navegue até Banners → Criar banner. Informe o domínio do seu site e selecione as legislações aplicáveis (LGPD, GDPR, CCPA, etc.). A Cookield detecta automaticamente a localização dos visitantes e exibe o banner correto.
Ao criar o banner, você receberá um Banner ID único que será usado no script de instalação.
Passo 3: Instale o script
Copie o script abaixo e adicione-o ao <head> do seu site, substituindo YOUR_BANNER_ID pelo ID do seu banner:
<script src="https://api.cookield.io/banner/YOUR_BANNER_ID.js" async></script>Exemplo completo em HTML:
<!DOCTYPE html>
<html lang="pt-BR">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Meu Site</title>
<!-- Cookield Banner Script — adicionar antes de outros scripts -->
<script src="https://api.cookield.io/banner/abc123-def456.js" async></script>
<!-- Seus outros scripts (analytics, ads, etc.) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXX"></script>
</head>
<body>
<!-- Conteúdo do site -->
</body>
</html>⚠️ O script deve ser adicionado antes de qualquer outro script de terceiros (analytics, ads, etc.) para garantir que o consentimento seja coletado antes do disparo de trackers.
Passo 4: Configure cores, textos e categorias
No dashboard, personalize o banner de acordo com a identidade visual do seu site:
- Cores: Defina cores primárias, de fundo e de texto para combinar com seu site.
- Textos: Personalize título, descrição e labels dos botões em qualquer idioma.
- Categorias de cookies: Ative/desative categorias como Analytics, Marketing, Funcionalidade e Social Media.
- Posição e layout: Escolha entre banner inferior, pop-up central, ou sidebar lateral.
Todas as alterações são salvas no servidor e refletidas imediatamente no seu site — sem necessidade de alterar o código.
Passo 5: Publique o banner
Antes de publicar, a Cookield verifica se o script foi instalado corretamente no seu domínio. O processo de verificação:
- Clique em Publicar no dashboard.
- A Cookield fará uma requisição ao seu domínio para confirmar a presença do script.
- Se verificado com sucesso, o banner será ativado automaticamente para todos os visitantes.
- Caso a verificação falhe, você receberá instruções para corrigir a instalação.
Como funciona por baixo dos panos
Quando um visitante acessa seu site, o script da Cookield:
- Faz uma requisição ao servidor com o Banner ID e a localização do visitante.
- O servidor determina a legislação aplicável (LGPD, GDPR, CCPA, etc.).
- Retorna a configuração completa do banner (cores, textos, categorias, comportamento).
- Renderiza o banner no DOM do site com as configurações recebidas.
- Coleta e armazena o consentimento, ativando sinais como Google Consent Mode v2.
Essa abordagem elimina a necessidade de qualquer configuração no client-side. Alterações no dashboard são refletidas em tempo real no site.