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 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 ett XDM-fält inte är tillgängligt mappas för Adobe Analyticsinkluderas den automatiskt som en kontextdatavariabel. Du kan sedan använda Bearbetar regler om du vill tilldela kontextdatavariabeln till den önskade Analytics-variabeln.
Även om det är en god vana att mappa data till rätt XDM-fält i DataStream, uppnår den här metoden liknande resultat.
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
The s.contextData
variabeln får inte ett 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 Suites.
- Markera önskad rapportserie och gå sedan till Redigera inställningar > Allmänt > Bearbetningsregler.
- 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
in 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";