context
La propriété context
est un tableau de chaînes qui détermine ce que le SDK Web peut collecter automatiquement. Bien que ces données puissent offrir une grande valeur, l’omission de certaines de ces données peut s’avérer bénéfique afin que vous puissiez vous conformer à la politique de confidentialité de votre entreprise.
Mots-clés de contexte et éléments XDM
Si vous incluez un mot-clé contextuel donné, le SDK Web renseigne automatiquement tous les éléments XDM associés. Si vous souhaitez omettre un élément XDM spécifique tout en autorisant d’autres, vous pouvez effacer les valeurs à l’aide de onBeforeEventSend
. Si vous envoyez plusieurs événements sur une page, le SDK Web inclut ces champs à chaque appel SendEvent
.
Web
Le mot-clé "web"
collecte des informations sur la page active.
xdm.web.webPageDetails.URL
https://example.com/index.html
xdm.web.webReferrer.URL
http://example.org/linkedpage.html
Appareil
Le mot-clé "device"
collecte des informations sur l’appareil de l’utilisateur.
xdm.device.screenHeight
900
xdm.device.screenWidth
1440
xdm.device.screenOrientation
landscape
ou portrait
.Environnement
Le mot-clé "environment"
collecte des informations sur le navigateur de l’utilisateur.
browser
.xdm.environment.type
browser
xdm.environment.browserDetails.viewportHeight
679
xdm.environment.browserDetails.viewportWidth
642
Contexte de l’emplacement
Le mot-clé "placeContext"
collecte des informations sur l’emplacement de l’utilisateur.
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
Date et heure
Le mot-clé timestamp
collecte des informations sur l’horodatage de l’événement. Cette partie du contexte ne peut pas être supprimée.
xdm.timestamp
2019-08-07T22:47:17.129Z
Détails d’implémentation
Le mot-clé implementationDetails
collecte des informations sur la version du SDK utilisée pour collecter l’événement.
xdm.implementationDetails.name
https://ns.adobe.com/experience/alloy
. Lorsque la bibliothèque est utilisée dans le cadre de l’extension de balise, la valeur est https://ns.adobe.com/experience/alloy+reactor
.xdm.implementationDetails.version
+
. Par exemple, si la version de la bibliothèque est 2.1.0
et que la version de l’extension de balise est 2.1.3
, la valeur sera 2.1.0+2.1.3
.browser
.xdm.implementationDetails.environment
browser
Conseils client à forte entropie high-entropy-client-hints
Le mot-clé "highEntropyUserAgentHints"
collecte des informations détaillées sur l’appareil de l’utilisateur. Ces données sont incluses dans l’en-tête HTTP de la demande envoyée à Adobe. Une fois les données arrivées dans le réseau Edge, l’objet XDM renseigne son chemin d’accès XDM respectif. Si vous définissez le chemin XDM respectif dans votre appel sendEvent
, il est prioritaire sur la valeur de l’en-tête HTTP.
Si vous utilisez des recherches d’appareils lors de la configuration de votre flux de données, les données peuvent être effacées au profit des valeurs de recherche d’appareils. Certains champs de conseil client et de recherche de périphérique ne peuvent pas exister dans le même accès.
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
collecte également cet élément.Sec-CH-UA-Full-Version-List
xdm.environment.browserDetails.
userAgentClientHints.vendor
Google
Sec-CH-UA
collecte également cet élément.Sec-UA-Full-Version-List
xdm.environment.browserDetails.
userAgentClientHints.brand
Chrome
Sec-CH-UA
collecte également cet élément. La version exacte du navigateur n’est pas collectée automatiquement.Sec-UA-Full-Version-List
xdm.environment.browserDetails.
userAgentClientHints.version
105
Collecte des informations contextuelles à l’aide de l’extension de balise SDK Web
Le paramètre d’informations contextuelles est une combinaison de boutons radio et de cases à cocher lors de la configuration de l’extension de balise. Chaque case à cocher correspond à un mot-clé contextuel.
- Connectez-vous à experience.adobe.com à l’aide de vos informations d’identification Adobe ID.
- Accédez à Collecte de données > Balises.
- Sélectionnez la propriété de balise de votre choix.
- Accédez à Extensions, puis cliquez sur Configurer sur la carte SDK Web Adobe Experience Platform.
- Faites défiler l’écran jusqu’à la section Collecte de données, puis sélectionnez Toutes les informations contextuelles par défaut ou Informations contextuelles spécifiques.
- Si vous sélectionnez Informations contextuelles spécifiques, cochez la case en regard de chaque élément d’informations contextuelles souhaité.
- Cliquez sur Enregistrer, puis publiez vos modifications.
Collecte d’informations contextuelles à l’aide de la bibliothèque JavaScript SDK Web
Définissez le tableau context
de chaînes lors de l’exécution de la commande configure
. Si vous omettez cette propriété lors de la configuration du SDK, toutes les informations contextuelles sauf "highEntropyUserAgentHints"
sont collectées par défaut. Définissez cette propriété si vous souhaitez collecter des indices client à forte entropie ou si vous souhaitez omettre d’autres informations contextuelles de la collecte de données. Les chaînes peuvent être incluses dans n’importe quel ordre.
context
. La valeur context
par défaut omet highEntropyUserAgentHints
, et si vous définissez la propriété context
, toutes les valeurs omises ne collectent pas de données.alloy("configure", {
datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
context: ["web", "device", "environment", "placeContext", "highEntropyUserAgentHints"]
});