google. ima. AdsManager
Proporciona la API pública externa al publicador y se comunica con la instancia interna del administrador de anuncios.
Métodos
contraer
contraer
Contraiga el anuncio actual. Esta es una no-op para SDK de HTML5.
configureAdsManager
configureAdsManager(contenido, adsRenderingSettings)
Establece los parámetros necesarios para obtener una referencia a este AdManager desde el evento AdsManagerLoaded.
Parámetro |
|
---|---|
contenido |
Objeto Objeto que reproduce el contenido del publicador El valor no debe ser nulo. |
Configuración de renderización de anuncios |
Opcional Configuración de renderización de anuncios Configuración opcional para controlar la renderización de anuncios. El valor puede ser nulo. |
destroy
destroy()
Quita los elementos del anuncio que se cargan en el tiempo de ejecución y que se deben quitar correctamente al momento de finalizar el anuncio, y detiene el anuncio y el seguimiento correspondiente.
descartarAdBreak
descartarAdBreak()
Si se está reproduciendo una pausa publicitaria, descártala y reanuda el contenido. De lo contrario, ignora la siguiente pausa publicitaria programada. Por ejemplo, esto se puede llamar inmediatamente después de que se carga el administrador de anuncios para ignorar un anuncio previo sin perder los anuncios durante el video o al final del video. Esta es una no-op, a menos que la solicitud de anuncio muestre una respuesta de lista de reproducción o VMAP.
expandir
expandir()
Expanda el anuncio actual. Esta es una no-op para SDK de HTML5.
enfoque
foco()
Enfoca el botón Omitir, si está presente. Si no están presentes, el foco se centra en elementos interactivos, incluidos los íconos o las creatividades interactivas.
getAdSkipState
getAdSkipState() muestra un valor booleano.
El resultado es verdadero si el anuncio se puede omitir en este momento. Cuando cambia este valor, AdsManager
activa un evento AdEvent.SKIPPABLE_STATE_CHANGED
.
- Resultado que se muestra
-
boolean
Verdadero si el anuncio se puede omitir en ese momento. De lo contrario, es falso.
getCuePoints
getCuePoints() muestra Array de número
Muestra un arreglo de desplazamientos en segundos que indica cuándo se reproducirá una pausa publicitaria programada. Un anuncio previo al video está representado por 0, y un anuncio final del video, que está representado por -1. Un arreglo vacío indica que el anuncio o grupo de anuncios no tiene programación y se puede reproducir en cualquier momento.
- Resultado que se muestra
-
non-null Array of number
Lista de compensaciones horarias en segundos.
getRemainingTime
getRemainingTime() muestra un número
Obtiene el tiempo restante del anuncio actual que se está reproduciendo. Si el anuncio aún no se cargó o terminó de reproducirse, la API mostrará -1.
- Resultado que se muestra
-
number
Muestra el tiempo restante del anuncio actual. Si el tiempo restante no está definido para el anuncio actual (por ejemplo, los anuncios personalizados), el valor muestra -1.
getVolume
getVolume() devuelve número
Obtenga el volumen del anuncio actual.
- Resultado que se muestra
-
number
El volumen del anuncio actual, de 0 (silenciado) a 1 (más alto)
init
init(ancho, altura, viewMode, videoElement)
Llama a init para inicializar la experiencia del anuncio en el administrador de anuncios.
Parámetro |
|
---|---|
ancho |
número El ancho elegido del anuncio. |
alto |
número La altura elegida del anuncio. |
modo de vista |
Modo de vista El modo de vista elegido El valor no debe ser nulo. |
elemento de video |
Opcional Elemento de video HTML El elemento de video para la reproducción personalizada. Este elemento de video anula el que se proporciona en el constructor AdDisplayContainer. Usa esta propiedad solo si es absolutamente necesaria; de lo contrario, recomendamos especificar este elemento de video cuando crees el AdDisplayContainer. El valor puede ser nulo. |
Seguimiento de clics personalizado
isCustomClickTrackingUsed() muestra un valor booleano
Muestra true si se usa un elemento personalizado de seguimiento de clics para el seguimiento de clics en el anuncio actual. El seguimiento de clics personalizado solo se usa cuando se proporciona un elemento opcional de seguimiento de clics a AdDisplayContainer
, se usa la reproducción personalizada y el anuncio actual no es un anuncio de AdSense/AdX.
- Resultado que se muestra
-
boolean
Indica si se utiliza el seguimiento de clics personalizado.
isCustomPlaybackUsed
isCustomPlaybackUsed() muestra un valor booleano.
Muestra true si se usa un elemento de video personalizado para reproducir el anuncio actual. La reproducción personalizada ocurre cuando se proporciona un elemento de video opcional al AdDisplayContainer
en plataformas en las que un elemento de video personalizado brindaría una experiencia de visualización de anuncios más fluida.
- Resultado que se muestra
-
boolean
Indica si se usa la reproducción personalizada.
pausar
pausa()
Detiene el anuncio actual que se reproduce. Esta función no funcionará cuando se muestre una superposición estática, o bien si el anuncio aún no se cargó o termina de reproducirse.
resize
cambio de tamaño(ancho, altura, modo de vista)
Permite cambiar el tamaño del anuncio actual.
Parámetro |
|
---|---|
ancho |
número Nuevo ancho del espacio publicitario. |
alto |
número Nueva altura del espacio publicitario. |
modo de vista |
Modo de vista El nuevo modo de vista. El valor no debe ser nulo. |
resume
CV()
Reanuda el anuncio actual que se cargó y detuvo. Esta función será no-op cuando se muestre una superposición estática o si el anuncio aún no se cargó o se termina de reproducir.
establecerVolumen
Volumen de volumen(volumen)
Establezca el volumen para el anuncio actual.
Parámetro |
|
---|---|
Volume |
número El volumen que se debe establecer, de 0 (silenciado) a 1 (más alto) |
omitir
skip()
Omite el anuncio actual cuando AdsManager.getAdSkippableState()
es verdadero. Cuando se lo llama en otras circunstancias, la omisión no tiene efecto. Una vez que se completa la omisión, AdsManager
activa un evento AdEvent.SKIPPED
.
iniciar
start()
Comience a reproducir los anuncios.
Los desarrolladores deben llamar primero a AdDisplayContainer.initialize()
.
stop
stop()
Deje de reproducir anuncios. Si lo haces, el publicador volverá al contenido.
updateAdsRenderingSettings
updateAdsRenderingSettings(adsRenderingSettings)
Actualiza la configuración de renderización de anuncios. Se debe usar específicamente para casos prácticos de VMAP entre pausas publicitarias cuando se debe actualizar la configuración de renderización de anuncios, como la tasa de bits.
Parámetro |
|
---|---|
Configuración de renderización de anuncios |
Configuración de renderización de anuncios Se actualizó la configuración de procesamiento de anuncios. El valor no debe ser nulo. |