Classe: annuncio

Metodi

getAdId

getAdId() restituisce stringa

L'ID annuncio viene utilizzato per sincronizzare gli annunci principali e companion.

Valori restituiti

string L'ID dell'annuncio o la stringa vuota se queste informazioni non sono disponibili.

getAdPodInfo

getAdPodInfo() restituisce AdPodInfo

Restituisce le informazioni sul pod dell'annuncio.

Valori restituiti

non-null AdPodInfo Informazioni sui pod dell'annuncio.

getAdSystem

getAdSystem() restituisce stringa

Le informazioni sull'ad server di origine incluse nella risposta di annuncio.

Valori restituiti

string L'ad server di origine dell'annuncio o la stringa vuota se queste informazioni non sono disponibili.

getNomeInserzionista

getInserzionistaName() restituisce stringa

Il nome dell'inserzionista come definito dalla parte che gestisce la pubblicazione.

Valori restituiti

string Il nome dell'inserzionista o la stringa vuota se queste informazioni non sono disponibili.

getApiFramework

getApiFramework() restituisce stringa

Identifica l'API necessaria per eseguire l'annuncio. Corrisponde all'apiapiwork specificato in VAST.

Valori restituiti

nullable string Il framework dell'API deve eseguire l'annuncio oppure essere nullo se queste informazioni non sono disponibili.

getCompanionAds

getCompanionAds(adSlotWidth, adSlotHeight, settings) restituisce un array di CompanionAd non null

Visualizza gli annunci companion per questo annuncio in base alle dimensioni dell'area annuncio companion. Facoltativamente, sono accettate le impostazioni di selezione avanzate. Tieni presente che questo metodo restituirà un array non vuoto solo per istanze di annuncio acquisite su o dopo l'evento AVVIATO. In particolare, gli annunci dell'evento LOADED restituiranno un array vuoto.

Parametro

Larghezza annuncio

numero

Larghezza dell'area annuncio companion.

Altezza annuncio

numero

Altezza dell'area annuncio companion.

impostazioni

Facoltativo

Impostazioni CompanionAdSelection

Le impostazioni di selezione per gli annunci companion.

Il valore non deve essere null.

Valori restituiti

non-null Array of non-null CompanionAd Array di annunci companion che corrispondono alle impostazioni e alle dimensioni dell'area annuncio.

getContentType

getContentType() restituisce stringa

Restituisce il tipo di contenuti della creatività attualmente selezionata oppure la stringa vuota se non è stata selezionata alcuna creatività o se il tipo di contenuto non è disponibile. Per gli annunci lineari, il tipo di contenuto sarà disponibile solo dopo l'evento START, quando il file multimediale è selezionato.

Valori restituiti

string Tipo di contenuto, stringa vuota se non disponibile.

ID annuncio creativo

getCreativeAdId() restituisce stringa

Restituisce il codice ISCI (Industry Standard Commercial Identifier) per un annuncio oppure una stringa vuota se il codice non è disponibile. Si tratta dell'ID annuncio della creatività nella risposta VAST.

Valori restituiti

string 

ID creatività

getCreativeId() restituisce stringa

Recupera l'ID della creatività selezionata per l'annuncio.

Valori restituiti

string L'ID della creatività selezionata per l'annuncio o la stringa vuota se queste informazioni non sono disponibili.

ID deal

getDealId() restituisce stringa

Restituisce il primo ID deal presente nella catena di wrapper per l'annuncio corrente, a partire dall'alto. Restituisce la stringa vuota se non disponibile.

Valori restituiti

string 

getDescription

getDescription() restituisce stringa

Restituisce la descrizione di questo annuncio dalla risposta VAST.

Valori restituiti

string La descrizione, se non specificata, è vuota.

getDuration

getDuration() restituisce numero

Restituisce la durata della creatività selezionata o -1 per le creatività non lineari.

Valori restituiti

number La durata della creatività selezionata in secondi, -1 se non lineare.

getHeight

getHeight() restituisce numero

Restituisce l'altezza della creatività non lineare selezionata.

Valori restituiti

number L'altezza della creatività non lineare selezionata o 0 per una creatività lineare.

getUrl URL

getMediaUrl() restituisce stringa

Restituisce l'URL del file multimediale scelto dall'annuncio in base alle impostazioni di selezione dei contenuti multimediali attualmente in uso. Restituisce null se queste informazioni non sono disponibili. Disponibile per l'evento AVVIATO.

Valori restituiti

nullable string 

getMinDurationDuration

getMinSuggestDuration() restituisce numero

Restituisce la durata minima suggerita in secondi durante la quale deve essere visualizzata la creatività non lineare. Restituisce -2 se la durata minima suggerita è sconosciuta. Per le creatività lineari, restituisce l'intera durata dell'annuncio.

Valori restituiti

number La durata minima consigliata in secondi per la visualizzazione di una creatività.

getSkipTimeOffset

getSkipTimeOffset() restituisce il numero

Il numero di secondi di riproduzione prima che l'annuncio diventi ignorabile. Viene restituito -1 per gli annunci non ignorabili o se questo non è disponibile.

Valori restituiti

number L'offset in secondi o -1.

getUrlUrl

getSurveyUrl() restituisce stringa

Restituisce l'URL associato al sondaggio per il determinato annuncio. Restituisce null se non disponibile.

Valori restituiti

nullable string 

getTitle

getTitle() restituisce stringa

