Guida all'implementazione

Video mid-roll

Mid-roll video ads

Annuncio video che entra a metà del contenuto, come una pausa pubblicitaria, e poi il video riprende da dove si era fermato.

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

Cos'è il video mid-roll

Pensa a una partita di calcio in TV: all'intervallo entrano le pubblicità e poi la partita riprende. Il mid-roll è la pausa pubblicitaria del video del tuo sito. Il video si ferma in un punto stabilito, riproduce uno o più annunci nello stesso player e poi riparte esattamente da dove si era fermato. Quando entrano più annunci di seguito, Google chiama questo gruppo gruppo di annunci (in inglese, ad pod), che è come un blocco di pubblicità.

Chi decide l'orario degli intervalli? In Ad Manager, lo fanno le regole degli annunci video, chiamate ad rules. Dicono quando e come gli annunci compaiono dentro un video. Puoi scegliere orari fissi, come i secondi 60, 120 e 180, oppure un intervallo ogni tot secondi. Puoi anche usare i cue point, che sono piccoli segni dentro il video che indicano i punti migliori per fermarsi, come la fine di una scena. Il player riceve questo piano in una risposta VMAP, che funziona come la griglia degli orari degli intervalli, e l'IMA SDK riproduce ogni intervallo al momento giusto.

Ci sono dettagli importanti. Le regole degli annunci video esistono solo in Google Ad Manager 360 con un contratto video avanzato. Perché il mid-roll funzioni, Ad Manager deve sapere quanto dura il video e dove sono i punti di stop. Puoi registrare i video in Ad Manager (si chiama ingestione dei contenuti) e inviare i codici cmsid e vid nel tag. Oppure, senza questa registrazione, puoi inviare la durata del video in secondi (vid_d) e l'elenco dei punti di stop in millisecondi (allcues). Google dice che la durata deve essere inviata per avere i mid-roll.

L'IMA deve anche sapere a che secondo è il video. Per questo consegni all'IMA l'elemento video stesso e attivi il gestore degli annunci prima che il contenuto inizi, perché è lì che comincia a contare il tempo. Il mid-roll ha senso nei video in cui la persona resta a guardare a lungo. Pensa sempre a chi sta guardando: Ad Manager permette di limitare quanti annunci entrano in ogni pausa, quanto può durare ciascuno e di usare limiti di frequenza per pausa, per video o per entrambi.

Passo passo

Come implementare

Attiva le regole degli annunciIn Ad Manager 360, vai in Amministrazione, Video e audio, Impostazioni audio e video. Attiva l'opzione Regole degli annunci e salva.
Crea una regola standardVai in Video, Regole degli annunci, Nuova regola dell'annuncio. Dai un nome, scegli Standard come tipo, scegli la priorità e imposta Annunci video intermedi su Attiva.
Scegli quando entrano gli intervalliNella frequenza dei mid-roll, scegli A orari fissi, Ogni n secondi, A punti di inserimento fissi o Ogni n punti di inserimento. Poi definisci il gruppo: Numero massimo di annunci e Durata massima dell'annuncio. I tempi devono essere numeri interi.
Invia la durata e i punti nel tagNel tag, richiedi le regole degli annunci con ad_rule=1. Se i video non sono registrati in Ad Manager, indica la durata in secondi (vid_d) e i punti di stop in millisecondi (allcues). Con i video registrati, invia cmsid e vid.
Collega IMA al videoConsegna a IMA l'elemento video, che fornisce il tempo attuale del video. Attiva il gestore degli annunci prima di riprodurre il contenuto, perché è lì che IMA inizia a seguire il tempo.
Metti in pausa e riprendi negli intervalliMetti in pausa il video quando IMA chiede la pausa e riprendi quando chiede di continuare. Così ogni intervallo entra ed esce al momento giusto.

Esempio implementato

Il codice e come appare sullo schermo

Va nello stesso codice del player con IMA: cambia solo il tag (con ad_rule=1, vid_d e allcues) e l'elemento video viene consegnato a IMA perché sappia il tempo.

