Propriétés

Définition

 

Définition globale

Une propriété (anciennement dimension) est une valeur qualitative que vous pouvez associer à un évènement. Par exemple dans l'affichage d'une page produit, vous pouvez retrouver en propriété le nom du produit affiché. Cette propriété est associée à votre organisation et sera alimentée en commun par les différents sites la composant.

 

Critères

Libellé

Le libellé qui sera utilisé dans les interfaces d'Analytics Suite pour l'afficher et la sélectionner. 

 

Type

La propriété sera alimentée par vos valeurs.
En fonction du type de valeurs que vous définissez pour la propriété, celle-ci bénéficiera de différents calculs.

Type	Customer Type	Exemple	Exemple affiché	Valeur par défaut	Limite de valeur
STRING	String	"Home"	"Home"	N/A	255
DECIMAL	Decimal	4.5	4.5	x	MIN -1.0E15 / MAX 1.0E15
	Percent	0.12	12%
	Currency	12.73	12.73 €
INTEGER	Integer	12	12	x	int64
	Duration	750	00 : 12 : 30
	DurationMs	145127	145,1 sec
BOOLEAN	Boolean	true / false	icons	N/A
DATE	Date	2019-12-01 00 : 00 : 00	2019-12-01	x
	Time	2019-12-01 12 : 00 : 00	2019-12-01 12 : 00 : 00
	TimeMinute	2019-12-01 12 : 00 : 00	2019-12-01 12 : 00
	TimeHour	2019-12-01 12 : 00 : 00	2019-12-01 12
	TimeMs	2019-12-01 12 : 00 : 00	2019-12-01 12 : 00 : 00.123
ARRAY STRING	String	"Topic 1, Topic 2"	"Topic 1, Topic 2"	N/A	20*255

 

Statut

Votre propriété dispose d'un statut qui va lui impliquer un traitement spécifique.

Etape	Définition	Etat propriété	Requêtable
Hit parameter	Données présentes dans le hit alimentant votre site.	Non déclarée	Non
Tag parameter	Données collectées ou pré-processing AT (ex: géolocalisation) disponible dans les règles.	Non déclarée	Non
Property Draft	Pour valider une propriété, vous devez spécifier tous les champs requis à la propriété sur un draft, il ne pourra être utilisé que dans Data Management.	Non déclarée	Non
Validé	objet qualifié (libellé, description) requêtable par l'API quel que soit son statut, avec un type immutable, property_Key immutable, et une règle de calcul	Déclarée	Oui
Désactivé	Votre propriété n'est plus alimentée, mais son historique est conservé.	Déclarée	Oui (que historique)

 

Property Key

La property key est la clé technique de votre propriété.
Elle est utilisée dans votre marquage et dans l'API de la solution.
La combinaison property.key + property type crée une propriété unique pour votre data model.
La property.key ne peut excéder 40 caractères. 

 

Description

Afin de partager la définition de votre propriété à vos utilisateurs dans les infobulles de la solution, nous proposons une description pour les propriétés standard et custom. Nous vous invitons à compléter cette dernière pour les propriétés custom.
 

Catégorie

Une propriété peut être associée à un ensemble de propriétés basé sur une catégorie.
AT Internet propose des catégories pour les propriétés standards, mais vous pouvez apposer vos propres catégories pour installer vos propres regroupements lors de vos recherches de propriétés.
 

Masquage

Une propriété peut être masquée pour vos utilisateurs dans les interfaces. Ce statut la rendra disponible uniquement dans le Data Model.

 

Traitement

Les valeurs d'une propriété peuvent être définies par 2 traitements différents :

• Calculée : la valeur de la propriété est déduite d'une autre (pas d'aggrégat)
• Processée : la valeur de la propriété est alimentée par le marquage, une règle ou un enrichissement Data Management, ou un enrichissement Piano Analytics/ natif (géolocalisation / technologie)

Seules les propriétés standards peuvent être basées sur le traitement Calculée.

 

Privacy

Si votre propriété contient des données sensibles, vous pouvez cocher la case Privacy flag pour vider les valeurs de la propriété en vous basant sur le visitor privacy mode (exempt/no-consent...) que vous saisissez dans le champ dédié Privacy Mode Anonymisation.

Une fois la propriété Sauvegardée et Deployée, elle et ses règles seront mises à jour avec un premier bloc condition, qui videra la valeur de la propriété en fonction du visitor privacy mode de l'évènement. Ce bloc ne pourra être édité qu'avec la case Privacy flag ou le champ Privacy Mode Anonymisation de l'onglet Configuration de votre propriété.

