contextData
Med kontextdatavariabler kan du definiera anpassade variabler på varje sida som bearbetningsregler kan läsa. I stället för att explicit tilldela värden till Analytics-variabler i koden kan du skicka data i kontextdatavariabler. Bearbetningsregler tar sedan hänsyn till variabelvärden för kontextdata och skickar dem till respektive Analytics-variabler. Se Bearbetar regler i användarhandboken för Admin.
Kontextdatavariabler är användbara för utvecklingsteam som samlar in data i namngivna element i stället för i numrerade variabler. I stället för att begära utvecklarteam tilldelar du till exempel sidans författare till eVar10
, kan du begära att de tilldelar den till s.contextData["author"]
i stället. En Analysadministratör i organisationen kan sedan skapa bearbetningsregler för att mappa kontextdatavariabler till analysvariabler för rapportering. Utvecklingsteamen skulle i slutänden bara bekymra sig om kontextdatavariabler i stället för de många sidvariablerna som Adobe erbjuder.
Sammanhangsdatavariabler med Web SDK
Om du använder XDM-objektet inkluderas automatiskt alla fält som inte mappar till en Adobe Analytics-variabel som kontextdatavariabel. Du kan också explicit ange kontextdata med XDM-objektet. Du kan sedan använda Bearbetningsregler för att tilldela kontextdatavariabeln till den önskade Analytics-variabeln. Mer information finns i Mappa andra XDM-fält till analysvariabler.
Om du använder dataobjektet finns alla kontextdatavariabler i data.__adobe.analytics.contextData
som nyckelvärdepar:
alloy("sendEvent", {
"data": {
"__adobe": {
"analytics": {
"contextData": {
"example_variable": "Example value",
"second_example": "Another value"
}
}
}
}
});
Gränssnittet Bearbetningsregler skulle visa c.example_variable
och c.second_example
i tillämpliga nedrullningsbara menyer.
Sammanhangsdatavariabler med Adobe Analytics-tillägget
Adobe Experience Platform Data Collection har ingen dedikerad plats för att ange kontextdatavariabler. Använd den anpassade kodredigeraren enligt AppMeasurementen syntax.
s.contextData i AppMeasurementet och den anpassade kodredigeraren för Analytics-tillägget
Variabeln s.contextData
får inget värde direkt. Ange i stället variabelns egenskaper som en sträng.
// Assign the example_variable property a value
s.contextData["example_variable"] = "Example value";
- Giltiga kontextdatavariabler innehåller endast alfanumeriska tecken, understreck och punkter. Adobe garanterar inte datainsamling i bearbetningsregler om du inkluderar andra tecken, t.ex. bindestreck.
- Starta inte kontextdatavariabler med
"a."
. Det här prefixet är reserverat och används av Adobe. Använd till exempel intes.contextData["a.InstallEvent"]
. - Sammanhangsdatavariabler är inte skiftlägeskänsliga. Variablerna
s.contextData["example"]
ochs.contextData["EXAMPLE"]
är identiska.
Använd bearbetningsregler för att fylla i analysvariabler
- Uppdatera implementeringen för att ange kontextdatavariabelnamn och -värden.
- Logga in på Adobe Analytics och gå till Admin > Report sviter.
- Välj önskad rapportsvit och gå sedan till Edit Settings > General > Processing Rules.
- Skapa en bearbetningsregel som ställer in en Analytics-variabel på kontextdatavariabelvärdet.
- Spara ändringar.
Bearbetningsreglerna börjar gälla omedelbart när de har sparats. De gäller inte historiska data.
Skicka kontextdata i ett länkspårningsanrop
Inkludera kontextdatavariabeln som en egenskap för contextData
i s.linkTrackVars
:
s.contextData["example_variable"] = "Example value";
s.linkTrackVars = "contextData.example_variable";
s.tl(true,"o","Example context data link");
Öka händelser med hjälp av kontextdatavariabler
När du skapar bearbetningsregler kan du tilldela kontextdatavariabler till händelser.
- Om en kontextdatavariabel innehåller någon typ av text ökas händelsen med ett.
- Om en kontextdatavariabel innehåller ett heltal ökas händelsen med det heltalsvärdet.
// 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";