Automatiser les playlists d'annonces

Modes de fonctionnement du SDK

Le SDK peut fonctionner dans un ou plusieurs modes, en fonction de la réponse publicitaire qu'il reçoit de l'ad server.

Annonce unique

Annonce pouvant être lue à tout moment lorsque le message start est envoyé au IMAAdsManager. Aucune initialisation spéciale n'est nécessaire pour lire une seule annonce.

Série d'annonces

Plusieurs annonces diffusées les unes après les autres lorsque le message start est envoyé à IMAAdsManager. Aucune initialisation spéciale n'est nécessaire pour lire un seul bloc d'annonces.

Règles relatives aux annonces

Playlist de coupures publicitaires programmées à certaines heures pour des contenus spécifiques. Le message start est ignoré en mode règles publicitaires. Plusieurs coupures publicitaires peuvent être programmées dans une même playlist (par exemple, pré-roll, mid-roll et post-roll). Pour en savoir plus sur l'implémentation, consultez la section Règles relatives aux annonces ci-dessous.

Règles relatives aux annonces

Le SDK IMA pour tvOS est compatible avec les playlists d'annonces entièrement automatisées. Cette fonctionnalité insère des pauses publicitaires dans le contenu, comme spécifié dans Google Ad Manager lors du trafficking de vos annonces. Il simplifie également considérablement le code du lecteur vidéo nécessaire pour prendre en charge les coupures publicitaires, y compris les annonces pré-roll, mid-roll et post-roll.

• Lorsque vous diffusez des annonces dans Ad Manager, vous pouvez spécifier différentes règles publicitaires, comme "toujours diffuser une coupure publicitaire au début du contenu" ou "diffuser une coupure publicitaire d'une minute toutes les 30 minutes de contenu".
• Lorsque des annonces sont demandées, l'ad server peut renvoyer une playlist d'annonces. Le SDK traite la playlist et planifie automatiquement les pauses publicitaires spécifiées.
• Lors de l'initialisation de AdsManager, un objet IMAContentPlayhead est transmis via l'appel initializeWithContentPlayhead:adsRenderingSettings:. Si vous utilisez un AVPlayer pour afficher votre contenu, vous transmettez une instance de IMAAVPlayerContentPlayhead au SDK lorsque vous créez votre adDisplayContainer. Cet objet permet de suivre la progression de la lecture du contenu afin que les coupures publicitaires soient automatiquement insérées aux moments spécifiés dans Ad Manager.
  

  Avec AVPlayer :

  IMAContentPlayhead *contentPlayhead =
      [[IMAAVPlayerContentPlayhead alloc] initWithAVPlayer:self.contentAVPlayer];
  IMAAdsRequest *request = [[IMAAdsRequest alloc] initWithAdTagUrl:adTagUrl
                                                adDisplayContainer:adDisplayContainer
                                                   contentPlayhead:contentPlayhead
                                                       userContext:nil];

  Sans AVPlayer :

  1. Implémentez l'interface IMAContentPlayhead.
  2. Implémentez currentTime pour renvoyer l'heure actuelle de votre lecteur vidéo.
  3. Modifiez l'appel d'initialisation IMAAdsManager pour utiliser initializeWithContentPlayhead:self.
• Le IMAAdsManagerDelegate est utilisé pour mettre en pause et reprendre le contenu lors de la diffusion des coupures publicitaires.

Remarque : Une fois le contenu lu ou lorsque l'utilisateur a arrêté la lecture, veillez à appeler contentComplete sur IMAAdsLoader pour indiquer au SDK que le contenu a été lu. Le SDK lit ensuite l'emplacement publicitaire post-roll, s'il a été planifié. L'événement ALL_ADS_COMPLETED est déclenché lorsque toutes les coupures publicitaires ont été diffusées. De plus, notez que le suivi du contenu commence lorsque la méthode initializeWithContentPlayhead:adsRenderingSettings de IMAAdsManager est appelée. Vous devez toujours appeler initializeWithContentPlayhead:adsRenderingSettings avant de lire du contenu.