DokumentationAnalyticsImplementierungshandbuch

Senden von Daten an Adobe Analytics mithilfe der Web SDK JavaScript-Bibliothek

Last update: Tue Dec 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Benutzende
  • Admin

Dieser Implementierungspfad umfasst eine Neuinstallation von Web SDK mithilfe der Web SDK JavaScript-Bibliothek. Andere Implementierungspfade werden auf separaten Seiten behandelt:

  • Web SDK-Tag-Erweiterung: Eine neue Web SDK-Installation unter Verwendung der Web SDK-Tag-Erweiterung. Ähnelt dem Ansatz mit der Web SDK JavaScript-Bibliothek (diese Seite), mit der Ausnahme, dass Sie die Implementierung mithilfe von Tags in der Adobe Experience Platform-Datenerfassung verwalten. Dazu muss die Adobe Analytics ExperienceEvent-Feldergruppe, die typische Analytics-Variablen enthält, in Ihr XDM-Schema aufgenommen werden.
  • Analytics-Erweiterung zur Web SDK-Erweiterung: Verwenden Sie einen reibungslosen und methodischen Ansatz, um von der Adobe Analytics-Tag-Erweiterung zur Web SDK-Tag-Erweiterung zu wechseln. Durch diesen Ansatz entfällt die Notwendigkeit, XDM zu verwenden, bis Ihr Unternehmen bereit ist, Adobe Experience Platform-Services wie Customer Journey Analytics zu verwenden. Verwenden Sie das data-Objekt anstelle des xdm-Objekts, um Daten an Adobe zu senden.
  • AppMeasurement zur Web SDK JavaScript Library: Ein reibungsloser und methodischer Ansatz für die Migration zur Web SDK, außer es werden keine Tags verwendet. Stattdessen können Sie die Adobe Analytics-Datenerfassungsbibliothek (AppMeasurement.js) manuell entfernen und durch die Web-SDK-JavaScript-Bibliothek (alloy.js) ersetzen.

Vor- und Nachteile dieses Implementierungspfads

Die Verwendung der Web SDK JavaScript-Bibliothek zum Senden von Daten an Adobe Analytics hat Vor- und Nachteile. Wägen Sie jede Option sorgfältig ab, um zu entscheiden, welcher Ansatz für Ihr Unternehmen am besten geeignet ist.

Vorteile
Nachteile
  • Direkter Ansatz: Dieser Implementierungspfad ist einfacher als Ansätze, die bestehende Adobe Analytics-Implementierungen verschieben. Wenn Sie derzeit keine Adobe Analytics-Implementierung haben, um die Sie sich Sorgen machen müssen, füllen Sie die entsprechenden XDM-Felder für Web SDK aus.
  • Vordefiniertes Schema: Wenn Ihr Unternehmen kein eigenes Schema benötigt, können Sie einfach das Schema verwenden, das auf Adobe Analytics ausgerichtet ist. Dieses Konzept gilt auch dann, wenn Sie zum Customer Journey Analytics übergehen. Das Konzept der Props und eVars gilt nicht für das Customer Journey Analytics, aber Sie können weiterhin Props und eVars als einfache benutzerdefinierte Dimensionen verwenden.
  • Implementierungsänderungen erfordern: Wenn Sie Änderungen an Ihrer Web SDK-Implementierung vornehmen möchten, müssen Sie mit Ihrem Entwicklungs-Team zusammenarbeiten, um den Code auf Ihrer Site zu bearbeiten. Der Ansatz, bei dem die TagErweiterung „Web SDK" verwendet wird vermeidet diesen Nachteil.
  • Mit einem bestimmten Schema verknüpft: Wenn Ihr Unternehmen auf Customer Journey Analytics umstellt, müssen Sie entweder mit der Verwendung des Adobe Analytics-Schemas fortfahren oder zum Schema Ihres eigenen Unternehmens migrieren (das ein separater Datensatz wäre). Wenn Ihr Unternehmen beim Wechsel zur Customer Journey Analytics sowohl das Adobe Analytics-Schema als auch die Migration zu einem separaten Datensatz vermeiden möchte, empfiehlt Adobe eine der beiden folgenden Methoden:
    • Verwenden des data: Mit dem data können Sie Daten an Adobe Analytics senden, ohne einem XDM-Schema zu entsprechen. Nachdem das Schema Ihres Unternehmens erstellt wurde, können Sie die Datenstromzuordnung verwenden, um data Objektfelder XDM zuzuordnen. Sowohl die Analytics-Erweiterung zur Web SDK-Erweiterung als auch das AppMeasurement zur Web SDK JavaScriptBibliothek verwenden dieses data.
    • Adobe Analytics ganz überspringen: Wenn Sie die Web-SDK implementieren, können Sie diese Daten an einen Datensatz in Adobe Experience Platform senden, um sie im Customer Journey Analytics zu verwenden. Sie können ein beliebiges Schema verwenden. Adobe Analytics ist an diesem Workflow überhaupt nicht beteiligt und erfordert daher keine Adobe Analytics ExperienceEvent-Feldergruppe. Diese Methode ist technisch am wenigsten verschuldet, lässt Adobe Analytics aber völlig außen vor.
