Pular para o conteúdo principal

Instalação Manual

Tempo: ~5 minutos Requer: Acesso ao código fonte HTML do seu site

Passo 1: Copie o seu snippet de incorporação​

No seu painel ConsentForge, vá a Propriedade → Incorporar e copie o seu snippet:

<script
  src="https://cdn.consentforge.com/consentforge.min.js"
  data-token="YOUR_EMBED_TOKEN"
  data-position="bottom"
  data-theme="auto"
  defer
></script>

Passo 2: Adicione-o ao seu HTML​

Cole o snippet antes de </head> — não no fundo do <body>.

<!DOCTYPE html>
<html>
<head>
  <meta charset="UTF-8">
  <title>O Meu Site</title>
  <!-- ConsentForge — deve estar antes de quaisquer scripts de terceiros -->
  <script
    src="https://cdn.consentforge.com/consentforge.min.js"
    data-token="cf_live_abc123"
    defer
  ></script>
</head>
<body>
  ...
</body>
</html>
A ordem é importante

O script ConsentForge deve carregar antes de quaisquer scripts de terceiros (Google Analytics, Meta Pixel, etc.) para que o bloqueio de scripts funcione corretamente.

Passo 3: Marque scripts de terceiros para bloqueio​

Adicione type="text/plain" e data-consent-category a qualquer script que pretende bloquear até o consentimento ser dado:

<!-- ANTES: carrega imediatamente, ignora consentimento -->
<script src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXX"></script>

<!-- DEPOIS: bloqueado até o utilizador consentir em "analytics" -->
<script
  type="text/plain"
  data-consent-category="analytics"
  src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXX"
></script>

Valores de categoria:

ValorSignificado
necessaryCarrega sempre (sem bloqueio)
analyticsCarrega após consentimento de análises
marketingCarrega após consentimento de marketing
functionalCarrega após consentimento funcional

Passo 4: Teste​

Abra o seu site numa janela incógnito. O banner de consentimento deve aparecer antes que qualquer script bloqueado seja carregado. Verifique em DevTools → Rede que os scripts bloqueados não aparecem até após o consentimento.

Exemplos comuns​

Google Analytics 4​

<script type="text/plain" data-consent-category="analytics"
  src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXX"></script>
<script type="text/plain" data-consent-category="analytics">
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());
  gtag('config', 'G-XXXXXX');
</script>

Meta Pixel​

<script type="text/plain" data-consent-category="marketing">
  !function(f,b,e,v,n,t,s)
  {if(f.fbq)return;n=f.fbq=function(){...}
  fbq('init', 'YOUR_PIXEL_ID');
  fbq('track', 'PageView');
</script>

Incorporação YouTube​

<!-- Use data-src em vez de src -->
<iframe
  data-src="https://www.youtube.com/embed/VIDEO_ID"
  data-consent-category="marketing"
  width="560" height="315"
  frameborder="0">
</iframe>