google. ima. AdsRequest
Una classe per specificare le proprietà della richiesta di annuncio.
Costruttore
Richiesta di annunci
nuovo AdsRequest()
- Implementa
- google.ima.AdsRequestInterface
Proprietà
URL tag annuncio
stringa
Specifica l'URL del tag annuncio richiesto dall'ad server. Per informazioni dettagliate sulla creazione dell'URL del tag annuncio, consulta l'articolo Creare manualmente un tag video principale.
Questo parametro è obbligatorio.
risposta_annunci
(Documento null, stringa o non null)
Specifica un documento VAST 2.0 da utilizzare come risposta agli annunci anziché effettuare una richiesta tramite l'URL di un tag annuncio. Ciò può essere utile per il debug e in altre situazioni in cui è già disponibile una risposta VAST.
Questo parametro è facoltativo.
Durata dei contenuti
(null o numero)
Specifica la durata dei contenuti in secondi da mostrare. Viene utilizzato in due casi: 1) il targeting degli annunci AdX e 2) decide quando precaricare i postroll VMAP.
Questo parametro è facoltativo.
Parole chiave dei contenuti
(valore null o valore null per l'array di stringa)
Specifica le parole chiave utilizzate per descrivere i contenuti da mostrare. Utilizzato nelle richieste AdX.
Questo parametro è facoltativo.
TitoloContenuto
(valore null o stringa)
Specifica il titolo dei contenuti da mostrare. Utilizzato nelle richieste AdX.
Questo parametro è facoltativo.
forceNonLinearFullSlot
boolean
Obbliga gli annunci AdSense non lineari a essere visualizzati a tutto spazio. Se impostato, il video dei contenuti verrà messo in pausa e l'annuncio di testo o illustrato non lineare verrà visualizzato come a tutto spazio. Il video dei contenuti riprenderà una volta che l'annuncio sarà stato ignorato o chiuso.
Altezza annuncio lineare
numero
Specifica l'altezza dell'area rettangolare all'interno della quale viene visualizzato un annuncio lineare. Questo valore viene utilizzato come uno dei criteri per la selezione degli annunci. Questo valore non deve necessariamente corrispondere all'altezza effettiva dell'annuncio.
Questo parametro è obbligatorio.
LinearAdSlotWidth
numero
Specifica la larghezza dell'area rettangolare all'interno della quale viene mostrato un annuncio lineare. Questo valore viene utilizzato come uno dei criteri per la selezione degli annunci. Non è necessario che questo valore corrisponda alla larghezza effettiva dell'annuncio.
Questo parametro è obbligatorio.
liveStreamPrefetchSeconds
numero
Specifica la quantità di tempo massima di attesa in secondi dopo la chiamata a requestAds prima di richiedere l'URL del tag annuncio. Può essere utilizzata per scaglionare le richieste durante un evento in live streaming, al fine di mitigare i picchi nel numero di richieste.
Altezza annuncio non lineare
numero
Specifica l'altezza dell'area rettangolare all'interno della quale viene visualizzato un annuncio non lineare. Questo valore viene utilizzato come uno dei criteri per la selezione degli annunci. Questo valore non deve necessariamente corrispondere all'altezza effettiva dell'annuncio.
Questo parametro è obbligatorio.
nonLinearAdSlotWidth
numero
Specifica la larghezza dell'area rettangolare all'interno della quale viene visualizzato un annuncio non lineare. Questo valore viene utilizzato come uno dei criteri per la selezione degli annunci. Non è necessario che questo valore corrisponda alla larghezza effettiva dell'annuncio.
Questo parametro è obbligatorio.
Regole omidAccessMode
Oggetto non null con proprietà stringa
Oggetto Impostazioni per mappare i fornitori di verifica alle modalità di accesso OMID. Le chiavi devono essere valori in google.ima.OmidVerificationVendor e i valori devono essere valori in google.ima.OmidAccessMode.
Gli URL degli script di verifica vengono abbinati internamente alle espressioni regolari fornite dal fornitore per risolvere una chiave OmidVerificationVendor. IMA cerca quindi la modalità di accesso per il fornitore specifico utilizzando questo oggetto.
Per gli URL degli script che non vengono risolti presso un fornitore noto o se l'oggetto OmidVerificationVendor non è stato fornito in questo oggetto, IMA utilizzerà la modalità di accesso fornita per OmidVerificationVendor.OTHER. Se OmidVerificationVendor.OTHER non viene fornito, verrà utilizzata la modalità di accesso LIMITATA.
URL pagina
(valore null o stringa)
Specifica l'URL completo della pagina che verrà inclusa nella richiesta di annuncio Google ai fini del targeting. L'URL deve essere un URL valido. Se specificato, questo valore verrà utilizzato per la macro VAST [PAGEURL].
Questo parametro è facoltativo.
vastLoadTimeout
numero
Esegui l'override del timeout di caricamento VAST predefinito in millisecondi per un singolo wrapper. Il timeout predefinito è 5000 ms.
Questo parametro è facoltativo.
Metodi
impostaadwillautoplay
setAdWillAutoPlay(autoPlay) restituisce null
Comunica all'SDK se il player intende avviare i contenuti e l'annuncio in risposta a un'azione dell'utente o se verrà riprodotto automaticamente. La modifica di questa impostazione non influirà sulla riproduzione degli annunci.
Parametro |
|
---|---|
riproduzione automatica |
boolean Indica se i contenuti e l'annuncio verranno riprodotti automaticamente o se saranno avviati da un'azione dell'utente. |
- Valori restituiti
-
void
setAdWillPlayMuted
setAdWillPlayMuted(audio disattivato) restituisce null
Informa l'SDK se il player intende avviare l'annuncio con l'audio disattivato. La modifica di questa impostazione non influirà sulla riproduzione dell'annuncio, ma invierà l'indicatore appropriato nella richiesta di annuncio per consentire agli acquirenti di fare offerte per l'inventario disattivato.
Parametro |
|
---|---|
audio disattivato |
boolean Indica se l'annuncio verrà riprodotto con l'audio disattivato. |
- Valori restituiti
-
void
impostaContinuaRiproduzione
setContinuousRiproduzione(continuousRiproduzione) restituisce null
Informa l'SDK se il player intende riprodurre continuamente i video dei contenuti uno dopo l'altro in modo simile alla trasmissione TV. La modifica di questa impostazione non influirà sulla riproduzione dell'annuncio, ma invierà l'indicatore appropriato in questa richiesta di annuncio per consentire agli acquirenti di fare offerte sul tipo di inventario pubblicitario.
Parametro |
|
---|---|
riproduzione continua |
boolean Consente di specificare se il video dei contenuti viene riprodotto uno dopo l'altro in modo continuativo. |
- Valori restituiti
-
void