Developers » AS2 tagging » JavaScript » Campagnes » Campagnes marketing v2 5.17.0
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 » où 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ètres | Description | Détails | Formats / Exemples |
---|---|---|---|
at_medium (obligatoire) | Medium de la campagne | Liens sponsorisés : sl | Valeur attendue : at_medium=sl |
at_campaign (obligatoire) | ID/Libellé de la campagne | Valeur de l’identifiant de campagne (donné par AT Internet) | ID : at_campaign=12 Libellé : at_campaign=my_campaign |
at_platform | Plateforme | Uniquement 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_creation | Groupe d’annonce | Correspondant à votre stratégie de communication sur la plateforme. | Libellé : at_creation=my_adgroup |
at_variant | Variante de l’annonce | En 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_network | Réseaux | Selon 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_term | Mot-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ètres | Description | Détails | Formats / Exemples |
---|---|---|---|
at_medium (obligatoire) | Medium de la campagne | Campagne email marketing : email | Valeur attendue : at_medium=email |
at_emailtype (obligatoire) | Type d’email | Les 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 campagne | Valeur de l’identifiant de campagne (donné par AT Internet) | ID : at_campaign=12 Libellé : at_campaign=my_campaign |
at_creation | Création | Correspond 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_date | Date d’envoi | La 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 destinataire | Correspond à l’identifiant numérique de votre destinataire dans votre base de destinataire. | ID : at_recipient_id=5336 |
at_recipient_list | Liste du destinataire | Correspond à 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ètres | Description | Détails | Formats / Exemples |
---|---|---|---|
at_medium (obligatoire) | Medium de la campagne | Campagne affichage publicitaire : display | Valeur attendue : at_medium=display |
at_campaign (obligatoire) | ID/Libellé de la campagne | Valeur de l’identifiant de campagne (donné par AT Internet) | ID : at_campaign=12 Libellé : at_campaign=my_campaign |
at_creation | Création | Correspond au modèle d’affichage publicitaire envoyé dans la campagne (Bon à tirer). | Libellé : at_creation=my_creation |
at_variant | Variante | La version de la création affichée sur le réseau publicitaire. Nécessite une valeur pour at_creation | Libellé : at_variant=my_variant |
at_format | Format | Les dimensions de l’affichage publicitaire utilisé. | Libellé : at_format=468 |
at_channel | Canal | Le réseau de distribution des affichages. | Libellé : at_channel=my_channel |
at_general_placement | Placement général | L’emplacement principal de l’affiche publicitaire. | Libellé : at_general_placement=home |
at_detail_placement | Placement 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ètres | Description | Détails | Formats / Exemples |
---|---|---|---|
at_medium (obligatoire) | Medium de la campagne | Campagne d’affiliation : affiliate | Valeur attendue : at_medium=affiliate |
at_campaign (obligatoire) | ID/Libellé de la campagne | Valeur de l’identifiant de campagne (donné par AT Internet) | ID : at_campaign=12 Libellé : at_campaign=my_campaign |
at_type | Type d’affilié | En fonction de la relation d’affiliation. | Libellé : at_type=affiliate_type |
at_identifier | Identifiant de l’affilié | Correspondant à celui utilisé dans votre liste d’affiliés. | ID : at_identifier=3591 |
at_format | Format | Les dimensions de l’affichage publicitaire utilisé. | Libellé : at_format=banner |
at_creation=my_creation | Création | Correspond au modèle d’affichage publicitaire envoyé dans la campagne (Bon à tirer). | Libellé : at_creation=my_creation |
at_variant | Variante | 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ètres | Description | Détails | Formats / Exemples |
---|---|---|---|
at_medium (obligatoire) | Medium de la campagne | Campagne affichage publicitaire : display | Valeur attendue : at_medium=custom1 |
at_campaign (obligatoire) | ID/Libellé de la campagne | Valeur de l’identifiant de campagne (donné par AT Internet) | ID : at_campaign=12 Libellé : at_campaign=my_campaign |
at_custom1 | Paramètre personnalisé 1 | Information de votre souhait. | Libellé : at_custom1=var_1 |
at_custom2 | Paramètre personnalisé 2 | Information de votre souhait. | Libellé : at_custom2=var_2 |
at_custom3 | Paramètre personnalisé 3 | Information de votre souhait. | Libellé : at_custom3=var_3 |
at_custom4 | Paramètre personnalisé 4 | Information 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ètres | Description | Détails | Formats / Exemples |
---|---|---|---|
at_medium (obligatoire) | Medium de la campagne | Attention à 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 campagne | Valeur attendue : at_campaign=my_campaign | |
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_ | 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