contextData
Met contextgegevensvariabelen kunt u aangepaste variabelen definiëren op elke pagina die door verwerkingsregels kan worden gelezen. In plaats van expliciet waarden toe te wijzen aan analytische variabelen in uw code, kunt u gegevens verzenden in contextgegevensvariabelen. De verwerkingsregels nemen dan de veranderlijke waarden van contextgegevens en gaan hen in respectieve variabelen van de Analyse over. Zie Regels van de Verwerkingin de Admin gebruikersgids.
Contextgegevensvariabelen zijn handig voor ontwikkelingsteams om gegevens te verzamelen in benoemde elementen in plaats van genummerde variabelen. In plaats van ontwikkelingsteams bijvoorbeeld te vragen de auteur van de pagina aan eVar10
toe te wijzen, kunt u deze laten toewijzen aan s.contextData["author"]
. Een beheerder van Analytics in uw organisatie kan dan verwerkingsregels tot stand brengen om de variabelen van de contextgegevens in analytische variabelen voor het melden in kaart te brengen. Ontwikkelingsteams zouden zich uiteindelijk alleen zorgen maken over de variabelen van de contextgegevens in plaats van over de vele paginariabelen die de Adobe aanbiedt.
Contextgegevensvariabelen die de SDK van het Web gebruiken
Als het gebruiken van het voorwerp XDM, zijn alle gebieden die niet aan een variabele van Adobe Analytics in kaart brengen automatisch inbegrepen als variabele van contextgegevens. U kunt ook contextgegevens met het XDM-object op expliciete wijze instellen. U kunt Regels van de Verwerkingdan gebruiken om de variabele van contextgegevens aan de gewenste variabele van Analytics toe te wijzen. Zie Toewijzing andere gebieden XDM aan de variabelen van Analyticsvoor meer informatie.
Als het gebruiken van het gegevensvoorwerp, verblijven alle variabelen van contextgegevens binnen data.__adobe.analytics.contextData
als zeer belangrijk-waardeparen:
alloy("sendEvent", {
"data": {
"__adobe": {
"analytics": {
"contextData": {
"example_variable": "Example value",
"second_example": "Another value"
}
}
}
}
});
De interface van de Regels van de Verwerkingzou c.example_variable
en c.second_example
in toepasselijke drop-down menu's tonen.
Contextgegevensvariabelen die de extensie Adobe Analytics gebruiken
Adobe Experience Platform-gegevensverzameling heeft geen specifieke locatie voor het instellen van contextgegevensvariabelen. Gebruik de aangepaste code-editor volgens de syntaxis van het AppMeasurement.
s.contextData in AppMeasurement en de de uitbreidingsredacteur van de douanecode van de Analyse
De variabele s.contextData
neemt niet rechtstreeks een waarde. Stel in plaats daarvan de eigenschappen van deze variabele in op een tekenreeks.
// Assign the example_variable property a value
s.contextData["example_variable"] = "Example value";
- Geldige contextgegevensvariabelen bevatten alleen alfanumerieke tekens, onderstrepingstekens en punten. Adobe garandeert geen gegevensverzameling in verwerkingsregels als u andere tekens, zoals afbreekstreepjes, opneemt.
- Begin geen variabelen van contextgegevens met
"a."
. Dit voorvoegsel is gereserveerd en wordt gebruikt door Adobe. Gebruik bijvoorbeeld niets.contextData["a.InstallEvent"]
. - Contextgegevensvariabelen zijn niet hoofdlettergevoelig. De variabelen
s.contextData["example"]
ens.contextData["EXAMPLE"]
zijn identiek. - Een enkele toets mag niet meer dan één waarde bevatten. Als u de variabelen van contextgegevens voor multi-waardevariabelen wilt gebruiken, schakelt alle waarden aaneen gebruikend een scheidingsteken (typisch a komma) en gaat het in of a lijst propof a lijstvariabelegebruikend verwerkingsregels over.
De verwerkingsregels van het gebruik om analysevariabelen te bevolken
- Werk uw implementatie bij om namen en waarden van variabelen voor de contextgegevens in te stellen.
- Meld u aan bij Adobe Analytics en ga naar Admin > Report Suites.
- Selecteer de gewenste rapportsuite en ga naar Edit Settings > General > Processing Rules .
- Creeer een verwerkingsregel die een variabele Analytics aan de veranderlijke waarde van contextgegevens plaatst.
- Wijzigingen opslaan.
De verwerkingsregels worden onmiddellijk van kracht nadat ze zijn opgeslagen. Zij zijn niet van toepassing op historische gegevens.
Contextgegevens verzenden in een koppelingsvraag
Neem de variabele met contextgegevens op als een eigenschap van contextData
in s.linkTrackVars
:
s.contextData["example_variable"] = "Example value";
s.linkTrackVars = "contextData.example_variable";
s.tl(true,"o","Example context data link");
Incrementele gebeurtenissen met gebruik van contextgegevensvariabelen
Wanneer u verwerkingsregels maakt, kunt u contextgegevensvariabelen aan gebeurtenissen toewijzen.
- Als een contextgegevensvariabele tekst bevat, wordt de gebeurtenis met één verhoogd.
- Als een contextgegevensvariabele een geheel getal bevat, wordt de waarde van het gehele getal verhoogd.
// 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";