Configurer la lecture des coupures publicitaires

Sélectionnez une plate-forme : Android iOS

Ce guide s'adresse aux utilisateurs qui souhaitent contrôler manuellement le timing de lecture des pauses publicitaires. Dans une implémentation par défaut, le SDK lit automatiquement les mid-rolls à l'heure prévue. Certains développeurs peuvent souhaiter empêcher le SDK de lire ces pauses publicitaires automatiquement. En implémentant la lecture manuelle des pauses publicitaires, le SDK déclenche un événement AD_BREAK_READY lorsqu'un mid-roll a été chargé et attend que vous lanciez la lecture de la pause.

Prérequis

  • Application iOS avec le SDK IMA implémenté.

Guides utiles

Si vous devez encore implémenter le SDK IMA dans votre application, consultez notre guide de démarrage.

Configurer la lecture manuelle des coupures publicitaires

La configuration de la lecture manuelle des coupures publicitaires se fait en trois étapes :

  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 ci-dessous montre les modifications à apporter à l'exemple avancé pour implémenter la lecture manuelle des pauses publicitaires :
- (void)setUpAdsLoader {
  ...
  IMASettings settings = [[IMASettings alloc] init];
  // Tell the SDK that you want to control ad break playback.
  settings.autoPlayAdBreaks = NO;
  self.adsLoader = [[IMAAdsLoader alloc] initWithSettings:settings];
  ...
}

- (void)adsManager:(IMAAdsManager *)adsManager didReceiveAdEvent:(IMAAdEvent *)event {
  ...
  switch (event.type) {
    // Listen for the AD_BREAK_READY event
    case kIMAAdEvent_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

Est-ce obligatoire pour une implémentation du SDK IMA ?
Absolument pas ! Cette option n'est proposée qu'aux éditeurs qui ne souhaitent pas que le SDK IMA diffuse automatiquement des annonces mid-roll lorsqu'elles sont planifiées par vos règles relatives aux annonces ou votre réponse VMAP.