Lecture manuelle des coupures publicitaires

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

Prérequis

  • Application iOS intégrant le SDK IMA

Introductions utiles

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

Configurer la lecture manuelle des coupures publicitaires

Pour configurer la lecture manuelle des coupures publicitaires, vous devez suivre trois étapes:

<ph type="x-smartling-placeholder">
    </ph>
  1. Indiquez au SDK que vous souhaitez contrôler la lecture des coupures publicitaires.
  2. Écoutez l'événement AD_BREAK_READY.
  3. Demandez au SDK de lire les annonces lorsque vous êtes prêt.
L'extrait de code ci-dessous présente les modifications nécessaires à l'exemple avancé pour implémenter la lecture manuelle des coupures 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 mettre en œuvre le SDK IMA ?
Absolument pas. Cette fonctionnalité 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 la réponse VMAP.