Panoramica dei metodi

Quando viene caricata la libreria Adobe Client Data Layer (ACDL), vengono aggiunti i metodi e le proprietà seguenti all’array adobeDataLayer:

Chiamare i metodi in modo sicuro call-safely

Se ACDL viene caricato in modo asincrono, l’approccio consigliato, il codice può essere eseguito prima del caricamento della libreria. A questo punto, adobeDataLayer è un array semplice: push() esiste, ma getState(), addEventListener() e removeEventListener() non lo sono.

Per chiamare questi metodi in modo sicuro, invia una funzione. ACDL la esegue non appena la libreria è pronta e trasmette il livello dati come suo argomento:

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

La chiamata diretta a adobeDataLayer.getState() funziona solo se si è certi che ACDL sia già stato caricato, ad esempio nella console per sviluppatori del browser o nel codice eseguito da un listener di eventi ACDL.

Metodi array array-methods

adobeDataLayer è ancora un array JavaScript. È possibile leggerlo con metodi che non lo modificano, ad esempio filter(), find() e length. Non utilizzare metodi che modificano l’array, ad esempio splice() o shift(). Vedi Coda e cronologia.