Aperçu des méthodes

Lorsque la bibliothèque ACDL (Client Data Layer) d’Adobe se charge, elle ajoute les méthodes et propriétés suivantes au tableau adobeDataLayer :

Méthodes d’appel sécurisées call-safely

Si l’ACDL se charge de manière asynchrone, ce qui est l’approche recommandée, votre code peut s’exécuter avant le chargement de la bibliothèque. À ce stade, adobeDataLayer est un tableau simple : push() existe, mais getState(), addEventListener() et removeEventListener() n’existent pas.

Pour appeler ces méthodes en toute sécurité, insérez une fonction . ACDL l’exécute dès que la bibliothèque est prête et transmet la couche de données comme argument :

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

L’appel direct à adobeDataLayer.getState() ne fonctionne que lorsque vous êtes sûr que l’ACDL a déjà été chargée, par exemple dans la Developer Console de votre navigateur ou dans le code qui s’exécute à partir d’un écouteur d’événement ACDL.

Méthodes de tableau array-methods

adobeDataLayer est toujours un tableau JavaScript. Vous pouvez le lire avec des méthodes qui ne le modifient pas, telles que filter(), find() et length. N’utilisez pas de méthodes qui modifient le tableau, telles que splice() ou shift(). Voir File d’attente et historique.