DocumentatieExperience PlatformDataverzameling

context

Last update: Tue Dec 02 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Ontwikkelaar

De eigenschap context is een array van tekenreeksen die bepaalt wat de Web SDK automatisch kan verzamelen. Hoewel deze gegevens een grote waarde kunnen hebben, kan het nuttig zijn om sommige van deze gegevens weg te laten, zodat u zich kunt houden aan het privacybeleid van uw organisatie.

Contexttrefwoorden en XDM-elementen

Als u een bepaald contextsleutelwoord omvat, bevolkt het Web SDK automatisch al zijn bijbehorende elementen XDM. Als u een specifiek XDM-element wilt weglaten terwijl u andere elementen toestaat, kunt u waarden wissen met onBeforeEventSend . Als u meerdere gebeurtenissen op een pagina verzendt, bevat de Web SDK deze velden voor elke SendEvent -aanroep.

Web

Het trefwoord "web" verzamelt informatie over de huidige pagina.

Dimension
Beschrijving
XDM-pad
Voorbeeldwaarde
Pagina-URL
De URL van de huidige pagina.
xdm.web.webPageDetails.URL
https://example.com/index.html
Referrer-URL
De URL van de vorige bezochte pagina.
xdm.web.webReferrer.URL
http://example.org/linkedpage.html

Apparaat

Het trefwoord "device" verzamelt informatie over het apparaat van de gebruiker.

Dimension
Beschrijving
XDM-pad
Voorbeeldwaarde
Schermhoogte
De hoogte van het scherm in pixels.
xdm.device.screenHeight
900
Schermbreedte
De breedte van het scherm in pixels.
xdm.device.screenWidth
1440
Schermoriëntatie
De oriëntatie van het scherm.
xdm.device.screenOrientation
landscape of portrait

Omgeving

Het trefwoord "environment" verzamelt informatie over de browser van de gebruiker.

Dimension
Beschrijving
XDM-pad
Voorbeeldwaarde
Type omgeving
Het type omgeving waardoor de ervaring optrad. Dit veld wordt altijd ingesteld door de Web SDK op browser .
xdm.environment.type
browser
Viewporthoogte
De hoogte van het inhoudsgebied van de browser in pixels.
xdm.environment.browserDetails.viewportHeight
679
Viewportbreedte
De breedte van het inhoudsgebied van de browser in pixels.
xdm.environment.browserDetails.viewportWidth
642

Context plaatsen

Het trefwoord "placeContext" verzamelt informatie over de locatie van de gebruiker.

Dimension
Beschrijving
XDM-pad
Voorbeeldwaarde
Lokale tijd
Lokale timestamp voor het eind - gebruiker in het vereenvoudigde uitgebreide ​ formaat van ISO 8601 ​.
xdm.placeContext.localTime
YYYY-08-07T15:47:17.129-07:00
Verschuiving lokale tijdzone
Het aantal minuten dat de gebruiker wordt verschoven ten opzichte van GMT.
xdm.placeContext.localTimezoneOffset
360
Landcode
De landcode van de eindgebruiker.
xdm.placeContext.geo.countryCode
US
Provincie
De provinciecode van de eindgebruiker.
xdm.placeContext.geo.stateProvince
CA
Breedte
De breedte van de locatie van de eindgebruiker.
xdm.placeContext.geo._schema.latitude
37.3307447
Lengtegraad
De lengtegraad van de eindgebruikerlocatie.
xdm.placeContext.geo._schema.longitude
-121.8945965

Tijdstempel

Het trefwoord "timestamp" verzamelt informatie over de tijdstempel van de gebeurtenis. Deze context is altijd inbegrepen en kan niet worden verwijderd.

Dimension
Beschrijving
XDM-pad
Voorbeeldwaarde
Tijdstempel van de gebeurtenis
UTC timestamp voor het eind - gebruiker in het vereenvoudigde uitgebreide ​ formaat van ISO 8601 ​.
xdm.timestamp
YYYY-08-07T22:47:17.129Z

Implementatiedetails

Het trefwoord implementationDetails verzamelt informatie over de SDK-versie die wordt gebruikt om de gebeurtenis te verzamelen.

