L'SDK IMA per HTML5 supporta le creatività JavaScript VPAID 2. Abilitare il supporto è facile, ma ci sono due differenze tra la specifica VPAID 2 e il modo in cui l'SDK IMA supporta VPAID 2. Queste differenze non influiscono sul codice di implementazione del player o dell'SDK, ma sono importanti per gli autori di creatività JavaScript VPAID 2, in quanto le creatività potrebbero generare errori o non funzionare come previsto quando vengono visualizzate dall'SDK IMA per HTML5.
Prerequisiti
- Video player HTML5 con SDK IMA per HTML5 integrato. Se non ne hai uno, consulta la nostra Guida introduttiva.
- Un URL del tag annuncio VAST che indirizza a una creatività JavaScript VPAID 2.
Istruzioni utili
- Se non conosci VPAID 2, puoi leggere ulteriori informazioni nella pagina VPAID di IAB.
Attivazione del supporto di VPAID 2
Per attivare il supporto JavaScript VPAID 2, chiama il metodo seguente prima di inizializzare AdDisplayContainer:
google.ima.settings.setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.ENABLED); ... var adDisplayContainer = new google.ima.AdDisplayContainer(adContainerElement); var adsLoader = new google.ima.AdsLoader(adDisplayContainer); ...
Le modalità VPAID disponibili sono le seguenti:
ENABLED
: consente gli annunci VPAID con le impostazioni predefinite.INSECURE
: consente gli annunci VPAID in modalità non sicura. Per ulteriori informazioni, consulta gli articoli Sicurezza iframe e Elemento proxy video player.DISABLED
: gli annunci VPAID non vengono riprodotti. Se un annuncio richiesto restituisce una creatività VPAID, viene generato un errore.
Avvertenze relative al supporto di VPAID 2
Sicurezza iframe
Per impostazione predefinita, l'SDK IMA utilizza un iframe sicuro anziché un iframe semplice (stesso dominio) o uno script in-page per eseguire il rendering delle creatività JavaScript VPAID 2. Ciò significa che se una creatività prevede di accedere al DOM della pagina principale, potrebbe causare un errore. Per eseguire il rendering dell'annuncio in un iframe semplice, puoi utilizzare ImaSdkSettings.setVpaidMode(...)
in questo modo:
adsLoader.getSettings().setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.INSECURE);
Elemento proxy video player
Per motivi di sicurezza e corretto funzionamento mobile, in modalità ENABLED
l'SDK IMA per HTML5 non fornisce l'elemento video effettivo all'annuncio, ma un elemento proxy che riproduce gran parte della funzionalità dell'elemento video normale. Per le creatività degli annunci che richiamano solo i metodi API supportati, non dovrebbero verificarsi modifiche al comportamento del rendering delle creatività. Con la modalità VpaidMode.INSECURE
, l'SDK fornisce l'elemento video player anziché il proxy.
Di seguito sono riportati i metodi, i listener e gli attributi disponibili per l'elemento proxy video:
Metodi
addEventListener
canPlayType
load
play
pause
setattribute
Tipi di evento per hreflang
abort
canplay
canplaythrough
click
durationchange
emptied
ended
error
loadeddata
loadedmetadata
loadstart
pause
play
playing
progress
ratechange
suspend
seeked
seeking
timeupdate
waiting
Attributi
currentTime
duration
ended
paused
playbackRate
src
type
Domande frequenti
- Le creatività VPAID 2 JavaScript sono supportate negli SDK per iOS o Android?
- L'SDK IMA per HTML5 è l'unica piattaforma SDK IMA che al momento supporta le creatività JavaScript VPAID 2.
- Le creatività VPAID vengono attivate nell'SDK IMA per HTML5?
- Sì, l'SDK IMA per HTML5 supporta le creatività JavaScript VPAID 2.