Guida all'implementazione

Video post-roll

Post-roll video ads

Annuncio video che parte nello stesso player subito dopo la fine del video, come gli spot alla fine di un programma.

Ad Manager
Ad Exchange
AdSense (tramite Ad Manager)
dentro il player video (mobile e desktop)

Scopri il formato Controlla sul mio sito

Desktop

Cellulare

Capirlo in 1 minuto

Che cos'è il video post-roll

Sai quando il programma TV finisce e, prima che inizi il successivo, passano degli spot? Il post-roll è questo sul tuo sito: un annuncio video che parte alla fine del video, dentro lo stesso player. La persona ha già guardato ciò che voleva e l'annuncio appare subito dopo. Pre significa prima, mid significa metà e post significa dopo.

Il segreto del post-roll è avvisare il player che il video è finito. L'IMA SDK, cioè il pacchetto di codice di Google per mettere gli annunci nel player, non indovina da solo che il contenuto è terminato. La guida di Google dice così: perché il post-roll parta, devi avvisare l'SDK quando il contenuto è finito, e a quel punto riproduce la pausa pubblicitaria finale, se ce n'è una programmata. Questo avviso va dato solo quando finisce il video, mai quando finisce un annuncio, perché l'IMA può usare lo stesso player per gli annunci. È come suonare la campanella della scuola solo quando la lezione finisce, e non in mezzo alla ricreazione.

Le pause possono essere organizzate con le regole degli annunci video, una funzione di Google Ad Manager 360. Con queste, il post-roll può essere attivato (Attiva), disattivato (Disattiva) o lasciato a una regola di priorità più bassa (Rimanda). Con le regole, la risposta arriva in VMAP, che è come il palinsesto della TV, e dice quali pause esistono. Senza regole, il player stesso può fare la richiesta alla fine del video e indicare nel tag che è un post-roll.

Quando vale la pena? Quando hai già video sul sito e vuoi un altro momento per gli annunci che non interrompe né l'inizio né la metà del contenuto. Le regole di qualsiasi annuncio In-stream continuano a valere: lo spazio deve essere dichiarato nel modo giusto, i controlli non possono essere nascosti e solo un player alla volta può partire da solo ed essere visibile. E, quando tutte le pause sono già state riprodotte, l'IMA avvisa con un evento apposito, che puoi usare per sistemare la pagina.

Passo passo

Come implementare

Prepara il player con l'IMACostruisci il player con l'IMA SDK come nel pre-roll: script dell'IMA, riquadro dell'annuncio sopra il video, AdsLoader e AdsRequest con il tuo tag.
Attiva il post-roll nella regolaIn Ad Manager 360, vai in Video, Regole degli annunci, Nuova regola dell'annuncio, scegli Standard e imposta gli annunci video finali su Attiva. Poi definisci Numero massimo di annunci e Durata massima dell'annuncio.
Regola il tagCon le regole degli annunci, il tag contiene ad_rule=1. Senza regole, il player fa la richiesta alla fine del video e può indicare vpos=postroll, che dice che la richiesta è di fine video.
Avvisa la fine del contenutoAscolta la fine del video e chiama l'avviso di contenuto completato dell'AdsLoader. Togli questo listener quando inizia un annuncio e rimettilo quando il contenuto torna.
Concludi dopo gli annunciL'IMA avvisa con l'evento ALL_ADS_COMPLETED quando tutte le pause sono già state riprodotte. Usa questo avviso per pulire il player, se serve.

Esempio implementato

Il codice e come appare sullo schermo

Va insieme al codice del player con l'IMA: avvisa la fine del video perché il post-roll parta e gestisce i listener mentre gli annunci passano.

