Publicités on-site

Avant-propos

Le SDK AT Internet propose la mesure de vos publicités in-app afin d’évaluer leurs performances.

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 app pour un tiers, puis de les analyser.

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.

Pour bien débuter

Une fois votre marqueur initialisé, vous pouvez débuter le marquage de vos publicités in-app.

Dans le cas où vous souhaitez utiliser des variables, veillez à importer les classes ATInternet, Tracker, SelfPromotion et Publisher dans votre Activity.

Marquage

Pour marquer vos publicités, le tracker expose deux objets Publishers et SelfPromotions selon le type de publicité à mesurer.

Ces deux objets exposent à leur tour deux méthodes :

• add
• sendImpressions

La méthode add permet d’ajouter un marqueur de publicité et de le mettre en attente d’envoi. Cette méthode renvoie un objet de type Publisher ou SelfPromotion selon le cas.

Pour envoyer les informations définies, vous devrez appeler la méthode sendTouch ou sendImpression de votre objet, en fonction du type d’action effectuée par l’utilisateur ou appeler la méthode dispatch du Tracker.

Attention, l’appel aux méthodes sendTouch et sendImpression, modifie la propriété action de l’objet.

La méthode sendImpressions permet d’envoyer toutes les informations de publicités dont l’action est définie comme Impression.

Les méthodes sendTouch et sendImpression sont disponibles uniquement via les objets Publisher ou SelfPromotion renvoyés par la méthode Add.
Elles permettent un envoi indépendant instantané (clic ou impression) du marqueur de publicité venant d’être ajouté.
Exemple

@Override
protected void onResume() {
    super.onResume();
    tracker.SelfPromotions().add(1).sendImpression();
}

La méthode sendImpressions est quand à elle disponible via les objets Publishers et SelfPromotions.
Elle permet un envoi global de tous les marqueurs de publicité de type impression ayant été précédemment ajoutés.
Exemple

@Override
protected void onResume() {
    super.onResume();
    tracker.SelfPromotions().add(1);
    tracker.SelfPromotions().add(2);
    tracker.SelfPromotions().sendImpressions();
}

Exemples de marquage

1. Marquage d’une impression d’une publicité pour un tiers

   package com.atinternet.atinternetdemo;
   
   import android.app.Activity;
   import android.os.Bundle;
   
   import com.atinternet.tracker.ATInternet;
   import com.atinternet.tracker.Tracker;
   
   
   public class MainActivity extends Activity {
   
       private Tracker tracker;
   
       @Override
       protected void onCreate(Bundle savedInstanceState) {
           super.onCreate(savedInstanceState);
           setContentView(R.layout.activity_main);
           tracker = ATInternet.getInstance().getDefaultTracker();
       }
   
       @Override
       protected void onResume() {
           super.onResume();
           tracker.Publishers().add("[ad1]").sendImpression();
       }
   }

2. Marquage d’un « clic » sur une publicité pour un tiers

   @Override
   public void onClick(View v) {
           ATInternet.getInstance().getDefaultTracker().Publishers().add("[ad1]").sendTouch();
   }

3. Marquage d’une impression d’une campagne d’auto-promotion

   package com.atinternet.atinternetdemo;
   
   import android.app.Activity;
   import android.os.Bundle;
   
   import com.atinternet.tracker.ATInternet;
   import com.atinternet.tracker.Debugger;
   import com.atinternet.tracker.Tracker;
   
   
   public class MainActivity extends Activity  {
   
       private Tracker tracker;
   
       @Override
       protected void onCreate(Bundle savedInstanceState) {
           super.onCreate(savedInstanceState);
           setContentView(R.layout.activity_main);
           tracker = ATInternet.getInstance().getDefaultTracker();
       }
   
       @Override
       protected void onResume() {
           super.onResume();
           tracker.SelfPromotions().add(1).sendImpression();
       }
   }

4. Marquage d’un « clic » sur une campagne d’auto-promotion

   @Override
   public void onClick(View v) {
           ATInternet.getInstance().getDefaultTracker().SelfPromotions().add(3).sendTouch();
   }

