Google Data Layer-Erweiterung

Mit der Google Data Layer-Erweiterung können Sie eine Google-Datenschicht in Ihrer Tag-Implementierung verwenden. Die Erweiterung kann unabhängig oder gleichzeitig mit Google-Lösungen und der Open Source von Google verwendet werden Data Layer Helper Library.

Die Hilfsbibliothek bietet ähnliche ereignisgesteuerte Funktionen wie der Adobe Client Data Dayer (ACDL). Die Datenelemente, Regeln und Aktionen der Google-Datenschicht-Erweiterung bieten ähnliche Funktionen wie die im ACDL-Erweiterung.

Laufzeit

Version 1.2.x ist eine Beta-Version, die in der Produktion verwendet wird.

Installation

Um die Erweiterung zu installieren, navigieren Sie zum Erweiterungskatalog in der Datenerfassungs-Benutzeroberfläche und wählen Sie Google-Datenschicht.

Nach der Installation erstellt oder greift die Erweiterung auf eine Datenschicht bei jedem Laden der Adobe Experience Platform Tags-Bibliothek zu.

Erweiterungsansicht

Die Erweiterungskonfiguration kann verwendet werden, um den Namen der Datenschicht zu definieren, die die Erweiterung nutzt. Wenn beim Laden von Adobe Experience Platform-Tags keine Datenschicht mit dem konfigurierten Namen vorhanden ist, erstellt die Erweiterung eine.

Der Standardwert für den Datenschichtnamen ist der Google-Standardname dataLayer.

Ereignisse

Die Erweiterung bietet Ihnen die Möglichkeit, auf Änderungen auf der Datenschicht zu warten.

Suchen Sie nach allen Push-Benachrichtigungen auf der Datenschicht.

Wenn Sie diese Option auswählen, überwacht Ihr Ereignis-Listener alle Änderungen an der Datenschicht.

Nach Push-Benachrichtigungen zum Ausschließen von Ereignissen suchen

Wenn Sie diese Option auswählen, überwacht Ihr Ereignis-Listener alle Datenübertragungen an die Datenschicht, wobei Ereignisse ausgeschlossen sind.

Das folgende Beispiel für Push-Ereignisse wird vom Listener verfolgt:

dataLayer.push({"data":"something"})

Das folgende Beispiel für Push-Ereignisse wird vom Listener nicht verfolgt:

dataLayer.push({"event":"myevent"})
dataLayer.push({"event":"myevent","data":"something"})

Alle Ereignisse überwachen

Wenn Sie diese Option auswählen, überwacht Ihr Ereignis-Listener alle Ereignisse, die an die Datenschicht gepusht werden.

Das folgende Beispiel für Push-Ereignisse wird vom Listener verfolgt:

dataLayer.push({"event":"myevent"})
dataLayer.push({"event":"myevent","data":"something"})

Das folgende Beispiel für ein Push-Ereignis wird vom Listener nicht verfolgt:

dataLayer.push({"data":"something"})

Suchen nach bestimmten Ereignissen

Wenn Sie ein Ereignis angeben, verfolgt der Ereignis-Listener alle Ereignisse, die mit einer bestimmten Zeichenfolge übereinstimmen.

Wenn Sie beispielsweise myEvent bei Verwendung dieser Konfiguration festlegen, verfolgt der Listener nur das folgende Push-Ereignis:

dataLayer.push({"event":"myEvent"})

Es kann ein (ECMAScript-/JavaScript-) Regex verwendet werden, um Ereignisnamen zuzuordnen.

Wenn beispielsweise "myEvent\d"festgelegt wird, wird myEvent mit einer Ziffer (\d):

dataLayer.push({"event":"myEvent1"})
dataLayer.push({"event":"myEvent2"})

Aktionen

Pushen zur Datenschicht

Die -Erweiterung bietet zwei Aktionen, um JSON an die Datenschicht zu pushen. ein freies Textfeld zur manuellen Erstellung des zu übertragenden JSON-Codes und ab Version 1.2.0 ein Multifield-Dialogfeld mit Schlüsselwerten.

Free text JSON

Die Aktion "Freitext"ermöglicht die direkte Verwendung von Datenelementen in der JSON-Datei. Innerhalb des JSON-Editors sollten Datenelemente mit der Prozentnotation referenziert werden. Beispiel: %dataElementName%.

{
    "page": {
        "url": "%url%",
        "previous_url": "%previous_url%",
        "concatenated_values": "static string %dataElement%"
    }
}

Mehrfeld für Schlüssel-Wert

Das neuere multifield-Dialogfeld mit dem Schlüssel-Wert-Wert ist eine benutzerfreundlichere Benutzeroberfläche, mit der ein Push-Vorgang konfiguriert werden kann, ohne JSON manuell zu schreiben.

Google DL auf berechneten Status zurücksetzen

Die -Erweiterung bietet Ihnen eine Aktion zum Zurücksetzen der Datenschicht. Wenn sie in einer Regel verwendet wird, die eine Google-Datenschichtänderung verarbeitet, wird die Datenschicht zum Zeitpunkt der Regelauslösung auf den berechneten Status der Datenschicht zurückgesetzt. Wenn die Aktion in einer Regel verwendet wird, die keine Änderung der Google-Datenschicht verarbeitet, wird die Datenschicht durch die Aktion geleert.

Datenelemente

Das bereitgestellte Datenelement kann während der Ausführung einer Regel verwendet werden, die durch eine Google-Datenschichtänderung (Push-Ereignis) ausgelöst wird, oder in einer nicht verwandten Regel wie "Bibliothek geladen". Im ersten Fall gibt das Datenelement einen Wert zurück, der aus dem berechneten Status zum Zeitpunkt der Datenschichtänderung entnommen wurde. Im letzteren Fall wird der berechnete Status zum Zeitpunkt der Regelausführung verwendet.

Mit einem Umschalter können Sie auswählen, ob das Datenelement Werte aus dem gesamten berechneten Status oder nur aus Ereignisinformationen zurückgeben soll (wenn es in einer durch eine Datenschichtänderung ausgelösten Regel verwendet wird).

Das Datenelement kann daher Folgendes zurückgeben:

• Leeres Feld: berechneter Status der Datenschicht.
• Feld mit Schlüssel (z. B. page.previous_url im obigen Beispiel): -Wert des Schlüssels im Ereignisobjekt oder im berechneten Status.

Zusätzliche Informationen

Die Datenelement- und Ereignisdialogfelder der Erweiterung enthalten detaillierte Nutzungsinformationen und Beispiele.

Weitere allgemeine Informationen finden Sie unter Projekt README

Ressourcen für Business.Adobe.com