CookiePilot

Instale o CookiePilot e associe cada tracker ao consentimento

Carregue primeiro o stub consent-default, depois o banner e por último os seus trackers. Escolha o caminho que corresponde à forma como os seus scripts são carregados.

Começar grátisLer a documentação

Escolha o seu caminho de instalação

1Método

Diretamente no <head>

Recomendado quando o GA4 ou o Meta são injetados por plugins e quer controlá-los num só lugar.

Passos

  1. 1Cole o stub consent-default no topo do <head>, com cada categoria definida como denied.
  2. 2Adicione o script do banner do CookiePilot logo a seguir ao stub.
  3. 3Mova o GA4, o Meta e os restantes trackers para baixo do banner e carregue-os só após o consentimento.
  4. 4Volte a publicar e recarregue sem cache para que a nova ordem seja servida.
2Método

Através do Google Tag Manager

Recomendado quando as suas tags já vivem num contentor do GTM.

Passos

  1. 1Mantenha o stub consent-default no <head>, antes do contentor do GTM.
  2. 2Carregue o loader do CookiePilot apenas uma vez: ou logo a seguir ao stub consent-default no <head>, ou como uma única tag Custom HTML no acionador Consent Initialization. Nunca pelas duas vias.
  3. 3Associe cada tag do GTM ao consentimento correspondente, para que nada dispare antes de Aceitar.
  4. 4Atenção: o GTM não controla trackers carregados fora dele por plugins do CMS. Traga-os para o GTM ou bloqueie-os diretamente.
3Método

Plugin ou módulo de CMS

Recomendado apenas quando existe uma integração CookiePilot documentada para a sua plataforma específica e prefere configurá-la a partir do painel de administração.

Passos

  1. 1Confirme primeiro que existe uma integração CookiePilot documentada para a sua plataforma; caso não exista, use as instruções diretas no <head> ou através do GTM.
  2. 2Verifique o código-fonte gerado da página: o stub consent-default e o banner do CookiePilot têm de aparecer antes dos trackers. Se a ordem estiver errada, corrija-a com o guia direto.
  3. 3Verifique cada plugin de analytics ou marketing separado: cada um continua a precisar de ler o consentimento do CookiePilot antes de carregar.
  4. 4Desative qualquer plugin que dispare os seus próprios scripts sem verificar o consentimento.
4Método

Fontes mistas

Recomendado quando os trackers vêm de vários sítios ao mesmo tempo (tema, plugins, GTM, tags fixas no código).

Passos

  1. 1Inventarie cada fonte de scripts: tema, plugins, GTM e tags fixas no código.
  2. 2Mantenha apenas um stub consent-default e um loader cookiepilot.js em todas as fontes e remova qualquer duplicado, para que nada carregue duas vezes.
  3. 3Associe cada fonte à categoria de consentimento correspondente.
  4. 4Volte a analisar após qualquer alteração para apanhar um novo script que tenha entrado sem bloqueio.

Exemplos de código seguros

Cole estes blocos pela ordem indicada. Substitua os marcadores YOUR_* pelos seus valores.

Ordem de carregamento correta

  1. 1Cole o stub consent-default no topo do <head>, com cada categoria definida como denied.
  2. 2Adicione o script do banner do CookiePilot logo a seguir ao stub.
  3. 3Mova o GA4, o Meta e os restantes trackers para baixo do banner e carregue-os só após o consentimento.
1. consent-default stub
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){ dataLayer.push(arguments); }
  gtag('consent', 'default', {
    ad_storage: 'denied',
    analytics_storage: 'denied',
    ad_user_data: 'denied',
    ad_personalization: 'denied',
    functionality_storage: 'denied',
    personalization_storage: 'denied',
    security_storage: 'granted',
    wait_for_update: 500,
  });
</script>
2. CookiePilot banner
<script async
  src="https://cdn.cookiepilot.io/cookiepilot.js"
  data-cpkey="YOUR_SITE_KEY"
></script>
3. GA4
<script>
  window.addEventListener('cookiepilot:consent', function(event) {
    var consent = event.detail || {};
    if (!consent.analytics || window.__cookiepilotGa4Loaded) return;
    window.__cookiepilotGa4Loaded = true;
    var ga = document.createElement('script');
    ga.async = true;
    ga.src = 'https://www.googletagmanager.com/gtag/js?id=' +
      encodeURIComponent('YOUR_GA4_ID');
    ga.onload = function() {
      gtag('js', new Date());
      gtag('config', 'YOUR_GA4_ID');
    };
    document.head.appendChild(ga);
  });
</script>
3. GTM
<script>
  (function(w,d,s,l,i){
    w[l]=w[l]||[];
    w[l].push({'gtm.start':new Date().getTime(),event:'gtm.js'});
    var f=d.getElementsByTagName(s)[0],j=d.createElement(s),
      dl=l!='dataLayer'?'&l='+l:'';
    j.async=true;
    j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
    f.parentNode.insertBefore(j,f);
  })(window,document,'script','dataLayer','YOUR_GTM_ID');
</script>

Instalar o banner não bloqueia os seus scripts por si só

O CookiePilot mostra o banner e regista o consentimento, mas não consegue bloquear silenciosamente scripts que não controla. Qualquer tracker carregado por um tema, plugin ou tag do GTM continua a disparar até o associar ao consentimento. Trate cada fonte separadamente e confirme que permanece em silêncio antes do consentimento.

Verificar numa sessão limpa

  • Antes do consentimento

    Abra o site numa janela privada nova. Antes de clicar em qualquer coisa, nenhum script de analytics ou marketing deve correr e nenhum cookie não essencial deve ser definido.

  • Após Rejeitar

    Clique em Rejeitar. Recarregue e confirme que os trackers continuam a não carregar e que não aparece nenhum cookie não essencial.

  • Após Aceitar

    Clique em Aceitar. Confirme que os trackers carregam agora e que os seus cookies aparecem, de acordo com as categorias que aceitou.

Pronto para instalar em minutos?

Crie um projeto, copie a sua site key e associe cada tracker a consentimento real.

Começar grátisLer a documentação