Plus d'exemples à venir dans le Privacy Centre.

 

Standard & Custom

Piano Analytics propose des propriétés Standard pour toutes ses organisations qui sont associées aux marqueurs de Piano Analytics.
Vous pouvez également créer une propriété qui sera propre à votre organisation.
 

Nombre de propriétés disponibles

Votre organisation vous permet de cumuler un certain nombre de propriétés custom actives dans votre Data Model.
 

Option	500	1000
Activation	Par défaut	Soumis à facturation
Propriétés à portée event	450	900
Propriétés à portée session	50	100
Propriétés sans limites de caractères	15	15

 

Créer une propriété

Pour créer une propriété, vous devez d'abord créer un draft de propriété.
Un draft est un objet qui contient toutes les informations requises pour créer une propriété.
Il ne peut être utilisé que dans Data Management, pour vous aider à préparer votre propriété.

Une fois le draft créé, vous pouvez le valider comme propriété avec le bouton dédié en haut de la page du draft.

Avant validation, vous pouvez éditer la property key et le type de la propriété, qui auront un impact direct sur la règle de la future propriété, la réinitialisant pour conserver seulement le bloc condition Tag Principle.

 

Marquage d'une propriété

Le marquage d'une propriété peut s'effectuer de plusieurs façons :

- En activant une analyse standard, Piano Analytics alimente certaines propriétés et d'autres sont à compléter dans le marquage ex: sales insights

- En activant une analyse personnalisée, vous pouvez utiliser 2 méthodes pour alimenter votre propriété :

• setProp ou setProps
  Vous pouvez ajouter une ou plusieurs propriétés dans votre hit, ces propriétés seront associées à l'ensemble des events présents dans le hit.
  Documentation developpeur
• Préciser la propriété dans votre évènement directement
  Vous pouvez préciser autant de propriétés que nécessaires associées à votre évènement en le spécifiant dans son marquage.
  Documentation développeur

Editer une propriété

Les propriétés custom peuvent être éditées sur différents critères
 

Libellé	Type	Statut	Property Key	Description	Catégories	Masquage
Oui	Oui	Oui	Non	Oui	Oui	Oui
		Ne revient pas du statut Désactivé

Les propriétés standard peuvent également être éditées sur différents critères
 

Libellé	Type	Statut	Property Key	Description	Catégories	Masquage
Non	Non	Non	Non	Non	Oui	Oui
					On ne peut pas éditer celles proposées par Piano Analytics

 

Désactiver une propriété

Vous pouvez désactiver une propriété custom uniquement.
Le statut désactivé vous permet de conserver l'historique de vos données pour cette propriété mais de ne plus alimenter cette propriété.
Ainsi vos documents, appels, seront toujours fonctionnels sur la période précédant le passage en statut désactivé.
Le passage au statut désactivé est définitif, vous ne pouvez pas réactiver une propriété.

Une fois la propriété passée en statut désactivée, elle est toujours visible dans le data model en filtrant sur son statut (décoché par défaut).

 

Règle

Votre propriété peut être retraitée grâce à une règle grâce à différents opérateurs, ce qui peut vous permettre de corriger une erreur de marquage par exemple sans contacter vos équipes techniques.
Certaines propriétés proposées par Piano Analytics ne peuvent être éditées avec des règles, les onglets Rule et Snippet ne sont alors pas affichés.

 

Traitements

Condition (SI)

 

Critères
Cette condition définie automatiquement précise les critères qui vont justifier le traitement particulier de votre propriété.

Catégories de critère :

1. Paramètre du tag
   On peut sélectionner ou renseigner un paramètre de tag à étudier pour vérifier la valeur associée dans l'event en fonction de son type associé.
   Exemple : transaction_firstpurchase mais pas &p=
   
   
2. User Agent
   On peut sélectionner une chaîne de caractères à vérifier correspondant au User Agent associé à l'évènement.
   Exemple :  Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/88.0.4324.150 Safari/537.36
   
   
3. Snippet
   On peut sélectionner une chaîne de caractères à vérifier en valeur de sortie d'un Snippet. Voir plus sur les Snippet.
   
   
4. Event URL
   On peut sélectionner une chaîne de caractères à vérifier dans l'URL depuis laquelle l'évènement est généré. On peut vérifier l'URL complète, le domaine, ou la query string (en précisant le paramètre de query string concerné).
   Exemple : https://www.mysite.com/path/page?article=101&type=202
   URL:  https://www.mysite.com/path/page?article=101&type=202
   Domain:  https://www.mysite.com/
   Query String sur paramètre type: 202
   
   
