DokumentationExperience PlatformWeb SDK-Tutorial

Erstellen von Tag-Regeln

Last update: Sat Jun 01 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Einsteiger
  • Fortgeschrittener
  • Entwickler

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. Mit dem 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 Benennungskonvention zum Verwalten von Regeln innerhalb von Tags
  • Ereignis mit XDM-Feldern mit den Aktionen "Variable aktualisieren"und "Ereignis senden"senden
  • Mehrere Sätze von XDM-Feldern über mehrere Regeln hinweg stapeln
  • Ordnen Sie einzelne oder komplette Array-Datenelemente dem XDM-Objekt zu.
  • Veröffentlichen einer Tag-Regel in einer Entwicklungsbibliothek

Voraussetzungen

Sie kennen Datenerfassungs-Tags und die Demosite "Luma" und die vorherigen Lektionen im Tutorial abgeschlossen haben:

Benennungskonventionen

Um Regeln in Tags zu verwalten, wird empfohlen, eine standardmäßige Namenskonvention einzuhalten. In diesem Tutorial wird eine fünfteilige Namenskonvention verwendet:

  • [location] - [event] - [Zweck] - [bestellen]

wo;

  1. location ist die Seite oder die Seiten 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. bestellen ist die Reihenfolge, in der die Regel im Verhältnis zu anderen Regeln ausgelöst werden soll

Erstellen von Tag-Regeln

In -Tags werden Regeln verwendet, um unter verschiedenen Bedingungen Aktionen (Aufrufe auslösen) auszuführen. Die Platform Web SDK-Tag-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 an das Experience Platform-Edge Network

Im Rest dieser Lektion werden wir:

  1. Erstellen Sie eine Regel mit der Variable aktualisieren Aktion zum Definieren einer "globalen Konfiguration"von XDM-Feldern.

  2. Erstellen Sie zusätzliche Regeln mit der Variable aktualisieren Aktion, die unsere "globale Konfiguration"außer Kraft setzt und unter bestimmten Bedingungen zusätzliche XDM-Felder hinzufügt (z. B. Produktdetails zu Produktseiten hinzufügen).

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

Alle diese Regeln werden mithilfe desbestellen".

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

https://video.tv.adobe.com/v/3427710/?learn=on

Globale Konfigurationsfelder

So erstellen Sie eine Tag-Regel für die globalen XDM-Felder:

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

  2. Navigieren Sie zu Regeln in der linken Navigation

  3. Wählen Sie die Neue Regel erstellen button

    Regel erstellen

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

  5. Im Veranstaltungen Bereich, wählen Sie Hinzufügen

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

  6. Verwenden Sie die Haupterweiterung und wählen Bibliothek geladen (Seitenanfang) als Ereignistyp

  7. Auswählen Erweitert Dropdown und 1 als Bestellung

    note note
    NOTE
    Je niedriger die Bestellnummer ist, desto früher wird sie ausgeführt. Deshalb geben wir unserer "globalen Konfiguration" eine niedrige Bestellnummer.

  8. Auswählen Änderungen beibehalten zum Hauptregelbildschirm zurückzukehren
    Trigger Bibliothek geladenauswählen

  9. Im Aktionen Bereich, wählen Sie Hinzufügen

  10. Als Erweiterung auswählen Adobe Experience Platform Web SDK

  11. Als Aktionstyp auswählen Variable aktualisieren

  12. Als Datenelement, wählen Sie die xdm.variable.content die Sie in der Erstellen von Datenelementen Lektion

    Variablenschema aktualisieren