<script src="//imasdk.googleapis.com/js/sdkloader/ima3.js"></script>
<script>
  // Vídeo de 10 minutos (vid_d=600)
  // com intervalos em 2 e 5 minutos (allcues em ms)
  var adsRequest = new google.ima.AdsRequest();
  adsRequest.adTagUrl = 'https://pubads.g.doubleclick.net/gampad/ads?' +
      'iu=/1234567/exemplo&sz=640x480&env=vp&gdfp_req=1' +
      '&ad_rule=1&output=vmap&vid_d=600&allcues=120000,300000' +
      '&unviewed_position_start=1&vpa=click&vpmute=0&plcmt=1' +
      '&description_url=https%3A%2F%2Fwww.exemplo.com%2Fvideo&correlator=';
  adsRequest.linearAdSlotWidth = 640;
  adsRequest.linearAdSlotHeight = 400;
  adsLoader.requestAds(adsRequest);

  adsLoader.addEventListener(
      google.ima.AdsManagerLoadedEvent.Type.ADS_MANAGER_LOADED,
      function (e) {
        // O próprio <video> informa o tempo atual (currentTime) ao IMA
        adsManager = e.getAdsManager(video);
        adsManager.addEventListener(
            google.ima.AdEvent.Type.CONTENT_PAUSE_REQUESTED,
            function () { video.pause(); });
        adsManager.addEventListener(
            google.ima.AdEvent.Type.CONTENT_RESUME_REQUESTED,
            function () { video.play(); });
      });

  // No clique de play: init() antes de tocar o conteúdo
  // adDisplayContainer.initialize();
  // adsManager.init(640, 360, google.ima.ViewMode.NORMAL);
  // adsManager.start();
</script>

Su desktopIl video si mette in pausa nel punto segnato, l'annuncio parte nello stesso player e, quando finisce, il contenuto continua da dove si era fermato.

Su smartphoneFunziona allo stesso modo dentro il player dello smartphone. Se la persona trascina la barra del video in avanti e il player non gestisce la cosa, più intervalli possono partire uno dopo l'altro.

Cosa indica Google

Cosa si può e non si può fare

Consentito

Scegliere gli intervalli per orari fissi, ogni N secondi, in cue point fissi o ogni N cue point.
Servire mid-roll senza registrare i video in Ad Manager, inviando vid_d e allcues nel tag.
Definire quanti annunci entrano in ogni intervallo e quanto può durare ciascuno.
Usare un limite di frequenza per intervallo, per video o per entrambi.
Disattivare l'avvio automatico degli intervalli in IMA e decidere al momento se ogni intervallo pronto verrà riprodotto.

Non consentito

Non si può avere il mid-roll senza indicare la durata del contenuto: Google dice che vid_d deve essere inviato per i mid-roll.
Le regole di sessione non servono per il mid-roll: possono essere applicate solo al pre-roll.
Non lasciare i controlli del video e dell'annuncio coperti, nascosti o non funzionanti.
Non si può segnalare la fine del contenuto quando a terminare è stato un annuncio: questo avviso è solo per la fine del video.

Consigli

Per farlo nel modo giusto

Quando la persona trascina la barra, salva il tempo da cui è partita e comunica quel tempo a IMA finché il video non torna normale. Così non partono più intervalli di fila.
In Safari su smartphone, il rilevamento del trascinamento del video non funziona bene. La guida di IMA mostra un modo manuale per accorgersi del trascinamento.
Se registri i video in Ad Manager, controlla in Video, Contenuti che Durata e Punti di inserimento dei break pubblicitari intermedi siano stati importati correttamente.
Esiste un'opzione beta, Specifica le impostazioni dell'ultimo break pubblicitario, per dare all'ultimo intervallo impostazioni proprie. Non entra nella previsione dell'inventario.

Attenzione

Errori comuni

Segnalare la fine del contenuto alla fine dell'annuncio

L'avviso di fine contenuto è solo per quando il video finisce. Poiché IMA può usare lo stesso player per gli annunci, segnalarlo alla fine di un annuncio confonde l'SDK.

Riprodurre il video prima di attivare IMA

IMA inizia a seguire il tempo solo quando il gestore degli annunci è attivato. Per questo Google chiede di attivarlo sempre prima di riprodurre il contenuto.

Player che cambia il tempo durante il trascinamento

Se il tuo player aggiorna il tempo durante il trascinamento della barra, Google consiglia di consegnare a IMA un oggetto proprio che comunichi il tempo corretto.

Cercare regole degli annunci in un account senza 360

Le regole degli annunci video sono solo di Google Ad Manager 360 con un contratto video avanzato. In un account normale, questa opzione non compare.

Domande frequenti

Devo registrare i miei video in Ad Manager?

No. Google dice che l'ingestione dei contenuti non è obbligatoria per i mid-roll con regole degli annunci. Senza di essa, invia la durata (vid_d) e i punti di stop (allcues) nel tag.

Cos'è un cue point?

È un piccolo segno in un punto del video che dice che lì può entrare un intervallo. Nel tag, i cue point vanno in millisecondi, separati da virgola, come 10000,20000.

Si può avere il mid-roll senza le regole degli annunci?

Google dice che le regole degli annunci sono necessarie perché Ad Manager restituisca mid-roll, e che sono una funzione di Ad Manager 360. Bisogna anche inviare la durata del video (vid_d).

Quanti annunci entrano in ogni intervallo?

Lo decidi nel gruppo con Numero massimo di annunci. L'opzione Nessun valore massimo esiste solo nei Gruppi ottimizzati, che permettono anche di limitare la durata totale della pausa.

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