Regole per gli annunci

Modalità operative dell'SDK

L'SDK può operare in una o più modalità, a seconda della risposta di annuncio che riceve dall'ad server.

Annuncio singolo
Un annuncio che può essere riprodotto in qualsiasi momento quando il messaggio start viene inviato a IMAAdsManager. Non è necessaria un'inizializzazione speciale per riprodurre un singolo annuncio.
Pod di annunci
Diversi annunci riprodotti uno dopo l'altro quando il messaggio start viene inviato allo IMAAdsManager. Non è necessaria alcuna inizializzazione speciale per riprodurre un singolo pod di annunci.
Regole per gli annunci
Una playlist di interruzioni pubblicitarie programmate in determinati orari su determinati contenuti. Il messaggio start viene ignorato in modalità regole per gli annunci. Possono essere presenti diverse interruzioni pubblicitarie programmate all'interno di una singola playlist (ad es. pre-roll, mid-roll e post-roll). Per ulteriori dettagli sull'implementazione, consulta la sezione Regole degli annunci di seguito.

Regole per gli annunci

L'SDK IMA per iOS supporta le playlist di annunci completamente automatiche. Questa funzionalità consente di inserire interruzioni pubblicitarie all'interno dei contenuti come specificato in Google Ad Manager durante la gestione del traffico degli annunci. Inoltre, semplifica notevolmente il codice del video player necessario per supportare le interruzioni pubblicitarie, inclusi pre-roll, mid-roll e post-roll.

  • Quando gestisci il traffico degli annunci in Ad Manager, è possibile specificare varie regole per gli annunci, ad esempio "riproduci sempre l'interruzione pubblicitaria all'inizio dei contenuti" o "riproduci un'interruzione pubblicitaria di un minuto ogni 30 minuti di contenuti".
  • Quando vengono richiesti annunci, l'ad server può restituire una playlist di annunci. L'SDK elabora la playlist e pianifica automaticamente le interruzioni pubblicitarie specificate.
  • Durante l'inizializzazione di AdsManager, un oggetto IMAContentPlayhead viene trasmesso tramite la chiamata initializeWithContentPlayhead:adsRenderingSettings:. Se utilizzi un AVPlayer per visualizzare i tuoi contenuti, passi un'istanza di IMAAVPlayerContentPlayhead all'SDK quando crei il tuo adDisplayContainer. Questo oggetto viene utilizzato per monitorare l'avanzamento della riproduzione dei contenuti in modo che le interruzioni pubblicitarie vengano inserite automaticamente negli orari 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:

    1. Implementa l'interfaccia IMAContentPlayhead.
    2. Implementa currentTime per restituire l'ora corrente del video player.
    3. Modifica la chiamata di inizializzazione IMAAdsManager per utilizzare initializeWithContentPlayhead:self.
  • IMAAdsManagerDelegate viene utilizzato per mettere in pausa e riprendere i contenuti mentre vengono riprodotte le interruzioni pubblicitarie.

Nota: quando la riproduzione dei contenuti è terminata o l'utente ha interrotto la riproduzione, assicurati di chiamare contentComplete su IMAAdsLoader per segnalare all'SDK che la riproduzione dei contenuti è terminata. L'SDK quindi riproduce l'interruzione pubblicitaria post-roll, se ne è stata pianificata una. L'evento ALL_ADS_COMPLETED viene generato quando sono state riprodotte tutte le interruzioni pubblicitarie. Inoltre, tieni presente che il monitoraggio dei contenuti inizia quando viene richiamato il metodo initializeWithContentPlayhead:adsRenderingSettings di IMAAdsManager e dovresti sempre chiamare initializeWithContentPlayhead:adsRenderingSettings prima di riprodurre i contenuti.