DokumentationExperience PlatformWeb SDK-Tutorial

Tag-Regeln erstellen

Last update: Thu Mar 05 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Einsteiger
  • Fortgeschrittener
  • Entwickler

Erfahren Sie, wie Sie Ereignisse mithilfe von Tag-Regeln an Adobe Experience Platform Edge Network senden. Eine Tag-Regel ist eine Kombination aus Ereignissen, Bedingungen und Aktionen, die die Tag-Eigenschaft anweist, etwas zu tun. Bei Platform Web SDK werden Regeln verwendet, um Ereignisse mit den richtigen Daten an Platform Edge Network zu senden.

Lernziele

Am Ende dieser Lektion können Sie:

  • Verwenden einer Namenskonvention zum Verwalten von Regeln in Tags
  • Senden eines Ereignisses mit XDM-Feldern mithilfe der Aktionen „Variable aktualisieren“ und „Ereignis senden“
  • Stapeln mehrerer Sätze von XDM-Feldern über mehrere Regeln hinweg
  • Ordnen Sie einzelne oder gesamte Array-Datenelemente dem XDM-Objekt zu
  • Veröffentlichen einer Tag-Regel in einer Entwicklungsbibliothek

Voraussetzungen

Sie sind mit Datenerfassungs-Tags und der Demo-Website von Luma vertraut und haben die vorherigen Lektionen im Tutorial abgeschlossen:

Benennungskonventionen

Um Regeln in Tags zu verwalten, wird empfohlen, eine standardmäßige Namenskonvention zu befolgen. In diesem Tutorial wird eine vierteilige Namenskonvention verwendet:

  • [Location] - [Event] - [Purpose] - [order]

wenn:

  1. location die Seite(n) auf der Site, auf der die Regel ausgelöst wird
  2. event ist der Trigger für die Regel
  3. Zweck ist die Hauptaktion, die von der Regel ausgeführt wird
  4. order ist die Reihenfolge, in der die Regel im Verhältnis zu anderen Regeln mit demselben Ereignis ausgelöst werden soll

Hinzufügen der Adobe Client-Datenschicht-Erweiterung

Die Luma-Website verwendet eine ereignisgesteuerte Datenschicht namens Adobe Client Data Layer (ACDL). Wenn ein Datenschichtereignis auftritt, wird es in das adobeDataLayer-Array gepusht. In diesem Tutorial wird eine Tag-Erweiterung namens Adobe Client Data Layer verwendet, um diese Ereignisse zur Erstellung Ihrer Regeln bequem anzuzapfen.

So fügen Sie die Erweiterung hinzu:

  1. Navigieren Sie zu Erweiterungen

  2. Nach Adobe Client-Datenschicht filtern

  3. Wählen Sie Installieren

    Adobe Client-Datenschicht-Erweiterung hinzufügen

  4. Standardeinstellungen beibehalten

  5. Wählen Sie Speichern

NOTE
Es ist nicht erforderlich, die Adobe-Client-Datenschicht zu verwenden, um Experience Platform Web SDK zu implementieren. Viele andere Ereignistypen werden häufig in Tag-Implementierungen verwendet (Bibliothek geladen, DOM bereit, Fenster geladen usw.), um Regeln auszulösen.

Tag-Regeln erstellen

In Tags werden Regeln verwendet, um Aktionen auszuführen, z. B. das Festlegen von Variablen und das Auslösen von Netzwerkaufrufen unter verschiedenen Bedingungen. Die Experience Platform Web SDK-Tag-Erweiterung umfasst zwei Aktionen, die in Regeln verwendet werden:

  • Variable aktualisieren ordnet Datenelemente Ihren XDM- oder Datenvariablen zu
  • Ereignis senden führt den Netzwerkaufruf durch, um Daten an Experience Platform Edge Network zu senden

