Camada de dados

Renomear a camada de dados

O nome padrão da camada de dados pela tag global do site é dataLayer. Para usar um nome diferente, faça o seguinte:

  • Atualize todas as instâncias de "dataLayer" no snippet da tag global do site para o novo nome.
  • Adicione um parâmetro de consulta chamado l ao URL para definir o novo nome da camada de dados.
<!-- Global site tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=GA_MEASUREMENT_ID&l=gDataLayer"></script>
<script>
  window.gDataLayer = window.gDataLayer || [];
  function gtag(){gDataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'GA_MEASUREMENT_ID');
</script>

Métodos de camada de dados personalizados

Se você enviar uma função para a camada de dados, ela será invocada com this definido como um modelo de dados abstratos. Esse modelo pode get e set valores para um armazenamento de chave-valor, além de expor uma maneira de redefinir a camada de dados.

Get

A função get no modelo de dados abstratos permite recuperar valores que foram set.

window.dataLayer.push(function() {
  const existingTime = this.get('time');
  if (existingTime !== null) {
    // Change behavior based on whether or not this value exists...
  } else {
    // ...
  }
})

Set

Com a função set no modelo de dados abstratos, você define valores a serem recuperados por meio da função get.

window.dataLayer.push(function() {
  this.set('time', new Date());
})

Reset

A função reset no modelo de dados abstratos permite redefinir os dados na camada de dados. Ela é mais útil em uma página de longa duração em que o tamanho da camada de dados continua a crescer com o tempo. Para redefinir a camada de dados, use o seguinte código:

window.dataLayer.push(function() {
  this.reset();
})