Modalità operative dell'SDK
L'SDK può funzionare in una o più modalità a seconda della risposta che riceve dall'annuncio stesso. o server web.
- Annuncio singolo
- Un annuncio che può essere riprodotto in qualsiasi momento quando
start
viene inviato aIMAAdsManager
. Nessuna inizializzazione speciale necessario per riprodurre un singolo annuncio. - Pod di annunci
- Diversi annunci che vengono riprodotti in sequenza quando il messaggio
start
viene inviato aIMAAdsManager
. Non è necessaria alcuna inizializzazione speciale riprodurre un singolo pod di annunci. - Regole per gli annunci
- Una playlist di interruzioni pubblicitarie pianificate in determinati orari rispetto a un particolare
contenuti. Il messaggio
start
viene ignorato in modalità regole per gli annunci. È possibile essere programmate in più interruzioni pubblicitarie all'interno di una singola playlist (ad es. pre-roll, mid-roll, post-roll). Per ulteriori dettagli sull'implementazione, consulta sezione Regole per gli annunci di seguito.
Regole per gli annunci
IMA L'SDK tvOS supporta le playlist di annunci completamente automatizzate. Questa funzionalità inserisce interruzioni pubblicitarie nei contenuti come specificato Google Ad Manager quando gestisci il traffico degli annunci. Inoltre, semplifica notevolmente il codice del video player necessarie per supportare le interruzioni pubblicitarie, tra cui pre-roll, mid-roll e post-roll.
- Quando gestisci il traffico degli annunci in Ad Manager, puoi specificare diverse regole per gli annunci ad esempio "riproduci sempre l'interruzione pubblicitaria all'inizio dei contenuti" oppure "riproduci un'interruzione pubblicitaria di un minuto ogni 30 minuti di contenuti".
- Quando vengono richiesti gli annunci, l'ad server può restituire una playlist di annunci. L'SDK elabora la playlist e pianifica automaticamente le interruzioni pubblicitarie specificato.
- Durante l'inizializzazione di
AdsManager
, viene generato unIMAContentPlayhead
viene trasmesso tramite l'elementoinitializeWithContentPlayhead:adsRenderingSettings:
chiamata. Se utilizzi un AVPlayer per visualizzare i tuoi contenuti, passi un diIMAAVPlayerContentPlayhead
all'SDK quando creiadDisplayContainer
. Questo oggetto viene utilizzato per monitorare l'avanzamento della riproduzione di contenuti in modo che vengono inserite automaticamente nei momenti specificati in Ad Manager.
Con AVPlayer:
IMAContentPlayhead *contentPlayhead = [[IMAAVPlayerContentPlayhead alloc] initWithAVPlayer:self.contentAVPlayer]; IMAAdsRequest *request = [[IMAAdsRequest alloc] initWithAdTagUrl:adTagUrl adDisplayContainer:adDisplayContainer contentPlayhead:contentPlayhead userContext:nil];
Senza AVPlayer:
- Implementa l'interfaccia
IMAContentPlayhead
. - Implementa
currentTime
per restituire l'ora attuale della tua video player. - Cambia la chiamata di inizializzazione di
IMAAdsManager
in utilizzainitializeWithContentPlayhead:self
.
- Implementa l'interfaccia
- L'utente IMAAdsManagerDelegate viene utilizzato per mettere in pausa e riprendere la riproduzione dei contenuti durante la riproduzione delle interruzioni pubblicitarie.
Nota:al termine della riproduzione dei contenuti o
l'utente ha interrotto la riproduzione; assicurati di chiamare contentComplete
su IMAAdsLoader
per segnalare all'SDK che i contenuti
ha finito di giocare. L'SDK riproduce quindi l'interruzione pubblicitaria post-roll, se è stata pianificata.
L'evento ALL_ADS_COMPLETED
viene generato quando tutte le interruzioni pubblicitarie hanno
è stato eseguito. Inoltre, tieni presente che il monitoraggio dei contenuti inizia quando
initializeWithContentPlayhead:adsRenderingSettings
di IMAAdsManager
e devi sempre chiamare initializeWithContentPlayhead:adsRenderingSettings
prima di riprodurre i contenuti.