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();

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
    });
});

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
    });
});