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:

  1. Remove todos os itens em fila da matriz.
  2. Adiciona os métodos ACDL à mesma matriz, incluindo sua própria versão de push().
  3. 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.

IMPORTANT
Se uma função na fila emitir um erro enquanto a biblioteca é carregada, o ACDL interrompe o processamento da fila. Os itens que foram enfileirados após essa função são perdidos. Detectar erros dentro das funções que você pressiona.

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:

Item enviado
Mantido na matriz
Objeto de dados
Sim
Objeto de evento, incluindo suas chaves event e eventInfo
Sim
Função
Não. A ACDL a chama e não a mantém.
Item inválido, como uma sequência ou um número
Não. O ACDL registra um erro e não o mantém.

O 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 0 depois que o ACDL for carregado:

    code language-js
    window.adobeDataLayer.push(function(dl) {
      dl.length = 0;
    });
    
recommendation-more-help
experience-platform-help-collection