Fila e histórico
A matriz adobeDataLayer tem duas funções. Antes de carregar a biblioteca ACDL (Adobe Client Data Layer), ela é uma fila de itens aguardando para serem processados. Depois que a biblioteca é carregada, é um histórico dos dados e eventos que foram enviados.
Antes do carregamento da ACDL: uma fila queue
Até que a biblioteca seja carregada, adobeDataLayer é uma matriz JavaScript simples e push() é o método de matriz padrão. Cada push adiciona o item ao final da matriz e não faz mais nada. Por esse motivo, qualquer script pode enviar dados, eventos e funções a qualquer momento, mesmo que a biblioteca ainda não tenha sido baixada.
Quando a biblioteca é carregada, ela faz o seguinte:
- Remove todos os itens em fila da matriz.
- Adiciona os métodos ACDL à mesma matriz, incluindo sua própria versão de
push(). - Envia novamente os itens em fila, um de cada vez, em sua ordem original. Cada item é processado como se tivesse sido enviado após o carregamento da biblioteca.
O objeto global adobeDataLayer permanece a mesma matriz em todo o processo. Referências a ele que os scripts salvos anteriormente continuam funcionando.
Executar código quando o ACDL estiver pronto ready
É garantido que apenas push() exista na matriz, porque talvez a biblioteca ainda não tenha sido carregada. Para chamar outros métodos, como getState() ou addEventListener(), envie uma função por push:
window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push(function(dl) {
console.log(dl.getState());
dl.addEventListener("click", handleClick);
});
Se a ACDL já tiver sido carregada, ela chamará a função imediatamente. Caso contrário, a função aguardará na fila e será executada quando a biblioteca for carregada, após os itens que foram enviados antes dela. A função recebe a camada de dados como seu argumento e como this.
Após o carregamento da ACDL: um histórico history
Depois que a biblioteca é carregada, a matriz mantém um registro do que foi enviado. A ACDL adiciona alguns tipos de itens ao array e remove outros:
event e eventInfoO histórico retém os objetos que você enviou, não cópias deles. Se você alterar um objeto depois de enviá-lo, o histórico mostrará a alteração, mas o estado computado não mostra.
Para inspecionar o histórico no console do desenvolvedor do seu navegador, digite adobeDataLayer e expanda a matriz. O número de itens no histórico é adobeDataLayer.length.
Ordem dos itens enviados por push dos ouvintes nested-order
Quando um ouvinte de eventos envia um item, o ACDL processa esse item antes de terminar de processar o item que acionou o ouvinte. Como resultado, o item enviado pelo listener aparece no histórico antes do item que o acionou.
Como os ouvintes usam o histórico replay
Quando você adiciona um ouvinte com o past ou all escopo, o ACDL o chama imediatamente para cada item correspondente no histórico, em ordem. Essa repetição permite que os scripts carregados com atraso, como uma biblioteca de tags, reajam a eventos que ocorreram antes de serem carregados.
A repetição usa os itens que estão na matriz quando o ouvinte é adicionado. Se o histórico tiver sido limpo, os itens limpos não serão repetidos.
Não modifique a matriz diretamente modify
Adicionar itens à camada de dados somente com push(). Não use outros métodos de matriz do JavaScript que alterem a matriz, como pop(), shift(), unshift(), splice(), sort(), reverse(), fill() ou copyWithin(). Esses métodos ignoram o ACDL, de modo que o estado calculado e os ouvintes não refletem a alteração e as repetições de novos ouvintes tornam-se inconsistentes.
Você pode ler a matriz com métodos que não a alteram, como filter() ou find().
Limpar o histórico clear
Cada push mantido pelo ACDL adiciona um item ao storage. Em páginas que permanecem abertas por muito tempo, como aplicativos de página única, o histórico continua crescendo. Você pode limpá-la em uma interrupção natural, como depois de cada exibição de página virtual.
A limpeza do histórico não altera o estado computado nem remove ouvintes. Ela afeta apenas quais itens são repetidos para ouvintes adicionados posteriormente com o escopo past ou all.
-
Se você usar marcas, use a ação Limpar histórico da camada de dados na extensão de marca ACDL. Ele pode manter um instantâneo do estado calculado atual na matriz ou deixar a matriz vazia.
-
Em seu próprio código, defina o comprimento da matriz como
0depois que o ACDL for carregado:code language-js window.adobeDataLayer.push(function(dl) { dl.length = 0; });