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 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ètreDescriptionDétailFormat / Exemple
at_medium
(obligatoire)
Medium de la campagneValeur attendue :
at_medium=mymediumvalue
at_campaign
(obligatoire)
Libellé de la campagneValeur attendue :
at_campaign=mycampaign
at_*Propriétés personnalisées de votre campagneTout 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éTypeExemple
at_creationStringat_creation=Main
at_variantStringat_variant=Blue
at_formatStringat_format=440x300
at_typeStringat_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