DokumentationExperience PlatformWeb SDK-Tutorial

Erstellen von Tag-Regeln

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

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.
  • Publish einer Tag-Regel in einer Entwicklungsbibliothek

Voraussetzungen

Sie sind mit Datenerfassungs-Tags und der Demosite "Luma" vertraut und haben die vorherigen Lektionen im Tutorial abgeschlossen:

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] - [order]

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. order 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 Aktion Variable aktualisieren , um eine "globale Konfiguration"von XDM-Feldern zu definieren.

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

  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 mithilfe der Option "order" ordnungsgemäß sequenziert.

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 im linken Navigationsbereich zu Regeln .

  3. Wählen Sie die Schaltfläche Neue Regel erstellen aus

    Erstellen einer Regel

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

  5. Wählen Sie im Abschnitt Ereignisse die Option Hinzufügen

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

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

  7. Wählen Sie das Dropdown-Menü Erweitert aus und geben Sie 1 als Reihenfolge ein.

    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. Wählen Sie Änderungen beibehalten aus, um zum Hauptregelbildschirm zurückzukehren.
    Trigger Bibliothek geladenauswählen

  9. Wählen Sie im Abschnitt Aktionen die Option Hinzufügen

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

  11. Wählen Sie als Aktionstyp Variable aktualisieren aus.

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

    Variablenschema aktualisieren

Ordnen Sie nun Ihre Datenelemente dem vom XDM-Objekt verwendeten Schema zu. 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. Geben Sie den Wert web.webpagedetails.pageViews ein.

    note tip
    TIP
    Um zu verstehen, welche Werte im Feld eventType eingegeben werden sollen, müssen Sie auf die Schemaseite 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 hat Werte auf der Schemaseite vorgeschlagen

  3. Suchen Sie anschließend das Objekt identityMap im Schema und wählen Sie es aus

  4. Dem identityMap.loginID-Datenelement zuordnen

    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 das Datenelement identityMap.loginID null ist, wird daher das Objekt identityMap nicht gesendet. Deshalb können wir sie in unserer "globalen Konfiguration" definieren.

  5. Scrollen Sie nach unten, bis Sie das Objekt web erreichen.

  6. Auswahl zum Öffnen

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

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

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

    Variableninhalt aktualisieren

    note tip
    TIP
    Während weder eventType auf web.webpagedetails.pageViews noch web.webPageDetails.pageViews.value festgelegt ist, 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. Wählen Sie Ä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 Platform-Edge Network gesendet wird.

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. Wählen Sie Regel hinzufügen

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

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

  4. Wählen Sie unter Erweiterung Core aus.

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

  6. Wählen Sie diese Option aus, um Erweiterte Optionen zu öffnen, und geben Sie in 20 ein. Dieser Bestellwert stellt sicher, dass die Regel nach dem all pages - library loaded - set global variables - 1 ausgeführt wird, der die globale Konfiguration festlegt.

  7. Wählen Sie Änderungen beibehalten aus

    Analytics-XDM-Regeln

  8. Wählen Sie unter Bedingungen die Option "Hinzufügen"

  9. Belassen Sie Logiktyp als Normal.

  10. Belassen Sie Extension als Core.

  11. Wählen Sie Bedingungstyp als Pfad ohne Abfragezeichenfolge aus.

  12. Aktivieren Sie rechts den Umschalter Regex .

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

  14. Wählen Sie Änderungen beibehalten aus

    Analytics-XDM-Regeln

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

  16. Wählen Sie die Erweiterung Adobe Experience Platform Web SDK

  17. Wählen Sie Aktionstyp als Variable aktualisieren aus.

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

  19. Scrollen Sie nach unten zum Objekt commerce

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

    Einrichten der Produktansicht

    note tip
    TIP
    Wenn Sie commerce.productViews.value=1 in XDM festlegen, wird dies 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 aufweist, wird der in der Regel "globale Konfiguration"festgelegte eventType-Wert überschrieben. 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 aus.

  23. Wählen Sie Bereitstellen einzelner Elemente aus.

  24. Wählen Sie Element hinzufügen

    Festlegen des Produktansichtsereignisses

    note caution
    CAUTION
    Der Datentyp productListItems ist ein array , sodass erwartet wird, dass Daten als Kollektion 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. Wählen Sie aus, um Element 1 zu öffnen

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

    Produkt-SKU XDM-Objektvariable

  27. Wählen Sie Änderungen beibehalten aus

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