Restituisce il titolo di questo annuncio dalla risposta VAST.

Valori restituiti

string Il titolo, se non specificato, è vuoto.

getParameterParameters

get TraffickingParameters() restituisce oggetto con proprietà stringa

Recupera i parametri personalizzati associati all'annuncio al momento della gestione del traffico degli annunci.

Valori restituiti

non-null Object with string properties Una mappatura delle chiavi di gestione del traffico ai relativi valori o all'oggetto vuoto se queste informazioni non sono disponibili.

getTrafficParametersString

getTrafficParametersString() restituisce stringa

Recupera i parametri personalizzati associati all'annuncio al momento della gestione del traffico degli annunci. Restituisce una versione non elaborata della stringa dei parametri analizzati da getTrafficParameters.

Valori restituiti

string Parametri di trafficking o la stringa vuota se queste informazioni non sono disponibili.

getUiElements

getUiElements() restituisce un array di stringhe

Restituisce gli elementi UI che vengono visualizzati quando viene riprodotto questo annuncio. Fai riferimento a UiElements per possibili elementi dell'array restituito.

Valori restituiti

non-null Array of string Gli elementi dell'interfaccia utente visualizzati.

getUniversalAdIdRegistry

getUniversalAdIdRegistry() restituisce stringa

Il registry associato alla catalogazione dell'UniversalAdId della creatività selezionata per l'annuncio.

Deprecazione
Usa ad.getUniversalAdIds()
Valori restituiti

string Restituisce il valore del Registro di sistema o "unknown" se non disponibile.

getUniversalAdIdValue

getUniversalAdIdValue() restituisce stringa

L'ID annuncio universale della creatività selezionata per l'annuncio.

Deprecazione
Usa ad.getUniversalAdIds()
Valori restituiti

string Restituisce il valore ID o "unknown" se non disponibile.

getUniversalAdIds

getUniversalAdIds() restituisce un array di UniversalAdIdInfo non null

L'elenco degli ID annunci universali della creatività selezionata per l'annuncio.

Valori restituiti

non-null Array of non-null UniversalAdIdInfo Restituisce l'elenco delle informazioni sull'ID annuncio universale applicabili a questo annuncio.

getVastMediaBitrate

getVastMediaBitrate() restituisce numero

Se la creatività e il file multimediale sono stati selezionati dall'SDK, verrà restituito il bitrate per il file multimediale indicato nella risposta VAST.

Valori restituiti

number La velocità in bit per il file multimediale selezionato o 0.

getVastMediaHeight

getVastMediaHeight() restituisce numero

Restituisce l'altezza del supporto VAST della creatività selezionata.

Valori restituiti

number L'altezza del supporto VAST della creatività selezionata o 0 se non è selezionata alcuna opzione.

getVastMediaWidth

getVastMediaWidth() restituisce numero

Restituisce la larghezza multimediale VAST della creatività selezionata.

Valori restituiti

number La larghezza del supporto VAST della creatività selezionata o pari a 0 se il criterio non è selezionato.

getWidth

getWidth() restituisce numero

Restituisce la larghezza della creatività selezionata.

Valori restituiti

number La larghezza della creatività non lineare selezionata o 0 per una creatività lineare.

getWrapperAdIds

getWrapperAdIds() restituisce array di stringa

ID annuncio utilizzati per gli annunci wrapper. Gli ID restituiti iniziano dall'annuncio in linea (interno) e passano all'annuncio wrapper più esterno. Se non sono presenti annunci wrapper, viene restituito un array vuoto.

Valori restituiti

non-null Array of string Gli ID degli annunci, a partire dall'annuncio in linea, oppure gli array vuoti se non sono presenti annunci wrapper.

getWrapperAdSystems

getWrapperAdSystems() restituisce un array di stringhe

Sistemi pubblicitari utilizzati per gli annunci wrapper. I sistemi pubblicitari restituiti iniziano dall'annuncio in linea e passano all'annuncio wrapper più esterno. Se non sono presenti annunci wrapper, viene restituito un array vuoto.

Valori restituiti

non-null Array of string I sistemi pubblicitari degli annunci, a partire dall'annuncio in linea oppure un array vuoto se non sono presenti annunci wrapper.

ID wrapper creatività

getWrapperCreativeIds() restituisce un array di stringhe

ID creatività selezionati utilizzati per gli annunci wrapper. Gli ID creatività restituiti iniziano dall'annuncio in linea e passano all'annuncio wrapper più esterno. Se non sono presenti annunci wrapper, viene restituito un array vuoto.

Valori restituiti

non-null Array of string Gli ID delle creatività degli annunci, a partire dall'annuncio in linea o un array vuoto se non sono presenti annunci wrapper.

Lineare

isLinear() restituisce booleani

Indica se la modalità operativa corrente dell'annuncio è lineare o non lineare. Se il valore è true, indica che l'annuncio è in modalità di riproduzione lineare; se è false, indica una modalità non lineare. Il player controlla la proprietà lineare e ne aggiorna lo stato in base ai dettagli del posizionamento dell'annuncio. Quando l'annuncio è in modalità lineare, il player mette in pausa il video dei contenuti. Se inizialmente il valore lineare è vero e l'annuncio è un pre-roll (definito esternamente), il player può scegliere di ritardare il caricamento del video dei contenuti fino alla fine della riproduzione dell'annuncio.

Valori restituiti

boolean Vero se l'annuncio è lineare, falso negli altri casi.