Versionv1

Instalar o Intastellar Consents no seu site (JavaScript)

Este guia é para um site comum (HTML próprio ou CMS que não está coberto pelos nossos artigos de WordPress ou Shopify). Você não precisa ser desenvolvedor para acompanhar o que vem abaixo — quem colar o trecho deve ler Trecho completo para colar e a tabela dos campos obrigatórios.

Use outro artigo se o site for montado só com:


O que isso faz (e por que importa)

O Intastellar Consents adiciona um banner de cookies / consentimento ao site. Em termos simples:

  • O visitante vê uma escolha clara antes de você depender de consentimento para cookies e armazenamento não essenciais.
  • Funções essenciais do site podem seguir; analytics, anúncios e pixels de redes sociais devem rodar só depois que você os tiver ligados à escolha do visitante (por exemplo com Google Consent Mode e ordem correta das tags no GTM).
  • A configuração fica em window.INTA; o produto carrega uc.js na CDN da Intastellar — o mesmo modelo dos dois blocos no <head> descrito na visão geral do Intastellar Consents.

Este centro de ajuda explica o produto, não o direito. Se precisar de certeza jurídica, consulte profissional habilitado. O que podemos ajudar a verificar é o comportamento técnico: banner visível, escolha armazenada e (com as tags bem configuradas) menos pedidos de rastreamento antes do consentimento.


Antes de começar

  1. Uma página de política de privacidade no seu site que o visitante consiga abrir (link https://… funcionando). Sem isso, o banner costuma ficar oculto de propósito.
  2. Nome da empresa ou do site e, para um visual profissional, URL do logo (https://…).
  3. Acesso ao head / layout compartilhado para todas as páginas carregarem o mesmo trecho — não só uma página estática.

Instalação rápida (duas partes no <head>)

Quem tiver acesso ao HTML deve:

  1. Abrir o modelo que gera o <head> de todo o site.
  2. Logo após <head>, colar primeiro o script pequeno que define window.INTA, depois a linha que carrega uc.js (a ordem importa).
  3. Preencher pelo menos os campos obrigatórios (próxima seção).
  4. Publicar e abrir o site em janela privada / anônima.

Exemplo mínimo (troque os três valores obrigatórios; acrescente campos recomendados assim que puder):

<script>
  window.INTA = {
    policy_link: "https://yourdomain.com/privacy-policy",
    settings: {
      rootDomain: "yourdomain.com",
      company: "Your company name",
      arrange: "ltr",
      color: "#111827",
      logo: "https://yourdomain.com/logo.png",
      design: "overlay",
    },
  };
</script>
<script src="https://consents.cdn.intastellarsolutions.com/uc.js"></script>

Você pode definir a URL da política em policy_link e/ou settings.privacy_policy — se usar ambos, os dois devem apontar para uma página no ar.


Configuração: obrigatório, recomendado e avançado

Tudo em window.INTA não tem a mesma urgência. Use esta ordem:

Obrigatório (sem isso o banner em geral não aparece)

CampoFinalidade
policy_link ou settings.privacy_policyURL funcionando da política de privacidade. Quebrada ou ausente → o banner não renderiza na maioria dos casos.
settings.rootDomainDomínio do site sem https:// (ex.: example.com). Domínio errado → comportamento estranho no armazenamento do consentimento.
settings.companyNome que o visitante vê no banner.

Recomendado (primeira publicação real)

CampoFinalidade
settings.logohttps://… do seu logo — transmite confiança.
settings.colorCor principal da interface (hex).
settings.designex.: overlay — veja Personalizar.
settings.arrangeltr ou rtl para direção do layout.

Opcional / integrações

CampoFinalidade
settings.gtagIdID de medição do Google quando você usa tags Google; costuma ir junto com Consent Mode e ordem correta das tags.
settings.requiredCookies, settings.keepInLocalStorageCookies estritamente necessários e chaves de armazenamento — veja referência INTA.

Lista completa de campos e tipos: esquema JSON window.INTA (para desenvolvedores e agências).


Depois da instalação: o que é “funcionando”

Numa primeira visita em janela privada você deve ver:

  1. Banner visível (se a URL da política e o posicionamento estiverem corretos).
  2. Escolha lembrada no mesmo domínio ao abrir outra página — sem popup quebrado a cada clique.
  3. Scripts não essenciais (analytics, anúncios, pixels) só depois que o visitante aceitou — desde que você tenha carregado essas tags de um modo que escute o consentimento (gtag direto + Consent Mode, acionadores GTM etc.).

Se o banner aparece mas Google Analytics ou Meta disparam na hora, o problema costuma ser ligação das tags, não só o trecho do banner. Ajuste ordem de carga e sinais de consentimento — Google Tag Manager é o lugar comum para isso.


Verificar no navegador (checagem técnica)

Isso não é prova jurídica de conformidade; é um teste rápido que titulares e integradores podem repetir.

  1. Abra o site em janela privada / anônima (ou limpe os dados do site para o seu domínio).
  2. Abra as Ferramentas do desenvolvedorRede.
  3. Recarregue a página antes de clicar em Aceitar / Recusar no banner.
  4. Filtre por nomes que você reconheça (google-analytics, collect, facebook, doubleclick etc.).
  5. Aceite os cookies no banner e recarregue ou navegue — muitas configurações mostram mais pedidos de terceiros ou analytics depois do consentimento.

O que você quer ver depende de como integrou GA4, Meta e outras tags. Se os pedidos disparam antes de entender que o consentimento foi dado, trate como erro de configuração na sua stack de tags, não como algo a ignorar.


Opcional: aparência e comportamento mais profundo

Quando o básico estiver ok, use Personalizar para cores, layout e apresentação. Para passos só de logo, veja Adicionar logo. Para iframes, veja iFrames.


Problemas comuns

O banner não aparece

  1. URL da política — Abra o link de policy_link / privacy_policy numa aba normal.
  2. Posição — Os dois scripts devem estar cedo no <head>, num layout compartilhado.
  3. Cache — Atualização forçada, outro navegador ou espera por CDN / plugins de otimização.
  4. Só uma página — O trecho precisa rodar em todas as páginas que devem exibir o banner.

O banner aparece, mas o rastreamento dispara cedo demais

  • O Consents não desliga sozinho as tags que você injeta em outro lugar. Use Consent Mode, ordem de acionadores no GTM ou carregamento condicional para as tags esperarem o consentimento. Veja Google Tag Manager e Depuração.

Domínio ou consentimento “estranhos” em subdomínios


Trecho completo para colar (inclui campos opcionais)

Copie para o head do site, logo após <head>. Depois substitua os placeholders usando as tabelas acima — não pule as linhas obrigatórias.

<script>
  window.INTA = {
    policy_link: "https://yourdomain.com/privacy-policy",
    settings: {
      rootDomain: "yourdomain.com",
      company: "yourcompany",
      arrange: "ltr",
      color: "#000000",
      logo: "https://yourdomain.com/logo.png",
      design: "overlay",
      gtagId: "G-XXXXXXXXXX",
      requiredCookies: [],
      keepInLocalStorage: [],
    },
  };
</script>
<script src="https://consents.cdn.intastellarsolutions.com/uc.js"></script>

Relacionados

Last updated