Developers » Piano Analytics Tagging » Marquer des événements » Gestion des campagnes marketing
Gestion des campagnes marketing
Avant-propos
Avant de commencer l’implémentation du plugin Campaigns, veuillez-vous assurer d’avoir initialisé le Tracker JavaScript AT Internet et sélectionné le plugin depuis l’interface Tag Composer. Ces paramètres de campagne sont compatibles avec toutes les versions de SmartTag JavaScript depuis la version 5.29.0.
Principe
Le plugin Campaigns vous permet de marquer vos différents types de campagnes (publicité, affiliation, liens sponsorisés, email marketing).
Paramétrage du plugin
Le plugin doit être configuré depuis l’interface Tag Composer. Plusieurs options sont disponibles:
- domainAttribution : fait de lier la mesure à un domaine ou un numéro de site (true: domaine courant, false: numéro de site ; true par défaut).
- lifetime : durée de conservation des donnéeas d’une campagne publicitaire en jours (30 jours par défaut).
- visitLifetime : durée de la visite en minutes (30 min par défaut).
- redirectionLifetime : durée de conservation des données sur une page de redirection en secondes (30 sec par défaut).
- lastPersistence : priorité de rémanence (true: première, false: dernière ; false par défaut).
- enableUTMTracking: récupération automatique des paramètres de campagne UTM (true par défaut).
Marquage
Le plugin Campaigns traite les données relatives aux campagnes marketing de façon automatique lors de l’utilisation d’un marqueur d’évènement (Event).
Mesure de liens
Le contenu des paramètres de campagne devra être communiqué dans l’URL de destination selon le format at_medium=email&at_campaign=new_offer
où at_medium
est le libellé de la source et at_campaign
est le libellé de la campagne. Ces paramètres sont tous deux obligatoires à minima pour que la campagne soit prise en compte dans vos analyses.
Ajouter les paramètres de campagne dans les liens pointant sur votre site :
- Si le lien dirige vers la racine du site ou d’un répertoire :
https://www.site.com/?at_medium=email&at_campaign=new_offer...
- Si le lien dirige vers un fichier sans variable transmise :
https://www.site.com/index.php?at_medium=email&at_campaign=new_offer...
Si le lien dirige vers un fichier avec variable transmise :
https://www.site.com/index.php?other_variable=2&at_medium=email&at_campaign=new_offer...
Le caractère « ? » (ou « & », en fonction de la position de la variable) peut être remplacé par le caractère « # » .
Format de campagne
Paramètre | Description | Détail | Format / Exemple |
---|---|---|---|
at_medium (obligatoire) | Medium de la campagne | Valeur attendue : at_medium=mymediumvalue | |
at_campaign (obligatoire) | Libellé de la campagne | Valeur attendue : at_campaign=mycampaign | |
at_* | Propriétés personnalisées de votre campagne | Tout paramètre de querystring débutant par at_ sera considéré comme paramètre de campagne, et sera traduit dans une propriété src_ . Il vous sera peut-être nécessaire de créer cette propriété src_* dans votre data model. | Valeur attendue : at_creation=myvalue |
Exemple complet :
https://www.site.com/?at_medium=mymedium&at_campaign=mycampaign&at_myproperty=myvalue&at_myotherproperty=myothervalue
Cela se traduira par les propriétés suivantes :
src_medium
:mymedium
src_campaign
:mycampaign
src_myproperty
:myvalue
src_myotherproperty
:myothervalue
Il vous est aussi possible d’associer à vos campagnes des propriétés standards du modèle de données :
Propriété | Type | Exemple |
at_creation | String | at_creation=Main |
at_variant | String | at_variant=Blue |
at_format | String | at_format=440x300 |
at_type | String | at_type=Direct |
Forcer la campagne depuis le marquage
Il est possible de forcer la campagne avec des paramètres de campagne directement depuis le marquage, en ajoutant la propriété forcedCampaignV2 au contexte du Tracker :
var config = {}; var context = { forcedCampaignV2: { medium: 'email', campaign: 'new offer', creation: 'Main', variant: 'Blue', format: '440x300', type: 'Direct', custom_prop: 'my value' // src_custom_prop must be declared in your data model } }; var tag = new ATInternet.Tracker.Tag(config, context);
Mesure d’ouverture d’email
Afin de mesurer les ouverture email en marquage Piano Analytics, il est nécessaire de construire un événement brut, inséré dans l’email avec une balise <img>
.
Nom d’événement : email.display.offsite
Exemple:
// Raw event https://<collection-domain>/event?s=<site-id>&events=[{"name":"email.display.offsite","data":{"src_medium":"email","src_campaign":"email campaign"}}] // Embedded <img src="https://<collection-domain>/event?s=<site-id>&events=%5B%7B%22name%22%3A%22email.display.offsite%22%2C%22data%22%3A%7B%22src_medium%22%3A%22email%22%2C%22src_campaign%22%3A%22email%20campaign%22%7D%7D%5D">
Forcer la source marketing d’une visite
Il est possible de forcer la source marketing d’une visite même si une différente a déjà été renseignée sur des events précédents.
Pour cela, vous devez renseigner la propriété src_force
(boolean) à true
:
var tag = new ATInternet.Tracker.Tag(); tag.events.send('page.display', { 'page': 'page name', 'page_chapter1': 'chapter 1', 'page_chapter2': 'chapter 2', 'page_chapter3': 'chapter 3', 'src_medium': 'email', 'src_campaign': 'launching', 'src_force': true } );
Si plusieurs sources sont forcées au cours d’une visite, la dernière renseignée sera celle qui sera conservée.
La source forcée est prise en compte à partir du lendemain. Les fonctionnalités en temps réel (exports granulaires Data Query, ou Data Flow) se basent toujours sur la détection classique des sources.
Homogénéisation du marquage AS2 et Piano Analytics
Si vous marquez via des méthodes “AS2 Tagging” et “Piano Analytics Tagging” combinées, et que vous devez conserver le même medium pendant votre transition, veuillez utiliser les codes medium AS2 (voir l’article AS2), en complément d’une règle Data Manager. Plus d’informations sur notre Help Center.
Dernière mise à jour : 04/04/2022