DokumentationExperience PlatformDatainsamling

context

Last update: Thu Dec 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Utvecklare

Egenskapen context är en matris med strängar som avgör vad Web SDK kan samla in automatiskt. Även om dessa data kan ge mycket värde kan det vara bra att utelämna en del av dessa data så att du kan följa organisationens sekretesspolicy.

Sammanhangsnyckelord och XDM-element

Om du tar med ett givet kontextnyckelord fyller Web SDK automatiskt i alla associerade XDM-element. Om du vill utesluta ett specifikt XDM-element och samtidigt tillåta andra, kan du ta bort värden med onBeforeEventSend. Om du skickar flera händelser på en sida innehåller Web SDK dessa fält vid varje SendEvent-anrop.

Webb

Nyckelordet "web" samlar in information om den aktuella sidan.

Dimension
Beskrivning
XDM-sökväg
Exempelvärde
Sidans URL
Den aktuella sidans URL.
xdm.web.webPageDetails.URL
https://example.com/index.html
Referent-URL
URL-adressen till föregående sida som besöktes.
xdm.web.webReferrer.URL
http://example.org/linkedpage.html

Enhet

Nyckelordet "device" samlar in information om användarens enhet.

Dimension
Beskrivning
XDM-sökväg
Exempelvärde
Skärmhöjd
Skärmens höjd i pixlar.
xdm.device.screenHeight
900
Skärmbredd
Skärmens bredd i pixlar.
xdm.device.screenWidth
1440
Skärmorientering
Skärmens orientering.
xdm.device.screenOrientation
landscape eller portrait

Miljö

Nyckelordet "environment" samlar in information om användarens webbläsare.

Dimension
Beskrivning
XDM-sökväg
Exempelvärde
Miljötyp
Den typ av miljö som upplevelsen upplevde. Web SDK anger alltid det här fältet som browser.
xdm.environment.type
browser
Höjd på visningsruta
Höjden på webbläsarens innehållsområde i pixlar.
xdm.environment.browserDetails.viewportHeight
679
Bredd på visningsruta
Bredden på webbläsarens innehållsområde i pixlar.
xdm.environment.browserDetails.viewportWidth
642

Montera kontext

Nyckelordet "placeContext" samlar in information om användarens plats.

Dimension
Beskrivning
XDM-sökväg
Exempelvärde
Lokal tid
Lokal tidsstämpel för slutanvändaren i förenklat utökat ISO 8601-format.
xdm.placeContext.localTime
YYYY-08-07T15:47:17.129-07:00
Lokal tidszonsförskjutning
Antalet minuter som användaren är förskjuten från GMT.
xdm.placeContext.localTimezoneOffset
360
Landskod
Slutanvändarens landskod.
xdm.placeContext.geo.countryCode
US
Statsprovins
Slutanvändarens landskod.
xdm.placeContext.geo.stateProvince
CA
Latitude
Slutanvändarens latitud.
xdm.placeContext.geo._schema.latitude
37.3307447
Longitud
Slutanvändarens longitud.
xdm.placeContext.geo._schema.longitude
-121.8945965

Tidsstämpel

Nyckelordet "timestamp" samlar in information om händelsens tidsstämpel. Den här kontexten inkluderas alltid och kan inte tas bort.

Dimension
Beskrivning
XDM-sökväg
Exempelvärde
Tidsstämpel för händelsen
UTC-tidsstämpel för slutanvändaren i förenklat utökat ISO 8601-format.
xdm.timestamp
YYYY-08-07T22:47:17.129Z

Implementeringsinformation

Nyckelordet implementationDetails samlar in information om den SDK-version som används för att samla in händelsen.

