contextData
Mithilfe von Kontextdatenvariablen können Sie auf jeder Seite benutzerdefinierte Variablen definieren, die Verarbeitungsregeln lesen können. Anstatt Analytics-Variablen explizit Werte in Ihrem Code zuzuweisen, können Sie Daten in Kontextdatenvariablen senden. Verarbeitungsregeln nehmen dann Kontextdatenvariablenwerte auf und übergeben sie an die entsprechenden Analytics-Variablen. Weitere Informationen finden Sie im Admin-Benutzerhandbuch unter Verarbeitungsregeln.
Kontextdatenvariablen sind für Entwicklungsteams hilfreich, um Daten in benannten Elementen, statt in nummerierten Variablen zu erfassen. Anstatt beispielsweise anzufordern, dass Entwicklungsteams den Autor der Seite eVar10 zuweisen, können Sie sie stattdessen auffordern, ihn s.contextData["author"] zuzuweisen. Ein Analytics-Administrator in Ihrem Unternehmen kann dann Verarbeitungsregeln erstellen, um Kontextdatenvariablen Analysevariablen für die Berichterstellung zuzuordnen. Entwicklungsteams würden sich letztlich nur um Kontextdatenvariablen kümmern, nicht um die vielen Seitenvariablen, die Adobe anbietet.
Kontextdatenvariablen, die das Web SDK verwenden
Bei Verwendung des XDM-Objekts werden alle Felder, die keiner Adobe Analytics-Variablen zugeordnet sind, automatisch als Kontextdatenvariable eingefügt. Sie können Kontextdaten auch mithilfe des XDM-Objekts explizit festlegen. Anschließend können Sie Verarbeitungsregeln verwenden, um die Kontextdatenvariable der gewünschten Analytics-Variablen zuzuweisen. Weitere Informationen finden Sie unter Zuordnen anderer XDM-Felder zu Analytics-Variablen .
Bei Verwendung des Datenobjekts befinden sich alle Kontextdatenvariablen in data.__adobe.analytics.contextData als Schlüssel-Wert-Paare:
alloy("sendEvent", {
"data": {
"__adobe": {
"analytics": {
"contextData": {
"example_variable": "Example value",
"second_example": "Another value"
}
}
}
}
});
Die Oberfläche der Verarbeitungsregeln zeigt c.example_variable und c.second_example in den entsprechenden Dropdownmenüs an.
Kontextdatenvariablen, die die Adobe Analytics-Erweiterung verwenden
Die Adobe Experience Platform-Datenerfassung verfügt über keinen speziellen Ort zum Festlegen von Kontextdatenvariablen. Verwenden Sie den Editor für benutzerdefinierten Code entsprechend der AppMeasurement-Syntax.
s.contextData in AppMeasurement und im benutzerdefinierten Code-Editor der Analytics-Erweiterung
Die s.contextData-Variable nimmt keinen Wert direkt an. Setzen Sie stattdessen die Eigenschaften dieser Variable auf eine Zeichenfolge.
// Assign the example_variable property a value
s.contextData["example_variable"] = "Example value";
- Gültige Kontextdatenvariablen enthalten nur alphanumerische Zeichen, Unterstriche und Punkte. Adobe garantiert die Datenerfassung in den Verarbeitungsregeln nicht, wenn Sie andere Zeichen, wie z. B. Bindestriche, einfügen.
- Starten Sie Kontextdatenvariablen nicht mit
"a.". Dieses Präfix ist reserviert und wird von Adobe verwendet. Verwenden Sie zum Beispiel nichts.contextData["a.InstallEvent"]. - Bei Kontextdatenvariablen wird nicht zwischen Groß- und Kleinschreibung unterschieden. Die Variablen
s.contextData["example"]unds.contextData["EXAMPLE"]sind identisch. - Ein einzelner Schlüssel darf nicht mehr als einen Wert enthalten. Wenn Sie Kontextdatenvariablen für Variablen mit mehreren Werten verwenden möchten, verketten Sie alle Werte mit einem Trennzeichen (normalerweise ein Komma) und übergeben Sie es mithilfe von Verarbeitungsregeln entweder an eine Listen-Prop oder an eine list-Variable.
Verwenden von Verarbeitungsregeln zum Ausfüllen von Analytics-Variablen
- Aktualisieren Sie Ihre Implementierung, um Kontextdatenvariablennamen und -werte festzulegen.
- Melden Sie sich bei Adobe Analytics an und gehen Sie zu "Admin"> "Report Suites".
- Wählen Sie die gewünschte Report Suite aus und gehen Sie dann zu "Einstellungen bearbeiten"> "Allgemein"> "Verarbeitungsregeln".
- Erstellen Sie eine Verarbeitungsregel, die eine Analytics-Variable auf den Wert der Kontextdatenvariablen setzt.
- Speichern Sie die Änderungen.
Verarbeitungsregeln werden sofort nach dem Speichern wirksam. Sie gelten nicht für historische Daten.
Senden von Kontextdaten in einem Linktracking-Aufruf
Schließen Sie die Kontextdatenvariable als Eigenschaft von contextData in s.linkTrackVars ein:
s.contextData["example_variable"] = "Example value";
s.linkTrackVars = "contextData.example_variable";
s.tl(true,"o","Example context data link");
Ereignisse mithilfe von Kontextdatenvariablen erhöhen
Beim Erstellen von Verarbeitungsregeln können Sie Ereignissen Kontextdatenvariablen zuweisen.
- Enthält eine Kontextdatenvariable einen Textt, wird das Ereignis um 1 inkrementiert.
- Wenn eine Kontextdatenvariable eine Ganzzahl enthält, wird das Ereignis um diesen ganzzahligen Betrag inkrementiert.
// Assigning this context data variable to an event increments it by one
s.contextData["example_text"] = "Text value";
// Assigning this context data variable to an event increments it by four
s.contextData["example_number"] = "4";