Controllare il supporto e la compatibilità dell'SDK

Questa pagina fornisce informazioni generali sul supporto e sulla compatibilità di IMA DAI per browser, formati video e piattaforme.

Browser e formati video supportati

HTML5 è ancora uno standard nuovo e in evoluzione. Di conseguenza, il supporto di varie funzionalità varia a seconda del browser e non esiste un unico formato video predefinito supportato da tutti i principali browser. I tre formati video principali utilizzati nella maggior parte dei browser sono H.264, HLS e Dash.

Compatibilità degli eventi VAST

Questa sezione elenca gli eventi VAST che vengono segnalati automaticamente al server in base alle informazioni restituite nella risposta VAST.

Completamente supportato

complete, creativeView, firstQuartile, impression, midpoint, pause, resume, rewind (attivato quando si verifica una ricerca significativa all'indietro), start, thirdQuartile.

Parzialmente supportate

• click

  L'evento Click viene inviato solo per gli annunci video. Non è possibile acquisire i clic sui player a schermo intero nativi su Android, iOS o computer, ma è comunque possibile acquisirli tramite un elemento di monitoraggio dei clic in pagina quando il video viene chiuso. Tuttavia, se l'elemento video utilizza i controlli nativi sull'iPad, i clic non possono essere acquisiti.

• fullscreen
  

  IMA supporta una modalità a schermo intero simulata, in cui il video occupa l'intera finestra del browser. IMA considera un video in modalità a schermo intero quando le sue dimensioni offsetWidth e offsetHeight sono almeno pari a quelle del corpo del documento. Questa modalità è supportata su tutti i browser.

  Su iPhone e sulle piattaforme Android precedenti alla versione 3.0, il video viene sempre riprodotto in modalità a schermo intero.

• mute, unmute

  Solo iOS e Android hanno il controllo nativo del volume. Pertanto, l'SDK IMA non può determinare il volume o lo stato di disattivazione dell'audio, né viene informato delle modifiche. Di seguito è riportato un elenco delle versioni del browser che supportano e non supportano mute, unmute:

  • Supportati:Firefox 3.5+, Chrome 8+, Safari 4+
  • Non supportato: iOS, Android

Per ulteriori dettagli sulla pubblicazione di annunci VAST, consulta le linee guida IAB.

Eventi pubblicitari durante la visualizzazione delle interruzioni pubblicitarie

IMA non attiva gli eventi pubblicitari durante la visualizzazione ripetuta degli annunci per i seguenti motivi:

• Gli URL evento devono essere attivati una sola volta, altrimenti potrebbero essere interpretati come comportamento di spam.
• In questo modo, gli utenti possono cercare all'interno e intorno alle interruzioni pubblicitarie che hanno già visualizzato, creando un'esperienza di ricerca migliore.

Questi sono gli unici eventi attivati durante la riproduzione delle interruzioni pubblicitarie:

• AD_PERIOD_STARTED
• AD_PERIOD_ENDED

Piattaforme di video player supportate

Gli SDK IMA di Google sono supportati sulle seguenti piattaforme:

Piattaforma	Versione
HTML5	Computer: Chrome, Firefox, Safari, Edge, Opera Dispositivi mobili: Chrome/browser Android (Android per smartphone e tablet), Safari e Chrome (iOS)
iOS	iOS 10.0 o versioni successive
Android	Android 4.4+
Google Cast	Tutti i dispositivi di trasmissione
tvOS	tvOS 14+
Roku	Tutti i dispositivi che ricevono ancora aggiornamenti software da Roku

Supporto del formato dello stream video

L'SDK IMA supporta sia HLS che DASH. Consulta questa tabella per informazioni sul supporto di piattaforme SDK specifiche. Per una corretta riproduzione dello stream, il tuo video player deve supportare il tipo di stream utilizzato.

Piattaforma SDK IMA	HLS	DASH
HTML5
iOS
Android
Google Cast
tvOS
Roku

Funzionalità video e versioni SDK

Per saperne di più sulle seguenti funzionalità, leggi la panoramica della pubblicità video.

Suite video IAB	Assistenza
VAST 4	1
VAST 3	2
VAST 2
VPAID 2
VMAP 1.0.1	3
Funzionalità video di Ad Manager	Assistenza
Annunci lineari
Annunci non lineari (overlay)
Companion	4
Risorse alternative per gli annunci companion VAST 3
Visibilità con Visualizzazione attiva
Reindirizzamenti VAST
Backfill companion con richiesta display
Compatibilità con il Tag publisher di Google (GPT)
Consapevolezza dei contenuti
Regole per gli annunci
Podding
Bumper
Report sul monitoraggio multi-evento (MET)
Ignorabile (prenotazione / non TrueView)	5
Funzionalità di AdSense per i video 7	Assistenza
InStream TrueView	6
In-Stream Select
In-stream standard
Full-slot
Companion	4
Backfill companion
Sovrapposizioni
Funzionalità di Ad Exchange in Ad Manager	Assistenza
InStream TrueView	6
In-Stream Select
In-stream standard
Full-slot
Companion	4
Backfill companion
Sovrapposizioni
Visibilità con Visualizzazione attiva
Perché questo annuncio?	8

¹ Delle funzionalità VAST 4 supportate da Google Ad Manager, IMA supporta le seguenti funzionalità:

• VAST 4.2
  • Supporto per Secure Interactive Media Interface Definition (SIMID)
  • Più nodi UniversalAdID consentiti
• VAST 4.0
  • AdID
  • File mezzanine
  • Nuovi codici di errore VAST
  • Nuove macro VAST
  • Assistenza AdVerifications

² Le seguenti funzionalità di VAST 3.0 non sono ancora supportate:

• Companion adSlotId
• Opzioni di pubblicazione companion
• Icone

³ Le seguenti funzionalità VMAP non sono ancora supportate:

• Eventi di monitoraggio specifici per VMAP
• Codici di errore specifici di VMAP
• Annunci in overlay
• Offset temporali diversi da hh:mm:ss o "start" e "end"
• Attributo Display breakType
• repeatAfter attributo

⁴ Sono supportati solo i companion immagine. Le immagini companion richiedono un'implementazione personalizzata per il riempimento degli annunci. Gli annunci companion non sono supportati su tvOS.

⁵ Gli annunci ignorabili tradizionali sono supportati solo negli SDK IMA DAI per HTML5, iOS, tvOS, Roku e Android (inclusa Android TV). Con l'SDK Cast, devi dichiarare la funzionalità di salto con StreamRequest.senderCanSkip, per supportare gli annunci ignorabili tradizionali.

⁶ Gli annunci ignorabili TrueView sono supportati solo negli SDK IMA DAI per HTML5, iOS e Android (inclusa Android TV).

⁷ funzionalità di AdSense non sono supportate nell'SDK Cast.

⁸ Perché questo annuncio? richiede che il parametro adUiElement venga passato durante la creazione di StreamManager. Perché questo annuncio? non è supportato nell'SDK Cast.

Avvertenze per i framework JavaScript

Quando utilizzi un framework JavaScript, come React o AngularJS, con l'SDK IMA HTML5, devi tenere presenti alcune considerazioni. Questi framework spesso spostano gli elementi del DOM, il che può interrompere l'SDK IMA, poiché si prevede che il DOM sia statico quando viene inizializzato. L'SDK IMA supporta i framework JavaScript a condizione che l'SDK venga inizializzato dopo che il framework ha terminato lo spostamento degli elementi DOM. In particolare, l'elemento HTML5 passato come argomento adUiElement durante la costruzione di StreamManager non deve essere spostato una volta istanziato.

Supporto di Apple AirPlay

L'SDK IMA non supporta Apple AirPlay. Disattiva AirPlay o le richieste di annunci quando viene rilevato AirPlay.