5. Source URL
   On peut sélectionner une chaîne de caractères à vérifier dans l'URL précédant l'URL depuis laquelle l'évènement est généré. On peut vérifier l'URL complète, le domaine, ou la query string (en précisant le paramètre de query string concerné).
   Exemple : https://www.mysite.com/path/page?article=101&type=202
   URL:  https://www.mysite.com/path/page?article=101&type=202
   Domain:  https://www.mysite.com/
   Query String sur paramètre type: 202

 

Combinaison de critères (ET SI)

Il est possible de cumuler les critères pour vérifier une condition globale en cliquant sur le bouton ET et en complétant les informations du critère.

 

Résultat de condition (ALORS)

Si votre condition est validée, vous pouvez retraiter la valeur de votre propriété avec plusieurs actions.

• Devient vide :
  La valeur associée à la propriété pour l'évènement vérifiant la condition est vide.
  
  
• Définie par : 
  Vous pouvez sélectionner tous les catégories de critères des règles sauf le User Agent pour vérifier une condition pour en extraire la valeur sur l'évènement et l'associée. Vous pouvez également utiliser un Snippet ou définir une valeur fixe en saisissant une nouvelle valeur.
  La valeur (non vide) sélectionnée peut être également retravaillée avec une Action.

 

Actions disponibles :

Action	Option	Détail
Découper et conserver	Depuis le début	Spécifier caractère séparateur et Index
	Depuis la fin	Spécifier caractère séparateur et Index
Découper et supprimer	Premiers éléments	Spécifier caractère séparateur et nombre d'éléments à supprimer
	Derniers éléments	Spécifier caractère séparateur et nombre d'éléments à supprimer
Supprimer	Premiers éléments	Spécifier nombre d'éléments à supprimer
	Derniers éléments	Spécifier nombre d'éléments à supprimer
Conserver	Premiers éléments	Spécifier nombre d'éléments à conserver
	Derniers éléments	Spécifier nombre d'éléments à conserver
Remplacer	Table de correspondance	Spécifier la table correspondance et le comportement par défaut
	Remplacer une chaîne	Spécifier la chaîne à rechercher et la chaîne à remplacer
Editer une chaîne	Passer en majuscule
	Passer en minuscule
	Vider la chaîne
	Concaténer	Spécifier les valeurs concatannées
Convertir	En entier
	En date	Spécifier le format de date
	En boolean
	En décimal	Spécifier le séparateur
Tester une condition	If (else if) / else	Spécifier la condition son action et le cas défaut

 

Bloc condition supplémentaire (SINON SI)

Vous pouvez sélectionner des conditions de traitement pour une règle de propriété en cliquant sur le bouton Ajouter une condition.
Il est à noter que les conditions se vérifient de façon séquentielle, autrement dit si une condition est valide avant un autre bloc, seul le traitement associé à la première condition sera effectué.
 

Cas par défaut (SINON)

Dans le cas où aucune des conditions définies n'est rencontrée, le bloc SINON définie un cas par défaut avec une valeur vide.
 

Compatibility Mode

Définition

Pour les organisations ayant des règles Data Manager ou des éléments personnalisés sur la précédente « Analytics suite », nous avons reproduit ici le traitement de ces règles.
Cette condition est appliquée par défaut en amont de la règle de votre propriété et peut être supprimée si besoin.
Elle reprend le contenu associé à vos éléments personnalisés ou vos règles Data Manager pour les adapter dans votre traitement.
Si la valeur du mode de compatibilité est enrichie alors elle prévaut, sinon les critères de conditions classiques prennent le relais.

Exemple :
Vous aviez déclaré un indicateur de site x1 nommé Couleur, pour préciser la couleur de votre produit affiché sur Analytics Suite 2.
Les indicateurs de sites sont devenus des propriétés dans Piano Analytics.
Grâce au compatibility mode, nous vérifions si vous envoyez un x1 dans le hit, récupérons sa valeur et l'associons à la propriété Couleur en amont des règles depuis le bloc Compatibility mode. Le cas échéant nous proposons de récupérer le paramètre du tag correspondant à Analytics Suite Delta (couleur), et en cas d'échec complet laissons la valeur de la propriété vide.
 

