Hinzufügen von Datenelementen, Regeln und Bibliotheken
In dieser Lektion erstellen Sie Ihr erstes Datenelement, Ihre erste Regel und Ihre erste Bibliothek.
Datenelemente und Regeln sind die grundlegenden Bausteine von Tags. Datenelemente speichern die Attribute, die Sie an Ihre Marketing- und Werbelösungen senden möchten, während Regeln die Anforderungen an diese Lösungen unter den richtigen Bedingungen auslösen. Bibliotheken sind die JavaScript-Dateien, die auf der Seite geladen werden, um alle Aufgaben auszuführen. In dieser Lektion werden Sie alle drei verwenden, damit unsere Beispielseite etwas tut.
- platform launch (Client-seitig) ist jetzt tags
- platform launch Server Side ist jetzt event forwarding
- Edge-Konfigurationen sind jetzt verfügbar datastreams
Lernziele
Am Ende dieser Lektion können Sie:
- ein Datenelement erstellen
- eine Regel erstellen
- eine Bibliothek erstellen
- Änderungen zu einer Bibliothek hinzufügen
- überprüfen, ob Ihre Bibliothek in Ihrem Webbrowser geladen wird
- die Arbeitsbibliothek-Funktion für effizienteres Arbeiten verwenden
Erstellen eines Datenelements für Seitennamen
Datenelemente sind die Tag-Version einer Datenschicht. Sie können Werte aus Ihrem eigenen Daten-Layer-Objekt, Ihren Cookies, Ihren lokalen Speicherobjekten, Ihren Abfragezeichenfolgenparametern, Ihren Seitenelementen, Ihren Meta-Tags usw. speichern. In dieser Übung erstellen Sie ein Datenelement für den Seitennamen, das Sie später in Ihren Target- und Analytics-Implementierungen verwenden werden.
Erstellen eines Datenelements
-
Klicken Sie im linken Navigationsbereich auf Datenelemente
-
Da Sie noch keine Datenelemente in dieser Eigenschaft erstellt haben, wird ein kurzes Video mit zusätzlichen Informationen zu diesem Thema angezeigt. Sehen Sie sich dieses Video an, wenn Sie möchten.
-
Klicken Sie auf die Schaltfläche Neues Datenelement erstellen:
-
Benennen Sie das Datenelement, z. B.
Page Name -
Verwenden Sie den JavaScript-Variablen-Datenelementtyp, um auf einen Wert im Daten-Layer Ihrer Beispielseite zu verweisen:
digitalData.page.pageInfo.pageName -
Markieren Sie die Kästchen für Wert in Kleinbuchstaben erzwingen und Text bereinigen, um die Groß-/Kleinschreibung zu standardisieren und unnötige Leerzeichen zu entfernen
-
Belassen Sie die Einstellung Keine als Speicherdauer, da dieser Wert typischerweise auf jeder Seite unterschiedlich ist.
-
Klicken Sie auf die Schaltfläche Speichern, um das Datenelement zu speichern.
Erstellen einer Regel
Als Nächstes verwenden Sie dieses Datenelement in einer einfachen Regel. Regeln sind eine der leistungsstärksten Funktionen in Tags und ermöglichen es Ihnen, festzulegen, was passieren soll, wenn der Besucher mit Ihrer Website interagiert. Wenn die in Ihren Regeln formulierten Kriterien erfüllt sind, löst die Regel die von Ihnen festgelegte Aktion aus.
Sie erstellen eine Regel, die den Datenelementwert des Seitennamens für die Browserkonsole ausgibt.
Erstellen einer Regel
-
Klicken Sie im linken Navigationsbereich auf Regeln
-
Da Sie noch keine Regeln in dieser Eigenschaft erstellt haben, wird ein kurzes Video mit zusätzlichen Informationen zum Thema angezeigt. Sehen Sie sich dieses Video an, wenn Sie möchten.
-
Klicken Sie auf die Schaltfläche Neue Regel erstellen:
-
Nennen Sie die Regel
All Pages - Library Loaded. Diese Namenskonvention gibt an, wo und wann die Regel ausgelöst wird. Dies erleichtert die Identifizierung und Wiederverwendung während der Entwicklung Ihrer Tag-Eigenschaft. -
Klicken Sie unter „Ereignisse“ auf Hinzufügen. Das Ereignis gibt an, wann Tags ausgelöst werden sollen. Dabei kann es sich um viele Aspekte handeln, darunter Seitenladung, Klick, benutzerspezifisches JavaScript-Ereignis.
-
Wählen Sie als Ereignistyp Bibliothek geladen (Seite oben) aus. Beachten Sie, dass bei der Auswahl des Ereignistyps durch Tags ein Name für das Ereignis anhand Ihrer Auswahl vorausgefüllt wird. Beachten Sie auch, dass die Standardreihenfolge für das Ereignis 50 beträgt. Die Reihenfolge ist eine leistungsstarke Funktion in Tags, die Ihnen eine präzise Steuerung der Aktionssequenz ermöglicht, wenn mehrere Regeln durch dasselbe Ereignis ausgelöst werden. Sie werden diese Funktion später im Tutorial verwenden.
-
Klicken Sie auf die Schaltfläche Änderungen beibehalten.
-
-
Da diese Regel auf allen Seiten ausgelöst werden soll, lassen Sie Bedingungen leer. Wenn Sie das Bedingungsmodalfenster öffnen, können Sie erkennen, dass Bedingungen aufgrund einer Vielzahl von Optionen, wie URLs, Datenelementwerten und Datumsbereichen, sowohl Beschränkungen als auch Ausnahmen hinzufügen können.
-
Klicken Sie unter „Aktionen“ auf Hinzufügen.
-
Wählen Sie Aktionstyp > Benutzerdefinierter Code aus, was derzeit die einzige Option ist. Später im Tutorial werden weitere Optionen zur Verfügung stehen, nachdem Sie Erweiterungen hinzugefügt haben.
-
Wählen Sie </> Editor öffnen aus, um den Codeeditor zu öffnen.
-
Fügen Sie dem Codeeditor Folgendes hinzu. Dieser Code gibt den Wert des Datenelements „Seitenname“ an die Browser-Konsole aus, damit Sie bestätigen können, dass es funktioniert:
code language-javascript console.log('The page name is '+_satellite.getVar('Page Name')); -
Speichern Sie den Codeeditor.
-
Klicken Sie im Fenster „Aktionskonfiguration“ auf Änderungen beibehalten.
-
Klicken Sie auf Speichern, um die Regel zu speichern.
Auf der Seite Regeln sollte Ihre neue Regel angezeigt werden:
Ihre Änderungen in einer Bibliothek speichern
Nachdem Sie eine Sammlung von Erweiterungen, Datenelementen und Regeln in der Datenerfassungsoberfläche konfiguriert haben, müssen Sie diese Funktionen und Logik in einen Satz von JavaScript-Code verpacken, den Sie auf Ihrer Website bereitstellen können, damit Marketing-Tags ausgelöst werden, wenn Besucher zur Site gelangen. Bei einer Bibliothek handelt es sich um den Satz von JavaScript-Code, der dies ausführt.
In einer früheren Lektion haben Sie den Einbettungscode Ihrer Entwicklungsumgebung auf der Beispielseite implementiert. Beim Laden der Beispielseite wurde ein 404-Fehler für die Einbettungscode-URL zurückgegeben, da noch keine Tag-Bibliothek erstellt und der Umgebung zugewiesen war. Fügen Sie jetzt Ihr neues Datenelement und Ihre Regel in eine Bibliothek ein, damit Ihre Beispielseite etwas tun kann.
Hinzufügen und Aufbauen einer Bibliothek
-
Klicken Sie im linken Navigationsbereich auf Veröffentlichungsfluss
-
Klicken Sie auf Neue Bibliothek hinzufügen.
-
Benennen Sie die Bibliothek, z. B.
Initial Setup -
Wählen Sie Umgebung > Entwicklung aus.
-
Klicken Sie auf Alle geänderten Ressourcen hinzufügen.
-
Beachten Sie Folgendes: Alle geänderten Ressourcen hinzufügen -Tags fassen die soeben vorgenommenen Änderungen zusammen.
-
Klicken Sie auf Speichern und Build zur Entwicklung erstellen
Nach einigen Augenblicken wird der Statuspunkt grün und zeigt die erfolgreich erstellte Bibliothek an.
Überprüfen Ihrer Änderungen
Überprüfen Sie jetzt, ob Ihre Regel erwartungsgemäß funktioniert.
Laden Sie Ihre Musterseite erneut. Wenn Sie sich die Registerkarte "Entwicklertools -> Netzwerk"ansehen, sollten Sie jetzt eine Antwort mit 200 für Ihre Tag-Bibliothek sehen!
Wenn Sie sich „Entwicklungstools -> Konsole“ ansehen, sehen Sie den Text „Der Seitenname ist Startseite“.
Herzlichen Glückwunsch! Sie haben Ihr erstes Datenelement und Ihre erste Regel erstellt und Ihre erste Tag-Bibliothek erstellt!
Verwenden der Arbeitsbibliothek-Funktion
Wenn Sie viele Änderungen an Tags vornehmen, ist es nicht praktisch, jedes Mal, wenn Sie das Ergebnis sehen möchten, zur Registerkarte "Veröffentlichung"zu wechseln, Änderungen hinzuzufügen und die Bibliothek zu erstellen. Nachdem Sie die Bibliothek „Ersteinrichtung“ erstellt haben, können Sie die Arbeitsbibliothek-Funktion verwenden, um Ihre Änderungen schnell zu speichern und die Bibliothek in einem Schritt neu zu erstellen.
Nehmen Sie eine kleine Änderung an der Regel „Alle Seiten – Bibliothek geladen“ vor. Klicken Sie im linken Navigationsbereich auf Regeln und klicken Sie dann auf All Pages - Library Loaded -Regel, um sie zu öffnen.
Klicken Sie auf der Edit Rule-Seite auf das Dropdown-Menü Arbeitsbibliothek und wählen Sie Ihre Bibliothek Initial Setup aus.
Nachdem Sie die Bibliothek ausgewählt haben, sollten Sie sehen, dass die Speichern Schaltfläche standardmäßig In Bibliothek speichern. Wenn Sie eine Änderung an Tags vornehmen, können Sie diese Option verwenden, um die Änderung automatisch direkt zu Ihrer Arbeitsbibliothek hinzuzufügen und/oder sie neu zu erstellen.
Testen Sie es aus. Öffnen Sie die Aktion „Benutzerdefinierter Code“ und fügen Sie einen Doppelpunkt nach dem Text „Der Name der Seite ist“ hinzu, sodass der gesamte Codeblock folgendermaßen lautet:
console.log('The page name is: '+_satellite.getVar('Page Name'));
Speichern Sie den Code, behalten Sie die Änderungen in der Aktion bei und klicken Sie jetzt auf die Schaltfläche In Bibliothek speichern und erstellen.
Warten Sie einen Augenblick, bis der grüne Punkt neben dem Dropdown-Menü Arbeitsbibliothek erneut angezeigt wird. Laden Sie jetzt Ihre Beispielseite neu und Sie sollten Ihre Änderung in der Konsolenmeldung sehen (Sie müssen möglicherweise Ihren Browser-Cache löschen und neu laden, um die Änderung an der Seite zu sehen):
Dies ist eine viel schnellere Arbeitsweise und Sie werden diesen Ansatz für den Rest des Tutorials verwenden.
Weiter mit „Wechseln von Umgebungen mit Experience Cloud Debugger“ >