Création d'une variable
Accueil et données générales
Une fois dans l’environnement Variables de Data Manager vous allez pouvoir commencer à créer votre configuration. Les variables permettent de récupérer des informations depuis une source de données (hit, URL, etc.). Des traitements peuvent être effectués sur ces variables (découper, supprimer, ajouter une chaine, etc.). Elles pourront être utilisées par la suite pour modifier les données remontées du marquage ou en exclure une partie.
Type de variables
Pour chaque variable créée il est nécessaire de choisir s’il s’agit d’une variable alphanumérique ou numérique.
Il est important de choisir le bon type dès la création, en effet, lorsque vous utilisez une variable simple dans une variable conditionnée, des traitements spécifiques au type seront accessibles. Par exemple, vous pourrez utiliser des filtres numériques (supérieur à, inférieur à etc.) pour les variables typées en numérique.
Statut
Une fois une variable créée, il est nécessaire de lui donner un statut. Il en existe quatre qui ont chacun un fonctionnement différent.
Une variable avec le statut « En développement » est en cours de création. Elle est toujours modifiable et vous pouvez l’utiliser pour tester des traitements. Il s’agit du seul statut vous permettant d’apporter des modifications.
Le statut « Pré-production » correspond aux variables que vous avez testé et que vous souhaitez passer en production. Il s’agit d’un statut généralement temporaire.
Le statut « En production » correspond aux variables actuellement actives sur votre site.
Le dernier statut, « A supprimer », permet de vous débarrasser complètement d’une variable qui après les tests ne vous a pas apporté satisfaction. Si la variable était « En développement » elle serait supprimée. Si elle était« En production », cela nécessiterait une nouvelle mise en production pour réellement la supprimer.
Dossier et informations supplémentaires
Vous pouvez utiliser des dossiers dans Data Manager pour vous aider à organiser vos variables.
Via le menu de gauche vous pouvez retrouver la liste de vos dossiers. En cliquant sur l’un d’entre eux vous pourrez filtrer vos variables pour n’afficher que celle de ce dossier. Il est aussi possible de créer un dossier via le bouton « Nouveau dossier ».
Pour placer une variable dans un dossier vous pouvez la glisser-déposer dans le dossier ou déplier les informations d’une variable (en cliquant sur son nom ou sur l’engrenage en bout de ligne) et choisir un dossier dans le menu déroulant correspondant. A noter qu’une variable ne peut être présente que dans un dossier.
Variable simple
Une variable simple permet de récupérer des informations depuis une source de données (hit, URL, etc.). Des traitements simples peuvent être effectués sur ces variables (découper, supprimer, ajouter une chaine, etc.).
La création d’une variable s’effectue en deux étapes. Il faut tout d’abord choisir sa source pour identifier sur quoi elle se basera. Il est ensuite possible d’ajouter des traitements pour la personnaliser (ajout ou suppression de caractères par exemple).
Choix de la source
Afin qu’une variable soit utilisable il faut spécifier sur quelle source de donnée elle se base. Il en existe six différentes.
La source Hits, correspond aux données envoyées par le tag Piano Ananlytics depuis un site. Pour comprendre comment un hit est formaté, vous pouvez accéder à notre documentation en ligne et plus précisément à l’article « Construire votre hit » : https://developers.atinternet-solutions.com/generalites/construire-votre-hit/
Prenons un hit en exemple : https://logs.xiti.com/hit.xiti?&p=maison::electromenager::cuisine::page_cuisson&s2=45
Si je désire créer une variable sur le nom de la page, je dois donc récupérer le paramètre p comme précisé dans la documentation. Pour ceci, dans Data Manager, après avoir sélectionné la source de données Hits, il faudra dans le menu déroulant sélectionner le paramètre.
Astuce : Le menu déroulant contient uniquement les paramètres que nous avons déjà reçu et processé une fois. Si vous ne trouvez pas le paramètre de votre choix, vous pouvez saisir une valeur personnalisée.
La source URL permet de récupérer des informations présentes dans l’URL du site.
La source Query String permet de récupérer les paramètres présents dans la Query String de l’URL d’un site.
Par exemple, pour l’URL suivante : http://www.mysite.com?param=1¶m2=value .
La partie avant le point d’interrogation (en rouge) correspond à l’URL de la page. La partie après le point d’interrogation (en vert) correspond à la Query String.
Si nous souhaitons récupérer la valeur de param2 il faudra la renseigner dans la première étape qui est la sélection du paramètre.
La source Referrer permet de récupérer l’URL de la page précédente.
La source User Agent permet de récupérer le User Agent du navigateur internet utilisé durant la navigation du visiteur.
La source objet personnalisé est une spécificité Piano Ananlytics. Elle permet de récupérer un paramètre particulier du hit : le stc. Ce paramètre vous permet d’envoyer les informations de votre choix sans vous limiter aux formats Piano Ananlytics.
Par exemple, pour l’App Analytics, nous utilisons un objet dédié à ce fonctionnement qui est de la forme suivante : {"lifecycle": {"fs": 0,"fsau": 0,"scsu": 2,"fsdau": 20160120,"dsu": 0,"sc": 5,"fsd": 20160120,"dslu": 0,"dsfs": 0,"sessionId": "e1e04f45-8d54-4e24-81cf-75314a5bcead"}}
Dans ce cas, si nous désirons récupérer le sessionID il faudra renseigner comme paramètre : lifecycle.sessionID
En effet, nous avons dans un premier niveau l’objet lifecycle et dans un second niveau l’objet sessionId. Le point nous permet de spécifier l’arborescence.
Règles de traitement
Une fois la source sélectionnée, nous allons pouvoir commencer à faire des traitements dans notre variable. Il existe cinq catégories de traitement.
Découper et conserver : Ce type de traitement permet de sélectionner une partie de la valeur à traiter et de la conserver.
Prenons un exemple de traitement sur l’URL suivante : http://www.mysite.com/category/subcategory
Nous souhaitons récupérer la catégorie présente dans l’URL. Nous savons que, sur ce site, la catégorie sera toujours au premier niveau après le nom de domaine. Nous pouvons donc nous baser sur le caractère séparateur slash (« / ») pour récupérer l’information souhaitée. En partant du début, le nom de la catégorie sera toujours le quatrième élément.
Astuce : vous pouvez utiliser le bloc Test sur la droite de l’interface pour vérifier que la variable que vous êtes en train de créer récupère la valeur souhaitée. Cette fonctionnalité est disponible quel que soit le statut de la variable, même en statut « En développement » sans l’avoir encore sauvegardée.
Le traitement « Découper et supprimer » fonctionne de la même façon que le traitement précédent mais permet de supprimer un élément non désiré.
Le traitement « Supprimer » permet de spécifier le nombre de caractères que vous désirez supprimer au début ou à la fin d’une chaîne.
Le traitement « Remplacer » vous permet de modifier la valeur que vous récupérez. Vous pouvez par exemple vous en servir pour traduire le nom de certaines pages. Si vous souhaitez remplacer plusieurs valeurs, vous pouvez utiliser une table de correspondance pour plus de facilité.
Le traitement « Ajouter une chaîne » permet quant à lui de pouvoir rajouter des caractères au début ou à la fin des valeurs récupérées.
Variable conditionnée
Une variable conditionnée vous permet de créer des traitements spécifiques à certains cas, en fonction de conditions que vous aurez déclarées. Ces variables se basent sur les variables simples que vous avez préalablement déclarées.
Les conditions
Après avoir créé des variables simples, il peut être nécessaire de créer des variables utilisant des conditions pour répondre à des besoins plus poussés.
Vous pouvez créer 10 conditions et chaque condition peut contenir 5 étapes. Il est important de noter que ces étapes sont vérifiées les unes après les autres.
Vous pouvez aussi utiliser une table de correspondance pour donner une valeur à votre variable. Si la clé n’a pas de correspondance dans la table, vous pouvez choisir de conserver la valeur d’origine de la clé.
Les tests
Tout au long de la création d’une variable, vous pouvez utiliser le panneau de test sur la droite de votre écran.
Il vous permet de vérifier si l’enchaînement des actions définies pour une variable correspond bien aux résultats que vous attendez. Cet outil peut vous permettre de voir où se situe exactement une erreur dans le cas où il y en aurait une.