Nun ordnen Sie Ihre Datenelemente der schema verwendet von Ihrem XDM-Objekt. Sie können einzelnen Eigenschaften oder ganzen Objekten zuordnen. In diesem Beispiel ordnen Sie die einzelnen Eigenschaften zu:

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

  2. Wert eingeben web.webpagedetails.pageViews

    note tip
    TIP
    So verstehen Sie, welche Werte im eventType -Feld, müssen Sie zur Schemaseite gehen und die eventType -Feld, um die vorgeschlagenen Werte in der rechten Leiste anzuzeigen. Sie können bei Bedarf auch einen neuen Wert eingeben.
    eventType hat Werte auf der Schemaseite vorgeschlagen

  3. Suchen Sie als Nächstes die identityMap -Objekt im Schema und wählen Sie es aus

  4. Zuordnung zu identityMap.loginID Datenelement

    Variable-Identitätszuordnung aktualisieren

    note tip
    TIP
    XDM-Felder werden nicht in die Netzwerkanforderung aufgenommen, wenn das Datenelement null ist. Wenn der Benutzer nicht authentifiziert ist und die identityMap.loginID das Datenelement null ist, wird das identityMap -Objekt wird nicht gesendet. Deshalb können wir sie in unserer "globalen Konfiguration" definieren.

  5. Scrollen Sie nach unten, bis Sie zum web Objekt

  6. Auswahl zum Öffnen

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

    • web.webPageDetials.name nach %page.pageInfo.pageName%
    • web.webPageDetials.server nach %page.pageInfo.server%
    • web.webPageDetials.siteSection nach %page.pageInfo.hierarchie1%

  8. Stellen Sie web.webPageDetials.pageViews.value auf 1 ein.

    Variableninhalt aktualisieren

    note tip
    TIP
    Während eventType auf web.webpagedetails.pageViews nor web.webPageDetails.pageViews.value erforderlich sind, damit Adobe Analytics ein Beacon als Seitenansicht verarbeiten kann, ist es nützlich, eine Standardmethode zur Anzeige einer Seitenansicht für andere nachgelagerte Anwendungen zu verwenden.

  9. Auswählen Änderungen beibehalten und dann Speichern die Regel im nächsten Bildschirm, um die Erstellung der Regel abzuschließen

Felder für Produktseiten

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

TIP
Die Regelreihenfolge bestimmt, welche Regel beim Auslösen eines Ereignisses zuerst ausgeführt wird. Wenn zwei Regeln denselben Ereignistyp aufweisen, wird zuerst die Regel mit der niedrigsten Nummer ausgeführt.

Beginnen Sie mit der Verfolgung der Produktansichten auf der Produktdetailseite von Luma:

  1. Auswählen Regel hinzufügen

  2. Benennen Sie ihn ecommerce - library loaded - set product details variables - 20

  3. Wählen Sie die + Symbol unter Ereignis zum Hinzufügen eines neuen Triggers

  4. under Erweiterung auswählen Core

  5. under Ereignistyp auswählen Bibliothek geladen (Seitenanfang)

  6. Zum Öffnen auswählen Erweiterte Optionen, Typ in 20. Dieser Bestellwert stellt sicher, dass die Regel ausgeführt wird after die all pages - library loaded - set global variables - 1 die globale Konfiguration festlegen.

  7. Auswählen Änderungen beibehalten

    Analytics-XDM-Regeln

  8. under Bedingungen, wählen Sie Hinzufügen

  9. Urlaub Logiktyp as Normal

  10. Urlaub Erweiterung as Core

  11. Auswählen Bedingungstyp as Pfad ohne Abfragezeichenfolge

  12. Aktivieren Sie rechts die Option Regex Umschalten

  13. under path equals set /products/. Auf der Demosite "Luma"wird sichergestellt, dass die Regel nur Trigger auf Produktseiten enthält.

  14. Auswählen Änderungen beibehalten

    Analytics-XDM-Regeln

  15. under Aktionen select Hinzufügen

  16. Auswählen Adobe Experience Platform Web SDK Erweiterung

  17. Auswählen Aktionstyp as Variable aktualisieren

  18. Auswählen xdm.variable.content als Datenelement

  19. Scrollen Sie nach unten zum commerce Objekt

  20. Öffnen Sie die productViews -Objekt und -set value nach 1

    Einrichten der Produktansicht

    note tip
    TIP
    Wenn Sie commerce.productViews.value=1 in XDM festlegen, wird dies automatisch dem prodView -Ereignis in Analytics

  21. Nach unten scrollen zu eventType und legen Sie commerce.productViews

    note note
    NOTE
    Da diese Regel eine höhere Reihenfolge aufweist, überschreibt sie die eventType in der Regel "globale Konfiguration"festgelegt. eventType kann nur einen Wert enthalten. Es wird empfohlen, ihn mit dem wertvollsten Ereignis festzulegen.

  22. Scrollen Sie nach unten zu und wählen Sie productListItems array

  23. Auswählen Bereitstellen einzelner Elemente

  24. Auswählen Element hinzufügen

    Festlegen des Produktansichtsereignisses

    note caution
    CAUTION
    Die productListItems ist array -Datentyp, sodass erwartet wird, dass Daten als Sammlung von Elementen eingehen. Aufgrund der Datenschichtstruktur der Demosite "Luma"und da es nur möglich ist, ein Produkt gleichzeitig auf der Site "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 Posten 1

  26. Zuordnung productListItems.item1.SKU nach %product.productInfo.sku%

    Produkt-SKU XDM-Objektvariable

  27. Auswählen Änderungen beibehalten

  28. Auswählen Speichern zum Speichern der Regel

