Classe: AdsManager

google.ima.AdsManager

class statico

Fornisce l'API esterna al publisher e comunica con l'istanza interna di Ads Manager.

Metodi

comprimi

comprimi()

Comprimi l'annuncio corrente. Questa operazione non prevede alcuna operazione per l'SDK HTML5.

configureAdsManager

configureAdsManager(content, adsRenderingSettings)

Imposta i parametri obbligatori per ottenere un riferimento a questo AdManager dall'evento AdsManagerLoaded.

Parametro
contenuti	Oggetto Oggetto che riproduce i contenuti del publisher. Il valore non deve essere null.
Impostazioni rendering annunci	Facoltativo Impostazioni rendering annunci Impostazioni facoltative per controllare il rendering degli annunci. Il valore può essere nullo.

destroy

destroy()

Rimuove gli asset degli annunci caricati in fase di esecuzione che devono essere rimossi correttamente al momento del completamento dell'annuncio e interrompe l'annuncio e tutto il monitoraggio.

ignora interruzione pubblicitaria

ignoraAdBreak()

Se è in riproduzione un'interruzione pubblicitaria, ignorala e riprendi i contenuti. Altrimenti, ignora la successiva interruzione pubblicitaria pianificata. Ad esempio, questo può essere chiamato subito dopo il caricamento dell'account manager per ignorare un pre-roll senza perdere i mid-roll o i post-roll futuri. Questa operazione non è necessaria, a meno che la richiesta di annuncio non abbia restituito una playlist o una risposta VMAP.

Espandi

espandi()

Espandi l'annuncio corrente. Questa operazione non prevede alcuna operazione per l'SDK HTML5.

obiettivo

messa a fuoco()

Consente di mettere lo stato attivo sul pulsante Salta, se presente. Se non è presente, viene messa in evidenza un elemento interattivo, incluse icone o creatività interattive.

getAdIgnoraState

getAdIgnoraState() restituisce booleano

Restituisce true se al momento l'annuncio può essere ignorato. Quando questo valore cambia, AdsManager attiva un evento AdEvent.SKIPPABLE_STATE_CHANGED.

Valori restituiti

boolean Vero se attualmente l'annuncio può essere ignorato, falso negli altri casi.

getCuePoints

getCuePoints() restituisce un array di numeri

Restituisce una matrice di offset in secondi che indica quando verrà riprodotta un'interruzione pubblicitaria pianificata. Un pre-roll è rappresentato da 0, mentre un post-roll è rappresentato da -1. Un array vuoto indica che l'annuncio o il pod di annunci non ha una pianificazione e può essere riprodotto in qualsiasi momento.

Valori restituiti

non-null Array of number Elenco di offset temporali in secondi.

getRemainingTime

getRemainingTime() restituisce il numero

Recupera il tempo rimanente dell'annuncio attualmente in riproduzione. Se l'annuncio non è ancora stato caricato o ha terminato la riproduzione, l'API restituirà -1.

Valori restituiti

number Restituisce il tempo rimanente dell'annuncio corrente. Se il tempo rimanente non è definito per l'annuncio corrente (ad esempio, gli annunci personalizzati), il valore restituisce -1.

getVolume

getVolume() restituisce il numero

Ottieni il volume per l'annuncio corrente.

Valori restituiti

number Il volume dell'annuncio corrente, compreso tra 0 (disattivato) e 1 (massimo).

init

init(larghezza, altezza, modalità di visualizzazione, elemento video)

Chiamata per inizializzare l'esperienza pubblicitaria su Ad Manager.

Parametro
width	number La larghezza selezionata dell'annuncio.
altezza	number L'altezza dell'annuncio che hai scelto.
modalitàModalità visualizzazione	Modalità di visualizzazione La modalità di visualizzazione scelta. Il valore non deve essere null.
elemento video	Facoltativo Elemento video HTML L'elemento video per la riproduzione personalizzata. Questo elemento video esegue l'override di quello fornito nel costruttore AdDisplayContainer. Utilizza questa proprietà solo se assolutamente necessario; in caso contrario, ti consigliamo di specificare questo elemento video durante la creazione di AdDisplayContainer. Il valore può essere nullo.

Rilevamento-clic personalizzato

isCustomClickTrackingUsed() restituisce booleano

Restituisce true se un elemento di monitoraggio dei clic personalizzato viene utilizzato per il monitoraggio dei clic sull'annuncio corrente. Il monitoraggio dei clic personalizzato viene utilizzato solo quando un elemento facoltativo di monitoraggio dei clic viene fornito a AdDisplayContainer, viene utilizzata la riproduzione personalizzata e l'annuncio corrente non è un annuncio AdSense/AdX.

Valori restituiti

boolean Utilizzo o meno del monitoraggio dei clic personalizzato.

ÈusaRiproduzione personalizzata

isCustomRiproduzioneUsed() restituisce booleani

Restituisce true se un elemento video personalizzato viene usato per riprodurre l'annuncio corrente. La riproduzione personalizzata si verifica quando un elemento video facoltativo viene fornito a AdDisplayContainer sulle piattaforme in cui un elemento video personalizzato offre un'esperienza di visualizzazione degli annunci più fluida.

Valori restituiti

boolean Utilizzo della riproduzione personalizzata.

metti in pausa

in pausa()

Consente di mettere in pausa l'annuncio attualmente in riproduzione. Questa funzione sarà indipendente quando viene mostrato un overlay statico o se l'annuncio non è stato ancora caricato o ha completato la riproduzione.

resize

ridimensionamento(larghezza, altezza, modalità di visualizzazione)

Ridimensiona l'annuncio corrente.

Parametro
width	number Nuova larghezza dell'area annuncio.
altezza	number Altezza nuova area annuncio.
modalitàModalità visualizzazione	Modalità di visualizzazione La nuova modalità di visualizzazione. Il valore non deve essere null.

resume

curriculum()

Ripristina l'annuncio corrente che viene caricato e messo in pausa. Questa funzione sarà indipendente quando viene mostrato un overlay statico o se l'annuncio non è stato ancora caricato o se la riproduzione è terminata.

imposta volume

setVolume(volume)

Imposta il volume dell'annuncio corrente.

Parametro
volume	number Il volume da impostare, da 0 (disattivato) a 1 (massimo).

ignora

ignora()

Salta l'annuncio corrente quando AdsManager.getAdSkippableState() è true. Quando viene chiamato in altre circostanze, il passaggio salta non ha effetto. Al termine del salto, AdsManager attiva un evento AdEvent.SKIPPED.

inizio

Inizio()

Inizia a riprodurre gli annunci.

Gli sviluppatori devono prima chiamare AdDisplayContainer.initialize().

arresto

stop()

Interrompi la riproduzione degli annunci. In questo modo, l'editore torna ai contenuti.

aggiornaImpostazioni RenderingAnnunci

updateAdsRenderingSettings(adsRenderingSettings)

Aggiorna le impostazioni di rendering degli annunci. Deve essere utilizzato specificamente per i casi d'uso VMAP tra le interruzioni pubblicitarie quando è necessario aggiornare impostazioni di rendering degli annunci, ad esempio la velocità in bit.

Parametro
Impostazioni rendering annunci	Impostazioni rendering annunci Le impostazioni di rendering degli annunci aggiornate. Il valore non deve essere null.