Tag-Regeln erstellen

Erfahren Sie, wie Sie mithilfe von Tag-Regeln Ereignisse mit Ihrem XDM-Objekt an das 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 das 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
  • Publish einer Tag-Regel in eine Entwicklungsbibliothek

Voraussetzungen

Sie sind mit Datenerfassungs-Tags und der Demo-Site 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 fünfteilige 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 ausgelöst werden soll

Tag-Regeln erstellen

In Tags werden Regeln verwendet, um Aktionen (Feueraufrufe) unter verschiedenen Bedingungen auszuführen. Die Platform Web SDK Tags-Erweiterung umfasst zwei Aktionen, die in dieser Lektion verwendet werden:

  • Variable aktualisieren ordnet Datenelemente Eigenschaften in einem XDM-Objekt zu
  • Ereignis senden sendet das XDM-Objekt zum Experience Platform-Edge Network

Im weiteren Verlauf dieser Lektion werden wir:

  1. Erstellen Sie eine Regel mit der Aktion Variable aktualisieren um eine „globale Konfiguration“ von XDM-Feldern zu definieren.

  2. Erstellen Sie zusätzliche Regeln mit der Aktion Variable aktualisieren die unsere „globale Konfiguration“ überschreiben und unter bestimmten Bedingungen zusätzliche XDM-Felder bereitstellen (z. B. Hinzufügen von Produktdetails auf Produktseiten).

  3. Erstellen Sie eine weitere Regel mit der Aktion Ereignis senden die das vollständige XDM-Objekt an das Adobe Experience Platform-Edge Network sendet.

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

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

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 - library loaded - 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 Core Erweiterung und wählen Sie Bibliothek geladen (Seitenanfang) 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. Wählen Sie Änderungen beibehalten aus, um zum Hauptbildschirm für Regeln zurückzukehren
    Trigger „Bibliothek geladen“ auswählen

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

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

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

  12. Wählen als das xdm.variable.content aus, das Sie in der Lektion Datenelemente erstellen erstellt haben

    Variablenschema aktualisieren

Ordnen Sie nun Ihre Datenelemente dem Schema zu, das von Ihrem XDM-Objekt verwendet wird. Sie können einzelne Eigenschaften oder ganze Objekte zuordnen. In diesem Beispiel ordnen Sie einzelne Eigenschaften zu:

  1. Suchen Sie das Feld eventType und wählen Sie es

  2. Wert eingeben web.webpagedetails.pageViews

    note tip
    TIP
    Um zu verstehen, welche Werte in das Feld eventType eingefügt werden sollen, müssen Sie auf die Seite Schema gehen und das Feld eventType auswählen, um die vorgeschlagenen Werte in der rechten Leiste anzuzeigen. Sie können bei Bedarf auch einen neuen Wert eingeben.
    eventType empfohlene Werte auf der Seite Schemata
  3. Suchen Sie anschließend das identityMap im Schema und wählen Sie es aus.

  4. Dem identityMap.loginID Datenelement zuordnen

    Aktualisieren der Identitätszuordnung für Variablen

    note tip
    TIP
    XDM-Felder werden nicht in die Netzwerkanfrage aufgenommen, wenn das Datenelement null ist. Wenn der Benutzer nicht authentifiziert ist und das identityMap.loginID Datenelement null ist, wird daher das identityMap-Objekt nicht gesendet. Deshalb können wir sie in unserer „globalen Konfiguration“ definieren.
  5. Scrollen Sie nach unten, bis Sie das web erreichen

  6. Auswählen, um es zu öffnen

  7. Ordnen Sie die folgenden Datenelemente den entsprechenden web XDM-Variablen zu

    • web.webPageDetials.name zu %page.pageInfo.pageName%
    • web.webPageDetials.server zu %page.pageInfo.server%
    • web.webPageDetials.siteSection zu %page.pageInfo.hierarchie1%
  8. Stellen Sie web.webPageDetials.pageViews.value auf 1 ein.

    Variableninhalt aktualisieren

    note tip
    TIP
    Obwohl weder eventType auf web.webpagedetails.pageViews noch web.webPageDetails.pageViews.value festgelegt sind, damit Adobe Analytics ein Beacon als Seitenansicht verarbeiten kann, ist es sinnvoll, eine Standardmethode zur Anzeige einer Seitenansicht für andere nachgelagerte Anwendungen zu verwenden.
  9. Wählen Sie Änderungen beibehalten und dann Speichern die Regel im nächsten Bildschirm aus, um die Erstellung der Regel abzuschließen

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 das --Edge Network senden.