Dimension
Beskrivning
XDM-sökväg
Exempelvärde
Namn
Identifieraren för SDK (Software Development Kit). I det här fältet används en URI för att förbättra unika identifierare som tillhandahålls av olika programbibliotek.
xdm.implementationDetails.name
När det fristående biblioteket används är värdet https://ns.adobe.com/experience/alloy. När biblioteket används som en del av taggtillägget är värdet https://ns.adobe.com/experience/alloy+reactor.
Version
Programvaruutvecklingsverktyget (SDK).
xdm.implementationDetails.version
När det fristående biblioteket används är värdet biblioteksversionen. När biblioteket används som en del av taggtillägget är värdet biblioteksversionen och taggtilläggsversionen som är kopplad till en +. Om biblioteksversionen till exempel är 2.1.0 och taggtilläggsversionen är 2.1.3 blir värdet 2.1.0+2.1.3.
Miljö
Den miljö där data samlades in. Det här fältet är alltid inställt på browser när du använder JavaScript-biblioteket.
xdm.implementationDetails.environment
browser

Tips för hög entropi-klient high-entropy-client-hints

Nyckelordet "highEntropyUserAgentHints" samlar in detaljerad information om användarens enhet. Dessa data inkluderas i HTTP-huvudet för den begäran som skickas till Adobe. När data har anlänt till Edge-nätverket fyller XDM-objektet i sin respektive XDM-sökväg. Om du anger respektive XDM-sökväg i ditt sendEvent-anrop har den företräde framför HTTP-rubrikvärdet.

Om du använder enhetssökningar när du konfigurerar ditt datastream kan data rensas till förmån för enhetssökningsvärden. Vissa klienttipsfält och enhetssökningsfält kan inte finnas i samma träff.

Egenskap
Beskrivning
HTTP-huvud
XDM-sökväg
Exempel
Operativsystemversion
Operativsystemets version.
Sec-CH-UA-Platform-Version
xdm.environment.browserDetails.
userAgentClientHints.platformVersion
10.15.7
Arkitektur
CPU underliggande arkitektur.
Sec-CH-UA-Arch
xdm.environment.browserDetails.
userAgentClientHints.architecture
x86
Enhetsmodell
Namnet på den enhet som används.
Sec-CH-UA-Model
xdm.environment.browserDetails.
userAgentClientHints.model
Intel Mac OS X 10_15_7
Bitness
Antalet bitar som den underliggande CPU-arkitekturen stöder.
Sec-CH-UA-Bitness
xdm.environment.browserDetails.
userAgentClientHints.bitness
64
Webbläsarleverantör
Företaget som skapade webbläsaren. Det låga entropytipset Sec-CH-UA samlar också in det här elementet.
Sec-CH-UA-Full-Version-List
xdm.environment.browserDetails.
userAgentClientHints.vendor
Google
Webbläsarnamn
Webbläsaren används. Det låga entropytipset Sec-CH-UA samlar också in det här elementet.
Sec-UA-Full-Version-List
xdm.environment.browserDetails.
userAgentClientHints.brand
Chrome
Webbläsarversion
Den viktiga versionen av webbläsaren. Det låga entropytipset Sec-CH-UA samlar också in det här elementet. Exakt webbläsarversion samlas inte in automatiskt.
Sec-UA-Full-Version-List
xdm.environment.browserDetails.
userAgentClientHints.version
105

Mer information finns i Klienttips för användaragent.

Ange strängarrayen context när du kör kommandot configure. Om du utelämnar den här egenskapen när du konfigurerar SDK samlas all kontextinformation förutom "highEntropyUserAgentHints" in som standard. Ange den här egenskapen om du vill samla in klienttips med hög entropi, eller om du vill utelämna annan kontextinformation från datainsamlingen. Strängar kan inkluderas i vilken ordning som helst.

NOTE
Om du vill samla in all kontextinformation, inklusive tips för hög entropi-klient, måste du ta med alla värden i context-arraysträngen. Standardvärdet context utelämnar highEntropyUserAgentHints, och om du anger egenskapen context samlar inga utelämnade värden in data.
alloy("configure", {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  context: ["web", "device", "environment", "placeContext", "highEntropyUserAgentHints"]
});

Samla in kontextinformation med taggtillägget Web SDK

Se Kontextinställningar under konfigurationsinställningar för datainsamling i dokumentationen för SDK-taggtillägg för webben.

recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1