DokumentationExperience PlatformAnvändarhandbok om webb-SDK

context

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

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 inkluderar 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 delen av kontexten 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
2019-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
SDK-identifierare (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. Den här inställningen är alltid browser.
xdm.implementationDetails.environment
browser

Tips för hög entropi-klient

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 kommit in i 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.

Dimension
Beskrivning
HTTP-huvud
XDM-sökväg
Exempelvärde
Operativsystemversion
Operativsystemets version.
Sec-CH-UA-Platform-Version
xdm.environment.browserDetails.
userAgentClientHints.platformVersion
Arkitektur
Den underliggande processorarkitekturen.
Sec-CH-UA-Arch
xdm.environment.browserDetails.
userAgentClientHints.architecture
Enhetsmodell
Namnet på den enhet som används.
Sec-CH-UA-Model
xdm.environment.browserDetails.
userAgentClientHints.model
Bitness
Antalet bitar som den underliggande processorarkitekturen stöder.
Sec-CH-UA-Bitness
xdm.environment.browserDetails.
userAgentClientHints.bitness
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
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
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

Samla in kontextinformation med taggtillägget Web SDK

Inställningen för kontextinformation är en kombination av alternativknappar och kryssrutor när taggtilläggetkonfigureras. Varje kryssruta mappas till ett kontextnyckelord.

  1. Logga in på experience.adobe.com med dina Adobe ID-inloggningsuppgifter.
  2. Navigera till Data Collection > Tags.
  3. Välj önskad taggegenskap.
  4. Navigera till Extensions och klicka sedan på Configure på Adobe Experience Platform Web SDK-kortet.
  5. Bläddra ned till avsnittet Data Collection och välj sedan antingen All default context information eller Specific context information.
  6. Om du väljer Specific context information aktiverar du kryssrutan bredvid varje önskat kontextinformationselement.
  7. Klicka på Save och publicera sedan ändringarna.

Samla in kontextinformation med Web SDK JavaScript-biblioteket

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", {
  "edgeConfigId": "ebebf826-a01f-4458-8cec-ef61de241c93",
  "orgId": "ADB3LETTERSANDNUMBERS@AdobeOrg",
  "context": ["web", "device", "environment", "placeContext", "highEntropyUserAgentHints"]
});
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636