Attivare le creatività JavaScript VPAID 2

L'SDK IMA HTML5 supporta le creatività JavaScript VPAID 2. Quando abiliti il supporto, tieni presente che esistono due differenze principali 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 sottoposte a rendering dall'SDK IMA HTML5.

Prerequisiti

Per seguire questa guida, inizia con un'app che abbia le seguenti caratteristiche:

  • Video player HTML5 con l'SDK IMA HTML5 integrato. Se non ne hai uno, consulta la pagina Configurare l'SDK IMA.
  • Un URL del tag annuncio VAST che rimanda a una creatività JavaScript VPAID 2.

Introduzioni utili

  • Se non hai familiarità con VPAID 2, puoi leggere ulteriori informazioni at IAB VPAID page.

Abilitare il supporto VPAID 2

Per abilitare il supporto JavaScript VPAID 2, chiama il seguente metodo prima di inizializzare il tuo 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 Sicurezza iframe e Elemento proxy del video player.
  • DISABLED - Gli annunci VPAID non vengono riprodotti. Se un annuncio richiesto restituisce una creatività VPAID, viene generato un errore.

Per ulteriori informazioni sulle modalità VPAID, consulta la documentazione dell'API per ImaSdkSettings.VpaidMode.

Avvertenze sul supporto VPAID 2

Sicurezza iframe

Per impostazione predefinita, l'SDK IMA utilizza un iframe sicuro anziché un iframe semplice (stesso dominio) o uno script in pagina per eseguire il rendering delle creatività JavaScript VPAID 2. Ciò significa che se una creatività prevede di accedere al DOM della pagina principale, potrebbe potenzialmente causare un errore. Per eseguire il rendering dell'annuncio in un iframe semplice, puoi utilizzare ImaSdkSettings.setVpaidMode(...) come segue:

adsLoader.getSettings().setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.INSECURE);

Elemento proxy del video player

Per garantire la sicurezza e la corretta funzionalità mobile, in modalità ENABLED l'SDK IMA HTML5 non fornisce l'elemento video effettivo all'annuncio, ma un elemento proxy che imita gran parte della funzionalità dell'elemento video normale. Per le creatività pubblicitarie che chiamano solo i metodi API supportati, non dovrebbero verificarsi modifiche del comportamento nel rendering delle creatività. Con la modalità VpaidMode.INSECURE, l'SDK fornisce l'elemento del video player anziché il proxy.

Di seguito sono riportati i metodi, i listener e gli attributi disponibili nell'elemento proxy video:

Metodi

  • addEventListener
  • canPlayType
  • load
  • play
  • pause
  • setattribute

Tipi di evento per addEventListener

  • 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à JavaScript VPAID 2 sono supportate negli SDK iOS o Android?
L'SDK IMA HTML5 è l'unica piattaforma SDK IMA che supporta le creatività JavaScript VPAID 2 JavaScript.
In questo modo le creatività VPAID vengono abilitate nell'SDK IMA HTML5?
Sì, l'SDK IMA HTML5 supporta le creatività JavaScript VPAID 2.