Developers » AS2 tagging » JavaScript » Campagnes » Publicités on-site
Publicités on-site
Avant-propos
Avant de commencer l’implémentation du plugin Publicités on-site, veuillez-vous assurer d’avoir initialisé le Tracker JavaScript AT Internet et sélectionné le plugin depuis l’interface Tag Composer. Afin de vous assurer de la bonne mesure de la campagne Auto-Promotion, il est également nécessaire de vérifier que la campagne est bien déclarée dans l’interface Configuration > Campagnes marketing.
Principe
L’objectif est de mesurer les clics et les impressions des campagnes de publicité d’auto-promotion mais également de campagnes affichées sur votre site pour un tiers, puis de les analyser.
Paramétrage du plugin
Le plugin Publicités on-site peut être configuré depuis l’interface Tag Composer. Deux paramètres sont concernés :
- Gestion automatique des clics : Lorsqu’un clic déclenche une navigation ou une redirection, les navigateurs empêchent la mesure de ces liens. Cette gestion permet de forcer la mesure.
- Timeout de la gestion automatique de clic : Durée après laquelle la gestion automatique de clic forcera la navigation même si la mesure n’a pas pu se faire (en millisecondes).
Marquage
Pour marquer vos publicités, le tracker expose deux fonctionnalités Publisher et Auto-promotion selon le type de publicité à mesurer.
Ces deux fonctionnalités exposent à leur tour trois méthodes :
- set : s’utilise avec la méthode dispatch du tracker
- add : s’utilise avec la méthode dispatch du tracker
- send : mesure ponctuelle d’une publicité
Paramètres Publisher
Propriété | Description |
---|---|
campaignId | Nom de la campagne (ex : [label] ou id[label]) (ce paramètre est obligatoire). |
creation | Nom de la création (ex : ([label] ou id[label]) |
variant | Nom de la variante (ex : ([label] ou id[label]) |
format | Identifiant indiquant le format (prédéfini ou personnalisé. ex : [120×40]) (voir Annexes). |
generalPlacement | Emplacement général (id texte prédéfini par nos soins, à mettre au format [label]) (voir Annexes). |
detailedPlacement | Détail de l’emplacement (ex : [label] ou id[label]) |
advertiserId | Identifiant de l’annonceur (ex : id[label]) |
url | URL vers laquelle se fait le lien (ex : [urlEncoded]) |
La propriété variant ne peut être utilisée sans la propriété creation. Vous devez en effet définir un nom de création avant de pouvoir ajouter une variante.
Paramètres Auto-promotion
Propriété | Description |
---|---|
adId | Identifiant à créer dans la zone Configuration qui caractérise l’ensemble « campagne > catégorie > création > variante » (ex : id) (ce paramètre est obligatoire). |
format | Identifiant indiquant le format de la publicité (prédéfini ou personnalisé. ex : [120×40]) (voir Annexes). |
productId | Identifiant du produit associé (Soumis à l’option SalesTracker) |
Les paramètres non souhaités ou non connus peuvent simplement être enlevés du marquage, seuls les identifiants « campaignId » et « adId » sont obligatoires
Paramètres optionnels (uniquement pour les méthodes send)
Propriété | Description |
---|---|
elem | Element du DOM marqué |
event | Evénement JavaScript (bloque la propagation de l’événement passé en paramètre) – depuis v5.7.0 |
callback | Fonction à exécuter – depuis v5.7.0 |
Marquage d’une impression de publicité
var tag = new ATInternet.Tracker.Tag(); tag.selfPromotion.set({ impression: { adId: 'id', format: '[60x60]', productId: 'id' } }); tag.dispatch();
var tag = new ATInternet.Tracker.Tag(); tag.publisher.set({ impression: { campaignId: 'id[label]', creation: 'id[label]', variant: 'id[label]', format: '[120x40]', generalPlacement: '[label]', detailedPlacement: 'id[label]', advertiserId: 'id[label]', url: '[urlEncoded]' } }); tag.dispatch();
Marquage de multiples impressions de publicité
50 impressions peuvent être mesurées au maximum par page
var tag = new ATInternet.Tracker.Tag(); tag.selfPromotion.add({ impression: { adId: 'id', format: '[60x60]', productId: 'id' } }); tag.selfPromotion.add({ impression: { adId: 'id2', format: '[90x90]', productId: 'id2' } }); tag.dispatch();
var tag = new ATInternet.Tracker.Tag(); tag.publisher.add({ impression: { campaignId: 'id[label]', creation: 'id[label]', variant: 'id[label]', format: '[120x40]', generalPlacement: '[label]', detailedPlacement: 'id[label]', advertiserId: 'id[label]', url: '[urlEncoded]' } }); tag.publisher.add({ impression: { campaignId: 'id2[label2]', creation: 'id2[label2]', variant: 'id2[label2]', format: '[60x40]', generalPlacement: '[label2]', detailedPlacement: 'id2[label2]', advertiserId: 'id2[label2]', url: '[urlEncoded2]' } }); tag.dispatch();
Marquage d’un clic de publicité
Exemples avec un lien
<a href="url" onclick="return tag.selfPromotion.send({elem:this,click:{adId:'id',format:'[120x40]',productId:'id'}});" >Link</a>
<a href="url" onclick="return tag.publisher.send({elem:this,click:{campaignId:'id[label]',creation:'id[label]',variant:'id[label]',format:'[120x40]',generalPlacement:'[label]',detailedPlacement:'id[label]',advertiserId:'id[label]',url:'[urlEncoded]'}});" >Link</a>
Exemples avec un formulaire
<form action="url" method="get" onsubmit="return tag.selfPromotion.send({elem:this,click:{adId:'id',format:'[120x40]',productId:'id'}});" > <input type="submit" value="Submit" /> </form>
<form action="url" method="get" onsubmit="return tag.publisher.send({elem:this,click:{campaignId:'id[label]',creation:'id[label]',variant:'id[label]',format:'[120x40]',generalPlacement:'[label]',detailedPlacement:'id[label]',advertiserId:'id[label]',url:'[urlEncoded]'}});" > <input type="submit" value="Submit" /> </form>
Exemples avec un événement JQuery
Disponible depuis la version 5.7.0
var tag = new ATInternet.Tracker.Tag(); $("#link").on( "click", function(event) { tag.selfPromotion.send({ elem: this, click: { adId: 'id', format: '[120x40]', productId: 'id' }, event: event }); });
var tag = new ATInternet.Tracker.Tag(); $("#link").on( "click", function(event) { tag.publisher.send({ elem: this, click: { campaignId: 'id[label]', creation: 'id[label]', variant: 'id[label]', format: '[120x40]', generalPlacement: '[label]', detailedPlacement: 'id[label]', advertiserId: 'id[label]', url: '[urlEncoded]' }, event: event }); });
Exemples avec un événement click
Disponible depuis la version 5.7.0
var tag = new ATInternet.Tracker.Tag(); var link = document.getElementById('link'); ATInternet.Utils.addEvtListener(link, 'click', function (event) { tag.selfPromotion.send({ elem: this, click: { adId: 'id', format: '[120x40]', productId: 'id' }, event: event }); });
var tag = new ATInternet.Tracker.Tag(); var link = document.getElementById('link'); ATInternet.Utils.addEvtListener(link, 'click', function (event) { tag.publisher.send({ elem: this, click: { campaignId: 'id[label]', creation: 'id[label]', variant: 'id[label]', format: '[120x40]', generalPlacement: '[label]', detailedPlacement: 'id[label]', advertiserId: 'id[label]', url: '[urlEncoded]' }, event: event }); });
Les paramètres « elem:this » et « event:event » sertvent à la gestion automatique des clics, il suffit de les enlever pour désactiver cette gestion sur le lien.
Marquage d’une impression de publicité sur une action de clic
Exemples avec un lien
<a href="url" onclick="return tag.selfPromotion.send({elem:this,impression:{adId:'id',format:'[120x40]',productId:'id'}});" >Link</a>
<a href="url" onclick="return tag.publisher.send({elem:this,impression:{campaignId:'id[label]',creation:'id[label]',variant:'id[label]',format:'[120x40]',generalPlacement:'[label]',detailedPlacement:'id[label]',advertiserId:'id[label]',url:'[urlEncoded]'}});" >Link</a>
Exemples avec un formulaire
<form action="url" method="get" onsubmit="return tag.selfPromotion.send({elem:this,impression:{adId:'id',format:'[120x40]',productId:'id'}});" > <input type="submit" value="Submit" /> </form>
<form action="url" method="get" onsubmit="return tag.publisher.send({elem:this,impression:{campaignId:'id[label]',creation:'id[label]',variant:'id[label]',format:'[120x40]',generalPlacement:'[label]',detailedPlacement:'id[label]',advertiserId:'id[label]',url:'[urlEncoded]'}});" > <input type="submit" value="Submit" /> </form>
Exemples avec un événement JQuery
Disponible depuis la version 5.7.0
var tag = new ATInternet.Tracker.Tag(); $("#link").on( "click", function(event) { tag.selfPromotion.send({ elem: this, impression: { adId: 'id', format: '[120x40]', productId: 'id' }, event: event }); });
var tag = new ATInternet.Tracker.Tag(); $("#link").on( "click", function(event) { tag.publisher.send({ elem: this, impression: { campaignId: 'id[label]', creation: 'id[label]', variant: 'id[label]', format: '[120x40]', generalPlacement: '[label]', detailedPlacement: 'id[label]', advertiserId: 'id[label]', url: '[urlEncoded]' }, event: event }); });
Exemples avec un événement click
Disponible depuis la version 5.7.0
var tag = new ATInternet.Tracker.Tag(); var link = document.getElementById('link'); ATInternet.Utils.addEvtListener(link, 'click', function (event) { tag.selfPromotion.send({ elem: this, impression: { adId: 'id', format: '[120x40]', productId: 'id' }, event: event }); });
var tag = new ATInternet.Tracker.Tag(); var link = document.getElementById('link'); ATInternet.Utils.addEvtListener(link, 'click', function (event) { tag.publisher.send({ elem: this, impression: { campaignId: 'id[label]', creation: 'id[label]', variant: 'id[label]', format: '[120x40]', generalPlacement: '[label]', detailedPlacement: 'id[label]', advertiserId: 'id[label]', url: '[urlEncoded]' }, event: event }); });
Les paramètres « elem:this » et « event:event » servent à la gestion automatique des clics, il suffit de les enlever pour désactiver cette gestion sur le lien.
Annexes
Annexe : formats
- 468 : format classique (468×60)
- sky320 : format skycrapers (160×320)
- sky600 : format skycrapers (160×600)
- rect180 : format rectangle (180×150)
- rect300 : format rectangle (300×250)
- rect336 : format rectangle (336×280)
- wide : format bannière large (728×90)
- vert240 : format bannière verticale 120×240
- vert600 : format bannière verticale 120×600)
- square : format bannière carrée (250×250)
- popup : format pop-up
- popund : format pop-under
- 16-9 : format 16/9ème (320×180)
- Inter : format interstitiel (800×600)
- maxwid : format Maxi leaderBoard (985×110)
- intext : format intext
- 0 : autres
Vous pouvez spécifier tout autre format de votre choix en utilisant la nomenclature suivante : « [name] ».
Exemple : vous pouvez saisir soit un libellé : [button], soit une taille : [120×40].
Annexe : emplacements
- GT : Rotation générale (General Turnover)
- HP : Home Page (uniquement sur la page d’accueil)
- PHP : Pré-HomePage
- 0 : autres