5. Marquage de plusieurs publicités et envoi des impressions
   

   50 impressions peuvent être mesurées au maximum par page

   package com.atinternet.atinternetdemo;
   
   import android.app.Activity;
   import android.os.Bundle;
   
   import com.atinternet.tracker.ATInternet;
   import com.atinternet.tracker.Tracker;
   
   
   public class MainActivity extends Activity {
   
       private Tracker tracker;
   
       @Override
       protected void onCreate(Bundle savedInstanceState) {
           super.onCreate(savedInstanceState);
           setContentView(R.layout.activity_main);
           tracker = ATInternet.getInstance().getDefaultTracker();
       }
   
       @Override
       protected void onResume() {
           super.onResume();
           tracker.Publishers().add("[ad1]")
                   .setCreation("[creation]")
                   .setVariant("[variant]")
                   .setFormat("[120x40]")
                   .setGeneralPlacement("[generalPlacement]")
                   .setDetailedPlacement("[detailedPlacement]")
                   .setAdvertiserId("1[advertiserId]")
                   .setUrl("[http://advertiser-url.com]");
   
           tracker.Publishers().add("[ad2]");
           tracker.Publishers().add("[ad3]")
                   .setCreation("[creation]")
                   .setVariant("[variant]");
   
           tracker.Publishers().sendImpressions();
       }
   }

6. Marquage de plusieurs campagnes d’auto-promotion et envoi des impressions

   package com.atinternet.atinternetdemo;
   
   import android.app.Activity;
   import android.os.Bundle;
   
   import com.atinternet.tracker.ATInternet;
   import com.atinternet.tracker.Debugger;
   import com.atinternet.tracker.Tracker;
   
   
   public class MainActivity extends Activity {
   
       private Tracker tracker;
   
       @Override
       protected void onCreate(Bundle savedInstanceState) {
           super.onCreate(savedInstanceState);
           setContentView(R.layout.activity_main);
           tracker = ATInternet.getInstance().getDefaultTracker();
       }
   
       @Override
       protected void onResume() {
           super.onResume();
           tracker.SelfPromotions().add(1)
                   .setFormat("[120x40]")
                   .setProductId("p1");
   
           tracker.SelfPromotions().add(2);
   
           tracker.SelfPromotions().add(3)
                   .setProductId("p3");
   
           tracker.SelfPromotions().sendImpressions();
       }
   }

7. Marquage de publicités et de campagnes d’auto-promotion et utilisation du dispatcher

   package com.atinternet.atinternetdemo;
   
   import android.app.Activity;
   import android.os.Bundle;
   
   import com.atinternet.tracker.ATInternet;
   import com.atinternet.tracker.Debugger;
   import com.atinternet.tracker.Tracker;
   
   
   public class MainActivity extends Activity {
   
       private Tracker tracker;
   
       @Override
       protected void onCreate(Bundle savedInstanceState) {
           super.onCreate(savedInstanceState);
           setContentView(R.layout.activity_main);
           tracker = ATInternet.getInstance().getDefaultTracker();
       }
   
       @Override
       protected void onResume() {
           super.onResume();
           tracker.Publishers().add("[ad1]");
           tracker.Publishers().add("[ad2]");
           tracker.SelfPromotions().add(1);
   
           // This will send one hit with publishers and selfpromotion impressions
           tracker.dispatch();
       }
   }

8. Marquage de publicités et campagnes d’auto-promotion et ajout des informations sur un écran

   package com.atinternet.atinternetdemo;
   
   import android.app.Activity;
   import android.os.Bundle;
   
   import com.atinternet.tracker.ATInternet;
   import com.atinternet.tracker.Debugger;
   import com.atinternet.tracker.Tracker;
   
   
   public class MainActivity extends Activity {
   
       private Tracker tracker;
   
       @Override
       protected void onCreate(Bundle savedInstanceState) {
           super.onCreate(savedInstanceState);
           setContentView(R.layout.activity_main);
           tracker = ATInternet.getInstance().getDefaultTracker();
       }
   
       @Override
       protected void onResume() {
           super.onResume();
           Screen s = tracker.Screens().add(this);
           s.Publishers().add("[ad1]");
           s.Publishers().add("[ad2]");
           s.SelfPromotions().add(1);
           s.sendView();
       }
   }

Classe Publisher

Propriétés

Méthodes

Classe SelfPromotion

Propriétés

Méthodes