context
La proprietà context
è un array di stringhe che determina ciò che l'SDK Web può raccogliere automaticamente. Anche se questi dati possono fornire un grande valore, omettere alcuni di questi dati può essere utile in modo da poter rispettare l’informativa sulla privacy della tua organizzazione.
Parole chiave di contesto ed elementi XDM
Se includi una determinata parola chiave di contesto, Web SDK compila automaticamente tutti gli elementi XDM associati. Se si desidera omettere un elemento XDM specifico consentendo ad altri elementi, è possibile cancellare i valori utilizzando onBeforeEventSend
. Se invii più eventi a una pagina, Web SDK include questi campi a ogni chiamata SendEvent
.
Web
La parola chiave "web"
raccoglie informazioni sulla pagina corrente.
xdm.web.webPageDetails.URL
https://example.com/index.html
xdm.web.webReferrer.URL
http://example.org/linkedpage.html
Dispositivo
La parola chiave "device"
raccoglie informazioni sul dispositivo dell'utente.
xdm.device.screenHeight
900
xdm.device.screenWidth
1440
xdm.device.screenOrientation
landscape
o portrait
Ambiente
La parola chiave "environment"
raccoglie informazioni sul browser dell'utente.
browser
.xdm.environment.type
browser
xdm.environment.browserDetails.viewportHeight
679
xdm.environment.browserDetails.viewportWidth
642
Contesto del luogo
La parola chiave "placeContext"
raccoglie informazioni sulla posizione dell'utente.
xdm.placeContext.localTime
YYYY-08-07T15:47:17.129-07:00
xdm.placeContext.localTimezoneOffset
360
xdm.placeContext.geo.countryCode
US
xdm.placeContext.geo.stateProvince
CA
xdm.placeContext.geo._schema.latitude
37.3307447
xdm.placeContext.geo._schema.longitude
-121.8945965
Timestamp
La parola chiave timestamp
raccoglie informazioni sulla marca temporale dell'evento. Questa parte del contesto non può essere rimossa.
xdm.timestamp
2019-08-07T22:47:17.129Z
Dettagli di implementazione
La parola chiave implementationDetails
raccoglie informazioni sulla versione SDK utilizzata per raccogliere l'evento.
xdm.implementationDetails.name
https://ns.adobe.com/experience/alloy
. Quando la libreria viene utilizzata come parte dell'estensione tag, il valore è https://ns.adobe.com/experience/alloy+reactor
.xdm.implementationDetails.version
+
. Ad esempio, se la versione della libreria è 2.1.0
e la versione dell'estensione tag è 2.1.3
, il valore sarà 2.1.0+2.1.3
.browser
.xdm.implementationDetails.environment
browser
Hint client ad alta entropia high-entropy-client-hints
La parola chiave "highEntropyUserAgentHints"
raccoglie informazioni dettagliate sul dispositivo dell'utente. Questi dati sono inclusi nell’intestazione HTTP della richiesta inviata all’Adobe. Una volta arrivati i dati all’interno della rete Edge, l’oggetto XDM compila il rispettivo percorso XDM. Se imposti il rispettivo percorso XDM nella chiamata sendEvent
, ha la precedenza sul valore dell'intestazione HTTP.
Se si utilizzano le ricerche dei dispositivi durante la configurazione dello stream di dati, è possibile cancellare i dati in favore dei valori di ricerca dei dispositivi. Alcuni campi degli hint client e dei campi di ricerca del dispositivo non possono esistere nello stesso hit.
Sec-CH-UA-Platform-Version
xdm.environment.browserDetails.
userAgentClientHints.platformVersion
10.15.7
Sec-CH-UA-Arch
xdm.environment.browserDetails.
userAgentClientHints.architecture
x86
Sec-CH-UA-Model
xdm.environment.browserDetails.
userAgentClientHints.model
Intel Mac OS X 10_15_7
Sec-CH-UA-Bitness
xdm.environment.browserDetails.
userAgentClientHints.bitness
64
Sec-CH-UA
raccoglie questo elemento.Sec-CH-UA-Full-Version-List
xdm.environment.browserDetails.
userAgentClientHints.vendor
Google
Sec-CH-UA
raccoglie questo elemento.Sec-UA-Full-Version-List
xdm.environment.browserDetails.
userAgentClientHints.brand
Chrome
Sec-CH-UA
raccoglie questo elemento. La versione esatta del browser non viene raccolta automaticamente.Sec-UA-Full-Version-List
xdm.environment.browserDetails.
userAgentClientHints.version
105
Raccogliere informazioni contestuali utilizzando l’estensione tag Web SDK
L'impostazione relativa alle informazioni di contesto è una combinazione di pulsanti di scelta e caselle di controllo durante la configurazione dell'estensione tag. Ogni casella di controllo è associata a una parola chiave di contesto.
- Accedi a experience.adobe.com utilizzando le credenziali Adobe ID.
- Passa a Raccolta dati > Tag.
- Seleziona la proprietà tag desiderata.
- Passa a Estensioni, quindi fai clic su Configura nella scheda Adobe Experience Platform Web SDK.
- Scorri fino alla sezione Raccolta dati, quindi seleziona Tutte le informazioni di contesto predefinite o Informazioni di contesto specifiche.
- Se si seleziona Informazioni di contesto specifiche, abilitare la casella di controllo accanto a ogni elemento informazioni di contesto desiderato.
- Fai clic su Salva, quindi pubblica le modifiche.
Raccogliere informazioni contestuali utilizzando la libreria JavaScript dell’SDK per web
Impostare la matrice di stringhe context
durante l'esecuzione del comando configure
. Se si omette questa proprietà durante la configurazione dell'SDK, tutte le informazioni di contesto tranne "highEntropyUserAgentHints"
vengono raccolte per impostazione predefinita. Imposta questa proprietà se desideri raccogliere hint client ad alta entropia o se desideri omettere altre informazioni contestuali dalla raccolta di dati. Le stringhe possono essere incluse in qualsiasi ordine.
context
. Il valore predefinito context
omette highEntropyUserAgentHints
e se si imposta la proprietà context
, eventuali valori omessi non raccolgono dati.alloy("configure", {
datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
context: ["web", "device", "environment", "placeContext", "highEntropyUserAgentHints"]
});