Lancer manuellement des coupures publicitaires

Sélectionnez une plate-forme : Android iOS

Ce guide explique comment remplacer le calendrier de coupures publicitaires par défaut et configurer vos propres durées de lecture des coupures publicitaires. Lorsque la lecture manuelle des coupures publicitaires est implémentée, le SDK déclenche un événement AD_BREAK_READY lorsqu'une coupure publicitaire est chargée et attend que vous lanciez la lecture de la coupure.

Prérequis

• Une application Android avec le SDK IMA implémenté.

Configurer la lecture manuelle des coupures publicitaires

Pour configurer la lecture manuelle des coupures publicitaires :

1. Indiquez au SDK que vous souhaitez contrôler la lecture des coupures publicitaires.
2. Écoutez l'événement AD_BREAK_READY.
3. Indiquez au SDK de diffuser des annonces lorsque vous êtes prêt.

L'extrait de code ci-dessous montre les modifications à apporter à l'exemple avancé pour implémenter la lecture manuelle des pauses publicitaires.

Point clé : l'exemple de base implémente l'extension Exoplayer-IMA, qui gère la configuration d'ImaSdkSettings et d'AdEvents. Par conséquent, l'exemple de base ne peut pas être utilisé comme point de départ pour ce guide.

public VideoPlayerController(
      Context context,
      VideoPlayerWithAdPlayback videoPlayerWithAdPlayback,
      View playButton,
      View playPauseToggle,
      String language,
      ViewGroup companionViewGroup,
      Logger log) {
  ...
  
  sdkFactory = ImaSdkFactory.getInstance();
  ImaSdkSettings imaSdkSettings = sdkFactory.createImaSdkSettings();
  imaSdkSettings.setLanguage(language);
  // Tell the SDK you want to control ad break playback.
  imaSdkSettings.setAutoPlayAdBreaks(false);
  
  ...
}
...
@Override
public void onAdEvent(AdEvent adEvent) {
    ...
    switch (adEvent.getType()) {
      // Listen for the AD_BREAK_READY event.
      case AD_BREAK_READY:
        // Tell the SDK to play ads when you're ready. To skip this ad break,
        // simply return from this handler without calling adsManager.start().
        adsManager.start();
        break;
      ...
}

Questions fréquentes

L'implémentation du SDK IMA nécessite-t-elle la lecture manuelle des annonces ?

Non. La lecture manuelle des annonces est une fonctionnalité facultative pour les éditeurs qui ne souhaitent pas que le SDK IMA lise automatiquement les coupures publicitaires planifiées par une règle publicitaire ou une réponse VMAP.