TIP
Die Regelreihenfolge bestimmt, welche Regel zuerst ausgeführt wird, wenn ein Ereignis ausgelöst wird. Wenn zwei Regeln denselben Ereignistyp aufweisen, wird zuerst die Regel mit der niedrigsten Zahl 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 ecommerce - library loaded - 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 Core

  5. Wählen unter „Ereignistyp die Option Bibliothek geladen (Seitenanfang)

  6. Wählen Sie zum Öffnen Erweiterte Optionen die 20 aus. Dieser Reihenfolgenwert stellt sicher, dass die Regel dem all pages - library loaded - set global variables - 1 ausgeführt wird der die globale Konfiguration festlegt.

  7. Wählen Änderungen beibehalten

    Analytics-XDM-Regeln

  8. Wählen unter „Bedingungen die Option zum Hinzufügen aus

  9. Behalten Logiktyp bei Regular

  10. Belassen extension als core

  11. Wählen Sie Bedingungstyp als Pfad ohne Abfragezeichenfolge

  12. Aktivieren Sie auf der rechten Seite den Umschalter Regex.

  13. Legen unter „Pfad" /products/ fest. Für die Demo-Site von Luma wird sichergestellt, dass die Regel nur Trigger auf Produktseiten enthält

  14. Wählen Änderungen beibehalten

    Analytics-XDM-Regeln

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

  16. Erweiterung Adobe Experience Platform Web SDK auswählen

  17. Wählen Sie Aktionstyp als Variable aktualisieren

  18. Wählen Sie xdm.variable.content als Datenelement

  19. Scrollen Sie nach unten zum commerce

  20. Öffnen Sie das productViews-Objekt und legen Sie value auf 1

    Produktansicht einrichten

    note tip
    TIP
    Das Festlegen von „commerce.productViews.value=1“ in XDM wird automatisch dem prodView-Ereignis in Analytics zugeordnet
  21. Scrollen Sie nach unten zu eventType und setzen Sie es auf commerce.productViews

    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.
  22. Scrollen Sie nach unten zu und wählen Sie productListItems Array aus

  23. Wählen Sie Einzeln bereitstellen

  24. Wählen Sie Element hinzufügen

    Festlegen des Produktansichtsereignisses

    note caution
    CAUTION
    Der productListItems ist ein array Datentyp. Daher erwartet er, dass Daten als eine Sammlung von Elementen eingehen. Aufgrund der Datenschichtstruktur der Demo-Site von Luma und da es nur möglich ist, jeweils ein Produkt auf der Site von Luma anzuzeigen, fügen Sie Elemente einzeln hinzu. Bei der Implementierung auf Ihrer eigenen Website können Sie je nach Datenschichtstruktur möglicherweise ein ganzes Array bereitstellen.
  25. Zum Öffnen auswählen Element 1

  26. productListItems.item1.SKU %product.productInfo.sku% zuordnen

    XDM-Objektvariable für Produkt-SKU

  27. Wählen Änderungen beibehalten

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

Warenkorbfelder

Sie können ein ganzes Array einem XDM-Objekt zuordnen, sofern das Array dem Format des XDM-Schemas entspricht. Das von cart.productInfo erstellte Datenelement für benutzerspezifischen Code durchläuft das digitalData.cart.cartEntries Datenschichtobjekt auf Luma 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).

IMPORTANT
Beachten Sie, wie numerische Variablen übersetzt werden und Zeichenfolgenwerte in der Datenschicht, wie price und qty, im Datenelement in Zahlen umformatiert werden. Diese Formatanforderungen sind für die Datenintegrität in Platform wichtig und werden im Schritt Schemas konfigurieren festgelegt. Im Beispiel verwendet quantity den Datentyp Integer.
Datentyp des XDM-Schemas

