Einrichten von Adobe Analytics mit dem Adobe Experience Platform Web SDK
Erfahren Sie, wie Sie Adobe Analytics mit Adobe Experience Platform Web SDKerstellen Tag-Regeln, um Daten an Adobe Analytics zu senden, und überprüfen, ob Analytics Daten erwartungsgemäß erfasst.
Adobe Analytics ist eine branchenführende Anwendung, mit der Sie Ihre Kunden besser verstehen und Ihr Geschäft mit Customer Intelligence steuern können.
Lernziele
Am Ende dieser Lektion können Sie:
- Konfigurieren eines Datenspeichers zur Aktivierung von Adobe Analytics
- Ermitteln, welche Standard-XDM-Felder automatisch Analytics-Variablen zugeordnet werden
- Analytics-Variablen im Datenobjekt festlegen
- Senden von Daten an eine andere Report Suite durch Überschreiben des Datastreams
- Validieren von Adobe Analytics-Variablen mithilfe von 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 auf diese.
-
Sie verfügen über mindestens eine Report Suite-ID für Tests/Entwicklung. Wenn Sie nicht über eine Report Suite für Tests/Entwicklung verfügen, die Sie für dieses Tutorial verwenden können, erstellen Sie bitte eine.
-
Schließen Sie die früheren Lektionen in den Abschnitten Erstkonfiguration und Tags-Konfiguration dieses Tutorials ab.
Konfigurieren des Datenspeichers
Das Platform Web SDK sendet Daten von Ihrer Website an Platform Edge Network. Ihr Datastream teilt dann Platform Edge Network mit, an welche Adobe Analytics Report Suites Ihre Daten gesendet werden sollen.
-
Navigieren Sie zu Datenerfassung Benutzeroberfläche
-
Wählen Sie im linken Navigationsbereich die Option Datenspeicher
-
Wählen Sie die zuvor erstellte
Luma Web SDK: Development Environment
datastream -
Auswählen Dienst hinzufügen
-
Auswählen Adobe Analytics als Dienst
-
Geben Sie die Report Suite-ID Ihrer Entwicklungs-Report Suite
-
Auswählen Speichern
note tip TIP Hinzufügen weiterer Report Suites durch Auswahl von Report Suite hinzufügen entspricht 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).
- Festlegen von Feldern in der
data
-Objekt (empfohlen). - Ordnen Sie XDM-Felder Analytics-Variablen in Analytics-Verarbeitungsregeln zu (nicht mehr empfohlen).
- Ordnen Sie Analytics-Variablen direkt im XDM-Schema zu (nicht mehr empfohlen).
Ab Mai 2024 müssen Sie kein XDM-Schema mehr erstellen, um Adobe Analytics mit dem Platform Web SDK zu implementieren. Die data
-Objekt (und der data.variable
Datenelement, das Sie im Erstellen von Datenelementen Lektion) verwendet werden, um alle benutzerdefinierten Analytics-Variablen festzulegen. Das Festlegen dieser Variablen im Datenobjekt ist für bestehende Analytics-Kunden bekannt, effizienter als die Verwendung der Benutzeroberfläche für Verarbeitungsregeln und verhindert, dass unnötige Daten in Echtzeit-Kundenprofilen Platz nehmen (wichtig bei Real-time Customer Data Platform oder Journey Optimizer).
Automatisch zugeordnete Felder
Viele XDM-Felder werden automatisch Analytics-Variablen zugeordnet. Die aktuellste Liste der Zuordnungen finden Sie unter Analytics-Variablenzuordnung in Adobe Experience Edge.
Dies tritt auf, wenn auch wenn Sie kein benutzerdefiniertes Schema definiert haben. Experience Platform Web SDK erfasst automatisch einige Daten und sendet sie als XDM-Felder an Platform Edge Network. Beispielsweise liest das Web SDK die aktuelle Seiten-URL und sendet sie als XDM-Feld web.webPageDetails.URL
. Dieses Feld wird an Adobe Analytics weitergeleitet und füllt automatisch die Seiten-URL-Berichte in Adobe Analytics.
Wenn Sie das Web SDK für Adobe Analytics mit einem XDM-Schema implementieren, wie in diesem Tutorial beschrieben, weisen einige der XDM-Felder, die Sie benutzerdefiniert implementiert haben, automatisch Analytics-Variablen zu, 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 der productListItems
-Objekt.
productListItems[].SKU
hat Priorität für die Zuordnung zum Produktnamen in der Variablen s.products .Der auf
productListItems[].name
nur dann dem Produktnamen zugeordnet wird, wenn productListItems[].SKU
existiert nicht. Andernfalls ist sie nicht zugeordnet und in Kontextdaten verfügbar.Setzen Sie keine leere Zeichenfolge oder null auf
productListItems[].SKU
. Dies hat den unerwünschten Effekt, dass die Zuordnung zum Produktnamen in der Variablen s.products vorgenommen wird.Festlegen von Variablen im Datenobjekt
Aber was ist mit eVars, Props und Ereignissen? Festlegen von Variablen in data
-Objekt ist die empfohlene Methode zum Festlegen dieser Analytics-Variablen mit dem Web SDK. Durch das Festlegen von Variablen im Datenobjekt können auch alle automatisch zugeordneten Variablen überschrieben werden.
Zunächst einmal, was ist das data
Objekt? In jedem Web SDK-Ereignis können Sie zwei Objekte mit benutzerdefinierten Daten senden, die xdm
und dem data
-Objekt. Beide werden an Platform Edge Network gesendet, jedoch nur die xdm
-Objekt an den Experience Platform-Datensatz gesendet. Eigenschaften in data
-Objekt kann auf der Edge-Seite xdm
-Felder, die die Funktion "Datenvorbereitung für Datenerfassung"verwenden, andernfalls jedoch nicht an Experience Platform gesendet werden. Dadurch ist es ideal, Daten an Anwendungen wie Analytics zu senden, die nativ nicht auf Experience Platform basieren.
Im Folgenden finden Sie die beiden Objekte in einem allgemeinen Web SDK-Aufruf:
Adobe Analytics ist so konfiguriert, dass es nach Eigenschaften im data.__adobe.analytics
-Objekt und verwenden Sie sie für Analytics-Variablen.
Nun sehen wir, wie das funktioniert. Setzen wir uns eVar1
und prop1
mit unserem Seitennamen und sehen Sie, wie XDM-mapped-Wert überschrieben werden kann.
- Tag-Regel öffnen
all pages - library loaded - set global variables - 1
- Hinzufügen neuer Aktion
- Auswählen Adobe Experience Platform Web SDK Erweiterung
- Auswählen Aktionstyp as Variable aktualisieren
- Auswählen
data.variable
als Datenelement - Wählen Sie die analytics Objekt
- Satz
eVar1
alspage.pageInfo.pageName
Datenelement - Satz
prop1
zum Kopieren des Werts voneVar1
- So testen Sie das Überschreiben von XDM-zugeordneten Werten in der Zusätzliche Eigenschaft -Abschnitt Seitennamen als statischen Wert festlegen
test
- Regel speichern
Jetzt müssen wir das Datenobjekt in unsere Versandereignisregel einbeziehen.
- Tag-Regel öffnen
all pages - library loaded - send event - 50
- Öffnen Sie die Ereignis senden action
- Auswählen
data.variable
als Daten - Auswählen Änderungen beibehalten
- Auswählen Speichern
Daten an eine andere Report Suite senden
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 Datastream als auch in einer Regel.
Konfigurieren des Datenspeichers für eine Report Suite-Überschreibung
So konfigurieren Sie die Einstellung zum Überschreiben der Adobe Analytics Report Suite im Datastream:
-
Datenspeicher öffnen
-
Bearbeiten Sie die Adobe Analytics Konfiguration durch Öffnen der Menü und anschließend Bearbeiten
-
Auswählen Erweiterte Optionen zum Öffnen 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
-
Auswählen 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 Funktion zur Außerkraftsetzung des Datenspeichers, um die Report Suite für eine Seite mithilfe der Variablen Ereignis senden Aktion.
-
Neue Regel erstellen, sie benennen
homepage - library loaded - AA report suite override - 51
-
Wählen Sie das Pluszeichen unter Ereignis , um einen neuen Trigger hinzuzufügen
-
under Erweiterung auswählen Core
-
under Ereignistyp auswählen Bibliothek geladen (Seitenanfang)
-
Zum Öffnen auswählen Erweiterte Optionen, Typ in
51
. Dadurch wird sichergestellt, dass die Regel nach demall pages - library loaded - send event - 50
, das das Grundlinien-XDM mit der Variable aktualisieren Aktionstyp. -
Auswählen Änderungen beibehalten
-
under Bedingungen, wählen Sie Hinzufügen
-
Urlaub Logiktyp as Normal
-
Urlaub Erweiterungen as Core
-
Auswählen Bedingungstyp as Pfad ohne Abfragezeichenfolge
-
Lassen Sie rechts die Regex Umschalten deaktiviert
-
under path equals set
/content/luma/us/en.html
. Auf der Demosite "Luma"wird sichergestellt, dass die Regel nur Trigger auf der Startseite enthält. -
Auswählen Änderungen beibehalten
-
under Aktionen select Hinzufügen
-
Als Erweiterung auswählen Adobe Experience Platform Web SDK
-
Als Aktionstyp auswählen Ereignis senden
-
Als XDM-Daten, wählen Sie die
xdm.variable.content
Datenelement, das Sie im Erstellen von Datenelementen Lektion -
Als Daten, wählen Sie die
data.variable
Datenelement, das Sie im Erstellen von Datenelementen Lektion -
Scrollen Sie nach unten zum Überschreibungen von Datenspeicherkonfigurationen Abschnitt
-
Lassen Sie die Entwicklung ausgewählt ist.
note tip TIP Diese Registerkarte bestimmt, in welcher Tagumgebung das Außerkraftsetzen erfolgt. Für diese Übung geben Sie nur die Entwicklungsumgebung an. Denken Sie jedoch daran, dies auch in der Produktion Umgebung. -
Wählen Sie die Sandbox Sie für das Tutorial verwenden
-
Wählen Sie die Datastream in diesem Fall
Luma Web SDK: Development Environment
-
under Report Suites wählen Sie die Report Suite aus, für die Sie die Site überschreiben möchten. In diesem Fall
tmd-websdk-course-stg
. -
Auswählen Änderungen beibehalten
-
und Speichern Ihre Regel
Erstellen der Entwicklungsumgebung
Fügen Sie Ihre aktualisierten Regeln zu Ihren Luma Web SDK Tutorial
-Tag-Bibliothek und erstellen Sie Ihre Entwicklungsumgebung neu.
Herzlichen Glückwunsch! Der nächste Schritt besteht darin, Ihre Adobe Analytics-Implementierung über das Experience Platform Web SDK zu validieren.
Adobe Analytics mit Debugger überprüfen
Erfahren Sie, wie Sie mit der Funktion "Edge Trace"des Experience Platform Debuggers überprüfen, ob Adobe Analytics die ECID, Seitenansichten, die Produktzeichenfolge und E-Commerce-Ereignisse erfasst.
Im Debugger In der Lektion haben Sie erfahren, wie Sie die clientseitige XDM-Anforderung mit dem Platform Debugger und der Browser-Entwicklerkonsole überprüfen, die dem Debugging einer AppMeasurement.js
Analytics-Implementierung. Sie haben auch erfahren, wie Sie serverseitige Anfragen für Platform Edge Network, die an Adobe-Anwendungen gesendet werden, validieren und wie Sie eine vollständig verarbeitete Payload mithilfe von Assurance anzeigen.
Um zu überprüfen, ob Analytics Daten ordnungsgemäß über das Experience Platform Web SDK erfasst, müssen Sie zwei Schritte weiter gehen:
- Validieren Sie mithilfe der Edge Trace-Funktion des Experience Platform-Debuggers, wie Daten vom XDM-Objekt im Platform-Edge Network verarbeitet werden.
- Überprüfen der vollständigen Verarbeitung von Daten durch Analytics mithilfe von Adobe Experience Platform Assurance
Experience Cloud ID-Überprüfung
-
Navigieren Sie zu Demosite "Luma"
-
Wählen Sie die Anmelde-Schaltfläche oben rechts aus und verwenden Sie die Anmeldeinformationen u: test@adobe.com p: test to authentication
-
Öffnen Sie den Experience Platform Debugger und Ändern Sie die Tag-Eigenschaft auf der Site in Ihre eigene Entwicklungseigenschaft.
-
Um den Edge Trace zu aktivieren, gehen Sie zum Experience Platform Debugger und wählen Sie im linken Navigationsmenü die Option Protokolle und wählen Sie dann die Edge und wählen Sie Verbinden
-
Es ist vorerst leer
-
Aktualisieren Sie die Seite "Luma"und aktivieren Sie Experience Platform Debugger erneut. Sie sollten sehen, dass Daten vorliegen. Die Zeile beginnt mit Automatische Zuordnung von Analytics ist das Adobe Analytics-Beacon
-
Wählen Sie aus, um beide
mappedQueryParams
Dropdown und das zweite Dropdown-Menü zur Ansicht von Analytics-Variablennote tip TIP Das zweite Dropdown-Menü 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
. Es handelt sich dabei um eine Kontextdatenvariable, die ECID erfasst -
Scrollen Sie nach unten, bis Analytics angezeigt wird.
mid
-Variable. Beide IDs stimmen mit der Experience Cloud-ID Ihres Geräts überein. -
Auf der Site "Luma":
note note NOTE Da Sie angemeldet sind, nehmen Sie sich einen Moment Zeit, um die authentifizierte ID zu validieren 112ca06ed53d3db37e4cea49cc45b71e
für den Benutzertest@adobe.com
wird auch imc.a.x.identitymap.lumacrmid.[0].id
Überprüfung der Report Suite-Überschreibung
Oben haben Sie eine Datastream-Überschreibung für die Startseite von Luma. Überprüfen dieser Konfiguration
-
Suchen nach einer Zeile mit Datastream-Konfiguration nach Anwendung der Außerkraftsetzung. Hier finden Sie die primäre Report Suite und die zusätzlichen Report Suites, die für die Report Suite-Überschreibung konfiguriert wurden.
-
Scrollen Sie nach unten zu der Zeile, beginnend mit Automatische Zuordnung von Analytics und überprüfen Sie, dass
reportSuiteIds
zeigt die Report Suite an, die Sie in Ihren Überschreibungskonfigurationen angegeben haben
Überprüfung der Inhaltsseitenansichten
Rufen Sie eine Produktseite auf, z. B. Didi Sport Watch-Produktseite. Überprüfen Sie, ob die Seitenansichten des Inhalts von Analytics erfasst werden.
-
Suchen nach
c.a.x.web.webpagedetails.pageviews.value=1
. -
Scrollen Sie nach unten, um die
gn
-Variable. Dies ist die dynamische Analytics-Syntax für dies.pageName
-Variable. Sie 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 denselben Edge Trace, um Produktdaten zu überprüfen, die von Analytics erfasst werden. Sowohl die Produktzeichenfolge als auch die E-Commerce-Ereignisse werden Analytics automatisch XDM-Variablen zugeordnet. Solange Sie dem entsprechenden productListItem
XDM-Variable während Konfigurieren eines XDM-Schemas für Adobe Analytics, übernimmt das Platform-Edge Network die Zuordnung der Daten zu den entsprechenden Analysevariablen.
Überprüfen Sie zunächst, ob die Product String
festgelegt ist
-
Suchen nach
c.a.x.productlistitems.[0].sku
. Die Variable erfasst den Datenelementwert, den Sie der VariablenproductListItems.item1.sku
früher in dieser Lektion -
Suchen Sie auch nach
c.a.x.productlistitems.[0]._experience.analytics.customdimensions.evars.evar1
. Die Variable erfasst den Datenelementwert, dem Sie zugeordnet sindproductListItems.item1._experience.analytics.customdimensions.evars.evar1
-
Scrollen Sie nach unten, um die
pl
-Variable. Dies ist die dynamische Syntax der Analytics-Variablen mit der Produktzeichenfolge . -
Beachten Sie, dass der Produktname aus der Datenschicht dem
c.a.x.productlistitems.[0].sku
undproduct
-Parameter der Produktzeichenfolge. Darüber hinaus wird der Produktname aus der Datenschicht der Merchandising-evar1 in der Produktzeichenfolge zugeordnet.Die Edge Trace-Behandlung
commerce
Ereignisse geringfügig anders alsproductList
Dimensionen. Es wird keine Kontextdatenvariable angezeigt, die auf die gleiche Weise zugeordnet ist wie der Produktname, derc.a.x.productlistitem.[0].name
höher. Stattdessen zeigt Edge Trace die endgültige automatische Ereigniszuordnung in Analytics anevent
-Variable. Das Platform-Edge Network ordnet es entsprechend zu, solange Sie dem entsprechenden XDM-Element zuordnencommerce
Variable während Konfiguration des Schemas für Adobe Analytics; in diesem Fall diecommerce.productViews.value=1
. -
Scrollen Sie im Experience Platform Debugger-Fenster nach unten zum
events
festgelegt ist, wirdprodView
-
Hinweis
c.a.x.eventType
aufcommerce.productViews
da Sie sich auf einer Produktseite befinden.note tip TIP Die ecommerce - pdp library loaded - AA (order 20)
-Regel überschreibt den Wert voneventType
festgelegt durchall pages global content variables - library loaded - AA (order 1)
-Regel, da sie später in der Sequenz auf "Trigger"festgelegt ist.
Überprüfen, ob die restlichen E-Commerce-Ereignisse und Produktzeichenfolgen für Analytics festgelegt sind
-
Hinzufügen Didi Sport Watch in den Warenkorb
-
Navigieren Sie zu Einkaufswagenseite, aktivieren Sie Edge Trace für
eventType
aufcommerce.productListViews
events: "scView"
, und- die Produktzeichenfolge festgelegt ist
-
Fahren Sie mit dem Checkout fort und suchen Sie nach Edge Trace für
eventType
aufcommerce.checkouts
events: "scCheckout"
, und- die Produktzeichenfolge festgelegt ist
-
Füllen Sie nur die Vorname und Nachname Felder im Versandformular und wählen Sie Weiter. Wählen Sie auf der nächsten Seite Bestellung platzieren
-
Überprüfen Sie auf der Bestätigungsseite Edge Trace auf
eventType
aufcommerce.purchases
- Kaufereignis festgelegt
events: "purchase"
- Währungscode-Variable festgelegt
cc: "USD"
- Kauf-ID festgelegt in
pi
- Produktzeichenfolge
pl
Festlegen von Produktname, Menge und Preis
Validieren von Adobe Analytics mithilfe von Assurance
Mit Adobe Experience Platform Assurance können Sie die Datenerfassung und die Bereitstellung von Erlebnissen auf Ihrer Website und in Ihrer mobilen Anwendung überprüfen, testen, simulieren und validieren.
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 des Experience Platform Debuggers 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 Assurance Lektion, es gibt mehrere Möglichkeiten, eine Zuverlässigkeitssitzung zu initiieren. Da Sie bereits einen Adobe Experience Platform Debugger geöffnet haben, bei dem eine Edge Trace-Sitzung von der letzten Übung aus initiiert wurde, empfehlen wir, über den Debugger auf "Assurance"zuzugreifen:
Innerhalb der "Web SDK-Tutorial 3" Sitzungseintrag "hitdebugger" in die Ereignissuchleiste, um die Ergebnisse nach den nach der Verarbeitung in Adobe Analytics verarbeiteten Daten zu filtern.
Experience Cloud ID-Überprüfung
Um zu überprüfen, ob Adobe Analytics die ECID erfasst, wählen Sie ein Beacon aus und öffnen Sie die Payload. Der Anbieter für dieses Beacon sollte com.adobe.analytics.hitdebugger
Scrollen Sie dann nach unten zu mcvisId , um zu überprüfen, ob die ECID korrekt erfasst wurde
Überprüfung der Inhaltsseitenansichten
Überprüfen Sie mit demselben Beacon, ob die Seitenansichten des Inhalts der richtigen Adobe Analytics-Variablen zugeordnet sind.
Nach unten scrollen zu pageName , um zu überprüfen, dass die Page Name
korrekt erfasst wurde
Validierung von Produktzeichenfolgen und E-Commerce-Ereignissen
Nach denselben Validierungsanwendungsfällen, die bei der obigen Validierung mit dem Experience Platform Debugger verwendet werden, verwenden Sie dasselbe Beacon zur Validierung der Ecommerce Events
und Product String
.
- Suchen Sie nach Payload , wobei die events contain
prodView
- Nach unten scrollen zu product-string validieren Sie die
Product String
.- Beachten Sie die
Product SKU
undMerchandizing eVar1
.
- Beachten Sie die
- Scrollen Sie weiter nach unten und überprüfen Sie, ob
prop1
, die Sie mithilfe der Verarbeitungsregeln im vorherigen Abschnitt konfiguriert haben, enthält dieProduct SKU
Überprüfen Sie weiterhin Ihre Implementierung, indem Sie sich die Warenkorb-, Checkout- und Kaufereignisse ansehen.
- Suchen Sie nach Payload , wobei die events contain
scView
und validieren Sie die Produktzeichenfolge.
- Suchen Sie nach Payload , wobei die events contain
scCheckout
und validieren Sie die Produktzeichenfolge.
- Suchen Sie nach Payload , wobei die events contain
purchase
- Bei der Validierung der
purchase
-Ereignis, beachten Sie, dass dieProduct String
sollte enthaltenProduct SKU
,Product Quantity
, undProduct Total Price
. - Darüber hinaus gilt für die
purchase
überprüfen, ob diepurchase-id
und/oderpurchaseId
festgelegt sind
Herzlichen Glückwunsch! Du hast es getan! Dies ist das Ende der Lektion und jetzt können Sie Adobe Analytics mit dem Platform Web SDK für Ihre eigene Website implementieren.