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 fournir une grande valeur, l’omission de certaines de ces données peut être bénéfique afin que vous puissiez vous conformer à la politique de confidentialité de votre organisation.

Mots-clés de contexte et éléments XDM

Si vous incluez un mot-clé de contexte donné, le SDK Web renseigne automatiquement tous ses éléments XDM associés. Si vous souhaitez omettre un élément XDM spécifique tout en 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.

Appareil

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

Environnement

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

Contexte de l’emplacement

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

Date et heure

Le mot-clé "timestamp" collecte des informations sur la date et l’heure de l’événement. Ce contexte est toujours inclus et ne peut pas être supprimé.

Détails d’implémentation

Le mot-clé implementationDetails collecte des informations sur la version de SDK utilisée pour collecter l’événement.

Indications du client à entropie élevée 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 requête envoyée à Adobe. Une fois les données arrivées au réseau Edge, l’objet XDM renseigne son chemin XDM respectif. Si vous définissez le chemin XDM correspondant dans votre appel sendEvent, il est prioritaire sur la valeur de l’en-tête HTTP.

Si vous utilisez les recherches d’appareil lors de la configuration de votre flux de données, les données peuvent être effacées au profit des valeurs de recherche d’appareil. Certains champs d’indications du client et champs de recherche de l’appareil ne peuvent pas exister dans le même accès.

Voir ​ Indications du client de l’agent utilisateur pour plus d’informations.

Référent unique pour Analytics one-time-analytics-referrer

Le mot-clé "oneTimeAnalyticsReferrer" envoie une valeur de référent à Adobe Analytics uniquement lors du premier appel de sendEvent non décisionnelle pour une page. Le principal cas d’utilisation de ce mot-clé de contexte consiste à empêcher le gonflement de la dimension Référent dans Adobe Analytics par les accès principalement utilisés dans les intégrations Analytics et Target.

Si une commande de sendEvent donnée utilise un type d’événement de prise de décision (decisioning.propositionFetch, decisioning.propositionDisplay, decisioning.propositionInteract), elle est ignorée lors du calcul de la première sendEvent d’une page. Si la valeur du référent change sur la page et qu’une autre sendEvent est déclenchée, la nouvelle valeur du référent est incluse dans la payload. Cette condition permet d’utiliser la fonction avec des applications monopages.

Lorsqu’une valeur de référent en double est détectée, la bibliothèque définit data.__adobe.analytics.referrer sur une chaîne vide ("").
La définition de ce champ d’objet de données sur une chaîne vide efface efficacement la valeur lorsqu’un accès arrive à Adobe Analytics, car l’objet de données remplace tout champ équivalent de l’objet XDM. Cela n’a aucun impact sur l’objet XDM, ce qui permet à ces données de continuer à être envoyées à un jeu de données Experience Platform si vous incluez plusieurs services dans un flux de données.

Mise en œuvre

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, à l’exception de "highEntropyUserAgentHints" et "oneTimeAnalyticsReferrer", sont collectées par défaut. Définissez cette propriété si vous souhaitez collecter des indications du client à entropie élevée 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.

alloy("configure", {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  context: ["web", "device", "environment", "placeContext", "highEntropyUserAgentHints", "oneTimeAnalyticsReferrer"]
});

Collecter des informations contextuelles à l’aide de l’extension de balise Web SDK

Voir Paramètres contextuels sous Paramètres de configuration de la collecte de données dans la documentation de l’extension de balise Web SDK.