Pular para o conteúdo principal

Instalação Manual

Tempo: ~5 minutos Requisitos: Acesso ao código fonte HTML do seu website

Passo 1: Copiar o fragmento de incorporação​

No painel do ConsentForge, aceda a Propriedade → Incorporar e copie o seu fragmento:

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

Passo 2: Adicioná-lo ao seu HTML​

Cole o fragmento antes de </head> — não no final de <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 do ConsentForge deve ser carregado antes de quaisquer scripts de terceiros (Google Analytics, Meta Pixel, etc.) para que o bloqueio de scripts funcione correctamente.

Passo 3: Marcar scripts de terceiros para bloqueio​

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

<!-- ANTES: carrega imediatamente, ignora o 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 para análise
marketingCarrega após consentimento para marketing
functionalCarrega após consentimento funcional

Passo 4: Testar​

Abra o seu site numa janela incógnito. O banner de consentimento deve aparecer antes de qualquer script bloqueado carregar. Verifique no DevTools → Rede que os scripts bloqueados não aparecem antes do 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​

<!-- Utilize 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>