Visão geral dos métodos

Quando a biblioteca ACDL (Adobe Client Data Layer) é carregada, ela adiciona os seguintes métodos e propriedades à matriz adobeDataLayer:

Método ou propriedade
Descrição
push()
Adiciona dados, eventos e funções à camada de dados. Disponível antes e depois do carregamento da biblioteca.
getState()
Retorna uma cópia do estado calculado ou do valor em um caminho.
addEventListener()
Chama uma função quando um evento nomeado ou um evento incorporado é acionado.
removeEventListener()
Remove ouvintes que addEventListener() adicionou.
version
Uma cadeia de caracteres que contém a versão da biblioteca ACDL, como "3.0.1".

Chamar métodos com segurança call-safely

Se a ACDL for carregada de forma assíncrona, que é a abordagem recomendada, seu código poderá ser executado antes que a biblioteca seja carregada. Nesse ponto, adobeDataLayer é uma matriz simples: push() existe, mas getState(), addEventListener() e removeEventListener() não.

Para chamar esses métodos com segurança, pressione uma função. A ACDL a executa assim que a biblioteca estiver pronta e transmite a camada de dados como seu argumento:

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

Chamar adobeDataLayer.getState() diretamente funciona somente quando você tem certeza de que o ACDL já foi carregado, como no console de desenvolvedor do seu navegador ou no código que é executado de um ouvinte de eventos ACDL.

Métodos de matriz array-methods

adobeDataLayer ainda é uma matriz JavaScript. Você pode lê-lo com métodos que não o alteram, como filter(), find() e length. Não use métodos que alterem a matriz, como splice() ou shift(). Consulte Fila e histórico.

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