google.
Questa classe rappresenta un contenitore per la visualizzazione di annunci. L'SDK creerà automaticamente strutture all'interno del parametro containerElement per ospitare gli annunci video e in overlay.
Quando viene creata un'istanza di questa classe, crea un IFRAME in
containerElement e carica il core SDK. Questo IFRAME deve essere conservato
affinché l'SDK funzioni correttamente. Una volta che tutti gli annunci sono stati riprodotti e l'SDK non è più necessario, utilizza il metodo destroy() per annullare il caricamento dell'SDK.
Il parametro containerElement deve essere un elemento che fa parte del DOM. È necessario posizionare correttamente il containerElement in modo che gli annunci vengano visualizzati correttamente. È consigliabile posizionarlo sopra il video player dei contenuti e ridimensionarlo in modo da coprire l'intero video player. Per informazioni dettagliate sulle implementazioni consigliate, consulta la documentazione dell'SDK.
Nota: è sempre necessario chiamare il metodo initialize() nel codice richiamato direttamente da un'azione dell'utente, ad esempio un clic o un tocco.
Costruttore
Contenitore per annunci display
nuovo AdDisplayContainer(containerElement, videoElement, clickTrackingElement)
Parametro |
|
|---|---|
|
containerElement |
L'elemento in cui visualizzare gli annunci. L'elemento deve essere inserito nel DOM prima di creare AdDisplayContainer. Il valore non deve essere null. |
|
elemento video |
Facoltativo Specifica l'elemento di riproduzione degli annunci video alternativo. Ti consigliamo di trasmettere sempre il video player dei contenuti. Il valore non deve essere null. |
|
Elemento di monitoraggio click |
Facoltativo Specifica l'elemento clic alternativo dell'annuncio video. Lascia questo valore null per consentire all'SDK di gestire i clic. Anche se viene fornito, l'SDK utilizzerà l'elemento di monitoraggio dei clic personalizzato solo quando le creatività non AdSense/AdX vengono visualizzate in ambienti che non supportano gli elementi UI che si sovrappongono a un video player (ad esempio, iPhone o versioni precedenti ad Android 4.0). L'elemento di monitoraggio dei clic personalizzato non deve mai essere visualizzato sul video player, perché può intercettare i clic sugli elementi UI visualizzati dall'SDK. Inoltre, tenete presente che l'SDK non modifica la visibilità dell'elemento di monitoraggio dei clic personalizzato. Ciò significa che se viene fornito un elemento di monitoraggio dei clic personalizzato, questo deve essere visualizzato correttamente quando viene riprodotto l'annuncio lineare. Puoi controllare ima.AdsManager.isCustomClickTrackingUsed quando l'evento ima.AdEvent.Type.STARTED viene attivato per determinare se visualizzare o meno l'elemento di monitoraggio dei clic personalizzato. Se opportuno per la tua UI, devi nascondere l'elemento di monitoraggio dei clic quando viene attivato l'evento ima.AdEvent.Type.CONTENT_RESUME_REQUESTED. Il valore non deve essere null. |
Metodi
destroy
destroy()
Elimina lo stato interno e gli elementi DOM creati in precedenza. L'SDK IMA verrà caricato e non verranno effettuate ulteriori chiamate ad alcuna API.
initialize
inizializza()
Inizializza gli elementi video interni per la riproduzione. Devi richiamare questo metodo come risultato diretto di un'azione dell'utente, in modo che il browser possa contrassegnare l'elemento video come avviato dall'utente.
Alcuni browser consentono la riproduzione video senza interazioni da parte degli utenti se l'audio del video è disattivato. Per questo comportamento, utilizza AdsRequest.setAdWillPlayMuted(true) e richiama questo metodo prima di AdsManager.start().