Felder im Warenkorb

Sie können das gesamte Array einem XDM-Objekt zuordnen, vorausgesetzt, das Array entspricht dem Format des XDM-Schemas. Das Datenelement des benutzerspezifischen Codes cart.productInfo Sie haben frühere Schleifen durch digitalData.cart.cartEntries Datenschichtobjekt auf Luma und übersetzt es in das erforderliche Format der productListItems -Objekt des XDM-Schemas.

Sehen Sie sich dazu den unten stehenden Vergleich der Datenschicht der Site "Luma"(links) mit dem übersetzten Datenelement (rechts) an:

XDM-Objekt-Array-Format

Das Datenelement mit dem productListItems Struktur (Hinweis, sollte übereinstimmen).

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

Zuordnen des Arrays zum XDM-Objekt:

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

  2. Wählen Sie die + Symbol unter Ereignis zum Hinzufügen eines neuen Triggers

  3. under Erweiterung auswählen Core

  4. under Ereignistyp auswählen Bibliothek geladen (Seitenanfang)

  5. Zum Öffnen auswählen Erweiterte Optionen, Typ in 20

  6. Auswählen Änderungen beibehalten

    Analytics-XDM-Regeln

  7. under Bedingungen, wählen Sie Hinzufügen

  8. Urlaub Logiktyp as Normal

  9. Urlaub Erweiterungen as Core

  10. Auswählen Bedingungstyp as Pfad ohne Abfragezeichenfolge

  11. rechts: nicht aktivieren die Regex Umschalten

  12. under path equals set /content/luma/us/en/user/cart.html. Auf der Demosite "Luma"wird sichergestellt, dass die Regel nur Trigger auf der Warenkorbseite enthält.

  13. Auswählen Änderungen beibehalten

    Analytics-XDM-Regeln

  14. under Aktionen select Hinzufügen

  15. Auswählen Adobe Experience Platform Web SDK Erweiterung

  16. Auswählen Aktionstyp as Variable aktualisieren

  17. Auswählen xdm.variable.content als Datenelement

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

  19. Öffnen Sie die productListViews -Objekt und -set value nach 1

    Einrichten der Produktansicht

    note tip
    TIP
    Wenn Sie commerce.productListViews.value=1 in XDM festlegen, wird dies automatisch dem scView -Ereignis in Analytics

  20. Auswählen eventType und auf commerce.productListViews

  21. Scrollen Sie nach unten zu und wählen Sie productListItems array

  22. Auswählen Gesamtes Array bereitstellen

  23. Zuordnung zu cart.productInfo Datenelement

  24. Auswählen Änderungen beibehalten

  25. Auswählen Speichern zum Speichern der Regel

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. Bedingung: /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 der Einstellung scCheckout -Ereignis in Analytics

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

  1. Bedingung: /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 der Einstellung purchase -Ereignis in Analytics

  4. Satz commerce.order.purchaseID der cart.orderId Datenelement

  5. Satz commerce.order.currencyCode zum hartcodierten Wert USD

    Festlegen der purchaseID für Analytics

    note tip
    TIP
    Dies entspricht der Einstellung s.purchaseID und s.currencyCode Variablen in Analytics

  6. Scrollen Sie nach unten zu und wählen Sie productListItems array

  7. Auswählen Gesamtes Array bereitstellen

  8. Zuordnung zu cart.productInfo.purchase Datenelement

  9. Auswählen Änderungen beibehalten

  10. Auswählen Speichern

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

