google. ima. Annuncio
Una classe dell'annuncio estesa da classi che rappresentano tipi di annunci diversi.
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.