Senden von Daten an Adobe Analytics mithilfe der Web-SDK
Erstellt für:
- Entwickler
Der Experience Platform Web SDK kann Daten über das Experience Platform-Edge Network an Adobe Analytics senden. Adobe bietet mehrere Optionen, um Daten mithilfe der Web-SDK an Adobe Analytics zu senden:
- Fügen Sie die Adobe Analytics ExperienceEvent Feldergruppe zu Ihrem Schema hinzu und verwenden Sie dann das
XDM-Objekt. - Verwenden Sie das
data-, um Daten ohne XDM-Schema an Adobe Analytics zu senden. - Verwenden Sie automatisch generierte Kontextdatenvariablen und Verarbeitungsregeln.
Verwenden des XDM
Wenn Sie ein vordefiniertes Schema verwenden möchten, das speziell für Adobe Analytics gilt, können Sie die Schemafeldgruppe Adobe Analytics ExperienceEvent zu Ihrem Schema hinzufügen. Nach dem Hinzufügen können Sie dieses Schema mithilfe des xdm-Objekts in der Web-SDK ausfüllen, um Daten an eine Report Suite zu senden. Wenn Daten am Edge Network eintreffen, wird das XDM-Objekt in ein Format übersetzt, das Adobe Analytics versteht.
Es gibt zwei Möglichkeiten, Daten über Web SDK an Adobe Analytics zu senden:
Siehe XDM-Objektvariablenzuordnung zu Adobe Analytics im Adobe Analytics-Implementierungshandbuch für eine vollständige Referenz zu XDM-Feldern und deren Zuordnung zu Analytics-Variablen.
Verwenden des data
Als Alternative zur Verwendung des XDM-Objekts können Sie stattdessen das Datenobjekt verwenden. Das Datenobjekt ist auf Implementierungen ausgerichtet, die derzeit AppMeasurement verwenden, was das Upgrade auf die Web-SDK viel einfacher macht.
Je nachdem, ob Sie AppMeasurement oder die Analytics-Tag-Erweiterung verwenden, finden Sie in den folgenden Handbüchern Details zur Migration zu Web SDK:
Eine vollständige Referenz der Datenobjektfelder und ihrer Zuordnung zu AnalyticsVariablen finden Sie in der DokumentationDatenobjektvariablenzuordnung zu Adobe Analytics" im Adobe Analytics-Implementierungshandbuch.
Verwenden von Kontextdatenvariablen
Alle Variablen, die nicht automatisch zugeordnet werden, sind als Kontextdatenvariablen“. Anschließend können Sie Verarbeitungsregeln verwenden, um Kontextdatenvariablen Analytics-Variablen zuzuordnen. Angenommen, Sie haben ein benutzerdefiniertes XDM-Schema, das wie folgt aussieht:
{
"xdm": {
"key":"value",
"animal": {
"species": "Raven",
"size": "13 inches"
},
"array": [
"v0",
"v1",
"v2"
],
"objectArray":[{
"ad1": "300x200",
"ad2": "60x240",
"ad3": "600x50"
}]
}
}
Dann wären diese Felder die Kontextdatenschlüssel, die Ihnen in der Benutzeroberfläche für Verarbeitungsregeln zur Verfügung stehen:
a.x.key //value
a.x.animal.species //Raven
a.x.animal.size //13 inches
a.x.array.0 //v0
a.x.array.1 //v1
a.x.array.2 //v2
a.x.objectarray.0.ad1 //300x200
a.x.objectarray.1.ad2 //60x240
a.x.objectarray.2.ad3 //600x50
Häufig gestellte Fragen
Beim AppMeasurement in Adobe Analytics werden separate Methodenaufrufe für Seitenansichten (t())Linktracking-Aufrufe (tl()). Die Web-SDK stellt stattdessen nur den sendEvent-Befehl zum Senden sowohl von Seitenansichten als auch von Linktracking bereit. Die Daten, die Sie in ein Ereignis einbeziehen, bestimmen, ob es sich um eine Seitenansicht oder ein Seitenereignis in Adobe Analytics handelt.
Standardmäßig werden alle Ereignisse in Adobe Analytics als Seitenansichten betrachtet. Wenn Sie ein Web-SDK-Ereignis auf einen Adobe Analytics-Linktracking-Aufruf festlegen möchten, legen Sie die folgenden Felder fest:
- XDM-Objekt:
xdm.web.webInteraction.name,web.webInteraction.typeundweb.webInteraction.URL - Datenobjekt:
data.__adobe.analytics.linkName,data.__adobe.analytics.linkTypeunddata.__adobe.analytics.linkURL - Kontextdaten: Nicht unterstützt
Weitere Informationen finden Sie 🔗 der tl() Methode im Adobe Analytics-Implementierungshandbuch .
Wenn Sie clickCollectionEnabled im configure-Befehl aktivieren, werden diese Felder für Sie ausgefüllt.
Alle Ereignisse, die an einen Datenstrom gesendet werden, werden an alle konfigurierten Services übergeben. Wenn Sie beispielsweise separate Aufrufe für Personalisierung und Analyse ausführen, werden beide Ereignisse an Analytics und Target gesendet. Diese Ereignisse werden im Analytics-Reporting aufgezeichnet und können Metriken wie die Absprungrate beeinflussen.
Wenn Sie die Web-SDK verwenden, werden diese Aufrufe normalerweise im sendEvent-Befehl kombiniert.