Analytics-XDM-Regeln

Ereignisregel senden

Nachdem Sie die Variablen festgelegt haben, können Sie die Regel erstellen, um das vollständige XDM-Objekt mit dem Ereignis senden Aktion.

  1. Wählen Sie rechts Regel hinzufügen zum Erstellen einer weiteren Regel

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

  3. Im Veranstaltungen Bereich, wählen Sie Hinzufügen

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

  5. Auswählen Erweitert Dropdown und 50 in Bestellung. Dadurch wird sichergestellt, dass diese Regel ausgelöst wird, nachdem alle anderen Regeln, die Sie konfiguriert haben (die 1 oder 20 als Bestellung).

  6. Auswählen Änderungen beibehalten zum Hauptregelbildschirm zurückzukehren
    Trigger Bibliothek geladenauswählen

  7. Im Aktionen Bereich, wählen Sie Hinzufügen

  8. Als Erweiterung auswählen Adobe Experience Platform Web SDK

  9. Als Aktionstyp auswählen Ereignis senden

  10. Als XDM, wählen Sie die xdm.variable.content Datenelement, das in der vorherigen Lektion erstellt wurde

  11. Auswählen Änderungen beibehalten zum Hauptregelbildschirm zurückzukehren

    Hinzufügen der Aktion Ereignis senden

  12. Auswählen Speichern zum Speichern der Regel

    Speichern der Regel

Regeln in einer Bibliothek veröffentlichen

Veröffentlichen Sie dann die Regel in Ihrer Entwicklungsumgebung, damit Sie überprüfen können, ob sie funktioniert.

So erstellen Sie eine Bibliothek:

  1. Navigieren Sie zu Veröffentlichungsfluss in der linken Navigation

  2. Auswählen Bibliothek hinzufügen

    Bibliothek hinzufügen

  3. Für Name, eingeben Luma Web SDK Tutorial

  4. Für Umgebung auswählen Development

  5. Auswählen 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 das grundlegende JavaScript, das für alle Web-Tag-Eigenschaften erforderlich ist.

  6. Auswählen Speichern und erstellen für Entwicklung

    Erstellen und Erstellen der Bibliothek

Die Erstellung der Bibliothek kann einige Minuten dauern. Wenn sie abgeschlossen ist, wird links neben dem Bibliotheksnamen ein grüner Punkt angezeigt:

Build-Abschluss

Wie Sie auf der Veröffentlichungsfluss -Bildschirm gibt es viel mehr im Veröffentlichungsprozess, was über den Rahmen dieses Tutorials hinausgeht. In diesem Tutorial wird nur eine einzige Bibliothek in Ihrer Entwicklungsumgebung verwendet.

Jetzt können Sie die Daten in der Anfrage mithilfe des Adobe Experience Platform Debuggers überprüfen.

Weiter

NOTE
Vielen Dank, dass Sie Ihre Zeit investiert haben, um mehr über das Adobe Experience Platform Web SDK zu erfahren. Wenn Sie Fragen haben, ein allgemeines Feedback teilen möchten oder Vorschläge zu künftigen Inhalten haben, teilen Sie diese bitte mit. Experience League Community-Diskussionsbeitrag
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4