Passar para o conteúdo principal

Como Axeptio se comunica com GTM: eventos e variáveis

Escrito por Alexandre Dias Da Silva

Ao integrar Axeptio com Google Tag Manager, nosso SDK envia automaticamente vários eventos e variáveis na dataLayer.

Esses dados podem ser usados para disparar ou bloquear certas tags de acordo com o estado do consentimento, e se adaptam a diferentes contextos técnicos.

Aqui está uma visão geral do que Axeptio transmite para GTM, para ajudá-lo a escolher no que confiar em seus disparadores.

O nome técnico dos serviços, utilizado tanto no nível dos eventos (ex.: axeptio_activate_google_analytics) quanto no conteúdo das variáveis (axeptio_authorized_vendors: ["google_analytics"]), é definido no nível dos cookies que você adicionou na configuração do seu projeto Axeptio (consulte o artigo Recuperar os nomes técnicos de seus serviços).

Eventos enviados na dataLayer

axeptio_activate_ (e axeptio_enable_)

Sempre que um usuário interage com o banner Axeptio (aceita um serviço, modifica suas escolhas, etc.), um evento é enviado na dataLayer.

O nome do evento é específico para o serviço em questão.

Exemplos:

  • axeptio_activate_facebook_pixel

  • axeptio_activate_google_analytics

  • axeptio_activate_google_ads

Esses eventos são úteis para criar disparadores de eventos personalizados no GTM: eles garantem que a tag seja disparada apenas após o consentimento explícito do usuário.

axeptio_disable_

Quando o usuário recusa um serviço ou retira seu consentimento, Axeptio envia um evento axeptio_disable_<nome_do_serviço> na dataLayer.

axeptio_update

Este evento é enviado a cada atualização do consentimento, seja na primeira exibição do banner ou ao fazer uma alteração via widget.

Você pode usá-lo como disparador base, combinado com uma condição na lista de serviços autorizados (veja abaixo), para disparar uma tag apenas se um determinado serviço foi aceito.

Modelo de variável Axeptio Consent State

O modelo de variável Axeptio Consent State, disponível na galeria GTM, permite recuperar facilmente a lista dos serviços para os quais o usuário deu seu consentimento.

Ele se baseia em uma variável da dataLayer chamada axeptio_authorized_vendors (apresentada na próxima seção), mas tem a vantagem de ser pronto para usar, mais legível e mais simples de usar em seus disparadores GTM.

Exemplo de uso:

Crie uma variável Axeptio Consent State baseada neste modelo e adicione uma condição aos seus disparadores:

{{Axeptio Consent State}} contém google_ads

Variável axeptio_authorized_vendors

A cada axeptio_update, uma variável também é enviada para a dataLayer:

axeptio_authorized_vendors, que contém um array com a lista dos serviços para os quais o usuário deu seu consentimento.

Exemplo de valor:

axeptio_authorized_vendors: [  "google_analytics",  "google_ads",  "clarity",  "facebook_pixel",  "mailchimp",  "hubspot",  "youtube",  "googletagmanager",  "axeptio",  "cloudflare",  "$$googleConsentMode",  "Google_Ads",  "MailChimp",  "Youtube",  "CloudFlare",  "$$completed"]

  • Alguns serviços podem aparecer em duplicata com nomes diferentes (ex. "google_ads" e "Google_Ads"), para garantir compatibilidade com integrações antigas.


  • As entradas que começam com $$ são serviços técnicos internos usados pelo SDK (como $$googleConsentMode ou $$completed)

No GTM, você pode criar uma variável da camada de dados apontando para axeptio_authorized_vendors e usá-la em seus disparadores:

{{DLV - axeptio_authorized_vendors}} contém google_analytics

Isso permite bloquear ou disparar uma tag dependendo se o serviço em questão tem consentimento ou não.

Opções avançadas

Nosso modelo de tag Axeptio CMP possui duas opções que influenciam o comportamento descrito neste artigo: dataLayer Name e Trigger GTM Events. Para sua descrição completa, consulte Parâmetros do template GTM Axeptio CMP.

Respondeu à sua pergunta?