Suivi des publicités sur Android

Les instructions suivantes fournissent des conseils pour la mise en œuvre à l’aide des kits SDK 2.x.

Constantes de suivi des publicités

Procédure de mise en œuvre

1. Identifiez le moment où la limite de coupure publicitaire commence, y compris preroll, et créez un AdBreakObject à l’aide des informations de coupure publicitaire.

   Référence AdBreakObject :

   Nom de variable	Description	Obligatoire
   name	Nom de la coupure publicitaire tel que preroll, mid-roll et post-roll.	Oui
   position	Position du numéro de la coupure publicitaire dans le contenu, en commençant par 1.	Oui
   startTime	Valeur du curseur de lecture au début de la coupure publicitaire.	Oui

   Création d’objet de coupure publicitaire :

   MediaObject adBreakInfo =
     MediaHeartbeat.createAdBreakObject(<ADBREAK_NAME>,
                                        <POSITION>,
                                        <START_TIME>);
   

2. Appelez trackEvent() avec AdBreakStart dans l’instance MediaHeartbeat pour commencer le suivi de la coupure publicitaire :

   public void onAdBreakStart(Observable observable, Object data) {
       _heartbeat.trackEvent(MediaHeartbeat.Event.AdBreakStart,
                             adBreakInfo,
                             null);
   }
   

3. Déterminez le moment où la publicité commence, puis créez une instance AdObject à l’aide des informations sur la publicité.

   Référence AdObject :

   Nom de variable	Description	Obligatoire
   name	Nom convivial de la publicité.	Oui
   adId	Identifiant unique de la publicité.	Oui
   position	Position du numéro de la publicité dans la coupure publicitaire, en commençant par 1.	Oui
   length	Longueur de la publicité	Oui

   Création d’objet publicitaire :

   MediaObject adInfo =
     MediaHeartbeat.createAdObject(<AD_NAME>
                                   <AD_ID>,
                                   <POSITION>,
                                   <LENGTH>);
   

4. Vous pouvez joindre des métadonnées standard et/ou de publicité à la session de suivi multimédia par le biais de variables de données contextuelles.

   • Mise en œuvre de métadonnées de publicité standard sur Android

   • Métadonnées de publicité personnalisées - Pour les métadonnées personnalisées, créez un objet de variable pour les variables de données personnalisées et renseignez les données de la publicité actuelle :

     // Setting Ad Metadata
     HashMap<String, String> adMetadata = new HashMap<String, String>();
     adMetadata.put("affiliate", "Sample affiliate");
     adMetadata.put("campaign", "Sample ad campaign");
     

5. Appelez trackEvent() avec l’événement AdStart dans l’instance MediaHeartbeat pour commencer le suivi de la lecture de publicité.

   Incluez une référence à votre variable de métadonnées personnalisées (ou un objet vide) comme troisième paramètre dans l’appel d’événement :

   public void onAdStart(Observable observable, Object data) {
       _heartbeat.trackEvent(MediaHeartbeat.Event.AdStart,
                             adInfo,
                             adMetadata);
   }
   

6. Lorsque la lecture de la publicité atteint la fin de la publicité, appelez trackEvent() avec l’événement AdComplete :

   public void onAdComplete(Observable observable, Object data) {
       _heartbeat.trackEvent(MediaHeartbeat.Event.AdComplete, null, null);
   }
   

7. Si la lecture de la publicité ne s’est pas terminée car l’utilisateur a choisi d’ignorer la publicité, suivez l’événement AdSkip :

   public void onAdSkip(Observable observable, Object data) {
       _heartbeat.trackEvent(MediaHeartbeat.Event.AdSkip, null, null);
   }
   

8. S’il existe d’autres publicités dans le même AdBreak, répétez les étapes 3 à 7.

9. Lorsque la coupure publicitaire est terminée, utilisez l’événement AdBreakComplete pour en effectuer le suivi :

   public void onAdBreakComplete(Observable observable, Object data) {
       _heartbeat.trackEvent(MediaHeartbeat.Event.AdBreakComplete, null, null);
   }
   

Consultez le scénario de suivi Lecture VOD avec publicités preroll pour en savoir plus.

Ressources Business.Adobe.com