CookieFácil para Programadores — Hub Técnico

Tudo o que precisas para implementar consentimento de cookies conforme o RGPD e a LGPD — bloqueio de scripts, Google Consent Mode v2, WordPress e Shopify, com exemplos de código funcionais.

Adicionar ao teu sítio grátis — 2 minutos Começar com JavaScript

O que precisa um programador implementar para conformidade RGPD/LGPD em cookies?

Três coisas. Primeiro, bloquear todos os scripts não essenciais antes do consentimento usando MutationObserver ou reescrita de tipo — nenhum script de rastreio pode executar até o visitante aceitar ativamente. Segundo, disparar gtag('consent', 'default', {...}) de forma síncrona antes de qualquer tag Google carregar. Terceiro, armazenar um registo de consentimento à prova de adulteração com data, categorias e versão do banner para auditorias da CNPD e ANPD.

A CookieFácil trata as três automaticamente com um único script tag colocado como primeiro elemento no <head> do teu HTML. Os guias abaixo cobrem implementação manual e especificidades de integração para cada plataforma.

Guias de integração

Escolhe o teu caminho de integração. Cada guia tem exemplos de código funcionais.

Implementação JavaScript

Bloqueio de scripts com MutationObserver, reescrita de tipo e gestão do estado de consentimento. Funciona com qualquer framework ou HTML puro.

  • Bloqueio de scripts antes do consentimento
  • Interceção de scripts dinâmicos
  • API de estado de consentimento
Ler guia

Google Consent Mode v2

Chamadas gtag() exatas, estado padrão negado, gatilhos de atualização e mapeamento de categorias para sinais RGPD/LGPD.

  • Snippet padrão pronto a copiar
  • Mapeamento categorias → sinais GCM
  • wait_for_update explicado
Ler guia

Integração WordPress

Colocação do script via wp_head prioridade 1, compatibilidade com plugins de cache e gestão de scripts de plugins de terceiros.

  • Configuração wp_enqueue_script
  • Compatibilidade WP Rocket, LiteSpeed
  • Resolução de conflitos entre plugins
Ler guia

Integração Shopify

Colocação em theme.liquid, ScriptTag API para programadores de apps e suporte Shopify Markets para clientes no Brasil e Portugal.

  • Colocação do script em theme.liquid
  • ScriptTag API para devs de apps
  • Shopify Markets + Brasil/Portugal
Ler guia

Quick start — qualquer plataforma

Cola este como primeiro script dentro do tag <head>. Substitui O_TEU_SITE_ID pelo ID do teu dashboard CookieFácil.

<!-- CookieFácil RGPD/LGPD — deve ser o PRIMEIRO script no <head> -->
<script data-cfasync="false"
        src="https://cdn.cookiefacil.com.br/cdn/cf-banner.min.js?site=O_TEU_SITE_ID"
        async></script>

O atributo data-cfasync="false" impede que o Cloudflare Rocket Loader adie este script.

Obter o teu Site ID grátis
Guia JavaScript completo

Perguntas frequentes — Programadores

  • O que precisa um programador implementar para conformidade RGPD/LGPD em cookies?

    Três coisas: bloquear todos os scripts não essenciais antes do consentimento usando MutationObserver ou reescrita de tipo, disparar gtag('consent', 'default', {...}) antes de qualquer tag Google carregar, e armazenar um registo de consentimento com data, categorias e versão do banner para auditorias da CNPD e ANPD.

  • Como integrar o CookieFácil num sítio WordPress?

    Usa o plugin oficial CookieFácil no WordPress.org ou adiciona o snippet JavaScript manualmente via wp_head com prioridade 1. O plugin gere automaticamente o bloqueio de scripts, compatibilidade com plugins de cache (WP Rocket, LiteSpeed) e integração com Google Consent Mode v2. Instalação em menos de 10 minutos.

  • O CookieFácil funciona com Google Tag Manager?

    Sim. O template GTM do CookieFácil configura automaticamente o Google Consent Mode v2 com estado padrão negado antes de qualquer tag carregar. Após o visitante aceitar, o estado de atualização é enviado com as categorias corretas. Compatível com GA4, Google Ads e Meta Pixel via GTM.

  • Qual é o impacto no desempenho do sítio?

    O script da CookieFácil tem menos de 20KB minificado e comprimido, servido via CDN Cloudflare com TTL longo. O banner renderiza em menos de 500ms em ligações móveis 4G. Não usa jQuery nem frameworks pesados — apenas JavaScript puro otimizado para performance.