Cette page a été traduite par l'API Cloud Translation.

Règles relatives aux annonces

Modes de fonctionnement du SDK

Le SDK peut fonctionner dans un ou plusieurs modes, selon la réponse qu'il reçoit de l'annonce Google Cloud.

Annonce unique: Annonce qui peut être lue à tout moment lorsque start est envoyé au IMAAdsManager. Aucune initialisation spéciale est nécessaire pour lire une seule annonce.
Série d'annonces: Plusieurs annonces sont diffusées les unes après les autres lorsque le message start est envoyé à le IMAAdsManager. Aucune initialisation spéciale n'est nécessaire pour diffuser une seule série d'annonces.
Règles relatives aux annonces: Playlist de coupures publicitaires programmées à certains moments pour des périodes spécifiques contenus. Le message start est ignoré en mode de règles relatives aux annonces. Il peut y avoir comporter plusieurs coupures publicitaires programmées au sein d'une même playlist (pré-roll, mid-roll, post-roll). Pour en savoir plus sur l'implémentation, consultez la Règles relatives aux annonces ci-dessous.

Règles relatives aux annonces

IMA Le SDK tvOS est compatible avec les playlists d'annonces entièrement automatisées. Cette fonctionnalité insère des coupures publicitaires dans le contenu, comme indiqué dans Google Ad Manager lors du trafficking de vos annonces. De plus, il simplifie considérablement le code du lecteur vidéo nécessaires pour accepter les coupures publicitaires, y compris les annonces vidéo pré-roll, mid-roll et post-roll.

Lors du trafficking des annonces dans Ad Manager, vous pouvez spécifier différentes règles relatives aux annonces comme "Toujours lire la coupure publicitaire au début du contenu" ou "faire une pause 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 coupures publicitaires spécifié.
Lors de l'initialisation de AdsManager, un IMAContentPlayhead est transmis via initializeWithContentPlayhead:adsRenderingSettings:. . Si vous utilisez un lecteur AVPlayer pour afficher votre contenu, vous transmettez une valeur instance de IMAAVPlayerContentPlayhead au SDK lorsque vous créez votre adDisplayContainer Cet objet sert à suivre la progression de la lecture du contenu afin que l'annonce sont 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 du lecteur vidéo.
3. Remplacez l'appel d'initialisation IMAAdsManager par utiliser initializeWithContentPlayhead:self.
Le gestionnaire IMAAdsManagerDelegate permet de mettre en pause et de reprendre la lecture d'un contenu lors de la lecture de coupures publicitaires.

Remarque:Lorsque la lecture du contenu est terminée ou l'utilisateur a arrêté la lecture, veillez à appeler contentComplete. sur le IMAAdsLoader pour signaler au SDK que le contenu a fini de jouer. Le SDK lit ensuite la coupure publicitaire post-roll, le cas échéant. L'événement ALL_ADS_COMPLETED est déclenché lorsque toutes les coupures publicitaires comportent a déjà été lu. De plus, notez que le suivi du contenu commence lorsque initializeWithContentPlayhead:adsRenderingSettings de IMAAdsManager est appelée et vous devez toujours appeler initializeWithContentPlayhead:adsRenderingSettings avant de lire le contenu.