Campagnes marketing v2

 

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.17.0. Afin de vous assurer de la bonne mesure de la campagne, il est également nécessaire de vérifier que la campagne est bien déclarée dans l’interface Configuration > Campagnes marketing.

 

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. Cinq paramètres doivent être renseignés :

  • 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 de page ou d’un marqueur d’évènement.

var tag = new ATInternet.Tracker.Tag();
tag.page.set({
	name:'pageName'
});
tag.events.add('myEvent', {
        'data': 'myData'
});
tag.dispatch();

Les informations collectées sont ajoutées aux hits de page et d’évènement. 

 

Mesure de liens

Cette méthode considère comme clic toute URL contenant les paramètres de campagne minimum requis.

A chaque campagne créée, est associé un identifiant qu’il faudra transmettre avec sa source dans l’URL qui pointe vers votre site.

Le contenu des paramètres de campagne devra être communiqué dans l’URL de destination selon le format « at_medium=sl&at_campaign=12 » at_medium est le préfixe définissant la source et at_campaign est l’identifiant de campagne. Ces paramètres sont tous deux obligatoires à minima pour être mesurés 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=sl&at_campaign=12...
  • Si le lien dirige vers un fichier sans variable transmise :

https://www.site.com/index.php#at_medium=sl&at_campaign=12...
  • Si le lien dirige vers un fichier avec variable transmise :

https://www.site.com/index.php?other_variable=2#at_medium=sl&at_campaign=12...

– L’utilisation de # permet de ne pas référencer les paramètres de campagne dans les moteurs de recherche.
– Si vous utilisez un outil qui ne gère pas les caractères « # », vous devez les remplacer par « ? » (ou « & », en fonction de la position de la variable).

 

Structure des paramètres de campagne

Une interface est accessible via notre marketplace si vous désirez simplifier le marquage de vos liens sans avoir besoin de connaître la signification de chaque champ. Veuillez noter que l 'interface a été créé par notre communauté et peut être améliorée, n 'hésitez pas à nous envoyer tous vos retours !

Les valeurs renseignées pour chacun des paramètres de campagne doivent être exclusivement spécifiées au format string alphanumérique.

 

Liens sponsorisés

ParamètresDescriptionDétailsFormats / Exemples
at_medium
(obligatoire)
Medium de la campagneLiens sponsorisés : slValeur attendue :
at_medium=sl
at_campaign
(obligatoire)
ID/Libellé de la campagneValeur de l 'identifiant de campagne (donné par AT Internet)ID :
at_campaign=12
Libellé :
at_campaign=my_campaign
at_platformPlateformeUniquement si votre campagne est distincte selon chaque plateforme. Les plateformes supportées aujourd’hui sont retranscrites ici sous ce même format: google, yahoo, miva, orange, msn, mirago, sklik, adfox, etarget, yandex, ebay, searchalliance, bing, naver, baidu, qwant, waze, amazon.Valeur attendue :
at_platform=google
at_creationGroupe d’annonceCorrespondant à votre stratégie de communication sur la plateforme.Libellé :
at_creation=my_adgroup
at_variantVariante de l’annonceEn saisissant exactement {creative} sur Google, Google placera un ID de variante unique qui pourra être réutilisée dans les analyses. La variante dépend d 'un groupe d 'annonces, elle ne sera pas prise en compte si ce dernier est erroné ou manquant.Libellé :
at_variant=my_variant
at_networkRéseauxSelon que la provenance vient du résultat de recherche (search) ou des publicités sur les réseaux de contenus (content).Valeur attendue :
at_network=search
at_termMot-clé achetéMot clé précis acheté. En saisissant exactement {keyword} pour une campagne sur Google, Google place automatiquement le mot clé précis acheté (qui peut légèrement différer du mot clé saisi). Le principe est similaire pour Yahoo ({YSMKEY})Libellé :
at_term=my_term

Exemple complet :

https://www.site.com/?at_medium=sl&at_campaign=12&at_platform=google&at_creation=my_adgroup&at_variant=my_variant&at_network=search&at_term=my_term 
 

Email marketing

