Eventos e API

Para categorias, estados e responsabilidades na stack, veja Conceitos fundamentais.

O que este portal de desenvolvedores documenta

Superfície	Finalidade
window.INTA	Objeto bootstrap antes de uc.js rodar—URL da política, domínio, empresa, gtagId opcional, opções de UI (JSON Schema).
Padrões de integração	Ordem de disparo GTM, GA4, Meta, Google Consent Mode (Integrations overview).

Esses são os contratos de integração suportados para construir em inta.dev.

cookie_consent_update (Google Tag Manager / dataLayer)

Quando o visitante altera o consentimento (aceitar, recusar, atualização granular, etc.), o banner envia uma entrada para o array Google dataLayer (o mesmo objeto que o GTM usa quando dataLayer é inicializado antes do carregamento do GTM).

Detalhe	Valor
Nome do evento	cookie_consent_update
Onde aparece	dataLayer—visível no GTM Preview (aba Data Layer) e no navegador após interação com o banner

Uso no GTM

1. Triggers → New → Custom Event
2. Event name: cookie_consent_update (correspondência exata, salvo se usar trigger regex de propósito)
3. Anexe este trigger às tags que devem rodar quando o consentimento mudar (ex. após aceitar estatísticas ou marketing), além das configurações de Consent nessas tags.

O push inclui um objeto de dados junto ao evento (campos relacionados ao consentimento). Não codifique em pedra suposições sobre cada propriedade—abra GTM Preview, faça uma ação de consentimento e leia o estado atual do Data Layer do seu deployment.

Se o GTM não estiver na página, garanta que window.dataLayer = window.dataLayer || [] exista antes de uc.js quando depender deste evento para outros consumidores.

API JavaScript programática (runtime)

Não há uma „API JavaScript CMP“ pública separada documentada neste portal (nenhum global garantido como window.IntastellarConsents.* para produção). Para GTM, use o evento dataLayer cookie_consent_update acima. Caso contrário:

• Controle o comportamento via window.INTA e uc.js conforme documentado.
• Use Google Tag Manager (ou a camada de tags da sua stack) para triggers e tags de fornecedores.
• Apoie-se em mecanismos de consentimento dos fornecedores (ex.: Google Consent Mode, parâmetros Meta) quando aplicável.

Se sua organização publicar uma API runtime versionada para um build CDN ou tier enterprise específico, adicione a URL canônica ao frontmatter desta página ou ao início da documentação quando estiver estável.

Lista de verificação prática

1. Valide o comportamento orientado a consentimento com GTM Preview ou a ordem de carregamento do seu bundler.
2. Use DevTools (Application → cookies / storage, Network) para confirmar que as tags se alinham ao consentimento antes e depois das escolhas.
3. Se algo precisar rodar quando o consentimento mudar, use um trigger Custom Event em cookie_consent_update (veja acima) ou código de aplicação que rode depois da CMP—not globals não documentados.

Sinais de consentimento para terceiros

Intastellar Consents repassa sinais de consentimento para stacks suportadas quando configurado, para que você não precise ligar cada fornecedor manualmente. Parâmetros específicos de plataforma ainda seguem Google, Meta, Microsoft, etc.—veja Integrations overview.