prop

Cette page d’aide décrit comment implémenter des props. Pour plus d’informations sur le fonctionnement des props en tant que dimension, consultez prop dans le guide d’utilisation Composants.

Les props sont des variables personnalisées que vous pouvez utiliser comme bon vous semble. Elles ne persistent pas au-delà de l’accès défini.

CONSEIL

Dans la plupart des cas, Adobe recommande d’utiliser des eVars. Dans les versions précédentes d’Adobe Analytics, les props et eVars présentaient des avantages et des inconvénients les uns pour les autres. Cependant, l’Adobe a amélioré les eVars dans la mesure où elles répondent désormais à presque tous les cas d’utilisation des props.

Si vous disposez d’un document de conception de solution, vous pouvez attribuer ces dimensions personnalisées aux valeurs propres à votre entreprise. Le nombre de props disponibles dépend de votre contrat avec Adobe. Si le contrat que vous avez conclu avec Adobe le prévoit, vous pouvez obtenir jusqu’à 75 props.

Props utilisant le SDK Web

Les props sont mappées pour Adobe Analytics sous les champs XDM _experience.analytics.customDimensions.props.prop1 à _experience.analytics.customDimensions.props.prop75. Les props de liste sont spécifiées dans un ensemble distinct de champs.

Props utilisant l’extension Adobe Analytics

Vous pouvez définir des props lors de la configuration de l’extension Analytics (variables globales) ou sous des règles.

  1. Connectez-vous à la collecte de données Adobe Experience Platform à l’aide de vos identifiants Adobe ID.
  2. Cliquez sur la propriété de balise de votre choix.
  3. Accédez à l’onglet Règles, puis cliquez sur une règle (ou créez une règle).
  4. Sous Actions, cliquez sur une action existante Adobe Analytics - Définir des variables ou cliquez sur l’icône « + ».
  5. Définissez la variable Extension de la liste déroulante vers Adobe Analytics, et la variable Type d’action to Définition de variables.
  6. Recherchez la section Props.

Vous pouvez définir une prop sur une valeur ou un élément de données. Vous pouvez également copier la valeur d’une autre variable Analytics.

s.prop1 - s.prop75 dans AppMeasurement et l’éditeur de code personnalisé de l’extension Analytics

Chaque variable prop est une chaîne qui contient des valeurs personnalisées propres à votre organisation. Leur longueur maximale est de 100 octets ; les valeurs de plus de 100 octets sont automatiquement tronquées lorsqu’elles sont envoyées à Adobe.

s.prop1 = "Example custom value";

Props de liste

Les props de liste désignent un paramètre appliqué aux props qui permet à la variable de contenir plusieurs valeurs dans le même accès. Si ce paramètre n’est pas activé ou si un délimiteur incorrect est utilisé, la variable est traitée comme une valeur unique.

Configuration des props de liste

Activez les props de liste dans Variables de trafic sous les paramètres de la suite de rapports. Assurez-vous que le délimiteur souhaité est correctement configuré. Adobe ne fournit pas de délimiteur par défaut.

CONSEIL

Les délimiteurs courants utilisés dans les mises en œuvre sont une virgule (,), deux-points (:), un point-virgule (;) ou une barre verticale (|). Vous pouvez utiliser n’importe quel délimiteur ASCII non étendu qui correspond le mieux à votre mise en œuvre.

Définir des props de liste à l’aide du SDK Web

Une fois que vous avez configuré les props de liste dans les paramètres de la suite de rapports avec le délimiteur souhaité, les props de liste sont mappées pour Adobe Analytics sous _experience.analytics.customDimensions.listProps.prop1.values[] à _experience.analytics.customDimensions.listProps.prop75.values[]. Le SDK Web utilise automatiquement le délimiteur correct répertorié sous les paramètres de la suite de rapports. Si vous définissez le délimiteur dans le champ XDM (par exemple, _experience.analytics.customDimensions.props.prop1.delimiter), cela remplace le délimiteur automatiquement récupéré à partir des paramètres de la suite de rapports et peut entraîner une analyse incorrecte de la chaîne de props de liste.

Définir des props de liste à l’aide de l’extension Adobe Analytics et d’AppMeasurement

Une fois que vous avez configuré les props de liste dans les paramètres de la suite de rapports avec le délimiteur souhaité, il n’y a aucune différence de mise en œuvre autre que l’utilisation du délimiteur.

// List prop delimited with a comma
s.prop1 = "value1,value2,value3";
IMPORTANT

Les propriétés de liste sont toujours soumises à la longueur maximale de 100 octets. Les propriétés de liste sont plus faciles à atteindre et à tronquer, puisqu’elles peuvent contenir plusieurs valeurs. Utilisez des abréviations ou des valeurs de raccourcissement si vous pouvez atteindre cette limite de 100 octets.

Si vous définissez la même valeur plusieurs fois dans une prop de liste, elle est dédupliquée dans les rapports. Analysis Workspace comptabilise le nombre d’accès où une valeur est affichée et non le nombre d’occurrences d’une valeur dans les données.

Sur cette page