Einrichten von Adobe Analytics mit Adobe Experience Platform Web SDK
Erfahren Sie, wie Sie Adobe Analytics mithilfe von Adobe Experience Platform Web SDK einrichten, Tag-Regeln erstellen, um Daten an Adobe Analytics zu senden, und überprüfen, ob Analytics die Daten erwartungsgemäß erfasst.
Adobe Analytics ist eine branchenführende Anwendung, mit der Sie Ihre Kunden als Mitarbeiter verstehen und Ihr Unternehmen mit Customer Intelligence steuern können.
Lernziele
Am Ende dieser Lektion können Sie:
- Konfigurieren eines Datenstroms zur Aktivierung von Adobe Analytics
- Ermitteln, welche standardmäßigen XDM-Felder automatisch Analytics-Variablen zugeordnet werden
- Analytics-Variablen im Datenobjekt festlegen
- Senden von Daten an eine andere Report Suite durch Überschreiben des Datenstroms
- Validieren von Adobe Analytics-Variablen mit Debugger und Assurance
Voraussetzungen
Um diese Lektion abzuschließen, müssen Sie zunächst:
-
Machen Sie sich mit Adobe Analytics vertraut und haben Sie Zugriff darauf.
-
Sie verfügen über mindestens eine Test-/Entwicklungs-Report Suite-ID. Wenn Sie keine Test-/Entwicklungs-Report Suite haben, die Sie für dieses Tutorial verwenden können, erstellen eine.
-
Die vorherigen Lektionen in den Abschnitten Erstkonfiguration und Tags-Konfiguration dieses Tutorials absolvieren.
Konfigurieren des Datenstroms
Platform Web SDK sendet Daten von Ihrer Website an das Platform-Edge Network. Ihr Datenstrom teilt dann Platform Edge Network mit, an welche Adobe Analytics Report Suites Ihre Daten gesendet werden sollen.
-
Zur Datenerfassung wechseln
-
Wählen Sie in der linken Navigation Datenströme
-
Wählen Sie den zuvor erstellten
Luma Web SDK: Development Environment
aus -
Wählen Sie Service hinzufügen
-
Wählen Sie Adobe Analytics als Service
-
Geben Sie die Report Suite-ID Ihrer Entwicklungs-Report Suite ein
-
Wählen Sie Speichern
note tip TIP Das Hinzufügen weiterer Report Suites durch Auswahl von Report Suite hinzufügen entspricht dem Multi-Suite-Tagging.
Analytics-Variablen festlegen
Es gibt mehrere Möglichkeiten, Analytics-Variablen in einer Web SDK-Implementierung festzulegen:
- Automatische Zuordnung von XDM-Feldern zu Analytics-Variablen (automatisch).
- Legen Sie Felder im
data
fest (empfohlen). - Zuordnen von XDM-Feldern zu Analytics-Variablen in Analytics-Verarbeitungsregeln (nicht mehr empfohlen).
- Zuordnen zu Analytics-Variablen direkt im XDM-Schema (nicht mehr empfohlen).
Ab Mai 2024 müssen Sie kein XDM-Schema mehr erstellen, um Adobe Analytics mit Platform Web SDK zu implementieren. Das data
(und das data.variable
Datenelement, das Sie in der Lektion Datenelemente erstellen erstellt haben) können zum Festlegen aller benutzerdefinierten Analytics-Variablen verwendet werden. Das Festlegen dieser Variablen im Datenobjekt ist bestehenden Analytics-Kunden vertraut, ist effizienter als die Verwendung der Benutzeroberfläche für Verarbeitungsregeln und verhindert, dass unnötige Daten in Echtzeit-Kundenprofilen Speicherplatz belegen (wichtig, wenn Sie über Real-time Customer Data Platform oder Journey Optimizer verfügen).
Automatisch zugeordnete Felder
Viele XDM-Felder werden automatisch Analytics-Variablen zugeordnet. Die aktuelle Liste der Zuordnungen finden Sie unter Analytics-Variablenzuordnung in Adobe Experience Edge.
Dies tritt auf, (auch wenn Sie kein benutzerdefiniertes Schema definiert haben. Experience Platform Web SDK erfasst automatisch einige Daten und sendet sie als XDM-Felder an das Platform-Edge Network. Beispielsweise liest Web SDK die URL der aktuellen Seite und sendet sie als XDM-web.webPageDetails.URL
. Dieses Feld wird an Adobe Analytics weitergeleitet und die Seiten-URL-Berichte in Adobe Analytics werden automatisch ausgefüllt.
Wenn Sie Web SDK für Adobe Analytics mit einem XDM-Schema implementieren, wie Sie es in diesem Tutorial getan haben, verfügen einige der XDM-Felder, die Sie anwenderdefiniert implementiert haben, über eine automatische Zuordnung zu Analytics-Variablen, wie in dieser Tabelle beschrieben:
identitymap.ecid.[0].id
web.webPageDetails.name
web.webPageDetails.server
web.webPageDetails.siteSection
commerce.productViews.value
commerce.productListViews.value
commerce.checkouts.value
commerce.purchases.value
commerce.order.currencyCode
commerce.order.purchaseID
productListItems[].SKU
productListItems[].name
productListItems[].quantity
productListItems[].priceTotal
Die einzelnen Abschnitte der Analytics-Produktzeichenfolge werden durch verschiedene XDM-Variablen unter dem productListItems
festgelegt.
productListItems[].SKU
Priorität für die Zuordnung zum Produktnamen in der s.products-Variablen.Der auf
productListItems[].name
festgelegte Wert wird nur dann dem Produktnamen zugeordnet, wenn productListItems[].SKU
nicht vorhanden ist. Andernfalls ist sie nicht zugeordnet und in Kontextdaten verfügbar.Legen Sie keine leere Zeichenfolge oder Null auf
productListItems[].SKU
fest. Dies hat den unerwünschten Effekt der Zuordnung zum Produktnamen in der s.products-Variablen.Festlegen von Variablen im Datenobjekt
Aber was ist mit eVars, Props und Ereignissen? Das Festlegen von Variablen im data
ist die empfohlene Methode zum Festlegen dieser Analytics-Variablen mit Web SDK. Durch Festlegen von Variablen im Datenobjekt können auch alle automatisch zugeordneten Variablen überschrieben werden.
Erstens, was ist das data
? In jedem Web-SDK-Ereignis können Sie zwei Objekte mit benutzerdefinierten Daten senden, das xdm
-Objekt und das data
-Objekt. Beide werden an das Platform-Edge Network gesendet, aber nur das xdm
-Objekt wird an den Experience Platform-Datensatz gesendet. Eigenschaften im data
können in der Edge xdm
Feldern mithilfe der Funktion „Datenvorbereitung für die Datenerfassung“ zugeordnet werden, werden andernfalls jedoch nicht an Experience Platform gesendet. Dies macht sie zu einer idealen Möglichkeit, Daten an Anwendungen wie Analytics zu senden, die nicht nativ auf Experience Platform erstellt wurden.
Im Folgenden finden Sie die beiden Objekte in einem generischen Web-SDK-Aufruf:
Adobe Analytics ist so konfiguriert, dass im data.__adobe.analytics
-Objekt nach Eigenschaften gesucht und diese für Analytics-Variablen verwendet werden.
Schauen wir uns an, wie das funktioniert. Legen wir eVar1
und prop1
mit unserem Seitennamen fest und sehen wir uns an, wie der XDM-zugeordnete Wert überschrieben werden kann
- Öffnen Sie die Tag-Regel
all pages - library loaded - set global variables - 1
- Fügen Sie eine neue Aktion“
- Erweiterung Adobe Experience Platform Web SDK auswählen
- Wählen Sie Aktionstyp als Variable aktualisieren
- Wählen Sie
data.variable
als Datenelement - Wählen Sie das analytics-Objekt aus
eVar1
alspage.pageInfo.pageName
Datenelement festlegenprop1
festlegen, um den Wert voneVar1
zu kopieren- Um das Überschreiben von XDM-zugeordneten Werten zu testen, legen Sie im Abschnitt Zusätzliche Eigenschaft den Seitennamen als statischen Wert
test
- Speichern der Regel
Jetzt müssen wir das Datenobjekt in unsere Regel „Ereignis senden“ einschließen.
- Öffnen Sie die Tag-Regel
all pages - library loaded - send event - 50
- Öffnen der Aktion Ereignis senden
- Wählen Sie
data.variable
als Daten - Wählen Änderungen beibehalten
- Wählen Sie Speichern
Senden von Daten an eine andere Report Suite
Möglicherweise möchten Sie ändern, an welche Adobe Analytics Report Suite-Daten gesendet werden, wenn sich Besucher auf bestimmten Seiten befinden. Dies erfordert eine Konfiguration sowohl im Datenstrom als auch in einer Regel.
Konfigurieren des Datenstroms für eine Report Suite-Überschreibung
So konfigurieren Sie die Einstellung "Adobe Analytics Report Suite-Überschreibung“ im Datenstrom:
-
Öffnen des Datenstroms
-
Bearbeiten Sie die Konfiguration von Adobe Analytics, indem Sie das Menü
-
Wählen Sie Erweiterte Optionen aus, um Report Suite-Überschreibungen
-
Wählen Sie die Report Suites aus, die Sie überschreiben möchten. In diesem Fall
Web SDK Course Dev
undWeb SDK Course Stg
-
Wählen Sie Speichern
Konfigurieren einer Regel für eine Report Suite-Überschreibung
Erstellen wir eine Regel, um einen zusätzlichen Seitenansichtsaufruf an eine andere Report Suite zu senden. Verwenden Sie die Datenstrom-Überschreibungsfunktion, um die Report Suite für eine Seite mithilfe der Aktion Ereignis senden zu ändern.
-
Neue Regel erstellen und
homepage - library loaded - AA report suite override - 51
benennen -
Wählen Sie das Pluszeichen unter Ereignis aus, um einen neuen Trigger hinzuzufügen
-
Wählen unter "" die Option Core
-
Wählen unter „Ereignistyp die Option Bibliothek geladen (Seitenanfang)
-
Wählen Sie zum Öffnen Erweiterte Optionen die
51
aus. Dadurch wird sichergestellt, dass die Regel nach demall pages - library loaded - send event - 50
ausgeführt wird, der den Grundlinien-XDM mit dem Aktionstyp Variable aktualisieren festlegt. -
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
-
Lassen Sie rechts den Umschalter Regex deaktiviert
-
Legen unter „Pfad"
/content/luma/us/en.html
fest. Für die Demo-Site von Luma wird sichergestellt, dass die Regel nur Trigger auf der Startseite enthält -
Wählen Änderungen beibehalten
-
Wählen unter Aktionen die Option Hinzufügen
-
Wählen Sie als Erweiterung die Option Adobe Experience Platform Web SDK
-
Wählen Sie als Aktionstyp "senden
-
Wählen Sie als XDM das
xdm.variable.content
Datenelement aus, das Sie in der Lektion Datenelemente erstellen erstellt haben -
Wählen als das
data.variable
Datenelement aus, das Sie in der Lektion Datenelemente erstellen erstellt haben -
Scrollen Sie nach unten zum Abschnitt Überschreibungen von Datenstromkonfigurationen
-
Lassen Sie die Entwicklung ausgewählt.
note tip TIP Diese Registerkarte bestimmt, in welcher Tag-Umgebung die Überschreibung erfolgt. Für diese Übung geben Sie nur die Entwicklungsumgebung an, denken Sie jedoch bei der Bereitstellung in der Produktionsumgebung daran, dies auch in der Produktionsumgebung zu tun. -
Wählen Sie die Sandbox aus, die Sie für das Tutorial verwenden
-
Wählen Sie Datenstrom aus, in diesem Fall
Luma Web SDK: Development Environment
-
Wählen unter „Report" die Report Suite aus, die Sie überschreiben möchten. In diesem Fall,
tmd-websdk-course-stg
. -
Wählen Änderungen beibehalten
-
Und Speichern Ihre Regel
Erstellen der Entwicklungsumgebung
Fügen Sie Ihre aktualisierten Regeln zu Ihrer Luma Web SDK Tutorial
Tag-Bibliothek hinzu und erstellen Sie Ihre Entwicklungsumgebung neu.
Herzlichen Glückwunsch! Der nächste Schritt besteht darin, Ihre Adobe Analytics-Implementierung über Experience Platform Web SDK zu validieren.
Validieren von Adobe Analytics mit Debugger
Erfahren Sie, wie Sie überprüfen können, ob Adobe Analytics die ECID, Seitenansichten, die Produktzeichenfolge und E-Commerce-Ereignisse mit der Edge Trace-Funktion von Experience Platform Debugger erfasst.
In der Debugger-Lektion haben Sie gelernt, wie Sie die Client-seitige XDM-Anfrage mit Platform Debugger und der Browser-Entwicklerkonsole überprüfen können, was dem Debuggen einer AppMeasurement.js
Analytics-Implementierung ähnelt. Sie haben auch etwas über die Validierung von Server-seitigen Platform-Edge Network-Anfragen erfahren, die an Adobe-Anwendungen gesendet werden, und darüber, wie Sie eine vollständig verarbeitete Payload mit Assurance anzeigen können.
Um zu überprüfen, ob Analytics die ordnungsgemäße Datenerfassung durch Experience Platform Web SDK gewährleistet, müssen Sie zwei Schritte weiter gehen, um:
- Überprüfen Sie mithilfe der Edge Trace-Funktion von Experience Platform Debugger, wie Daten vom XDM-Objekt im Platform-Edge Network verarbeitet werden
- Überprüfen, wie Daten von Analytics mithilfe von Adobe Experience Platform Assurance vollständig verarbeitet werden
Experience Cloud-ID-Validierung
-
Navigieren Sie zur Demo-Site von Luma
-
Klicken Sie auf die Schaltfläche Anmelden oben rechts und verwenden Sie die Anmeldedaten u: test@adobe.com p: Test zur Authentifizierung
-
Öffnen Sie den Experience Platform-Debugger und wechseln Sie die Tag-Eigenschaft auf der Site zu Ihrer eigenen Entwicklungseigenschaft
-
Um den Edge-Trace zu aktivieren, wechseln Sie zum Experience Platform-Debugger, wählen Sie im linken Navigationsbereich Protokolle und dann die Registerkarte Edge aus und klicken Sie auf Verbinden
-
Er wird vorerst leer sein
-
Aktualisieren Sie die Luma-Seite und überprüfen Sie Experience Platform Debugger erneut. Sie sollten Daten sehen, die durchlaufen werden. Die Zeile, die mit Automatisches Analytics-Mapping beginnt, ist das Adobe Analytics-Beacon
-
Wählen Sie aus, um sowohl das Dropdown-Menü
mappedQueryParams
als auch das zweite Dropdown-Menü zu öffnen und Analytics-Variablen anzuzeigennote tip TIP Die zweite Dropdown-Liste entspricht der Analytics Report Suite-ID , an die Sie Daten senden. Sie sollte mit Ihrer eigenen Report Suite übereinstimmen, nicht mit der im Screenshot. -
Scrollen Sie nach unten, um
c.a.x.identitymap.ecid.[0].id
zu finden. Es ist eine Kontextdatenvariable, die ECID erfasst -
Scrollen Sie nach unten, bis Sie die Variable Analytics-
mid
sehen. Beide IDs stimmen mit der Experience Cloud-ID Ihres Geräts überein. -
Auf der Website von Luma
note note NOTE Da Sie angemeldet sind, sollten Sie kurz überprüfen, ob die authentifizierte ID 112ca06ed53d3db37e4cea49cc45b71e
für den Benutzertest@adobe.com
auch in derc.a.x.identitymap.lumacrmid.[0].id
erfasst wird
Validierung der Report Suite-Überschreibung
Oben haben Sie eine Datenstrom-Überschreibung für die (LumaHomepage konfiguriert. So validieren Sie diese Konfiguration
-
Suchen Sie nach einer Zeile mit Datastream-Konfiguration nach angewendeter Überschreibung. Hier finden Sie die primäre Report Suite und die zusätzlichen Report Suites, die für die Überschreibungen der Report Suite konfiguriert wurden.
-
Scrollen Sie nach unten zur Zeile, die mit Automatisches Analytics-Mapping“ beginnt und stellen Sie sicher, dass im
reportSuiteIds
die Report Suite angezeigt wird, die Sie in Ihren Überschreibungskonfigurationen angegeben haben
Validierung der Inhaltsseitenansichten
Navigieren Sie zu einer Produktseite wie der Didi Sport Watch-Produktseite. Überprüfen Sie, ob Inhalts-Seitenansichten von Analytics erfasst werden.
-
Suchen Sie nach
c.a.x.web.webpagedetails.pageviews.value=1
. -
Scrollen Sie nach unten, um die Variable
gn
anzuzeigen. Dies ist die dynamische Analytics-Syntax für dies.pageName
. Erfasst den Seitennamen aus der Datenschicht.
Validierung von Produktzeichenfolgen und E-Commerce-Ereignissen
Da Sie sich bereits auf einer Produktseite befinden, verwendet diese Übung weiterhin dieselbe Edge Trace, um zu überprüfen, ob Produktdaten von Analytics erfasst werden. Sowohl die Produktzeichenfolge als auch die E-Commerce-Ereignisse werden Analytics automatisch XDM-Variablen zugeordnet. Sofern Sie beim Konfigurieren XDM-Schemas für Adobe Analytics der richtigen productListItem
-XDM-Variablehaben, mappt das Platform-Edge Network die Daten den richtigen Analytics-Variablen zu.
Überprüfen Sie zunächst, ob die Product String
festgelegt ist
-
Suchen Sie nach
c.a.x.productlistitems.[0].sku
. Die Variable erfasst den Datenelementwert, den Sie derproductListItems.item1.sku
zuvor in dieser Lektion zugeordnet haben -
Suchen Sie auch nach
c.a.x.productlistitems.[0]._experience.analytics.customdimensions.evars.evar1
. Die Variable erfasst den Datenelementwert, den SieproductListItems.item1._experience.analytics.customdimensions.evars.evar1
zugeordnet haben -
Scrollen Sie nach unten, um die Variable
pl
anzuzeigen. Dies ist die dynamische Syntax der Analytics-Produktzeichenfolgen-Variablen -
Beachten Sie, dass der Produktname aus der Datenschicht sowohl dem
c.a.x.productlistitems.[0].sku
- als auch demproduct
-Parameter der Produktzeichenfolge zugeordnet ist. Darüber hinaus wird der Produkttitel aus der Datenschicht Merchandising-eVar1 in der Produktzeichenfolge zugeordnet.Edge Trace behandelt
commerce
Ereignisse geringfügig anders alsproductList
Dimensionen. Eine Kontextdatenvariable wird nicht auf die gleiche Weise zugeordnet angezeigt wie der Produktname, derc.a.x.productlistitem.[0].name
oben zugeordnet ist. Stattdessen zeigt Edge Trace die endgültige automatische Ereigniszuordnung in der Analytics-event
an. Das Platform-Edge Network ordnet es entsprechend zu, solange Sie es bei der Konfiguration des Schemas für Adobe Analytics der richtigen XDM-commerce
zuordnen. In diesem Fall ist dies diecommerce.productViews.value=1
. -
Scrollen Sie im Fenster Experience Platform-Debugger nach unten zur Variablen
events
und legen Sie sie aufprodView
fest -
Beachten Sie außerdem, dass
c.a.x.eventType
aufcommerce.productViews
gesetzt ist, da Sie sich auf einer Produktseite befinden.note tip TIP Die ecommerce - pdp library loaded - AA (order 20)
-Regel überschreibt den Wert dereventType
, die durch dieall pages global content variables - library loaded - AA (order 1)
-Regel festgelegt wird, da sie später in der Sequenz auf Trigger festgelegt wird
Validieren Sie den Rest der E-Commerce-Ereignisse und Produktzeichenfolgen, die für Analytics festgelegt sind
-
Add Didi Sport Watch to cart
-
Gehen Sie zur Warenkorbseite und überprüfen Sie Edge Trace auf
eventType
festgelegt aufcommerce.productListViews
events: "scView"
und- Die Produktzeichenfolge ist festgelegt
-
Zur Kasse gehen, Edge Trace überprüfen auf
eventType
festgelegt aufcommerce.checkouts
events: "scCheckout"
und- Die Produktzeichenfolge ist festgelegt
-
Füllen Sie nur die Felder Vorname und Nachname auf dem Versandformular aus und wählen Sie Weiter. Klicken Sie auf der nächsten Seite auf Bestellung aufgeben
-
Überprüfen Sie auf der Bestätigungsseite, ob Edge Trace
eventType
festgelegt aufcommerce.purchases
- Kaufereignis wird
events: "purchase"
- Währungs-Code-Variable, die
cc: "USD"
wird - Kauf-ID wird in
pi
festgelegt - Produktzeichenfolge
pl
Festlegen von Produktname, Menge und Preis
Validieren von Adobe Analytics mithilfe von Assurance
Mit Adobe Experience Platform Assurance können Sie die Art und Weise, wie Sie Daten erfassen oder Erlebnisse mit Ihrer Website und Mobile App bereitstellen, untersuchen, testen, simulieren und überprüfen.
In der vorherigen Übung haben Sie überprüft, ob Adobe Analytics die ECID, Seitenansichten, die Produktzeichenfolge und E-Commerce-Ereignisse mit der Edge Trace-Funktion von Experience Platform Debugger erfasst. Als Nächstes validieren Sie dieselben Ereignisse mit Adobe Experience Platform Assurance, einer alternativen Schnittstelle für den Zugriff auf dieselben Daten in Edge Trace.
Wie Sie in der Lektion zu Assurance gelernt haben, gibt es mehrere Möglichkeiten, eine Assurance-Sitzung zu starten. Da Sie bereits über Adobe Experience Platform Debugger mit einer Edge Trace-Sitzung verfügen, die in der letzten Übung initiiert wurde, empfehlen wir Ihnen, über den Debugger auf Assurance zuzugreifen:
Geben Sie im „Web SDK Tutorial 3“ Assurance Session „hitdebugger“ in die Ereignissuchleiste ein, um die Ergebnisse nach den in Adobe Analytics nachbearbeiteten Daten zu filtern.
Experience Cloud-ID-Validierung
Um zu überprüfen, ob Adobe Analytics die ECID erfasst, wählen Sie ein Beacon aus und öffnen Sie die Payload. Der Anbieter dieses Beacons sollte com.adobe.analytics.hitdebugger sein
Scrollen Sie dann nach unten zu mcvisId, um zu überprüfen, ob die ECID korrekt erfasst wird
Validierung der Inhaltsseitenansichten
Überprüfen Sie mithilfe desselben Beacons, ob die Inhaltsseitenansichten der richtigen Adobe Analytics-Variablen zugeordnet sind.
Scrollen Sie nach unten zu pageName, um zu überprüfen, ob die Page Name
korrekt erfasst wird
Validierung von Produktzeichenfolgen und E-Commerce-Ereignissen
Nach denselben Validierungsanwendungsfällen, die bei der Validierung mit dem Experience Platform-Debugger oben verwendet wurden, verwenden Sie weiterhin denselben Beacon, um die Ecommerce Events
und die Product String
zu validieren.
- Suchen Sie nach Payload, in der die Ereignisse
prodView
enthalten
- Scrollen Sie nach unten product-string, um die
Product String
zu validieren.- Beachten Sie die
Product SKU
undMerchandizing eVar1
.
- Beachten Sie die
- Scrollen Sie weiter nach unten und überprüfen Sie, ob die
prop1
, die Sie mithilfe von Verarbeitungsregeln im vorherigen Abschnitt konfiguriert haben, dieProduct SKU
enthält
Validieren Sie Ihre Implementierung weiter, indem Sie die Warenkorb-, Checkout- und Kaufereignisse lesen.
- Suchen Sie nach Payload, in der Ereignisse
scView
enthalten, und validieren Sie die Produktzeichenfolge.
- Suchen Sie nach Payload, in der Ereignisse
scCheckout
enthalten, und validieren Sie die Produktzeichenfolge.
- Suchen Sie nach Payload, in der die Ereignisse
purchase
enthalten
- Beachten Sie bei der Validierung des
purchase
-Ereignisses, dass dieProduct String
dieProduct SKU
,Product Quantity
undProduct Total Price
enthalten sollte. - Überprüfen Sie für die
purchase
außerdem, ob diepurchase-id
und/oderpurchaseId
festgelegt sind
Herzlichen Glückwunsch! Du hast es geschafft! Dies ist das Ende der Lektion. Jetzt können Sie Adobe Analytics mit Platform Web SDK für Ihre eigene Website implementieren.