Übersicht über Methoden

Beim Laden der Adobe Client Data Layer (ACDL)-Bibliothek werden dem adobeDataLayer-Array die folgenden Methoden und Eigenschaften hinzugefügt:

Methode oder Eigenschaft
Beschreibung
push()
Fügt der Datenschicht Daten, Ereignisse und Funktionen hinzu. Verfügbar vor und nach dem Laden der Bibliothek.
getState()
Gibt eine Kopie des berechneten Status oder des Werts unter einem Pfad zurück.
addEventListener()
Ruft eine Funktion auf, wenn ein benanntes Ereignis oder ein integriertes Ereignis ausgelöst wird.
removeEventListener()
Entfernt Listener, die hinzugefügt addEventListener().
version
Eine Zeichenfolge, die die Version der ACDL-Bibliothek enthält, z. B. "3.0.1".

Methoden sicher aufrufen call-safely

Wenn ACDL asynchron geladen wird, was der empfohlene Ansatz ist, kann der Code ausgeführt werden, bevor die Bibliothek geladen wird. An diesem Punkt ist adobeDataLayer ein einfaches Array: push() existiert, aber getState(), addEventListener() und removeEventListener() nicht.

Um diese Methoden sicher aufzurufen, drücken Sie eine -Funktion. ACDL führt es aus, sobald die Bibliothek bereit ist, und übergibt die Datenschicht als Argument:

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

Der direkte Aufruf von adobeDataLayer.getState() funktioniert nur, wenn Sie sicher sind, dass ACDL bereits geladen wurde, z. B. in der Entwicklerkonsole Ihres Browsers oder in Code, der von einem ACDL-Ereignis-Listener ausgeführt wird.

Array-Methoden array-methods

adobeDataLayer ist immer noch ein JavaScript-Array. Sie können sie mit Methoden lesen, die sie nicht ändern, z. B. filter(), find() und length. Verwenden Sie keine Methoden zum Ändern des Arrays, z. B. splice() oder shift(). Siehe Warteschlange und ​.

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