In dieser Lektion streamen Sie Daten mit dem Adobe Experience Platform Web SDK.
In der Datenerfassungsoberfläche müssen wir zwei Hauptaufgaben erledigen:
Wir müssen das Web SDK auf der Luma-Website implementieren, um Daten über Besucheraktivitäten von der Website an das Adobe Edge-Netzwerk zu senden. Wir führen eine einfache Implementierung mithilfe von Tags (früher Launch) durch.
Wir müssen einen Datastream konfigurieren, der dem Edge-Netzwerk mitteilt, wohin die Daten weitergeleitet werden sollen. Wir werden es so konfigurieren, dass Daten an unsere Luma Web Events
-Datensatz in unserer Platform-Sandbox.
Dateningenieure müssen Streaming-Daten außerhalb dieses Tutorials erfassen. Bei der Implementierung von Web- oder Mobile-SDKs von Adobe Experience Platform ist normalerweise ein Web- oder Mobilentwickler an der Erstellung von Datenschichten und der Konfiguration von Tag-Eigenschaften beteiligt.
Bevor Sie mit den Übungen beginnen, sehen Sie sich diese beiden kurzen Videos an, um mehr über die Erfassung von Streaming-Daten und das Web SDK zu erfahren:
Während dieses Tutorial die Streaming-Erfassung von Websites mit Web SDK zum Schwerpunkt hat, können Sie Daten auch mithilfe der Adobe Mobile SDK, Apache Kafka Connectund anderen Mechanismen.
Im Berechtigungen konfigurieren Lektion erstellen Sie alle Zugriffssteuerungen, die zum Abschluss dieser Lektion erforderlich sind.
Zuerst konfigurieren wir den Datastream. Ein Datastream teilt dem Adobe Edge-Netzwerk mit, wohin die Daten nach dem Erhalt vom Web SDK-Aufruf gesendet werden sollen. Möchten Sie die Daten beispielsweise an Experience Platform, Adobe Analytics oder Adobe Target senden? Datenspeicher werden in der Benutzeroberfläche für die Datenerfassung (früher Launch) verwaltet und sind für die Datenerfassung mit dem Web SDK von entscheidender Bedeutung.
So erstellen Sie Ihre datastream:
Melden Sie sich bei der Benutzeroberfläche der Datenerfassung von Experience Platform
Auswählen Datenspeicher in der linken Navigation
Wählen Sie die Neuer Datenspeicher Schaltfläche in der oberen rechten Ecke
Für Anzeigename, eingeben Luma Platform Tutorial
(Fügen Sie am Ende Ihren Namen hinzu, wenn mehrere Personen aus Ihrem Unternehmen dieses Tutorial absolvieren)
Klicken Sie auf die Schaltfläche Speichern
Geben Sie im nächsten Bildschirm an, wohin Daten gesendet werden sollen. So senden Sie Daten an Experience Platform:
Aktivieren Adobe Experience Platform um zusätzliche Felder verfügbar zu machen
Für Sandbox auswählen Luma Tutorial
Für Ereignis-Datensatz auswählen Luma Web Events Dataset
Wenn Sie andere Adobe-Applikationen verwenden, sollten Sie sich die anderen Abschnitte ansehen, um zu sehen, welche Informationen in der Edge-Konfiguration dieser anderen Lösungen erforderlich sind. Beachten Sie, dass das Web SDK nicht nur zum Streamen von Daten in Experience Platform entwickelt wurde, sondern auch zum Ersetzen aller vorherigen JavaScript-Bibliotheken, die von anderen Adobe Apps verwendet wurden. Die Edge-Konfiguration wird verwendet, um die Kontodetails jeder Anwendung anzugeben, an die Sie die Daten senden möchten.
Wählen Sie Speichern aus
Nachdem die Edge-Konfiguration gespeichert wurde, werden im resultierenden Bildschirm drei Umgebungen für Entwicklung, Staging und Produktion erstellt. Zusätzliche Entwicklungsumgebungen können hinzugefügt werden:
Alle drei Umgebungen enthalten die Plattformdetails, die Sie eingegeben haben. Diese Details können jedoch je Umgebung unterschiedlich konfiguriert werden. Sie können beispielsweise festlegen, dass jede Umgebung Daten an eine andere Platform-Sandbox sendet. In diesem Tutorial werden wir keine zusätzlichen Anpassungen an unseren Datastream vornehmen.
Zuerst müssen wir eine Tag-Eigenschaft erstellen (ehemals eine Tag-Eigenschaft). Eine Eigenschaft ist ein Container für alle JavaScript-, Regeln- und anderen Funktionen, die zum Erfassen von Details von einer Webseite und zum Senden an verschiedene Speicherorte erforderlich sind.
So erstellen Sie eine Eigenschaft:
Navigieren Sie zu Eigenschaften in der linken Navigation
Klicken Sie auf die Schaltfläche Neue Eigenschaft
Als Name, eingeben Luma Platform Tutorial
(Fügen Sie am Ende Ihren Namen hinzu, wenn mehrere Personen aus Ihrem Unternehmen dieses Tutorial absolvieren)
Als Domänen, eingeben enablementadobe.com
(später erklärt)
Wählen Sie Speichern aus
Nachdem Sie jetzt über eine Eigenschaft verfügen, können Sie das Web SDK mithilfe einer Erweiterung hinzufügen. Eine Erweiterung ist ein Paket mit Code, das die Datenerfassungsoberfläche und -funktion erweitert. Hinzufügen der Erweiterung:
Web SDK
data.enablementadobe.com
. Mit dieser Einstellung können Sie Erstanbieter-Cookies in Ihrer Web SDK-Implementierung setzen. Dies wird empfohlen. Später in dieser Lektion werden Sie eine Website auf der enablementadobe.com
Domäne zu Ihrer Tag-Eigenschaft hinzufügen. Der CNAME für die enablementadobe.com
-Domäne bereits konfiguriert wurde, sodass data.enablementadobe.com
leitet an Adobe-Server weiter. Wenn Sie das Web SDK auf Ihrer eigenen Website implementieren, müssen Sie einen CNAME für Ihre eigenen Datenerfassungszwecke erstellen, z. B. data.YOUR_DOMAIN.com
Luma Platform Tutorial
datastream.Jetzt erstellen wir eine Regel zum Senden von Daten an Platform. Eine Regel ist eine Kombination aus Ereignissen, Bedingungen und Aktionen, die Tags dazu anweisen, etwas zu tun. Erstellen einer Regel:
All Pages - Library Loaded
.Luma Web Events Schema
Als Nächstes veröffentlichen wir die Regel in unserer Entwicklungsumgebung, damit wir überprüfen können, ob sie funktioniert.
So erstellen Sie eine Bibliothek:
Luma Platform Tutorial
Development
All Pages - Library Loaded
-Regel, sehen Sie auch die Core -Erweiterung hinzugefügt, die das grundlegende JavaScript enthält, das für alle Launch-Webeigenschaften erforderlich ist.)Die Erstellung der Bibliothek kann einige Minuten dauern. Wenn sie abgeschlossen ist, wird links neben dem Bibliotheksnamen ein grüner Punkt angezeigt:
Wie Sie auf der Veröffentlichungsfluss -Bildschirm gibt es viel mehr im Veröffentlichungsprozess, was über den Rahmen dieses Tutorials hinausgeht. Wir werden nur eine einzige Bibliothek in unserer Entwicklungsumgebung verwenden.
Der Experience Platform Debugger ist eine Erweiterung, die für Chrome- und Firefox-Browser verfügbar ist und Ihnen dabei hilft, die auf Ihren Webseiten implementierte Adobe zu sehen. Laden Sie die Version für Ihren bevorzugten Browser herunter:
Wenn Sie den Debugger noch nie verwendet haben - und dieser sich vom älteren Adobe Experience Cloud Debugger unterscheidet -, sollten Sie sich dieses fünfminütige Übersichtsvideo ansehen:
Für dieses Tutorial verwenden wir eine öffentlich gehostete Version der Demowebsite von Luma. Öffnen wir es und markieren Sie es mit einem Lesezeichen:
Diese gehostete Website ist der Grund, warum wir enablementadobe.com
im Domänen Feld unserer ursprünglichen Tag-Eigenschaftenkonfiguration und Grund für die Verwendung von data.enablementadobe.com
als Erstanbieterdomäne im Adobe Experience Platform Web SDK -Erweiterung. Sehen Sie, ich hatte einen Plan!
Der Experience Platform Debugger verfügt über eine coole Funktion, mit der Sie eine vorhandene Tag-Eigenschaft durch eine andere ersetzen können. Dies ist für die Validierung nützlich und ermöglicht es uns, viele Implementierungsschritte in diesem Tutorial zu überspringen.
Stellen Sie sicher, dass die Site "Luma"geöffnet ist, und wählen Sie das Symbol für die Erweiterung "Experience Platform Debugger"
Der Debugger wird geöffnet und zeigt einige Details zur hartcodierten Implementierung an, die nicht mit diesem Tutorial in Zusammenhang steht (Sie müssen die Site "Luma"möglicherweise neu laden, nachdem Sie den Debugger geöffnet haben).
Vergewissern Sie sich, dass der Debugger "Verbunden mit Luma", wie unten dargestellt, und wählen Sie dann "lock", um den Debugger mit der Site "Luma"zu sperren.
Wählen Sie die Anmelden rechts oben zur Authentifizierung.
Gehen Sie jetzt zu Launch in der linken Navigation
Wählen Sie die Registerkarte Konfiguration .
Rechts neben dem Ort, an dem Sie die Seiten-Einbettungscodes, öffnen Sie die Aktionen und wählen Sie Ersetzen
Da Sie authentifiziert sind, ruft der Debugger Ihre verfügbaren Launch-Eigenschaften und -Umgebungen ab. Wählen Sie Ihre Luma Platform Tutorial
property
Wählen Sie Ihre Development
Umgebung
Wählen Sie die Anwenden button
Die Luma-Website wird jetzt neu geladen mit der Tag-Eigenschaft. Hilfe, ich wurde gehackt! Mach nur Spaß.
Navigieren Sie zu Zusammenfassung in der linken Navigation, um die Details Ihrer Launch property
Gehen Sie jetzt zu AEP Web SDK in der linken Navigation, um die Netzwerkanforderungen
Öffnen Sie die events row
Beachten Sie, dass die web.webpagedetails.pageView
Ereignistyp, den wir in unserer Ereignis senden und anderen nativen Variablen, die der AEP Web SDK ExperienceEvent Mixin
format
Diese Arten von Anforderungsdetails sind auch in den Webentwickler-Tools des Browsers sichtbar. Netzwerk Registerkarte. Öffnen Sie es und laden Sie die Seite neu. Filtern von Aufrufen mit interact
Um den Aufruf zu finden, wählen Sie ihn aus und sehen Sie sich dann im Kopfzeilen Registerkarte, Anfrage-Payload Bereich.
Navigieren Sie zu Reaktion und beachten Sie, wie der ECID-Wert in der Antwort enthalten ist. Kopieren Sie diesen Wert, da Sie ihn verwenden werden, um die Profilinformationen in der nächsten Übung zu validieren.
Sie können überprüfen, ob Daten in Platform landen, indem Sie sich die Batches der Daten ansehen, die in der Datei Luma Web Events Dataset
. (Ich weiß, es wird Streaming-Datenerfassung genannt, aber jetzt sage ich, dass es in Batches ankommt! Es streamt in Echtzeit an das Profil, sodass es für die Echtzeit-Segmentierung und Aktivierung verwendet werden kann, aber alle 15 Minuten in Batches an den Data Lake gesendet wird.)
Überprüfen der Daten:
Luma Web Events Dataset
und bestätigen, dass ein Batch angekommen ist. Denken Sie daran, dass sie alle 15 Minuten gesendet werden. Daher müssen Sie möglicherweise warten, bis der Batch angezeigt wird.Sie können auch bestätigen, dass das neue Profil angezeigt wird:
In der Datenerfassungs-Tags-Benutzeroberfläche oben rechts in der Luma Platform Tutorial
-Eigenschaft, öffnen Sie die Arbeitsbibliothek auswählen und wählen Sie Ihre Luma Platform Tutorial
-Bibliothek. Diese Einstellung erleichtert die Veröffentlichung zusätzlicher Aktualisierungen in unserer Bibliothek.
Gehen Sie jetzt zu Datenelemente in der linken Navigation
Wählen Sie die Neues Datenelement erstellen button
Als Name, eingeben Page Name
Als Datenelementtyp auswählen JavaScript Variable
Als JavaScript-Variablenname, eingeben digitalData.page.pageInfo.pageName
Um das Format der Werte zu standardisieren, aktivieren Sie die Kontrollkästchen für Kleinbuchstaben erzwingen Wert und Text bereinigen
Stellen Sie sicher, dass Luma Platform Tutorial
als Arbeitsbibliothek ausgewählt ist
Auswählen In Bibliothek speichern
Nun ordnen wir unseren Seitennamen dem Web SDK zu.
Um diese Aufgabe abzuschließen, müssen wir sicherstellen, dass Ihr Benutzer zunächst Zugriff auf die Prod-Sandbox hat. Wenn Sie nicht bereits über ein anderes Produktprofil auf die Sandbox "Produktion"zugreifen können, öffnen Sie Ihre Luma Tutorial Platform
Profil erstellen und das Berechtigungselement hinzufügen Sandboxes > Prod. Führen Sie anschließend auf der Seite "Datenelemente"eine Umschalt- und eine Umschalt- Taste aus, um den Cache zu leeren.
Im Datenelemente Seite:
Neues Datenelement erstellen
Als Name, eingeben XDM Object
Als Erweiterung auswählen Adobe Experience Platform Web SDK
Als Datenelementtyp auswählen XDM object
Als Sandbox, wählen Sie Luma Tutorial
Sandbox
Als Schema, wählen Sie Luma Web Events Schema
Wählen Sie die web.webPageDetails.name
field
Als Wert, wählen Sie das Symbol aus, um das Datenelement-Auswahlmodul zu öffnen, und wählen Sie Ihre Page Name
Datenelement
Auswählen In Bibliothek speichern
Dasselbe Verfahren wird verwendet, um zusätzliche benutzerdefinierte Daten auf Ihrer Website XDM-Feldern zuzuordnen.
Nachdem Sie Daten mit XDM-Feldern verknüpft haben, können Sie sie in Ihre Aktion "Ereignis senden"einbeziehen:
All Pages - Library Loaded
RegelAdobe Experience Platform Web SDK - Send Event
actionXDM Object
DatenelementLuma Platform Tutorial
als Arbeitsbibliothek für die letzten Übungen ausgewählt haben, wurden Ihre letzten Änderungen direkt in der Bibliothek gespeichert. Anstatt unsere Änderungen über den Bildschirm "Veröffentlichungsfluss"veröffentlichen zu müssen, können Sie einfach das Dropdown-Menü auf der blauen Schaltfläche öffnen und die Option In Bibliothek speichern und erstellenDadurch wird eine neue Tag-Bibliothek mit den drei soeben vorgenommenen Änderungen erstellt.
Sie sollten jetzt in der Lage sein, die Startseite von Luma neu zu laden, während Sie mit dem Debugger Ihrer Tag-Eigenschaft zugeordnet sind, wie Sie zuvor erfahren haben, und feststellen, dass das Feld für den Seitennamen in der Anfrage ausgefüllt ist!
Sie können auch überprüfen, ob die Seitennamen-Daten in Platform empfangen wurden, indem Sie eine Vorschau des Datensatzes und des Profils anzeigen.
Ihre Web SDK-Implementierung sendet jetzt Ereignisse mit der Experience Cloud-ID (ECID) als primärer Kennung. Die ECID wird automatisch vom Web SDK generiert und ist pro Gerät und Browser eindeutig. Ein einzelner Kunde kann je nach verwendetem Gerät und Browser über mehrere ECIDs verfügen. Wie können wir also eine einheitliche Ansicht dieses Kunden erhalten und seine Online-Aktivität mit unseren CRM-, Treueprogramm- und Offline-Kaufdaten verknüpfen? Dazu erfassen wir zusätzliche Identitäten während ihrer Sitzung und verbinden ihr Profil durch Identitätszusammenfügung deterministisch.
Wenn Sie sich erinnern, erwähnte ich, dass wir die ECID und CRM-ID als Identitäten für unsere Webdaten im Zuordnungsidentitäten Lektion. Erfassen wir also die CRM-ID mit dem Web SDK!
Zunächst wird die CRM-ID in einem Datenelement gespeichert:
CRM Id
digitalData.user.0.profile.0.attributes.username
Luma Platform Tutorial
sollte weiterhin Ihre Arbeitsbibliothek sein)Nachdem wir nun den Wert der CRM-ID erfasst haben, müssen wir ihn mit einem speziellen Datenelementtyp namens Identitätszuordnung Datenelement:
Hinzufügen eines Datenelements mit dem Namen Identities
Als Erweiterung auswählen Adobe Experience Platform Web SDK
Als Datenelementtyp auswählen Identitätszuordnung
Als Namespace, eingeben Luma CRM Id
, wobei namespace haben wir in einer früheren Lektion erstellt
Mit der Adobe Experience Platform Web SDK-Erweiterung Version 2.2 können Sie Namespace aus einer vorausgefüllten Dropdown-Liste auswählen, in der Sie die tatsächlichen Werte in Ihrem Platform-Konto angeben. Leider ist diese Funktion noch nicht "Sandbox-fähig"und daher die Luma CRM Id
-Wert nicht im Dropdown-Menü angezeigt. Dies kann Sie daran hindern, diese Übung abzuschließen. Wir werden eine Problemumgehung veröffentlichen, sobald sie bestätigt wurde.
Als ID, wählen Sie das Symbol aus, um das Datenelement-Auswahlmodul zu öffnen, und wählen Sie Ihre CRM Id
Datenelement
Als Authentifizierter Status auswählen Authentifiziert
Urlaub Primär deaktiviert. Da die CRM-ID für die meisten Besucher der Luma-Website nicht vorhanden ist, können Sie möchten die ECID nicht als primäre Kennung überschreiben. In seltenen Fällen kann nur die ECID als primäre Kennung verwendet werden. Normalerweise erwähne ich die Standardeinstellungen in diesen Anweisungen nicht, aber ich rufe diese an, um Ihnen zu helfen, Kopfschmerzen später in Ihrer eigenen Implementierung zu vermeiden.
Wählen Sie die In Bibliothek speichern button (Luma Platform Tutorial
sollte weiterhin Ihre Arbeitsbibliothek sein)
Sie können mehrere Kennungen mithilfe der Identitätszuordnung Datentyp.
Es gibt ein weiteres Datenelement, das wir aktualisieren müssen - das XDM-Objektdatenelement. Es mag seltsam erscheinen, drei separate Datenelemente aktualisieren zu müssen, um diese eine Identität zu übergeben. Dieser Prozess wurde jedoch für die Skalierung mehrerer Identitäten entwickelt. Keine Sorge! Wir sind fast fertig mit dieser Lektion!
Identities
DatenelementLuma Platform Tutorial
als Arbeitsbibliothek für die letzten Übungen ausgewählt haben, wurden Ihre letzten Änderungen direkt in der Bibliothek gespeichert. Anstatt unsere Änderungen über den Bildschirm "Veröffentlichungsfluss"veröffentlichen zu müssen, können Sie das Dropdown-Menü auf der blauen Schaltfläche öffnen und In Bibliothek speichern und erstellenSo überprüfen Sie, ob die CRM-ID jetzt vom Web SDK gesendet wird:
test@adobe.com
/test
lumaCrmId
:Gute Arbeit! Das waren viele Informationen zum Web SDK und Launch. Es gibt viel mehr an einer vollständigen Implementierung, aber dies sind die Grundlagen, die Ihnen bei den ersten Schritten und der Anzeige der Ergebnisse in Platform helfen.
Nachdem Sie die Lektion zur Streaming-Aufnahme abgeschlossen haben, können Sie die Prod Sandbox aus Luma Tutorial Platform
Produktprofil
Dateningenieure können bei Bedarf die Lektion zu Ausführungsabfragen.
Datenarchitekten, können Sie zu Zusammenführungsrichtlinien!