Felder im Warenkorb

Sie können das gesamte Array einem XDM-Objekt zuordnen, vorausgesetzt, das Array entspricht dem Format des XDM-Schemas. Das zuvor erstellte Datenelement des benutzerspezifischen Codes cart.productInfo durchläuft das Datenschichtobjekt digitalData.cart.cartEntries auf Luma und übersetzt es in das erforderliche Format des Objekts productListItems 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

Vergleichen Sie das Datenelement mit der Struktur productListItems (Tipp: Es sollte übereinstimmen).

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

Zuordnen des Arrays zum XDM-Objekt:

  1. Neue Regel mit dem Namen ecommerce - library loaded - set shopping cart variables - 20 erstellen

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

  3. Wählen Sie unter Erweiterung Core aus.

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

  5. Wählen Sie diese Option aus, um Erweiterte Optionen zu öffnen, geben Sie in 20 ein.

  6. Wählen Sie Änderungen beibehalten aus

    Analytics-XDM-Regeln

  7. Wählen Sie unter Bedingungen die Option "Hinzufügen"

  8. Belassen Sie Logiktyp als Normal.

  9. Belassen Sie Erweiterungen als Core .

  10. Wählen Sie Bedingungstyp als Pfad ohne Abfragezeichenfolge aus.

  11. rechts: nicht aktivieren den Umschalter Regex

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

  13. Wählen Sie Änderungen beibehalten aus

    Analytics-XDM-Regeln

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

  15. Wählen Sie die Erweiterung Adobe Experience Platform Web SDK

  16. Wählen Sie Aktionstyp als Variable aktualisieren aus.

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

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

  19. Öffnen Sie das Objekt productListViews und setzen Sie value auf 1

    Einrichten der Produktansicht

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

  20. Wählen Sie eventType aus und setzen Sie auf commerce.productListViews

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

  22. Wählen Sie Gesamtes Array bereitstellen

  23. Dem cart.productInfo-Datenelement zuordnen

  24. Wählen Sie Änderungen beibehalten aus

  25. Wählen Sie Speichern aus, 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. 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 des scCheckout -Ereignisses 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 des purchase -Ereignisses in Analytics

  4. Setzen Sie commerce.order.purchaseID auf das Datenelement cart.orderId

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

    Festlegen der purchaseID für Analytics

    note tip
    TIP
    Dies entspricht dem Festlegen von s.purchaseID - und s.currencyCode -Variablen in Analytics

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

  7. Wählen Sie Gesamtes Array bereitstellen

  8. Dem cart.productInfo.purchase-Datenelement zuordnen

  9. Wählen Sie Änderungen beibehalten aus

  10. Wählen Sie Speichern aus.

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

  1. Wählen Sie rechts Regel hinzufügen aus, 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 im Abschnitt Ereignisse die Option Hinzufügen

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

  5. Wählen Sie das Dropdown-Menü Erweitert aus und geben Sie 50 in Reihenfolge ein. Dadurch wird sichergestellt, dass diese Regel ausgelöst wird, nachdem alle anderen Regeln, die Sie konfiguriert haben (die 1 oder 20 als ihren Auftrag hatten), ausgelöst wurden.

  6. Wählen Sie Änderungen beibehalten aus, um zum Hauptregelbildschirm zurückzukehren.
    Trigger Bibliothek geladenauswählen

  7. Wählen Sie im Abschnitt Aktionen die Option Hinzufügen

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

  9. Wählen Sie als Aktionstyp Ereignis senden aus.

  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 Hauptregelbildschirm zurückzukehren.

    Fügen Sie die Aktion Ereignis sendenhinzu

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

    Speichern der Regel

Regeln in einer Bibliothek Publish

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 im linken Navigationsbereich zu Veröffentlichungsfluss .

  2. Wählen Sie Bibliothek hinzufügen

    Bibliothek hinzufügen auswählen

  3. Geben Sie für den Namen Luma Web SDK Tutorial ein.

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

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

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

  6. Wählen Sie Speichern und für Entwicklung erstellen

    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 abgeschlossen

Wie Sie auf dem Bildschirm "Veröffentlichungsfluss"sehen, 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 oder Anregungen zu künftigen Inhalten haben möchten, teilen Sie diese bitte in diesem Experience League Community-Diskussionsbeitrag mit.
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4