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.

Dimension
Description
Chemin XDM
Exemple de valeur
Page URL (URL de la page)
URL de la page active.
xdm.web.webPageDetails.URL
https://example.com/index.html
URL du référent
URL de la page précédemment visitée.
xdm.web.webReferrer.URL
http://example.org/linkedpage.html

Appareil

Le mot-clé "device" collecte des informations sur l’appareil de l’utilisateur.

Dimension
Description
Chemin XDM
Exemple de valeur
Hauteur d’écran
Hauteur de l’écran en pixels.
xdm.device.screenHeight
900
Largeur d’écran
Largeur de l’écran en pixels.
xdm.device.screenWidth
1440
Orientation de l’écran
Orientation de l’écran.
xdm.device.screenOrientation
landscape ou portrait.

Environnement

Le mot-clé "environment" collecte des informations sur le navigateur de l’utilisateur.

Dimension
Description
Chemin XDM
Exemple de valeur
Type d’environnement
Type d’environnement par lequel l’expérience est apparue. Le SDK Web définit toujours ce champ sur browser.
xdm.environment.type
browser
Hauteur de la fenêtre d’affichage
Hauteur de la zone de contenu du navigateur en pixels.
xdm.environment.browserDetails.viewportHeight
679
Largeur de la fenêtre d’affichage
Largeur de la zone de contenu du navigateur en pixels.
xdm.environment.browserDetails.viewportWidth
642

Contexte de l’emplacement

Le mot-clé "placeContext" collecte des informations sur l’emplacement de l’utilisateur.

Dimension
Description
Chemin XDM
Exemple de valeur
Heure locale
Horodatage local pour l’utilisateur final au format étendu simplifié ISO 8601.
xdm.placeContext.localTime
YYYY-08-07T15:47:17.129-07:00
Décalage du fuseau horaire local
Le nombre de minutes pendant lesquelles l’utilisateur est décalé par rapport à GMT.
xdm.placeContext.localTimezoneOffset
360
Code pays
Code pays de l’utilisateur final.
xdm.placeContext.geo.countryCode
US
Province de l'État
Code de province d’état de l’utilisateur final.
xdm.placeContext.geo.stateProvince
CA
Latitude
Latitude de l’emplacement de l’utilisateur final.
xdm.placeContext.geo._schema.latitude
37.3307447
Longitude
Longitude de la position de l’utilisateur final.
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.

Dimension
Description
Chemin XDM
Exemple de valeur
Horodatage de l’événement
Horodatage UTC pour l’utilisateur final au format étendu simplifié ISO 8601.
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.

Dimension
Description
Chemin XDM
Exemple de valeur
Nom
Identifiant du kit de développement logiciel (SDK). Ce champ utilise un URI pour améliorer l’unicité entre les identifiants fournis par différentes bibliothèques de logiciels.
xdm.implementationDetails.name
Lorsque la bibliothèque autonome est utilisée, la valeur est 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.
Version
Version du kit de développement logiciel (SDK).
xdm.implementationDetails.version
Lorsque la bibliothèque autonome est utilisée, la valeur est la version de la bibliothèque. Lorsque la bibliothèque est utilisée dans le cadre de l’extension de balise, la valeur est la version de la bibliothèque et la version de l’extension de balise associée à un +. 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.
Environnement
Environnement dans lequel les données ont été collectées. Cette valeur est toujours définie sur browser.
xdm.implementationDetails.environment
browser

Conseils client à forte entropie high-entropy-client-hints

TIP
Consultez la documentation sur les conseils sur le client de l’agent utilisateur pour obtenir des informations détaillées sur la manière de les configurer.

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.

Propriété
Description
En-tête HTTP
Chemin XDM
Exemple
Version du système d’exploitation
Version du système d’exploitation.
Sec-CH-UA-Platform-Version
xdm.environment.browserDetails.
userAgentClientHints.platformVersion
10.15.7
Architecture
Architecture du processeur sous-jacent.
Sec-CH-UA-Arch
xdm.environment.browserDetails.
userAgentClientHints.architecture
x86
Modèle de périphérique
Nom du périphérique utilisé.
Sec-CH-UA-Model
xdm.environment.browserDetails.
userAgentClientHints.model
Intel Mac OS X 10_15_7
Bitness
Nombre de bits pris en charge par l’architecture du processeur sous-jacente.
Sec-CH-UA-Bitness
xdm.environment.browserDetails.
userAgentClientHints.bitness
64
Fournisseur du navigateur
Société qui a créé le navigateur. L’indice d’entropie faible Sec-CH-UA collecte également cet élément.
Sec-CH-UA-Full-Version-List
xdm.environment.browserDetails.
userAgentClientHints.vendor
Google
Nom du navigateur
Le navigateur utilisé. L’indice d’entropie faible Sec-CH-UA collecte également cet élément.
Sec-UA-Full-Version-List
xdm.environment.browserDetails.
userAgentClientHints.brand
Chrome
Version du navigateur
Version significative du navigateur. L’indice d’entropie faible 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.

  1. Connectez-vous à experience.adobe.com à l’aide de vos informations d’identification Adobe ID.
  2. Accédez à Collecte de données > Balises.
  3. Sélectionnez la propriété de balise de votre choix.
  4. Accédez à Extensions, puis cliquez sur Configurer sur la carte SDK Web Adobe Experience Platform.
  5. 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.
  6. Si vous sélectionnez Informations contextuelles spécifiques, cochez la case en regard de chaque élément d’informations contextuelles souhaité.
  7. 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.

NOTE
Si vous souhaitez collecter toutes les informations contextuelles, y compris les indices client à forte entropie, vous devez inclure chaque valeur dans la chaîne de tableau 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"]
});
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636