Im weiteren Verlauf dieser Lektion werden wir:

  1. Verwenden Sie die Aktion Variable aktualisieren, um eine „globale Konfiguration“ von XDM-Feldern zu definieren.

  2. Verwenden Sie die Aktion Variable aktualisieren erneut, um unsere „globale Konfiguration“ zu überschreiben und unter bestimmten Bedingungen zusätzliche XDM-Felder bereitzustellen (z. B. Hinzufügen von Produktdetails auf Produktseiten).

  3. Verwenden Sie die Ereignis senden Aktion, um die Daten an Adobe Experience Platform Edge Network zu senden.

Alle diese Regeln werden ordnungsgemäß mit der Option "" ​.

In diesem Video erhalten Sie einen Überblick über den Prozess:

https://video.tv.adobe.com/v/3454036/?captions=ger&learn=on&enablevpops

Globale Konfigurationsfelder

Erstellen einer Tag-Regel für die globalen XDM-Felder:

  1. Öffnen Sie die Tag-Eigenschaft, die Sie für dieses Tutorial verwenden

  2. Navigieren Sie linken Navigationsbereich zu Regeln“

  3. Klicken Sie auf Schaltfläche „Neue Regel"

    Regel erstellen

  4. Geben Sie einen Namen für die Regel ein all pages - adobeDataLayer push - set global variables - 1.

  5. Wählen Sie Abschnitt Ereignisse“ Hinzufügen

    Benennen Sie die Regel und fügen Sie ein Ereignis hinzu

  6. Verwenden Sie die Erweiterung Adobe Client Data Layer und wählen Sie Data Push als Ereignistyp

  7. Wählen Sie Dropdown- „Erweitert“ aus und geben Sie 1 als ein

    note note
    NOTE
    Je niedriger die Ordnungszahl, desto früher wird sie ausgeführt. Daher geben wir unserer „globalen Konfiguration“ eine niedrige Bestellnummer.

  8. Überwachen von Alle Ereignisse

  9. Wählen Sie Änderungen beibehalten aus, um zum Hauptbildschirm für Regeln zurückzukehren
    Trigger „Bibliothek geladen“ auswählen

  10. Wählen Sie Abschnitt Aktionen“ Hinzufügen

  11. Wählen Sie als Erweiterung die Option Adobe Experience Platform Web SDK

  12. Wählen Sie als Aktionstyp die Option Variable aktualisieren

  13. Wählen als das XDM Variable aus, das Sie in der Lektion Datenelemente erstellen erstellt haben

    Variablenschema aktualisieren

  14. Geben Sie nun die XDM-Felder an, indem Sie sie entsprechenden Werten zuordnen:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    XDM-Feld Zuordnen zu
    eventType Web Webpagedetails Page Views (fangen Sie mit der Eingabe an, um die vorgeschlagenen Werte anzuzeigen)
    identityMap Identity Map Datenelement
    web.webPageDetails.name Page Name Datenelement
    web.webPageDetails.pageViews.value 1
    note tip
    TIP
    XDM-Felder werden nicht in die Netzwerkanfrage aufgenommen, wenn das Datenelement null ist. Wenn der Benutzer nicht authentifiziert ist und das Identity Map Datenelement null ist, wird daher das identityMap-Objekt nicht gesendet. Deshalb können wir sie in unserer „globalen Konfiguration“ sicher definieren.
    note tip
    TIP
    Das Festlegen von web.webPageDetails.pageViews.value bietet eine Standardmethode zum Anzeigen einer Seitenansicht für andere nachgelagerte Anwendungen. Es ist nicht erforderlich, dass Adobe Analytics einen Netzwerkaufruf als Seitenansicht verarbeitet.

  15. Wenn Sie fertig sind, sieht Ihr XDM Variable in etwa so aus. Beachten Sie, dass die ausgefüllten und teilweise ausgefüllten Felder durch blaue Kreise gekennzeichnet sind:
    XDM-Variable

  16. Wählen Sie Änderungen beibehalten und dann Speichern die Regel aus

