google. ima. AdsRequest
Es una clase para especificar propiedades de la solicitud de anuncio.
Constructor
Solicitud de anuncios
nuevo AdsRequest()
- Implementa
- google.ima.AdsRequestInterface
Propiedades
URL de etiqueta de anuncio
string
Especifica la URL de la etiqueta de anuncio que se solicita al servidor de anuncios. Para obtener información detallada sobre cómo crear la URL de la etiqueta del anuncio, consulte Cree una etiqueta de video del anuncio principal manualmente.
Este parámetro es obligatorio.
Respuesta de los anuncios
(nulo, string o no nulo)
Especifica un documento de VAST 2.0 para usar como respuesta de anuncios en lugar de realizar una solicitud a través de una URL de etiqueta de anuncio. Esto puede ser útil para la depuración y otras situaciones en las que una respuesta de VAST ya esté disponible.
Este parámetro es opcional.
Duración del contenido
(nulo o número)
Especifica la duración del contenido en segundos que se mostrará. Se usa en 2 casos: 1) la segmentación de anuncios de AdX y 2) la decisión de cuándo precargar un anuncio final de VMAP.
Este parámetro es opcional.
palabras clave en contenido
(Array de string nulo o no nulo)
Especifica las palabras clave que se utilizan para describir el contenido que se mostrará. Se usa en las solicitudes de AdX.
Este parámetro es opcional.
Título del contenido
(nulo o string)
Especifica el título del contenido que se mostrará. Se usa en solicitudes de AdX.
Este parámetro es opcional.
forzarNonLineFullSlot
boolean
Hace que los anuncios no lineales de AdSense se rendericen como espacios publicitarios lineales completos. Si se configura, el video de contenido se detendrá y el anuncio de texto o con imágenes no lineal se procesará como espacio publicitario completo. El video de contenido se reanudará una vez que el anuncio se haya omitido o cerrado.
Altura del espacio publicitario lineal
número
Especifica la altura del área rectangular en la que se muestra un anuncio lineal. Este valor se usa como uno de los criterios para la selección de anuncios. No es necesario que este valor coincida con la altura real del anuncio.
Este parámetro es obligatorio.
Ancho del espacio publicitario lineal
número
Especifica el ancho del área rectangular en la que se muestra un anuncio lineal. Este valor se usa como uno de los criterios para la selección de anuncios. No es necesario que este valor coincida con el ancho real del anuncio.
Este parámetro es obligatorio.
liveStreamPrefetchSeconds
número
Especifica el tiempo máximo que se debe esperar en segundos, después de llamar a requestAds, antes de solicitar la URL de la etiqueta de anuncio. Esto se puede usar para escalonar solicitudes durante un evento de transmisión en vivo, a fin de mitigar los aumentos repentinos en la cantidad de solicitudes.
Altura del espacio no lineal
número
Especifica la altura del área rectangular en la que se muestra un anuncio no lineal. Este valor se usa como uno de los criterios para la selección de anuncios. No es necesario que este valor coincida con la altura real del anuncio.
Este parámetro es obligatorio.
noLinealAnchoAnchoDelAnuncio
número
Especifica el ancho del área rectangular en la que se muestra un anuncio no lineal. Este valor se usa como uno de los criterios para la selección de anuncios. No es necesario que este valor coincida con el ancho real del anuncio.
Este parámetro es obligatorio.
omidAccessModeRules
Objeto no nulo con propiedades de string
Objeto de configuración para asignar proveedores de verificación a los modos de acceso OMID. Las claves deben ser valores en google.ima.OmidVerificationVendor, y los valores deben ser valores en google.ima.OmidAccessMode.
Las URL de las secuencias de comandos de verificación se comparan internamente con las expresiones regulares proporcionadas por el proveedor para resolver una clave de OmidVerificationVendor. Luego, IMA busca el modo de acceso para el proveedor determinado mediante este objeto.
En el caso de las URLs de secuencias de comandos que no se resuelven para un proveedor conocido, o si el OmidVerificationVendor resuelto no se proporciona en este objeto, IMA usará el modo de acceso proporcionado para OmidVerificationVendor.OTHER. Si no se proporciona OmidVerificationVendor.OTHER, se usará el modo de acceso LIMITADO.
URL de la página
(nulo o string)
Especifica la URL completa de la página que se incluirá en la solicitud de anuncio de Google para fines de segmentación. La URL debe ser válida. Si se especifica, este valor se usará para la macro VAST [PAGEURL].
Este parámetro es opcional.
vastLoadTimeout
número
Anula el tiempo de espera predeterminado de carga de VAST en milisegundos para un solo wrapper. El tiempo de espera predeterminado es de 5,000 ms.
Este parámetro es opcional.
Métodos
setAdWillAutoPlay
setAdWillAutoPlay(autoPlay) muestra void
Notifica al SDK si el reproductor tiene la intención de iniciar el contenido y el anuncio en respuesta a una acción del usuario o si se reproducirá automáticamente. Cambiar esta configuración no afectará la reproducción de anuncios.
Parámetro |
|
---|---|
reproducción automática |
boolean Si el contenido y el anuncio se reproducirán automáticamente o si una acción del usuario los iniciará. |
- Resultado que se muestra
-
void
setAdWillPlayMuted
setAdWillPlayMuted(muted) devuelve void
Notifica al SDK si el reproductor tiene la intención de iniciar el anuncio mientras está silenciado. Cambiar esta configuración no tendrá ningún impacto en la reproducción de anuncios, pero enviará el indicador apropiado en la solicitud de anuncio para permitir que los compradores oferten en el inventario silenciado.
Parámetro |
|
---|---|
silenciado |
boolean Indica si el anuncio se reproducirá mientras está silenciado. |
- Resultado que se muestra
-
void
setContinuousPlayback
setContinuousPlayback(continuousPlayback) muestra void
Notifica al SDK si el reproductor está configurado para reproducir continuamente los videos uno tras otro similares a los de una transmisión de TV. Cambiar esta configuración no tendrá ningún impacto en la reproducción de anuncios, pero enviará el indicador adecuado en esta solicitud de anuncio para permitir que los compradores oferten en el tipo de inventario de anuncios.
Parámetro |
|
---|---|
Reproducción continua |
boolean Indica si el video de contenido se reproduce uno tras otro. |
- Resultado que se muestra
-
void