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
campaignIdNom de la campagne (ex : [label] ou id[label]) (ce paramètre est obligatoire).
creationNom de la création (ex : ([label] ou id[label])
variantNom de la variante (ex : ([label] ou id[label])
formatIdentifiant indiquant le format (prédéfini ou personnalisé. ex : [120×40]) (voir Annexes).
generalPlacementEmplacement général (id texte prédéfini par nos soins, à mettre au format [label]) (voir Annexes).
detailedPlacementDétail de l’emplacement (ex : [label] ou id[label])
advertiserIdIdentifiant de l’annonceur (ex : id[label])
urlURL 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
adIdIdentifiant à créer dans la zone Configuration qui caractérise l’ensemble « campagne > catégorie > création > variante » (ex : id) (ce paramètre est obligatoire).
formatIdentifiant indiquant le format de la publicité (prédéfini ou personnalisé. ex : [120×40]) (voir Annexes).
productIdIdentifiant 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
elemElement du DOM marqué
eventEvénement JavaScript (bloque la propagation de l’événement passé en paramètre) – depuis v5.7.0
callbackFonction à 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
Dernière mise à jour : 27/08/2020
Developers » AS2 tagging » JavaScript » Campagnes » Publicités on-site