Passar para o conteúdo principal

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

Axeptio envia para GTM eventos e variáveis que você pode usar para configurar seus acionadores de tags.

Escrito por Alexandre Dias Da Silva

Quando você integra o Axeptio com o Google Tag Manager, nosso SDK envia automaticamente vários eventos e variáveis no dataLayer.

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

Aqui está um panorama do que o Axeptio transmite ao GTM, para ajudá-lo a escolher em quais bases contar em seus acionadores.

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 no dataLayer

axeptio_activate_ (e axeptio_enable_)

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

O nome do evento é específico do 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 acionadores de eventos personalizados no GTM: garantem que a tag seja acionada apenas após o consentimento explícito do usuário.

axeptio_disable_

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

axeptio_update

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

Você pode usá-lo como acionador básico, combinado com uma condição na lista de serviços autorizados (veja abaixo), para ativar uma tag apenas se um serviço específico foi aceito.

Modelo de variável Axeptio Consent State

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

Ele é baseado em uma variável do 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 acionadores do GTM.

Exemplo de uso:

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

{{Axeptio Consent State}} contém google_ads

Variável axeptio_authorized_vendors

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

axeptio_authorized_vendors, que contém um array com a lista de 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 duplicados com nomes diferentes (ex. "google_ads" e "Google_Ads"), para garantir compatibilidade com integrações antigas.


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

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

{{DLV - axeptio_authorized_vendors}} contém google_analytics

Isso permite bloquear ou ativar 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?