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:
- location die Seite(n) auf der Site, auf der die Regel ausgelöst wird
- event ist der Trigger für die Regel
- Zweck ist die Hauptaktion, die von der Regel ausgeführt wird
- 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:
-
Erstellen Sie eine Regel mit der Aktion Variable aktualisieren um eine „globale Konfiguration“ von XDM-Feldern zu definieren.
-
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).
-
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:
-
Öffnen Sie die Tag-Eigenschaft, die Sie für dieses Tutorial verwenden
-
Navigieren Sie linken Navigationsbereich zu Regeln“
-
Klicken Sie auf Schaltfläche „Neue Regel"
-
Geben Sie einen Namen für die Regel ein
all pages - library loaded - set global variables - 1
. -
Wählen Sie Abschnitt Ereignisse“ Hinzufügen
-
Verwenden Sie die Core Erweiterung und wählen Sie Bibliothek geladen (Seitenanfang) als Ereignistyp
-
Wählen Sie Dropdown- „Erweitert“ aus und geben Sie
1
als einnote note NOTE Je niedriger die Ordnungszahl, desto früher wird sie ausgeführt. Daher geben wir unserer „globalen Konfiguration“ eine niedrige Bestellnummer. -
Wählen Sie Änderungen beibehalten aus, um zum Hauptbildschirm für Regeln zurückzukehren
-
Wählen Sie Abschnitt Aktionen“ Hinzufügen
-
Wählen Sie als Erweiterung die Option Adobe Experience Platform Web SDK
-
Wählen Sie als Aktionstyp die Option Variable aktualisieren
-
Wählen als das
xdm.variable.content
aus, das Sie in der Lektion Datenelemente erstellen erstellt haben
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:
-
Suchen Sie das Feld eventType und wählen Sie es
-
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 FeldeventType
auswählen, um die vorgeschlagenen Werte in der rechten Leiste anzuzeigen. Sie können bei Bedarf auch einen neuen Wert eingeben.
-
Suchen Sie anschließend das
identityMap
im Schema und wählen Sie es aus. -
Dem
identityMap.loginID
Datenelement zuordnennote 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 dasidentityMap
-Objekt nicht gesendet. Deshalb können wir sie in unserer „globalen Konfiguration“ definieren. -
Scrollen Sie nach unten, bis Sie das
web
erreichen -
Auswählen, um es zu öffnen
-
Ordnen Sie die folgenden Datenelemente den entsprechenden
web
XDM-Variablen zuweb.webPageDetials.name
zu%page.pageInfo.pageName%
web.webPageDetials.server
zu%page.pageInfo.server%
web.webPageDetials.siteSection
zu%page.pageInfo.hierarchie1%
-
Stellen Sie
web.webPageDetials.pageViews.value
auf1
ein.note tip TIP Obwohl weder eventType
aufweb.webpagedetails.pageViews
nochweb.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. -
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.
Beginnen Sie, indem Sie die Produktansichten auf der Produktdetailseite von Luma verfolgen:
-
Wählen Sie Regel hinzufügen
-
Benennen Sie ihn
ecommerce - library loaded - set product details variables - 20
-
Wählen Sie das Symbol
-
Wählen unter "" die Option Core
-
Wählen unter „Ereignistyp die Option Bibliothek geladen (Seitenanfang)
-
Wählen Sie zum Öffnen Erweiterte Optionen die
20
aus. Dieser Reihenfolgenwert stellt sicher, dass die Regel demall pages - library loaded - set global variables - 1
ausgeführt wird der die globale Konfiguration festlegt. -
Wählen Änderungen beibehalten
-
Wählen unter „Bedingungen die Option zum Hinzufügen aus
-
Behalten Logiktyp bei Regular
-
Belassen extension als core
-
Wählen Sie Bedingungstyp als Pfad ohne Abfragezeichenfolge
-
Aktivieren Sie auf der rechten Seite den Umschalter Regex.
-
Legen unter „Pfad"
/products/
fest. Für die Demo-Site von Luma wird sichergestellt, dass die Regel nur Trigger auf Produktseiten enthält -
Wählen Änderungen beibehalten
-
Wählen unter Aktionen die Option Hinzufügen
-
Erweiterung Adobe Experience Platform Web SDK auswählen
-
Wählen Sie Aktionstyp als Variable aktualisieren
-
Wählen Sie
xdm.variable.content
als Datenelement -
Scrollen Sie nach unten zum
commerce
-
Öffnen Sie das productViews-Objekt und legen Sie value auf
1
note tip TIP Das Festlegen von „commerce.productViews.value=1“ in XDM wird automatisch dem prodView
-Ereignis in Analytics zugeordnet -
Scrollen Sie nach unten zu
eventType
und setzen Sie es aufcommerce.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. -
Scrollen Sie nach unten zu und wählen Sie
productListItems
Array aus -
Wählen Sie Einzeln bereitstellen
-
Wählen Sie Element hinzufügen
note caution CAUTION Der productListItems
ist einarray
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. -
Zum Öffnen auswählen Element 1
-
productListItems.item1.SKU
%product.productInfo.sku%
zuordnen -
Wählen Änderungen beibehalten
-
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:
Vergleichen Sie das Datenelement mit der productListItems
(Hinweis, es sollte übereinstimmen).
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.
Ordnen wir nun unser Array dem XDM-Objekt zu:
-
Erstellen Sie eine neue Regel mit dem Namen
ecommerce - library loaded - set shopping cart variables - 20
-
Wählen Sie das Symbol
-
Wählen unter "" die Option Core
-
Wählen unter „Ereignistyp die Option Bibliothek geladen (Seitenanfang)
-
Wählen Sie zum Öffnen Erweiterte Optionen die folgende Option aus
20
-
Wählen Änderungen beibehalten
-
Wählen unter „Bedingungen die Option zum Hinzufügen aus
-
Behalten Logiktyp bei Regular
-
Erweiterungen als ""
-
Wählen Sie Bedingungstyp als Pfad ohne Abfragezeichenfolge
-
Aktivieren Sie auf der rechten Seite nicht den Umschalter Regex.
-
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 -
Wählen Änderungen beibehalten
-
Wählen unter Aktionen die Option Hinzufügen
-
Erweiterung Adobe Experience Platform Web SDK auswählen
-
Wählen Sie Aktionstyp als Variable aktualisieren
-
Wählen Sie
xdm.variable.content
als Datenelement -
Scrollen Sie nach unten zum
commerce
und wählen Sie es aus, um es zu öffnen. -
Öffnen Sie das productListViews-Objekt und legen Sie value auf
1
festnote tip TIP Das Festlegen von „commerce.productListViews.value=1“ in XDM wird automatisch dem scView
-Ereignis in Analytics zugeordnet -
eventType
auswählen und aufcommerce.productListViews
setzen -
Scrollen Sie nach unten zum Array productListItems und wählen Sie es aus.
-
Wählen Sie Gesamtes Array bereitstellen
-
Zu
cart.productInfo
Datenelement zuordnen -
Wählen Änderungen beibehalten
-
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
-
condition: /content/luma/us/en/user/checkout.html
-
Stellen Sie
eventType
aufcommerce.checkouts
ein. -
Stellen Sie
commerce.checkout.value
auf1
ein.note tip TIP Dies entspricht dem Festlegen scCheckout
Ereignisses in Analytics
Regelname: ecommerce - library loaded - set purchase variables - 20
-
condition: /content/luma/us/en/user/checkout/order/thank-you.html
-
Stellen Sie
eventType
aufcommerce.purchases
ein. -
Stellen Sie
commerce.purchases.value
auf1
ein.note tip TIP Dies entspricht dem Festlegen purchase
Ereignisses in Analytics -
commerce.order.purchaseID
auf dascart.orderId
Datenelement festlegen -
commerce.order.currencyCode
auf den hartcodierten WertUSD
note tip TIP Dies entspricht dem Festlegen von s.purchaseID
- unds.currencyCode
in Analytics -
Scrollen Sie nach unten zum Array productListItems und wählen Sie es aus.
-
Wählen Sie Gesamtes Array bereitstellen
-
Zu
cart.productInfo.purchase
Datenelement zuordnen -
Wählen Änderungen beibehalten
-
Wählen Sie Speichern
Wenn Sie fertig sind, sollten Sie die folgenden Regeln erstellt sehen.
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.
-
Klicken Sie auf der rechten Seite auf Regel hinzufügen, um eine weitere Regel zu erstellen
-
Geben Sie einen Namen für die Regel ein
all pages - library loaded - send event - 50
. -
Wählen Sie Abschnitt Ereignisse“ Hinzufügen
-
Verwenden Sie die Core Erweiterung und wählen Sie
Library Loaded (Page Top)
als Ereignistyp -
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 (die1
oder20
hatten order). -
Wählen Sie Änderungen beibehalten aus, um zum Hauptbildschirm für Regeln zurückzukehren
-
Wählen Sie Abschnitt Aktionen“ Hinzufügen
-
Wählen Sie als Erweiterung die Option Adobe Experience Platform Web SDK
-
Wählen Sie als Aktionstyp die Option Ereignis senden
-
Wählen Sie als XDM das in der vorherigen Lektion erstellte
xdm.variable.content
-Datenelement aus -
Wählen Sie Änderungen beibehalten aus, um zum Hauptbildschirm für Regeln zurückzukehren
-
Wählen Speichern, um die Regel zu speichern
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:
-
Navigieren Sie linken Navigationsbereich Veröffentlichungsfluss "".
-
Wählen Sie Bibliothek hinzufügen
-
Geben Sie für Name den Wert
Luma Web SDK Tutorial
-
Wählen Sie für Umgebung die Option
Development
-
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. -
Wählen Sie Für Entwicklung speichern und erstellen
Es kann einige Minuten dauern, bis die Bibliothek erstellt ist. Nach Abschluss wird links neben dem Bibliotheksnamen ein grüner Punkt angezeigt:
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.