DokumentationAnalyticsImplementierungshandbuch

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

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Benutzende
  • Admin

Dieser Implementierungspfad umfasst eine neue Web SDK-Installation unter Verwendung der Web SDK JavaScript-Bibliothek. Andere Implementierungspfade werden auf separaten Seiten behandelt:

  • Web SDK tag extension: Eine neue Web SDK-Installation mit der Web SDK-Tag-Erweiterung. Ähnlich wie beim Web SDK JavaScript Library-Ansatz (diese Seite), mit dem Unterschied, dass Sie die Implementierung mithilfe von Tags in der Adobe Experience Platform-Datenerfassung verwalten. Dazu ist die Adobe Analytics ExperienceEvent-Feldergruppe erforderlich, die typische Analytics-Variablen enthält, die in Ihr XDM-Schema aufgenommen werden sollen.
  • Analytics-Erweiterung auf Web SDK-Erweiterung: Verwenden Sie einen reibungslosen und methodischen Ansatz, um von der Adobe Analytics-Tag-Erweiterung zur Web SDK-Tag-Erweiterung zu wechseln. Dieser Ansatz unterdrückt die Notwendigkeit, XDM zu verwenden, bis Ihr Unternehmen für die Verwendung von Adobe Experience Platform-Diensten wie Customer Journey Analytics bereit ist. Verwenden Sie das Objekt data anstelle des Objekts xdm , um Daten an Adobe zu senden.
  • AppMeasurement in die JavaScript-Bibliothek des Web SDK: Ein reibungsloser und methodischer Ansatz für die Migration zum Web SDK, allerdings werden keine Tags verwendet. Stattdessen können Sie die Adobe Analytics-Datenerfassungsbibliothek (AppMeasurement.js) manuell entfernen und sie durch die Web SDK JavaScript-Bibliothek (alloy.js) ersetzen.

Vorteile und Nachteile dieses Implementierungspfads

Die Verwendung der Web SDK JavaScript-Bibliothek zum Senden von Daten an Adobe Analytics hat sowohl Vor- als auch Nachteile. Legen Sie bei jeder Option sorgfältig ab, welcher Ansatz für Ihr Unternehmen am besten geeignet ist.

Vorteile
Nachteile
  • Direkter Ansatz: Dieser Implementierungspfad ist einfacher als Ansätze, die vorhandene Adobe Analytics-Implementierungen verschieben. Wenn Sie keine aktuelle Adobe Analytics-Implementierung haben, um die Sie sich Sorgen machen müssen, füllen Sie die entsprechenden Web SDK-XDM-Felder aus.
  • Vordefiniertes Schema: Wenn Ihr Unternehmen kein eigenes Schema benötigt, können Sie einfach das für Adobe Analytics bestimmte Schema verwenden. Dieses Konzept gilt auch bei der Umstellung auf Customer Journey Analytics. Das Konzept der Props und eVars gilt nicht für Customer Journey Analytics, Sie können aber Props und eVars weiterhin als einfache benutzerdefinierte Dimensionen verwenden.
  • Implementierungsänderungen erfordern die Intervention des Entwicklers: Wenn Sie Änderungen an Ihrer Web SDK-Implementierung vornehmen möchten, müssen Sie sich an Ihr Entwicklungsteam wenden, um den Code auf Ihrer Site zu bearbeiten. Der Ansatz, der die Web SDK Tag-Erweiterung verwendet, vermeidet diesen Nachteil.
  • Wird mit einem bestimmten Schema blockiert: Wenn Ihr Unternehmen zu Customer Journey Analytics wechselt, müssen Sie entscheiden, das Adobe Analytics-Schema weiterhin zu verwenden oder zum eigenen Schema zu migrieren (was ein separater Datensatz wäre). Wenn Ihr Unternehmen beim Wechsel zu 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 Sie das Objekt data : Mit dem Objekt data können Sie Daten an Adobe Analytics senden, ohne ein XDM-Schema zu erfüllen. Nachdem das Schema Ihres Unternehmens erstellt wurde, können Sie die Datastream-Zuordnung verwenden, um data -Objektfelder XDM zuzuordnen. Sowohl die Analytics-Erweiterung für Web SDK-Erweiterung als auch die AppMeasurement für Web SDK JavaScript-Bibliothek verwenden dieses data -Objekt.
    • Adobe Analytics vollständig überspringen: Wenn Sie das Web SDK implementieren, können Sie diese Daten zur Verwendung in Customer Journey Analytics an einen Datensatz in Adobe Experience Platform senden. Sie können ein beliebiges Schema verwenden. Adobe Analytics ist an diesem Workflow überhaupt nicht beteiligt und benötigt daher keine Adobe Analytics ExperienceEvent-Feldergruppe. Bei dieser Methode entsteht der geringste technische Schuldenstand, aber auch Adobe Analytics wird vollständig ausgeschlossen.
IMPORTANT
Für diese Implementierungsmethode müssen Sie ein für Adobe Analytics konfiguriertes Schema verwenden. Wenn Ihr Unternehmen in Zukunft Ihr eigenes Schema mit Customer Journey Analytics verwenden möchte, kann die Verwendung des Adobe Analytics-Schemas für Datenadministratoren oder Architekten Verwirrung stiften. Es gibt mehrere Möglichkeiten, dieses Hindernis zu beheben:
  • Sie können das Adobe Analytics-Schema in CJA verwenden. Beachten Sie, dass CJA kein Konzept von Props oder eVars hat. Sie werden wie jedes andere Schemafeld behandelt. Beachten Sie außerdem, dass die Verwendung des Adobe Analytics-Schemas in CJA die Verwendung anderer Plattformdienste wie Adobe Journey Optimizer oder Real-time Customer Data Platform erschweren kann.
  • Sie können das Datenobjekt ähnlich einem Migrations-Workflow verwenden. Beachten Sie, dass die Verwendung des Datenobjekts erfordert, dass Sie jedes Datenobjektfeld einem XDM-Schemafeld zuordnen.
  • 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 ideal und ermöglicht es Ihrem Unternehmen, mit der Verwendung von Customer Journey Analytics zu beginnen.

Schritte, die zur Implementierung der Web SDK JavaScript-Bibliothek erforderlich sind

Ein allgemeiner Überblick über die Implementierungsaufgaben:

Implementieren von Adobe Analytics mit dem Web SDK-Workflow, wie in diesem Abschnitt beschrieben.

Aufgabe
Weitere Informationen
1
Stellen Sie sicher, dass Sie eine Report Suite definiert haben.
Report Suite Manager
2
Schemas 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 Schemas
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 Dienst steuert, ob und wie Daten an Adobe Analytics gesendet werden und an welche Report Suite(s) speziell.
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 Datastraam-ID (ehemals "Edge Configuration ID (datastreamId)"), der Organisations-ID (orgId) und anderen verfügbaren Optionen konfiguriert ist. Stellen Sie sicher, dass Variablen ordnungsgemäß zugeordnet werden.
Web SDK konfigurieren
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