Dans le cas où votre site utilise le SDK Piano Analytics, nous vous invitons à vous référer à la documentation ci-dessous : UTM Management
Le SDK permet de prendre en compte les UTM via la déclaration des préfixes de campagne et la création de propriétés personnalisées sans ajout de règles de processing.
Portées de propriétés
Définition :
La portée d'une propriété désigne l'application de la valeur de la propriété aux évènements d'une visite.
On distingue 2 types de portées de propriétés : la portée évènement et la portée visite.
Portée Evenement :
Définition :
La valeur de la propriété n'est associée qu'à l'évènement qui a remonté cette propriété.
On récupère la valeur de la propriété pour l'évènement auquel elle est associée dans le hit et l'associe à l'évènement dans les données.
Exemple :
La propriété URL Event (event_url) est alimentée par l'URL qui a généré l'évènement.
Si au cours de sa visite, l'utilisateur change d'URL, alors la visite aura plusieurs valeurs pour cette propriété.
Portée Visite :
Définition :
La valeur de la propriété est associée à tous les évènements qui composent la visite. On récupère la valeur associée à un premier affichage de page.
Exemple :
La propriété Source (src) est alimentée par la valeur associée à un premier chargement de page, tous les évènements qui suivent dans la visite seront associés à cette valeur.
Propriétés dédiées aux UTMs
Mise en place :
Vous pouvez utiliser des propriétés à portée évènement pour mesurer toutes les campagnes rencontrées au cours de la visite.
Pour cela, il vous suffit de vous rendre dans Data Management > Propriétés, vérifier si le filtre de visibilité inclu les propriétés masquées, puis de consulter les pages des propriétés à portée event ci-dessous pour décocher la case "Masquer la propriété" et enfin cliquer sur Sauvegarder et Déployer.
Liste des propriétés disponibles :
- utm_campaign
- utm_content
- utm_medium
- utm_source
- utm_term
Processing des propriétés :
Chaque propriété est alimentée avec la règle suivante :
- Vérification d'une alimentation du paramètre de tag utm_xxx
- Si OUI alors la propriété est alimentée par la valeur
- Si NON alors on vérifie la présence d'utm_xxx dans la Query String de l'event
- Si OUI la propriété est alimentée par la valeur
- Si NON alors la propriété est vide
Propriétés de sources
Utilisation :
L'utilisateur peut également choisir d'inclure ses UTMs dans les propriétés de sources qui ont une portée visite.
Exemple :
Dans le cas d'une visite ayant pour source une campagne UTM, en utilisant une propriété de source, vous apposez les informations de source à tous les évènements de la visite. Ainsi si la visite envoie un premier événement avec la campagne, puis un second sans cette campagne, vos obtiendrez une source campagne pour le second événement tout comme le premier.
Mise en place :
Nous vous recommandons les propriétés suivantes avec les property key suivantes :
| Paramètre de Tag | Propriété | Actions |
| utm_campaign | src_campaign | Editer la règle de la propriété |
| utm_content | src_utm_content | Créer la propriété et éditer sa règle |
| utm_medium | src_medium | Editer la règle de la propriété |
| utm_source | src_campaign_group | Editer la règle de la propriété |
| utm_term | src_utm_term | Créer la propriété et éditer sa règle |
Pour chaque propriété vous devrez définir la règle en suivant ce principe ↓
Exemple pour la propriété "src_medium" dans laquelle on souhaite intégrer les utm_medium :
Bloc condition 1 / Vérifier le paramètre de tag natif
SI src_medium (paramètre de tag) n'est pas vide
ALORS la propriété src_medium prends la valeur du paramètre de tag src_medium
Bloc condition 2 / Vérifier le paramètre de tag de l'utm
SINON SI utm_medium (paramètre de tag) n'est pas vide
ALORS la propriété src_medium prends la valeur du paramètre de tag utm_medium
Bloc condition 3 / Vérifier la présence d'UTM dans la Query String de l'URL de l'évènement
SINON SI utm_medium (URL de l'évènement > Query String) n'est pas vide
ALORS la propriété src_medium prends la valeur du paramètre de Query String utm_medium de l'URL de l'évènement
Bloc condition 4 / Default case
SINON la propriété est vide