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 annonces mid-roll à l'heure prévue. Certains développeurs souhaitent empêcher le SDK de lire automatiquement ces coupures publicitaires. Si vous implémentez la lecture manuelle des coupures publicitaires, le SDK déclenche un événement AD_BREAK_READY lors du chargement d'une annonce mid-roll et attend que vous commenciez la lecture de la coupure.

Conditions préalables

• une application iOS avec le SDK IMA implémenté.

Introductions utiles

Si vous avez encore besoin de mettre en œuvre le SDK IMA dans votre application, consultez notre guide de démarrage.

Configuration de la lecture manuelle des coupures publicitaires

Pour configurer la lecture manuelle des coupures publicitaires, vous devez suivre 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. Demandez au SDK de diffuser des annonces lorsque vous êtes prêt.

L'extrait ci-dessous indique les modifications requises dans 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 la mise en œuvre du SDK IMA ?

Absolument pas. Cette option n'est proposée qu'aux éditeurs qui ne souhaitent pas que le SDK IMA lance automatiquement des annonces mid-roll lorsqu'elles sont planifiées par vos règles relatives aux annonces ou votre réponse VMAP.