Capa de datos

Cambiar el nombre de la capa de datos

Importante: Cambia el nombre de la capa de datos solo si tu proyecto requiere un nombre diferente. Perderás los datos de medición si no cambias el nombre de todas las referencias existentes.

El nombre predeterminado de la capa de datos de la etiqueta global de sitio web es dataLayer. Para usar un nombre diferente:

• Cambia todas las instancias de "dataLayer" en el fragmento de etiqueta global de sitio web por el nuevo nombre.
• Añade un parámetro de consulta denominado l a la URL para indicar el nuevo nombre de la capa de datos.

<!-- 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 capa de datos personalizados

Si envías una función a la capa de datos, se invocará con this establecido en un modelo de datos resumen. Este modelo de datos resumen puede get (obtener) y set (definir) valores en un almacén de valores clave y, además, muestra una forma de restablecer la capa de datos.

Importante: Para utilizar métodos de capa de datos personalizados, debes .push (enviarlos) directamente a la variable dataLayer. Si usas la etiqueta gtag global, la función se interpretará como un comando gtag no válido y se ignorará.

Get

La función get del modelo de datos resumen te permite recuperar valores que eran 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

La función set del modelo de datos resumen te permite establecer valores para recuperarlos mediante get.

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

Reset

La función reset del modelo de datos resumen te permite restablecer los datos de la capa de datos. Esto resulta más útil en una página de larga duración en la que el tamaño de la capa de datos siga creciendo. Para restablecer la capa de datos, utiliza el siguiente código:

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