Felder der Produktseite

Beginnen Sie jetzt mit der Verwendung von Variable aktualisieren in zusätzlichen, sequenziellen Regeln, um das XDM-Objekt anzureichern, bevor Sie es an Platform Edge Network senden.

TIP
Die Regelreihenfolge bestimmt, welche Regel zuerst ausgeführt wird, wenn ein Ereignis ausgelöst wird. Wenn zwei Regeln denselben Ereignistyp haben, wird zuerst die Regel mit der niedrigsten Ordnungsnummer ausgeführt.

Beginnen Sie, indem Sie die Produktansichten auf der Produktdetailseite von Luma verfolgen:

  1. Wählen Sie Regel hinzufügen

  2. Benennen Sie ihn product detail pages - adobeDataLayer push - set product details variables - 20

  3. Wählen Sie das Symbol + Ereignis aus, um einen neuen Trigger hinzuzufügen

  4. Wählen unter "" die Option Adobe Client-Datenschicht

  5. Wählen unter "" die Option Daten gepusht

  6. Wählen Sie zum Öffnen Erweiterte Optionen die 20 aus. Dieser Reihenfolgenwert stellt sicher, dass die Regel nach) globalen Variablenregel ausgeführt wird.

  7. Überwachen eines spezifischen Ereignisses

  8. Geben Sie productView als Ereignis/Schlüssel für die Registrierung ein

  9. Wählen Änderungen beibehalten

    Analytics-XDM-Regeln

  10. Wählen unter Aktionen die Option Hinzufügen

  11. Erweiterung Adobe Experience Platform Web SDK auswählen

  12. Wählen Sie Aktionstyp als Variable aktualisieren

  13. Wählen Sie XDM Variable als Datenelement

  14. Ordnen Sie diese XDM-Felder entsprechenden Werten zu:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    XDM-Feld Zuordnen zu
    eventType Commerce Product Views (fangen Sie mit der Eingabe an, um die vorgeschlagenen Werte anzuzeigen)
    commerce.productViews.value 1
    productListItems.name Ecommerce Product Name Datenelement (Wählen Sie Einzeln bereitstellen und zuerst Element hinzufügen aus)
    productListItems.sku Ecommerce Product Id Datenelement

  15. Wählen Änderungen beibehalten

  16. Wählen Speichern, um die Regel zu speichern

    note note
    NOTE
    Da diese Regel eine höhere Reihenfolge hat, überschreibt sie die in der Regel „Globale Konfiguration“ festgelegte eventType. eventType darf nur einen Wert enthalten, und es wird empfohlen, ihn auf das Ereignis mit dem höchsten Wert festzulegen.
    note tip
    TIP
    Das Festlegen von „commerce.productViews.value=1“ in XDM wird automatisch dem prodView-Ereignis in Analytics zugeordnet

Warenkorbfelder

Sie können ein ganzes Array einem XDM-Objekt zuordnen, sofern das Array dem Format des XDM-Schemas entspricht. Das von Ecommerce Cart Products erstellte Datenelement für benutzerspezifischen Code durchläuft das adobeDataLayer.ecommerce.cart.items Datenschichtobjekt auf der Luma-Website und übersetzt es in das erforderliche Format des productListItems des XDM-Schemas.

Zur Veranschaulichung sehen Sie sich den unten stehenden Vergleich der Datenschicht der Luma-Site (links) mit dem übersetzten Datenelement (rechts) an:

XDM-Objekt-Array-Format

Vergleichen Sie das Datenelement mit der productListItems (Hinweis, es sollte übereinstimmen).

NOTE
_satellite.getVar('Ecommerce Cart Products') können an dieser Stelle im Tutorial nicht ausgeführt werden.
IMPORTANT
Stellen Sie beim Zuordnen von Feldern aus Ihrer Datenschicht zu XDM sicher, dass die Felder mit dem Datentyp des XDM-Felds übereinstimmen. Im obigen Beispiel müssen quantity und priceTotal Ganzzahlen sein, da sonst der Datensatz nicht in Platform aufgenommen wird.
Datentyp des XDM-Schemas