ParamètresDescriptionDétailsFormats / Exemples
at_medium
(obligatoire)
Medium de la campagneCampagne email marketing : emailValeur attendue :
at_medium=email
at_emailtype
(obligatoire)
Type d’emailLes campagnes e-mail peuvent être réparties en 3 types exclusifs et distincts : acquisition, retention, promotion.Valeur attendue :
at_emailtype=acquisition
at_campaign
(obligatoire)
ID/Libellé de la campagneValeur de l 'identifiant de campagne (donné par AT Internet)ID :
at_campaign=12
Libellé :
at_campaign=my_campaign
at_creation CréationCorrespond au modèle d’e-mail envoyé dans la campagne (Bon à tirer).
(Requis pour l’analyse de Liens cliqués).
Libellé :
at_creation=my_creation
at_send_dateDate d’envoiLa date à laquelle la campagne a été transmise par le routeur e-mailing.Date (YYYYMMDD) :
at_send_date=20190401
at_link Lien cliquéA personnaliser entre chacun des liens de l’email pour identifier quel lien a été cliqué (doit être envoyé avec at_creation).Libellé :
at_link=cta_button
at_recipient_id Identifiant du destinataireCorrespond à l’identifiant numérique de votre destinataire dans votre base de destinataire.ID :
at_recipient_id=5336
at_recipient_list Liste du destinataireCorrespond à la liste utilisée pour envoyer le message à une sélection de destinataires.ID :
at_recipient_list=2

Exemple complet :

https://www.site.com/?at_medium=email&at_emailtype=acquisition&at_campaign=12&at_creation=my_creation&at_send_date=20190401&at_link=cta_button&at_recipient_id=5336&at_recipient_list=2
 
Ouverture d’emails

Afin de suivre l’ouverture d’emails en marquage AS2, il est nécessaire d’utiliser le format des campagnes v1.

 

Publicités

ParamètresDescriptionDétailsFormats / Exemples
at_medium
(obligatoire)
Medium de la campagneCampagne affichage publicitaire : displayValeur attendue :
at_medium=display
at_campaign
(obligatoire)
ID/Libellé de la campagneValeur de l 'identifiant de campagne (donné par AT Internet)ID :
at_campaign=12
Libellé :
at_campaign=my_campaign
at_creationCréationCorrespond au modèle d’affichage publicitaire envoyé dans la campagne (Bon à tirer).Libellé :
at_creation=my_creation
at_variantVarianteLa version de la création affichée sur le réseau publicitaire. Nécessite une valeur pour at_creationLibellé :
at_variant=my_variant
at_formatFormatLes dimensions de l’affichage publicitaire utilisé.Libellé :
at_format=468
at_channelCanalLe réseau de distribution des affichages.Libellé :
at_channel=my_channel
at_general_placementPlacement généralL’emplacement principal de l’affiche publicitaire.Libellé :
at_general_placement=home
at_detail_placementPlacement détailléL’emplacement spécifique de l’affiche publicitaire.Libellé :
at_detail_placement=sidebar

Exemple complet :

https://www.site.com/?at_medium=display&at_campaign=12&at_creation=my_creation&at_variant=my_variant&at_format=468&at_channel=my_channel&at_general_placement=home&at_detail_placement=sidebar
 

Affiliation

ParamètresDescriptionDétailsFormats / Exemples
at_medium
(obligatoire)
Medium de la campagneCampagne d’affiliation : affiliateValeur attendue :
at_medium=affiliate
at_campaign
(obligatoire)
ID/Libellé de la campagneValeur de l 'identifiant de campagne (donné par AT Internet)ID :
at_campaign=12
Libellé :
at_campaign=my_campaign
at_typeType d’affiliéEn fonction de la relation d’affiliation.Libellé :
at_type=affiliate_type
at_identifierIdentifiant de l’affiliéCorrespondant à celui utilisé dans votre liste d’affiliés.ID :
at_identifier=3591
at_formatFormatLes dimensions de l’affichage publicitaire utilisé.Libellé :
at_format=banner
at_creation=my_creationCréationCorrespond au modèle d’affichage publicitaire envoyé dans la campagne (Bon à tirer).Libellé :
at_creation=my_creation
at_variantVariante La version de la création affichée sur le réseau publicitaire.Libellé :
at_variant=my_variant

