Cola e historial
La matriz adobeDataLayer tiene dos funciones. Antes de que se cargue la biblioteca de la capa de datos del cliente de Adobe (ACDL), hay cola de elementos esperando a procesarse. Una vez cargada la biblioteca, se trata de un historial de los datos y eventos que se insertaron.
Antes de cargar ACDL: una cola queue
Hasta que se cargue la biblioteca, adobeDataLayer es una matriz de JavaScript sin formato y push() es el método de matriz estándar. Cada inserción agrega el elemento al final de la matriz y no hace nada más. Debido a esto, cualquier script puede insertar datos, eventos y funciones en cualquier momento, incluso si la biblioteca aún no se ha descargado.
Cuando se carga la biblioteca de, hace lo siguiente:
- Quita todos los elementos en cola de la matriz.
- Agrega los métodos ACDL a la misma matriz, incluida su propia versión de
push(). - Inserta de nuevo los elementos en cola, uno a la vez, en su orden original. Cada elemento se procesa como si se hubiera insertado después de cargar la biblioteca.
El objeto adobeDataLayer global permanece como la misma matriz en todo. Referencias a que los scripts guardados anteriormente siguen funcionando.
Ejecutar código cuando ACDL esté listo ready
Se garantiza que solo push() existe en la matriz, ya que es posible que la biblioteca aún no se haya cargado. Para llamar a otros métodos, como getState() o addEventListener(), inserte una función:
window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push(function(dl) {
console.log(dl.getState());
dl.addEventListener("click", handleClick);
});
Si ACDL ya se ha cargado, llama a la función inmediatamente. Si no es así, la función espera en la cola y se ejecuta cuando se carga la biblioteca, después de los elementos insertados antes de ella. La función recibe la capa de datos como argumento y como this.
Después de cargar ACDL: un historial history
Una vez cargada la biblioteca, la matriz guarda un registro de lo que se ha insertado. ACDL añade algunos tipos de elementos a la matriz y elimina otros:
event y eventInfoEl historial contiene los objetos insertados, no copias de ellos. Si cambia un objeto después de insertarlo, el historial mostrará el cambio, pero el estado calculado no.
Puede inspeccionar el historial en la consola del desarrollador del explorador escribiendo adobeDataLayer y expandiendo la matriz. El número de elementos en el historial es adobeDataLayer.length.
Orden de los elementos insertados desde los oyentes nested-order
Cuando un detector de eventos inserta un elemento, ACDL procesa ese elemento antes de que termine de procesar el elemento que activó el detector. Como resultado, el artículo que el oyente insertó aparece en el historial antes del artículo que lo activó.
Uso del historial por parte de los oyentes replay
Cuando agrega un agente de escucha con el past o all ámbito, ACDL lo llama inmediatamente para cada elemento coincidente del historial, en orden. Esta reproducción permite que los scripts que se cargan tarde, como una biblioteca de etiquetas, reaccionen a los eventos que se produjeron antes de que se cargaran.
La reproducción utiliza los elementos que están en la matriz cuando se añade el listener. Si se borró el historial, los elementos borrados no se vuelven a reproducir.
No modifique la matriz directamente modify
Agregue elementos a la capa de datos solamente con push(). No use otros métodos de matriz de JavaScript que cambien la matriz, como pop(), shift(), unshift(), splice(), sort(), reverse(), fill() o copyWithin(). Estos métodos omiten ACDL, por lo que el estado calculado y los oyentes no reflejan el cambio, y las repeticiones de los nuevos oyentes se vuelven incoherentes.
Puede leer la matriz con métodos que no la cambien, como filter() o find().
Borrar el historial clear
Cada inserción que mantiene ACDL agrega un elemento a la matriz. En páginas que permanecen abiertas durante mucho tiempo, como aplicaciones de una sola página, el historial sigue creciendo. Puede borrarla con un salto natural, como después de cada vista de página virtual.
Borrar el historial no cambia el estado calculado ni elimina los agentes de escucha. Solo afecta a los elementos que se reproducen para los agentes de escucha que se agregan posteriormente con el ámbito past o all.
-
Si usa etiquetas, use la acción Borrar historial de la capa de datos en la extensión de etiqueta ACDL. Puede mantener una instantánea del estado calculado actual en la matriz o dejar vacía la matriz.
-
En su propio código, establezca la longitud de la matriz en
0después de cargar ACDL:code language-js window.adobeDataLayer.push(function(dl) { dl.length = 0; });