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.
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 aux variables suivantes :
- Objet XDM :
xdm._experience.analytics.customDimensions.props.prop1-xdm._experience.analytics.customDimensions.props.prop75- Les props de liste sont spécifiées dans un ensemble distinct de champs. - Objet de données :
data.__adobe.analytics.prop1-data.__adobe.analytics.prop75; oudata.__adobe.analytics.c1-data.__adobe.analytics.c75- Les props de liste sont incluses dans ces 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.
- Connectez-vous à la collecte de données Adobe Experience Platform à l’aide de vos identifiants Adobe ID.
- Cliquez sur la propriété de balise de votre choix.
- Accédez à l’onglet Règles, puis cliquez sur une règle (ou créez une règle).
- Sous Actions, cliquez sur une action existante Adobe Analytics - Définir des variables ou cliquez sur l’icône « + ».
- Définissez la liste déroulante Extension sur Adobe Analytics et le Type d’action sur Définir des variables.
- 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.
,), 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 list-props-web-sdk
Si vous utilisez l’ objet XDM, les props de liste sont mappées à xdm._experience.analytics.customDimensions.listProps.prop1.values[] - xdm._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, xdm._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.
Si vous utilisez l’ objet de données, les props de liste utilisent les mêmes champs que les props standard et suivent la syntaxe de l’AppMeasurement.
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";
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.