<script>
  var video = document.getElementById('conteudo');

  // Avisa o IMA que o CONTEÚDO acabou (nunca no fim de um anúncio)
  var contentEndedListener = function () { adsLoader.contentComplete(); };
  video.addEventListener('ended', contentEndedListener);

  adsLoader.addEventListener(
      google.ima.AdsManagerLoadedEvent.Type.ADS_MANAGER_LOADED,
      function (e) {
        adsManager = e.getAdsManager(video);

        adsManager.addEventListener(
            google.ima.AdEvent.Type.CONTENT_PAUSE_REQUESTED,
            function () {
              // anúncio vai tocar: tira o ouvinte de fim do vídeo
              video.removeEventListener('ended', contentEndedListener);
              video.pause();
            });

        adsManager.addEventListener(
            google.ima.AdEvent.Type.CONTENT_RESUME_REQUESTED,
            function () {
              // conteúdo volta: coloca o ouvinte de novo
              video.addEventListener('ended', contentEndedListener);
              if (!video.ended) { video.play(); }
            });

        adsManager.addEventListener(
            google.ima.AdEvent.Type.ALL_ADS_COMPLETED,
            function () { console.log('Todos os intervalos tocaram'); });
      });
</script>

Su desktopQuando il video arriva alla fine, l'annuncio parte nello stesso player. Dopo l'annuncio, il video non riparte da solo.

Su smartphoneCome sul computer: l'annuncio parte nel player del telefono subito dopo la fine del video.

Cosa indica Google

Cosa si può e non si può fare

Consentito

Riprodurre un annuncio alla fine del video, dentro lo stesso player, usando l'IMA SDK.
Attivare, disattivare o lasciare decidere a un'altra regola il post-roll nelle regole degli annunci video di Ad Manager 360.
Fare la richiesta alla fine del video senza regole degli annunci e indicare nel tag che è un post-roll.
Usare l'evento di tutti gli annunci completati per sistemare la pagina dopo l'ultima pausa.

Non consentito

Non avvisare la fine del contenuto quando a finire è stato un annuncio: l'avviso è solo per la fine del video.
Non lasciare i controlli del video e dell'annuncio coperti, nascosti o non funzionanti.
Non puoi dichiarare lo spazio sbagliato: un player con video deve essere In-stream o Contenuto complementare.
Non avere più di un player che parte da solo ed è visibile nello stesso momento.
Non usare i prodotti IMA per guadagnare con i video di YouTube.

Consigli

Per farlo nel modo giusto

Se dimentichi di segnalare la fine del contenuto, il post-roll semplicemente non parte.
L'esempio di Google non avvisa la fine del contenuto se in quel momento è in riproduzione un annuncio.
Quando il contenuto riprende dopo un annuncio, l'esempio di Google ordina di riprodurre solo se il video non è ancora finito.

Attenzione

Errori comuni

Non avvisare la fine del video

Google dice che, perché il post-roll parta, l'SDK deve sapere che il contenuto è finito. Senza questo avviso, la pausa finale non avviene.

Avvisare alla fine di un annuncio

Se il listener di fine video resta attivo mentre l'annuncio è in riproduzione nello stesso player, l'avviso può partire nel momento sbagliato. Togli il listener durante la pausa e rimettilo quando il contenuto torna.

Far partire un video già finito

Dopo il post-roll, l'IMA chiede di riprendere il contenuto. Se il video è già finito, non ordinare di riprodurlo di nuovo, altrimenti potrebbe ripartire senza che la persona lo chieda.

Domande frequenti

Perché il mio post-roll non appare?

Un possibile motivo è non aver avvisato l'IMA che il video è finito. Google chiede che il sito segnali la fine del contenuto perché l'SDK riproduca la pausa finale, se ce n'è una programmata.

Servono le regole degli annunci per avere il post-roll?

Non necessariamente. Con le regole (Ad Manager 360), il post-roll arriva programmato nel VMAP. Senza regole, il player può richiedere l'annuncio alla fine del video e indicare vpos=postroll nel tag.

Il post-roll interrompe il video?

No. Parte dopo che il contenuto è finito, nello stesso player.

Biblioteca

Fonte ufficiale di Google

Tutto in questa pagina segue la documentazione ufficiale di Google. Leggila direttamente alla fonte:

Il tuo sito usa questo formato nel modo giusto?

L'audit legge il sito come un visitatore, senza cliccare su nulla, e mostra cosa correggere.

Avvia un audit