Ordnen wir nun unser Array dem XDM-Objekt zu:

  1. Erstellen Sie eine neue Regel mit dem Namen ecommerce - library loaded - set shopping cart variables - 20

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

  3. Wählen unter "" die Option Core

  4. Wählen unter „Ereignistyp die Option Bibliothek geladen (Seitenanfang)

  5. Wählen Sie zum Öffnen Erweiterte Optionen die folgende Option aus20

  6. Wählen Änderungen beibehalten

    Analytics-XDM-Regeln

  7. Wählen unter „Bedingungen die Option zum Hinzufügen aus

  8. Behalten Logiktyp bei Regular

  9. Erweiterungen als ""

  10. Wählen Sie Bedingungstyp als Pfad ohne Abfragezeichenfolge

  11. Aktivieren Sie auf der rechten Seite nicht den Umschalter Regex.

  12. Legen unter „Pfad" /content/luma/us/en/user/cart.html fest. Für die Demo-Site von Luma wird sichergestellt, dass die Regel nur Trigger auf der Warenkorbseite enthält

  13. Wählen Änderungen beibehalten

    Analytics-XDM-Regeln

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

  15. Erweiterung Adobe Experience Platform Web SDK auswählen

  16. Wählen Sie Aktionstyp als Variable aktualisieren

  17. Wählen Sie xdm.variable.content als Datenelement

  18. Scrollen Sie nach unten zum commerce und wählen Sie es aus, um es zu öffnen.

  19. Öffnen Sie das productListViews-Objekt und legen Sie value auf 1 fest

    Produktansicht einrichten

    note tip
    TIP
    Das Festlegen von „commerce.productListViews.value=1“ in XDM wird automatisch dem scView-Ereignis in Analytics zugeordnet
  20. eventType auswählen und auf commerce.productListViews setzen

  21. Scrollen Sie nach unten zum Array productListItems und wählen Sie es aus.

  22. Wählen Sie Gesamtes Array bereitstellen

  23. Zu cart.productInfo Datenelement zuordnen

  24. Wählen Änderungen beibehalten

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

Erstellen Sie zwei weitere Regeln für Checkout und Kauf nach demselben Muster mit den folgenden Unterschieden:

Regelname: ecommerce - library loaded - set checkout variables - 20

  1. condition: /content/luma/us/en/user/checkout.html

  2. Stellen Sie eventType auf commerce.checkouts ein.

  3. Stellen Sie commerce.checkout.value auf 1 ein.

    note tip
    TIP
    Dies entspricht dem Festlegen scCheckout Ereignisses in Analytics

Regelname: ecommerce - library loaded - set purchase variables - 20

  1. condition: /content/luma/us/en/user/checkout/order/thank-you.html

  2. Stellen Sie eventType auf commerce.purchases ein.

  3. Stellen Sie commerce.purchases.value auf 1 ein.

    note tip
    TIP
    Dies entspricht dem Festlegen purchase Ereignisses in Analytics
  4. commerce.order.purchaseID auf das cart.orderId Datenelement festlegen

  5. commerce.order.currencyCode auf den hartcodierten Wert USD

    Festlegen der Kauf-ID für Analytics

    note tip
    TIP
    Dies entspricht dem Festlegen von s.purchaseID- und s.currencyCode in Analytics
  6. Scrollen Sie nach unten zum Array productListItems und wählen Sie es aus.

  7. Wählen Sie Gesamtes Array bereitstellen

  8. Zu cart.productInfo.purchase Datenelement zuordnen

  9. Wählen Änderungen beibehalten

  10. Wählen Sie Speichern

Wenn Sie fertig sind, sollten Sie die folgenden Regeln erstellt sehen.

Analytics-XDM-Regeln

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 an Platform-Edge Network zu senden.

  1. Klicken Sie auf der rechten Seite auf Regel hinzufügen, um eine weitere Regel zu erstellen

  2. Geben Sie einen Namen für die Regel ein all pages - library loaded - send event - 50.

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

  4. Verwenden Sie die Core Erweiterung und wählen Sie Library Loaded (Page Top) als Ereignistyp

  5. Wählen Sie Dropdown- „Erweitert“ aus und geben Sie 50 in Reihenfolge ein. Dadurch wird sichergestellt, dass diese Regel nach allen anderen von Ihnen konfigurierten Regeln ausgelöst wird (die 1 oder 20 hatten order).

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

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

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

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

  10. Wählen Sie als XDM das in der vorherigen Lektion erstellte xdm.variable.content-Datenelement aus

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

    Hinzufügen der Aktion „Ereignis senden“

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

    Speichern der Regel

Publish - Regeln in einer Bibliothek

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 mit dem Adobe Experience Platform Debugger validieren.

Weiter

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