GPT dentro un iframe
L'IMA per HTML5 riconosce gli spazi del GPT solo nella pagina principale. In un iframe, senza lo script proxy, il companion non appare.
Guida all'implementazione
Companion ads
Banner che appare nella pagina nello stesso momento in cui un annuncio video o audio viene riprodotto nel player, formando una coppia.
Capirlo in 1 minuto
Pensa a un concerto: mentre la cantante è sul palco, uno schermo di fianco mostra il nome della canzone. I due raccontano la stessa storia nello stesso momento. L'annuncio companion è così. Mentre l'annuncio video o audio viene riprodotto nel player, un banner dello stesso annuncio compare in uno spazio pubblicitario della pagina, vicino al player.
Google spiega che gli annunci companion permettono di mostrare annunci in spazi display nello stesso momento in cui un annuncio viene servito in un player video o audio. Dipendono sempre dall'annuncio principale, chiamato master: senza master, non esiste il companion. È come il maxischermo del concerto, che ha senso solo se c'è qualcuno che canta. Un annuncio VAST può contenere fino a 6 annunci display companion.
Come fa il sito? Gli spazi display vicino al player sono creati con la GPT, la Google Publisher Tag, che è il codice di Google per gli spazi pubblicitari. La GPT ha tre elementi per questo. Il primo, companionAds, dice che quello spazio può ricevere un companion quando c'è un annuncio VAST in riproduzione in un player della stessa pagina. Il secondo, setRefreshUnfilledSlots, chiede di riempire più tardi gli spazi rimasti vuoti. Il terzo, enableVideoAds, fa usare alla GPT e all'IMA SDK lo stesso correlator, un numero uguale in tutte le richieste di annunci della stessa visualizzazione di pagina. Dal lato del player, l'IMA invia le dimensioni dei companion nel parametro ciu_szs del tag.
Quando conviene? Quando hai annunci video o audio e vuoi che l'annuncio compaia anche nella pagina. Per i player video che possono ricevere annunci audio, Google consiglia vivamente di usare banner companion, perché il player non resti vuoto mentre l'audio è in riproduzione. Alcune attenzioni: lo spazio deve avere la stessa dimensione del companion, gli annunci responsive non sono supportati come companion del video e, se il player è dentro un iframe, serve uno script proxy della GPT.
Passo passo
Esempio implementato
<!-- No head: GPT com um espaço que aceita complementar -->
<script async
src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"></script>
<script>
window.googletag = window.googletag || { cmd: [] };
googletag.cmd.push(function () {
googletag
.defineSlot('/1234567/exemplo', [728, 90], 'companionDiv')
.addService(googletag.companionAds())
.addService(googletag.pubads());
googletag.companionAds().setRefreshUnfilledSlots(true);
googletag.pubads().enableVideoAds();
googletag.enableServices();
});
</script>
<!-- No body: a caixa do complementar, do mesmo tamanho -->
<div id="companionDiv" style="width:728px; height:90px;">
<script>
googletag.cmd.push(function () { googletag.display('companionDiv'); });
</script>
</div>
<!-- Na tag do IMA, os tamanhos dos complementares vão em ciu_szs:
...&ciu_szs=728x90&... -->Cosa indica Google
Consigli
Attenzione
L'IMA per HTML5 riconosce gli spazi del GPT solo nella pagina principale. In un iframe, senza lo script proxy, il companion non appare.
Il companion deve avere la stessa dimensione dello spazio. Uno spazio 728x90 non riceve un companion 300x250.
Un player con IMA deve inviare le dimensioni dei companion nel parametro ciu_szs. Senza di esse, il server non sa quali dimensioni accetta la pagina.
In un video o audio che parte da solo, un banner normale può apparire per un istante. Google indica disableInitialLoad per evitarlo.
No. Dipende sempre dall'annuncio master che viene riprodotto nel player. Se non c'è un companion, lo spazio può ricevere un altro annuncio della tua rete.
Un annuncio VAST può contenere fino a 6 annunci display companion.
Sì. Nei player video che possono ricevere annunci audio, Google consiglia vivamente di usare banner companion, perché il player non resti vuoto mentre il suono è in riproduzione.
Fa usare alla GPT e all'IMA SDK lo stesso correlator, un numero uguale in tutte le richieste di annunci della stessa visualizzazione di pagina.
Biblioteca
Tutto in questa pagina segue la documentazione ufficiale di Google. Leggila direttamente alla fonte:
L'audit legge il sito come un visitatore, senza cliccare su nulla, e mostra cosa correggere.