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.
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.
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.
Vous pouvez définir des props lors de la configuration de l’extension Analytics (variables globales) ou sous des règles.
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.
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";
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.
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.
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.
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.
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";
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.