google.
Esta clase representa un contenedor para mostrar anuncios. El SDK creará estructuras dentro del parámetro containerElement para alojar anuncios superpuestos y de video.
Cuando se crea una instancia de esta clase, se crea un IFRAME en containerElement y carga el núcleo del SDK. Este IFRAME debe conservarse para que el SDK funcione correctamente. Una vez que se hayan reproducido todos los anuncios y el SDK ya no sea necesario, usa el método destroy() para descargar el SDK.
El parámetro containerElement debe ser un elemento que forma parte del DOM. Es necesario posicionar el containerElement correctamente para que los anuncios se muestren correctamente. Se recomienda colocarlo sobre el reproductor de video de contenido y ajustarlo al tamaño completo. Consulta la documentación del SDK para obtener detalles sobre las implementaciones recomendadas.
Nota: Siempre es necesario llamar al método initialize() en el código que una acción del usuario invocó directamente (como hacer clic o presionar).
Constructor
Contenedor de anuncio gráfico
nuevo AdDisplayContainer(containerElement, videoElement, clickTrackingElement)
Parámetro |
|
|---|---|
|
containerElement |
El elemento en el que se mostrarán los anuncios. El elemento debe insertarse en el DOM antes de crear AdDisplayContainer. El valor no debe ser nulo. |
|
elemento de video |
Opcional Especifica el elemento de reproducción de anuncios de video alternativo. Te recomendamos que siempre pases el reproductor de video de contenido. El valor no debe ser nulo. |
|
Elemento de seguimiento de clics |
Opcional Especifica el elemento de clic de anuncio de video alternativo. Deja este valor nulo para permitir que el SDK controle los clics. Incluso si se proporciona, el SDK solo usará el elemento personalizado de seguimiento de clics cuando las creatividades que no sean de AdSense/AdX se muestren en entornos que no admitan elementos de la IU superpuestos a un reproductor de video (por ejemplo, iPhone o versiones anteriores a Android 4.0). El elemento personalizado de seguimiento de clics nunca debe procesarse en el reproductor de video, ya que puede interceptar clics en elementos de la IU que procesa el SDK. Además, ten en cuenta que el SDK no modificará la visibilidad del elemento de seguimiento de clic personalizado. Esto significa que, si se proporciona un elemento personalizado de seguimiento de clics, se debe mostrar correctamente cuando se reproduce el anuncio lineal. Puedes verificar ima.AdsManager.isCustomClickTrackingUsed cuando se activa el evento ima.AdEvent.Type.STARTED para determinar si se muestra o no tu elemento de seguimiento de clics personalizado. Si corresponde para tu IU, debes ocultar el elemento de seguimiento de clics cuando se active el evento ima.AdEvent.Type.CONTENT_RESUME_REQUESTED. El valor no debe ser nulo. |
Métodos
destroy
destroy()
Destruye el estado interno y los elementos del DOM creados anteriormente. Se descargará el SDK de IMA y no se deberán realizar más llamadas a ninguna API.
initialize
inicializar()
Inicializa los elementos de video internos para la reproducción. Debes llamar a este método como resultado directo de una acción del usuario, de modo que el navegador pueda marcar el elemento de video como iniciado por el usuario.
Algunos navegadores permitirán la reproducción de video sin interacciones del usuario si este se silencia. Para este comportamiento, usa AdsRequest.setAdWillPlayMuted(true) y llama a este método antes del AdsManager.start().