IMPORTANT
Diese Implementierungsmethode erfordert die Verwendung eines für Adobe Analytics konfigurierten Schemas. Wenn Ihr Unternehmen beabsichtigt, in Zukunft Ihr eigenes Schema mit Customer Journey Analytics zu verwenden, kann die Verwendung des Adobe Analytics-Schemas für Datenadministratoren oder -architekten zu Verwirrung führen. Es gibt mehrere Optionen, um dieses Hindernis zu beheben:
  • Sie können das Adobe Analytics-Schema in CJA verwenden. Beachten Sie, dass CJA über kein Konzept von Props oder eVars verfügt. Sie werden wie jedes andere Schemafeld behandelt. Beachten Sie außerdem, dass die Verwendung des Adobe Analytics-Schemas in CJA die Verwendung anderer Platform-Services wie Adobe Journey Optimizer oder Real-time Customer Data Platform erschweren kann.
  • Sie können das Datenobjekt verwenden, ähnlich wie bei einem Migrations-Workflow. Beachten Sie, dass Sie zur Verwendung des Datenobjekts jedes Datenobjektfeld einem XDM-Schemafeld zuordnen müssen.
  • Sie können die Adobe Analytics-Implementierung vollständig überspringen und Daten mithilfe Ihres eigenen Schemas an Adobe Experience Platform senden. Dieser Ansatz ist langfristig optimal und ermöglicht Ihrem Unternehmen, mit der Verwendung von Customer Journey Analytics zu beginnen.

Zur Implementierung der Web SDK JavaScript-Bibliothek erforderliche Schritte

Ein allgemeiner Überblick über die Implementierungsaufgaben:

Implementieren von Adobe Analytics mithilfe des Web-SDK-Workflows, wie in diesem Abschnitt beschrieben.

Aufgabe
Weitere Informationen
1
Stellen Sie sicher, dass Sie eine Report Suite definiert haben.
Report Suite Manager
2
Schemata einrichten. Um die Datenerfassung für die Verwendung in allen Anwendungen zu standardisieren, die Adobe Experience Platform nutzen, hat Adobe das offene und öffentlich dokumentierte Standard Experience-Datenmodell (XDM) erstellt.
Übersicht über die Benutzeroberfläche von Schemata
3
Erstellen Sie eine Datenschicht, um das Tracking der Daten auf Ihrer Website zu verwalten.
Datenschicht erstellen
4
Installieren Sie die vordefinierte eigenständige Version. Sie können direkt auf Ihrer Seite auf die Bibliothek (alloy.js) im CDN verweisen oder sie herunterladen und in Ihrer eigenen Infrastruktur hosten. Alternativ können Sie das NPM-Paket verwenden.
Installieren der vordefinierten eigenständigen Version und Verwenden des NPM-Pakets
5
Konfigurieren eines Datenstroms. Ein Datenstrom stellt die Server-seitige Konfiguration bei der Implementierung des Adobe Experience Platform Web SDK dar.
Konfigurieren eines Datenstroms
6
Fügen Sie einen Adobe Analytics-Service in Ihrem Datenstrom hinzu. Dieser Service steuert, ob und wie Daten an Adobe Analytics gesendet werden und an welche Report Suite(s).
Hinzufügen des Adobe Analytics-Service zu einem Datenstrom
7
Konfigurieren des Web SDKs. Stellen Sie sicher, dass die Bibliothek, die Sie in Schritt 4 installiert haben, ordnungsgemäß mit der Datenstrom-ID (ehemals Edge-Konfigurations-ID (datastreamId)), der Organisations-ID (orgId) und anderen verfügbaren Optionen konfiguriert ist. Sicherstellen einer ordnungsgemäßen Zuordnung von Variablen.
Konfigurieren der Web SDK
XDM-Objektvariablenzuordnung
8
Führen Sie Befehle aus und/oder verfolgen Sie Ereignisse. Nachdem der Basis-Code auf Ihrer Web-Seite implementiert wurde, können Sie mit der Ausführung von Befehlen und dem Nachverfolgen von Ereignissen mit dem SDK beginnen.
Ereignisse senden
9
Erweitern und validieren Sie die Implementierung, bevor Sie sie in die Produktion verschieben.
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690