Les campagnes marketing peuvent être suivies chez Piano grâce à un marquage spécifique. Cet article a pour objectif de clarifier les possibilités de tracking offertes par Piano pour suivre des campagnes marketing.
Pré-requis
Afin qu'une campagne marketing soit prise en compte sur Piano Analytics, il est nécessaire d'alimenter, a minima, les propriétés src_medium (Source et Campagne - Type) et src_campaign (Campagne - Nom).
Marquage d'une campagne marketing
SDK Piano Analytics
Comme l'explique la documentation technique des SDK Piano Analytics, tout paramètre d'URL préfixé par at_ sera interprété comme un paramètre de campagne, et transformé par le SDK en une propriété src_ au sein des événements.
Par exemple, avec l'URL suivante :
https://www.site.com/?at_medium=MaSource&at_campaign=MaCampagne&at_myproperty=MaValeur&at_myotherproperty=MonAutreValeur
Vous retrouverez les couples propriétés/valeurs suivants dans vos événements :
- src_medium = MaSource
- src_campaign = MaCampagne
- src_myproperty = MaValeur
- src_myotherproperty = MonAutreValeur
Attention, il sera nécessaire de déclarer les paramètres personnalisés (ici, src_myproperty et src_myotherproperty) au sein de votre Data Model, et le préfixe "src_" est requis.
Concernant le cas d'applications mobiles, vous devrez alimenter vous-même les propriétés (commençant par src_) depuis le marquage, comme dans cet exemple de code.
SmartTag
Il existe deux versions du marqueur pour suivre des campagnes marketing. Nous conseillons de disposer d'une version du SmartTag supérieure à la 5.17.0 pour utiliser le modèle de campagne le plus récent, car le SDK Piano Analytics n'interprète pas l'ancienne version de nos campagnes, ce qui vous obligerait à retravailler vos liens le jour où vous souhaiteriez mettre à jour le marquage de votre site.
La documentation technique du suivi de ces campagnes se compose en deux parties : les paramètres de campagnes natifs, et les campagnes entièrement personnalisées.
Paramètres natifs
Dans le cas des paramètres de campagnes natifs, vous retrouverez des paramètres propres à chaque type de campagne. Ces paramètres sont automatiquement traduits au bon format dans les hits, grâce à la valeur renseignée dans at_medium.
Par exemple, avec le lien suivant :
www.site.com?at_medium=sl&at_campaign=MaCampagne&at_platform=google
La valeur de at_medium (sl) est reconnue automatiquement par le SmartTag, qui formatera les informations de campagne correctement dans le hit, tel que :
xto = sec-[MaCampagne]-goo
Les règles de processing natives à la propriété src_medium (qui récupère la valeur poussée dans at_medium) permettent également d'effectuer cette traduction, dans le cas où vous pousseriez les informations de campagnes vous-même depuis le tag :
Campagnes entièrement personnalisées
Il est aussi possible de pousser une campagne complètement personnalisée, c'est-à-dire avec la valeur de votre choix au sein de at_medium et des paramètres d'URL supplémentaires. Pour cela, il vous suffit de disposer du SmartTag à la version 5.29.0 ou supérieure, et de renseigner les valeurs de votre choix dans chaque paramètre.
Par exemple, avec l'URL suivante :
https://www.site.com/?at_medium=MaSource&at_campaign=MaCampagne&at_myproperty=MaValeur&at_myotherproperty=MonAutreValeur
Vous retrouverez les couples propriétés/valeurs suivants dans vos événements :
- src_medium = MaSource
- src_campaign = MaCampagne
- src_myproperty = MaValeur
- src_myotherproperty = MonAutreValeur
Attention, il sera nécessaire de déclarer les paramètres personnalisés (ici, src_myproperty et src_myotherproperty) au sein de votre Data Model, et le préfixe "src_" est requis.