Table de référence
Afin de voir rapidement la conversion de votre élément personnalisé (indicateurs de sites, indicateurs de page ou source marketing personnalisée) en propriété, nous vous précisons le paramètre alimentant le Compatibility mode dans l'onglet Table de référence.

Suppression
La suppression du bloc Compatibility mode est définitive, en le supprimant vous ne pourrez vous appuyer que sur les traitements d'Analytics Suite Delta, et cela pour tous les sites de l'orga.

Déplacer un bloc condition

Vous pouvez déplacer un bloc condition en cliquant sur les flèches dans le coin supérieur droit de chaque bloc condition pour changer l'ordre de vérification. Les blocs Compatibility mode et Privacy ne peuvent être déplacés.

Application de la règle

L'application de la règle se traduit en 3 scopes distincts.
La mise en production sur un des scopes sera effectuée d'ici 20 minutes maximum après le clic sur Sauvegarder et Déployer.
 

Règle par défaut

Piano Analytics vous propose une règle par défaut appliquée à toute l'organisation que vous pouvez éditer si besoin.
Vous pouvez créer des exceptions à cette règle en cliquant sur le bouton Nouvelle règle.
Les sites virtuels ne subissent pas le traitement de la règle par défaut.
 

Site

Vous pouvez sélectionner un site et faire une exception à la règle appliquée à l'organisation.
Ce site ne pourra avoir qu'une seule règle pour cette propriété.
Vous ne pouvez pas sélectionner de site virtuel (icône nuage barré et site grisé).

Groupe de sites

Dès lors que vous souhaitez appliquer une même règle à plusieurs, vous devez créer un groupe de vos sites pour appliquer cette règle.
 

Copier la règle par défaut de l'organisation

Vous pouvez cocher la case Copier la règle par défaut de l'organisation pour reprendre les composants de la règle proposée par Piano Analytics.
Ainsi l'édition spécifique sur un sous périmètre de l'organisation est facilitée.

Snippet

Définition

Un snippet est un ensemble de traitements appliqués sur un paramètre du tag. La valeur issue du snippet peut ensuite être reprise dans une règle pour ne pas saisir manuellement le même retraitement dans plusieurs critères, cela peut aussi permettre de simplifier la lecture de la règle. En vous rendant dans l'onglet Snippet depuis une propriété vous pouvez retrouver tous les snippets réalisés sur votre propriété. Une propriété peut faire appel à autant de Snippets que nécessaire.

 

Création

Depuis l'onglet Snippet de votre propriété vous pouvez créer un snippet en cliquant sur le bouton dédié. Le processus se compose de plusieurs étapes :

1. Nommage du snippet et sélection du type de sortie du snippet (type de valeur)

2. Sélection de la source de données

3. Sélection des actions à appliquer à votre donnée

4. Sauvegarde et déploiement

Une fois le Snippet enregistré il vous faudra ensuite l'utiliser dans vos critères pour qu'il soit véritablement déployé. 

 

Utilisation

Vous pouvez utiliser un snippet sauvegardé pour votre propriété en le sélectionnant dans une condition en précisant le critère snippet puis le snippet concerné. Ainsi vous conditionnerez une action en vous basant sur la valeur issue de votre snippet.

 

Suppression

Vous pouvez supprimer un snippet à tout moment de votre propriété.
Pour se faire vous devrez le retirer de votre règle en vérifiant les critères de vos conditions, et ensuite cliquer sur l'icône corbeille dans la liste de l'onglet Snippet. Cette modification ne sera effective qu'après avoir Sauvegardé et Déployé la règle sans Snippet.

S'il est en cours d'utilisation dans votre règle, votre snippet ne pourra être supprimé.

 

Testeurs

Avant de sauvegarder les règles de votre propriété, vous pouvez les tester en vous appuyant sur les panneaux dédiés.

 

Test

Cette interface reprend les conditions et traitements appliqués dans vos règles pour vérifier la donnée de sortie dans les différents cas (output).
Les critères utilisés dans vos conditions étant repris, vous n'avez plus qu'à compléter la valeur associée à tester.
Vous pouvez également ajouter des paramètres complémentaires si nécessaire en cliquant sur le bouton prévu à cet effet.

Il vous est également possible de renseigner un site pour vérifier toute différence de traitement d'un site à l'autre.

 

Test Hit

Un autre onglet en dessous du premier, vous permet de renseigner un hit pour vérifier son interprétation par la règle de la propriété. Ainsi, vous pouvez vérifier les données que votre marquage transmet directement, et ce quel que soit le type de marquage employé.