Ordnen wir nun unser Array dem XDM-Objekt zu:

  1. Erstellen Sie eine neue Regel mit dem Namen cart page - adobeDataLayer push - set cart variables - 20

  2. Wählen Sie das Symbol + Ereignis aus, um einen neuen Trigger hinzuzufügen

  3. Wählen unter "" die Option Adobe Client-Datenschicht

  4. Wählen unter "" die Option Daten gepusht

  5. Wählen Sie zum Öffnen Erweiterte Optionen die 20 aus. Dieser Reihenfolgenwert stellt sicher, dass die Regel nach) globalen Variablenregel ausgeführt wird.

  6. Überwachen eines spezifischen Ereignisses

  7. Geben Sie cartView als Ereignis/Schlüssel für die Registrierung ein

  8. Wählen Änderungen beibehalten

    Ereignis für Warenkorbregel

  9. Wählen unter Aktionen die Option Hinzufügen

  10. Erweiterung Adobe Experience Platform Web SDK auswählen

  11. Wählen Sie Aktionstyp als Variable aktualisieren

  12. Wählen Sie XDM Variable als Datenelement

  13. Ordnen Sie diese XDM-Felder entsprechenden Werten zu:

    table 0-row-2 1-row-2 2-row-2 3-row-2
    XDM-Feld Zuordnen zu
    eventType Commerce Product List (Cart) Views (fangen Sie mit der Eingabe an, um die vorgeschlagenen Werte anzuzeigen)
    commerce.productListViews.value 1
    productListItems Ecommerce Cart Products Datenelement (Wählen Sie zuerst Gesamtes Array)
    note tip
    TIP
    Das Festlegen von „commerce.productListViews.value=1“ in XDM wird automatisch dem scView-Ereignis in Analytics zugeordnet

  14. Wählen Änderungen beibehalten

  15. Wählen Speichern, um die Regel zu speichern

Felder zur Bestellbestätigung

Erstellen Sie eine weitere Regel für Kaufereignisse:

  1. Erstellen Sie eine neue Regel mit dem Namen order confirmation - adobeDataLayer push - set purchase variables - 20

  2. Wählen Sie das Symbol + Ereignis aus, um einen neuen Trigger hinzuzufügen

  3. Wählen unter "" die Option Adobe Client-Datenschicht

  4. Wählen unter "" die Option Daten gepusht

  5. Wählen Sie zum Öffnen Erweiterte Optionen die 20 aus. Dieser Reihenfolgenwert stellt sicher, dass die Regel nach) globalen Variablenregel ausgeführt wird.

  6. Überwachen eines spezifischen Ereignisses

  7. Geben Sie purchase als Ereignis/Schlüssel für die Registrierung ein

  8. Wählen Änderungen beibehalten

  9. Wählen unter Aktionen die Option Hinzufügen

  10. Erweiterung Adobe Experience Platform Web SDK auswählen

  11. Wählen Sie Aktionstyp als Variable aktualisieren

  12. Wählen Sie XDM Variable als Datenelement

  13. Ordnen Sie diese XDM-Felder entsprechenden Werten zu:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
    XDM-Feld Zuordnen zu
    eventType Commerce Purchases (fangen Sie mit der Eingabe an, um die vorgeschlagenen Werte anzuzeigen)
    commerce.productListViews.value 1
    commerce.order.purchaseID Ecommerce Purchase Id Datenelement
    commerce.order.currencyCode USD
    productListItems Ecommerce Cart Products Datenelement (Auswählen Gesamtes Array bereitstellen zuerst )
    note tip
    TIP
    Das Festlegen von commerce.productListViews.value auf 1, commerce.order.purchaseID und commerce.order.currencyCode in XDM wird automatisch den purchase-, s.purchaseID- bzw. s.currencyCode-Variablen in Analytics zugeordnet.

  14. Wählen Änderungen beibehalten

  15. Wählen Sie Speichern

