Creatività JavaScript VPAID 2

L'SDK IMA per HTML5 supporta le creatività JavaScript VPAID 2. Abilitare l'assistenza è facile, ma ci sono due differenze di cui tenere conto tra le specifiche VPAID 2 e il modo in cui l'SDK IMA supporta VPAID 2. Queste differenze non influiscono sul player o sul codice di implementazione 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 l'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.

Iniziative utili

Attivazione del supporto di VPAID 2

Per attivare il supporto di JavaScript VPAID 2, chiama il seguente metodo 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 le sezioni Sicurezza iframe ed Elemento proxy video player.
  • DISABLED: gli annunci VPAID non vengono riprodotti. Se un annuncio richiesto restituisce una creatività VPAID, viene generato un errore.
di Gemini Advanced. Per ulteriori informazioni sulle modalità VPAID, consulta la documentazione dell'API per ImaSdkSettings.VpaidMode.

Avvertenze sul supporto di VPAID 2

Sicurezza iframe

Per impostazione predefinita, l'SDK IMA utilizza un iframe protetto 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 verificarsi 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 del corretto funzionamento dei dispositivi mobili, in modalità ENABLED l'SDK IMA per HTML5 non fornisce l'elemento video effettivo all'annuncio. fornisce invece un elemento proxy che riproduce gran parte delle funzionalità del normale elemento video. Per le creatività degli annunci che richiamano solo metodi dell'API supportati, il rendering delle creatività non deve subire modifiche del comportamento. 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 accessibility

  • 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 per HTML5 è l'unica piattaforma SDK IMA che attualmente supporta le creatività JavaScript VPAID 2.
In questo modo vengono attivate le creatività VPAID nell'SDK IMA per HTML5?
Sì, l'SDK IMA per HTML5 supporta le creatività JavaScript VPAID 2.