contextData

Les variables de données contextuelles vous permettent de définir des variables personnalisées sur chaque page que les règles de traitement peuvent lire. Au lieu d’affecter explicitement des valeurs aux variables Analytics dans votre code, vous pouvez envoyer des données dans des variables de données contextuelles. Les règles de traitement prennent ensuite les valeurs des variables de données contextuelles et les transfèrent dans les variables Analytics respectives. Voir Règles de traitement dans le guide d’utilisation destiné à l’administrateur.

Les variables de données contextuelles permettent aux équipes de développement de collecter des données dans des éléments nommés plutôt que dans des variables numérotées. Par exemple, au lieu de demander aux équipes de développement d’affecter l’auteur de la page à eVar10, vous pouvez demander à ce qu’elles l’affectent à s.contextData["author"] à la place. Un administrateur Analytics de votre entreprise peut alors créer des règles de traitement pour mapper des variables de données contextuelles dans des variables d’analyse pour la création de rapports. En fin de compte, les équipes de développement se soucient uniquement des variables de données contextuelles au lieu des nombreuses variables de page qui Adobe les offres.

Variables de données contextuelles utilisant le SDK Web

Si vous utilisez l’ objet XDM, tous les champs qui ne correspondent pas à une variable Adobe Analytics sont automatiquement inclus en tant que variable de données contextuelles. Vous pouvez également définir explicitement les données contextuelles à l’aide de l’objet XDM. Vous pouvez ensuite utiliser les règles de traitement pour affecter la variable de données contextuelles à la variable Analytics souhaitée. Pour plus d’informations, voir Mappage d’autres champs XDM avec des variables Analytics .

Si vous utilisez l’ objet de données, toutes les variables de données contextuelles résident dans data.__adobe.analytics.contextData en tant que paires clé-valeur :

alloy("sendEvent", {
  "data": {
    "__adobe": {
      "analytics": {
        "contextData": {
          "example_variable": "Example value",
          "second_example": "Another value"
        }
      }
    }
  }
});

L’interface Règles de traitement affiche c.example_variable et c.second_example dans les menus déroulants applicables.

Variables de données contextuelles utilisant l’extension Adobe Analytics

La collecte de données Adobe Experience Platform ne dispose pas d’un emplacement dédié pour la définition des variables de données contextuelles. Utilisez l’éditeur de code personnalisé, en respectant la syntaxe AppMeasurement.

s.contextData dans AppMeasurement et l’éditeur de code personnalisé de l’extension Analytics

La variable s.contextData ne prend pas directement une valeur. Définissez plutôt les propriétés de cette variable sur une chaîne.

// Assign the example_variable property a value
s.contextData["example_variable"] = "Example value";

Utiliser des règles de traitement pour renseigner les variables d’analyse

Les règles de traitement prennent immédiatement effet une fois enregistrées. Elles ne s’appliquent pas aux données historiques.

Envoyer des données contextuelles dans un appel de suivi de lien

Incluez la variable de données contextuelles comme propriété de contextData dans s.linkTrackVars :

s.contextData["example_variable"] = "Example value";
s.linkTrackVars = "contextData.example_variable";
s.tl(true,"o","Example context data link");

Incrémentation des événements à l’aide de variables de données contextuelles

Lors de la création de règles de traitement, vous pouvez affecter des variables de données contextuelles à des événements.

// Assigning this context data variable to an event increments it by one
s.contextData["example_text"] = "Text value";

// Assigning this context data variable to an event increments it by four
s.contextData["example_number"] = "4";