Ereignisregel senden

Nachdem Sie die Variablen festgelegt haben, können Sie mit der Aktion „Ereignis senden die Regel erstellen, um das vollständige XDM-Objekt Platform Edge Network zu senden.

  1. Erstellen Sie eine neue Regel mit dem Namen all pages - adobeDataLayer push - send event - 50

  2. Wählen Sie das Symbol + Ereignis aus, um einen neuen Trigger hinzuzufügen

  3. Wählen unter "" die Option Adobe Client-Datenschicht

  4. Wählen unter "" die Option Daten gepusht

  5. Wählen Sie zum Öffnen Erweiterte Optionen, geben Sie 50 ein (was wahrscheinlich der Standard ist). Dieser Reihenfolgenwert stellt sicher, dass die Regel nach den Regeln zum Festlegen der Variablen ausgeführt wird.

  6. Überwachen eines Alle Ereignisse

  7. Wählen Änderungen beibehalten

  8. Wählen unter Aktionen die Option Hinzufügen

  9. Erweiterung Adobe Experience Platform Web SDK auswählen

  10. Wählen Sie Aktionstyp als Ereignisvariable senden

  11. Wählen Sie als Aktionstyp die Option Ereignis senden

  12. Wählen Sie als XDM das in der vorherigen Lektion erstellte XDM Variable-Datenelement aus

  13. Wählen Sie Änderungen beibehalten aus, um zum Hauptbildschirm für Regeln zurückzukehren

    Hinzufügen der Aktion „Ereignis senden“

  14. Wählen Speichern, um die Regel zu speichern

    Speichern der Regel

In Ihrer Eigenschaft sollten die folgenden Regeln vorhanden sein:

Liste der Regeln überprüfen

Regeln in einer Bibliothek veröffentlichen

Als Nächstes veröffentlichen Sie die Regel in Ihrer Entwicklungsumgebung, damit Sie überprüfen können, ob sie funktioniert.

So erstellen Sie eine Bibliothek:

  1. Navigieren Sie linken Navigationsbereich Veröffentlichungsfluss "".

  2. Wählen Sie Bibliothek hinzufügen

    Bibliothek hinzufügen auswählen

  3. Geben Sie für Name den Wert Luma Web SDK Tutorial

  4. Wählen Sie für Umgebung die Option Development

  5. Wählen Sie Alle geänderten Ressourcen hinzufügen

    note note
    NOTE
    Sie sollten alle Tag-Komponenten sehen, die in vorherigen Lektionen erstellt wurden. Die Haupterweiterung enthält die Basis-JavaScript, die für alle Web-Tag-Eigenschaften erforderlich ist.

  6. Wählen Sie Für Entwicklung speichern und erstellen

    Bibliothek erstellen und erstellen

Es kann einige Minuten dauern, bis die Bibliothek erstellt ist. Nach Abschluss wird links neben dem Bibliotheksnamen ein grüner Punkt angezeigt:

Build abgeschlossen

Wie Sie auf dem Bildschirm Publishing-Ablauf sehen können, gibt es sehr viel mehr am Publishing-Prozess, was den Rahmen dieses Tutorials sprengt. Dieses Tutorial verwendet nur eine einzige Bibliothek in Ihrer Entwicklungsumgebung.

Jetzt können Sie die Daten in der Anfrage mithilfe der Adobe Experience Platform Debugger validieren.

NOTE
Vielen Dank, dass Sie sich Zeit genommen haben, um mehr über Adobe Experience Platform Web SDK zu erfahren. Wenn Sie Fragen haben, allgemeines Feedback geben möchten oder Vorschläge für zukünftige Inhalte haben, teilen Sie diese bitte auf diesem Experience League Community-Diskussionsbeitrag
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4