Exemple complet :

https://www.site.com/?at_medium=affiliate&at_campaign=12&at_type=affiliate_type&at_identifier=3591&at_format=banner&at_creation=my_creation&at_variant=my_variant
 

Sources marketing personnalisées

ParamètresDescriptionDétailsFormats / Exemples
at_medium
(obligatoire)
Medium de la campagneCampagne affichage publicitaire : displayValeur attendue :
at_medium=custom1
at_campaign
(obligatoire)
ID/Libellé de la campagneValeur de l 'identifiant de campagne (donné par AT Internet)ID :
at_campaign=12
Libellé :
at_campaign=my_campaign
at_custom1Paramètre personnalisé 1Information de votre souhait.Libellé :
at_custom1=var_1
at_custom2Paramètre personnalisé 2Information de votre souhait.Libellé :
at_custom2=var_2
at_custom3Paramètre personnalisé 3Information de votre souhait.Libellé :
at_custom3=var_3
at_custom4Paramètre personnalisé 4Information de votre souhait.Libellé :
at_custom4=var_4

Exemple complet :

https://www.site.com/?at_medium=custom1&at_campaign=12&at_custom1=var_1&at_custom2=var_2&at_custom3=var_3&at_custom4=var_4
 

Traduction xtor -> at_

Copiez-collez votre xtor actuel, et récupérez l’équivalent au nouveau format

 

SmartTag >= version 5.29.0

 

Campagne entièrement personnalisée

Ce marqueur n’est disponible que pour l’analyse sur l’Analytics Suite Delta, et il n’est compatible qu’avec un marquage basé sur les événements.

ParamètresDescriptionDétailsFormats / Exemples
at_medium
(obligatoire)
Medium de la campagneAttention à ce que la valeur de votre medium ne corresponde pas à un marquage connu (voir plus haut) et ne commence pas par « custom »Valeur attendue :
at_medium=mymediumvalue
at_campaign
(obligatoire)
Libellé de la campagneValeur attendue :
at_campaign=my_campaign
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_ Valeur attendue :
at_mycustomprop=myvalue

Exemple complet :

https://www.site.com/?at_medium=mymedium&at_myproperty=myvalue&at_myotherproperty=myothervalue

Cela se traduira par les propriétés suivantes :

  • src_medium : mymedium
  • src_myproperty : myvalue
  • src_myotherproperty : myothervalue
 

Forcer la campagne v2 depuis le marquage 

Il est possible de forcer la campagne avec des paramètres de campagne v2 directement depuis le marquage, en ajoutant la propriété forcedCampaignV2 au contexte du Tracker :

var config = {};
// // Sponsored links example
var context = {
    forcedCampaignV2: {
        medium: 'sl',
        campaign: '12[my_campaign]',
        platform: 'google',
        creation: 'my_adgroup',
        variant: 'my_variant',
        network: 'search',
        term: 'my_term'
    }
};
var tag = new ATInternet.Tracker.Tag(config, context);

 

Forcer la source marketing d’une visite

Ce marqueur n’est disponible que pour l’analyse sur l’Analytics Suite Delta.

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.

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 :

//xtor tagging
tag.setProps({
    'xto': 'AD-1234',
    'b:src_force': 'true'
}, true);
 
//at_ tagging
tag.setProps({
 'src_medium': 'sl',
 'src_campaign': 'ATCampaign',
 'b:src_force': 'true'
}, true);

Si plusieurs sources sont forcées au cours d’une visite, la dernière renseignée sera celle qui sera conservée.

 

Homogénéisation du marquage AS2 et Delta

Si vous marquez via des méthodes “AS2 Tagging” et  “Delta Tagging” combinées, et que vous devez conserver le même medium pendant votre transition, veuillez utiliser les codes medium (voir ci-dessus), en complément d’une règle Data Manager. Plus d’informations sur notre Help Center.

 

Annexe

Nous proposons un outil pour créer des liens pour vos campagnes marketing : https://developers.atinternet-solutions.com/ATInternetCampaignCreator/at/

Dernière mise à jour : 20/02/2023