Información general sobre métodos

Cuando se carga la biblioteca de la capa de datos del cliente de Adobe (ACDL), agrega los siguientes métodos y propiedades a la matriz adobeDataLayer:

Método o propiedad
Descripción
push()
Agrega datos, eventos y funciones a la capa de datos. Disponible antes y después de que se cargue la biblioteca.
getState()
Devuelve una copia del estado calculado o del valor de una ruta.
addEventListener()
Llama a una función cuando se activa un evento con nombre o un evento integrado.
removeEventListener()
Quita los agentes de escucha que addEventListener() agregó.
version
Cadena que contiene la versión de la biblioteca ACDL, como "3.0.1".

Llamar a métodos de forma segura call-safely

Si ACDL se carga asincrónicamente, que es el método recomendado, el código se puede ejecutar antes de que se cargue la biblioteca. En ese momento, adobeDataLayer es una matriz sin formato: push() existe, pero getState(), addEventListener() y removeEventListener() no existe.

Para llamar a estos métodos de forma segura, inserte una función. ACDL lo ejecuta en cuanto la biblioteca está lista y pasa la capa de datos como su argumento:

window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push(function(dl) {
  const title = dl.getState("page.title");
  dl.addEventListener("cart add", handleCartAdd);
});

Llamar a adobeDataLayer.getState() directamente solo funciona cuando está seguro de que ACDL ya se ha cargado, como en la consola para desarrolladores del explorador o en código que se ejecuta desde un detector de eventos ACDL.

Métodos de matriz array-methods

adobeDataLayer sigue siendo una matriz de JavaScript. Puede leerlo con métodos que no lo cambien, como filter(), find() y length. No utilice métodos que cambien la matriz, como splice() o shift(). Ver Cola e historial.

recommendation-more-help
experience-platform-help-collection