Central de ajuda › Recursos do aviso
API JavaScript
window.AccessConsent: consultar, ouvir mudanças, abrir preferências, ligar à conta.
| Chamada | O que faz |
|---|---|
AccessConsent.getConsent() | { categories, decided, visitorId, decidedAt, versionId, lang, gpc } |
AccessConsent.get() | categorias liberadas: { necessary, functional, analytics, marketing } |
AccessConsent.has('analytics') | true se a categoria está liberada |
AccessConsent.decided() | a pessoa já decidiu neste site? |
AccessConsent.onChange(fn) | chama fn(detail) a cada mudança; devolve a função que cancela a inscrição |
AccessConsent.on('change', fn) | o mesmo que onChange |
AccessConsent.open() | abre as preferências (o mesmo que clicar em [data-consent-open]) |
AccessConsent.setAccount(ref) | liga a decisão à conta do cliente logado (chame antes da decisão) |
AccessConsent.visitorId() | identificador aleatório deste navegador |
AccessConsent.accept(doc, subject, opts) | registra o aceite de um documento — ver Aceite de documentos |
AccessConsent.crossDomainUrl(url) | promessa com o endereço levando a decisão para outro domínio do grupo — ver Consentimento entre domínios |
Eventos
detail = { categories, decided, source, gpc }, com source: decision (escolheu agora), restore (escolha anterior, em cada página), carry_over (herdada de outro site da empresa — subdomínio ou outro domínio do grupo) ou none (sem decisão).
document.addEventListener('accessconsent:change', (e) => console.log(e.detail));Quando há decisão, o mesmo vai para o dataLayer:
{ event: 'access_consent_update',
access_consent: { necessary: true, functional: false, analytics: true, marketing: false,
decided: true, source: 'decision', gpc: false } }O que fica no navegador
O cookie ac_consent (necessário, 365 dias) guarda o identificador aleatório e a escolha. Se o envio falhar (sem internet), a decisão espera numa fila local (ac_consent_q) e é reenviada. A escolha é pedida de novo após 12 meses ou quando uma versão nova do aviso exige novo consentimento.