Dimension
Beschrijving
XDM-pad
Voorbeeldwaarde
Naam
De id van de Software Development Kit (SDK). In dit veld wordt een URI gebruikt om de unieke id's van verschillende softwarebibliotheken te verbeteren.
xdm.implementationDetails.name
Wanneer de zelfstandige bibliotheek wordt gebruikt, is de waarde https://ns.adobe.com/experience/alloy. Wanneer de bibliotheek wordt gebruikt als onderdeel van de tagextensie, is de waarde https://ns.adobe.com/experience/alloy+reactor .
Versie
De versie van de Software Development Kit (SDK).
xdm.implementationDetails.version
Wanneer de zelfstandige bibliotheek wordt gebruikt, is de waarde de bibliotheekversie. Wanneer de bibliotheek wordt gebruikt als onderdeel van de tagextensie, is de waarde de bibliotheekversie en wordt de versie van de tagextensie gekoppeld aan een + . Als de bibliotheekversie bijvoorbeeld 2.1.0 is en de versie van de tagextensie 2.1.3 is, is de waarde 2.1.0+2.1.3 .
Omgeving
De omgeving waarin de gegevens zijn verzameld. Dit veld wordt altijd ingesteld op browser wanneer de JavaScript-bibliotheek wordt gebruikt.
xdm.implementationDetails.environment
browser

Hoog entropieclienthints high-entropy-client-hints

Het trefwoord "highEntropyUserAgentHints" verzamelt gedetailleerde informatie over het apparaat van de gebruiker. Deze gegevens worden opgenomen in de HTTP-header van het verzoek dat naar Adobe wordt verzonden. Nadat de gegevens naar het Edge-netwerk zijn gearriveerd, vult het XDM-object het desbetreffende XDM-pad. Als u het respectieve pad XDM in uw sendEvent vraag plaatst, neemt het belangrijkheid over de kopbalwaarde van HTTP.

Als u apparatenraadplegingen gebruikt wanneer ​ vormend uw datastream ​, kunnen de gegevens worden ontruimd ten gunste van de waarden van de apparatenraadpleging. Bepaalde velden voor client-hint en opzoekvelden van apparaten kunnen niet bestaan in dezelfde hit.

Eigenschap
Beschrijving
HTTP-header
XDM-pad
Voorbeeld
Versie besturingssysteem
De versie van het besturingssysteem.
Sec-CH-UA-Platform-Version
xdm.environment.browserDetails.
userAgentClientHints.platformVersion
10.15.7
Architectuur
De onderliggende CPU-architectuur.
Sec-CH-UA-Arch
xdm.environment.browserDetails.
userAgentClientHints.architecture
x86
Apparaatmodel
De naam van het gebruikte apparaat.
Sec-CH-UA-Model
xdm.environment.browserDetails.
userAgentClientHints.model
Intel Mac OS X 10_15_7
Bitsheid
Het aantal bits dat de onderliggende CPU-architectuur ondersteunt.
Sec-CH-UA-Bitness
xdm.environment.browserDetails.
userAgentClientHints.bitness
64
Browserleverancier
Het bedrijf dat de browser heeft gemaakt. Dit element wordt ook verzameld door de lage entropiehint Sec-CH-UA .
Sec-CH-UA-Full-Version-List
xdm.environment.browserDetails.
userAgentClientHints.vendor
Google
Browsernaam
De gebruikte browser. Dit element wordt ook verzameld door de lage entropiehint Sec-CH-UA .
Sec-UA-Full-Version-List
xdm.environment.browserDetails.
userAgentClientHints.brand
Chrome
Browserversie
De significante versie van de browser. Dit element wordt ook verzameld door de lage entropiehint Sec-CH-UA . Exacte browserversie wordt niet automatisch verzameld.
Sec-UA-Full-Version-List
xdm.environment.browserDetails.
userAgentClientHints.version
105

Zie ​ de wenken van de de agentencliënt van de Gebruiker ​ voor meer informatie.

Stel de array context van tekenreeksen in wanneer u de opdracht configure uitvoert. Als u deze eigenschap weglaat bij het configureren van de SDK, worden standaard alle contextgegevens behalve "highEntropyUserAgentHints" verzameld. Stel deze eigenschap in als u hoge entropieclientiptips wilt verzamelen of als u andere contextgegevens uit gegevensverzameling wilt weglaten. Tekenreeksen kunnen in elke willekeurige volgorde worden opgenomen.

NOTE
Als u alle contextinformatie wilt verzamelen, inclusief hoge entropieclienthints, moet u elke waarde in de array-tekenreeks context opnemen. Bij de standaardwaarde van context wordt highEntropyUserAgentHints weggelaten en bij de instelling van de eigenschap context worden geen gegevens verzameld door weggelaten waarden.
alloy("configure", {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  context: ["web", "device", "environment", "placeContext", "highEntropyUserAgentHints"]
});

Verzamel contextinformatie met de Web SDK-tagextensie

Zie ​ montages van de Context ​ onder de configuratiemontages van de gegevensinzameling in de de markeringsuitbreidingsdocumentatie van SDK van het Web.

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