Parámetros que se requieren para las aplicaciones

La implementación de una solución de video basada en etiquetas para la demanda de Ad Exchange sin el uso del SDK de IMA es una opción en fase beta y es posible que no esté disponible para su red. Para obtener más información, puede comunicarse con su administrador de cuentas.

A continuación, se incluye un subconjunto de los parámetros de URL de las etiquetas de anuncios de VAST. Estos parámetros se requieren en las soluciones de video basadas en etiquetas para apps cuando no se integran con el SDK de IMA.

Consulta la lista de parámetros que se requieren para la Web o los parámetros recomendados para la monetización programática.

 Avanza a un parámetro específico en la lista

an correlator description_url env gdfp_req idtype

is_lat iu msid output pvid pvid_s

rdid sz unviewed_position_start url wta

 

Parámetro	Detalles
correlator (Correlator)	El parámetro de correlator admite un valor variable que comparten múltiples solicitudes provenientes de la misma página vista. Se usa para implementar exclusiones de la competencia, incluso en entornos sin cookies. Si usa el SDK de IMA, el valor de correlator se establece automáticamente. Si tu reproductor intenta establecer este valor, el SDK lo reemplaza y establece su propio valor. Si no usas el SDK de IMA, asegúrate de elegir un valor entero positivo verdaderamente aleatorio que no se vuelva a usar en varias páginas vistas. Ejemplo de uso correlator=4345645667 Requisito Se requiere para la Web y las aplicaciones. Se recomienda para la monetización programática.
description_url (URL de descripción)	El parámetro de URL de descripción acepta un valor variable que debe describir el video que se reproduce en la página. Por lo general, es la página que contiene el reproductor de video, pero también puede ser una página con texto que describa el video. El valor description_url debe estar codificado en formato de URL para los reproductores de video de las páginas web y dispositivos OTT o CTV, y no debe tener codificación si está destinado a los reproductores de video de anuncios en apps para dispositivos móviles. El SDK de IMA no configura este parámetro automáticamente, por lo que se debe definir de forma manual. Ejemplo de uso Con codificación en formato de URL: description_url= https%3A%2F%2Fwww.sample.com%2Fgolf.html Sin codificación: description_url= https://www.sample.com/golf.html Requisito Se requiere para la Web, las aplicaciones y Ad Exchange. Se recomienda para la monetización programática.
env (Entorno)	El parámetro de entorno admite un valor constante que indica que una solicitud es in-stream o que proviene específicamente de un reproductor de video. Los valores posibles son instream, que se puede utilizar para anuncios de video y audio, o vp, que solo se puede utilizar para anuncios de video. Ejemplo de uso Video o audio: env=instream Solo video: env=vp Requisito Se requiere para la Web y las aplicaciones.
gdfp_req (Indicador de esquema de Ad Manager)	El parámetro de indicador de esquema de Ad Manager admite un valor constante que indica que el usuario está en el esquema de Ad Manager. Ejemplo de uso gdfp_req=1 Requisito Se requiere para la Web y las aplicaciones.
iu (Unidad de anuncios)	El parámetro de bloque de anuncios admite un valor variable que se debe definir con el bloque de anuncios actual, en el formato que se indica a continuación: /network_id/.../ad_unit Ejemplo de uso iu=/6062/videodemo Requisito Se requiere para la Web y las aplicaciones.
msid (ID de la app) an (Nombre de la app)	Los parámetros de ID y nombre de la app admiten valores variables que se deben aplicar a las solicitudes que se envíen desde apps para dispositivos móviles y dispositivos de TV conectada, ya que son necesarios en la mayoría de los anuncios de video programáticos. El SDK de IMA los propagará automáticamente, pero deben especificarse de forma manual en entornos que no pertenezcan al SDK, incluidas las llamadas directas de VAST, o cuando se use la Biblioteca de acceso programático (PAL) o el Inventario autenticado por el publicador (PAI). Si bien el nombre de la app debe ser legible por humanos, en iOS y tvOS, el SDK no puede acceder al ID de la app. En estos casos, no se envía el parámetro msid, y el SDK envía el paquete de aplicación con el parámetro an. Ejemplo de uso msid=com.package.publisher&an=sample%20app Los IDs de apps tienen distintos nombres y formatos en función de las diferentes tiendas de aplicaciones. Consulta los lineamientos de la IAB para la identificación de apps o ejemplos de identificadores únicos comunes. En el caso de las plataformas en las que no exista una tienda de aplicaciones, la IAB recomienda a los publicadores usar el siguiente formato para los IDs de tiendas: com.publicador.plataformadedispositivo. Requisito Ambos parámetros son obligatorios para la app. Se recomienda para la monetización programática.
output (Formato de salida del anuncio)	El parámetro de formato de salida del anuncio admite un valor constante que debe definirse con el formato de salida del anuncio. Use output=vast para la versión de VAST predeterminada definida para su red. En el caso de determinadas etiquetas de anuncios o partes de su sitio, puede solicitar versiones específicas de VAST o VMAP. En VAST, si su reproductor de video usa el SDK de IMA, el parámetro de salida para una solicitud de anuncio de video siempre se establecerá en output=xml_vast4. Esto no supone ningún riesgo de confiabilidad, ya que el SDK es retrocompatible con todas las versiones de VAST que pueda publicar cualquier servidor de anuncios de terceros. Use output=vmap para mostrar la versión de VMAP predeterminada que activó en su red (por ejemplo, VMAP 1). Si muestra VAST dentro de VMAP, puede usar xml_vmap1_vast3 o xml_vmap1_vast4 para especificar la versión de VAST que se mostrará. Ejemplo de uso Configuración de VAST predeterminada de su red: output=vast VAST 4: output=xml_vast4 Configuración de VMAP predeterminada de su red: output=vmap VMAP 1: output=xml_vmap1 VMAP 1, para mostrar VAST 4: output=xml_vmap1_vast4 Requisito Se requiere para la Web y las aplicaciones.
pvid (ID del conjunto de apps) pvid_s (Alcance del conjunto de apps)	Los valores de ID del conjunto de aplicaciones son necesarios para la monetización cuando los usuarios inhabilitan la personalización en dispositivos Android. El parámetro pvid acepta un valor variable que se establece en el ID del conjunto de aplicaciones para Android, y el parámetro pvid_s acepta una constante que representa el alcance del ID del conjunto de aplicaciones (scope_app o scope_developer). Si bien el SDK de IMA/PAL pasa este campo automáticamente, los publicadores con implementaciones que no pertenecen al SDK deben llamar al SDK del conjunto de aplicaciones y pasar estos parámetros de forma manual en la solicitud de anuncio. Consulte la documentación de Android sobre cómo recuperar el ID del conjunto de aplicaciones. Ejemplo de uso pvid=[AppSetID_value] pvid_s=scope_app Requisito Se requiere para las aplicaciones. Se recomienda para la monetización programática.
rdid idtype is_lat (Identificadores de dispositivos que se pueden restablecer)	Los identificadores de dispositivos que se pueden restablecer admiten valores variables. Con las aplicaciones integradas (no en la Web ni en la Web móvil), el SDK pasa identificadores de dispositivos que se pueden restablecer con fines de segmentación de usuarios para sus solicitudes de transmisión con los parámetros de idtype, is_lat y rdid. En las transmisiones de SSB, debe pasar estos parámetros como explícitos, del mismo modo que lo haría en una solicitud de anuncio del cliente. Obtenga más información acerca de los identificadores de dispositivos. Casi todos los anuncios programáticos de video requieren que estos valores estén presentes. A partir de iOS 14.5, Apple dio de baja el indicador LAT. En cambio, Google se basa en la presencia de un IDFA distinto de cero para indicar que el usuario dio su consentimiento para el seguimiento de versiones de iOS compatibles con la Transparencia en el Seguimiento de Aplicaciones. Por lo tanto, se requerirá un UserAgent válido que indique la versión correcta del SO. Ejemplo de uso Vea ejemplos detallados de identificadores de dispositivos que se pueden restablecer. Requisito Se requiere para las aplicaciones. Se recomienda para la monetización programática.
sz (Tamaño)	El parámetro de tamaño admite un valor variable que debe definirse con el tamaño del espacio publicitario de video principal. Si hay varios tamaños, debe separarlos con el carácter de barra vertical (|). No incluya "v" después del tamaño. Ejemplo de uso sz=400x300 Requisito Se requiere para la Web y las aplicaciones. Este parámetro es opcional si solo se solicita ad_type=audio.
unviewed_position_start (Impresiones retrasadas)	El parámetro de impresiones retrasadas admite un valor constante para indicar las impresiones de video retrasadas. Ejemplo de uso unviewed_position_start=1 Requisito Se requiere para la Web y las aplicaciones.
url (URL)	El parámetro de URL admite un valor variable que se debe definir con la URL completa desde la que se envía la solicitud. Este valor es necesario para ayudar a los compradores a identificar y comprender el contexto del origen de donde proviene esta solicitud. En la medida de lo posible, este valor se debe propagar de forma dinámica en la solicitud de anuncio.  En una página web, esta es la URL de la página que muestra el reproductor de video. Si usas el SDK de IMA, el valor de URL se define automáticamente. Si el reproductor establece este valor, el SDK de IMA respetará el valor establecido. En una aplicación (para dispositivos móviles o CTV), este valor se debe definir como una URL que represente de la manera más precisa posible el inventario de video o audio que se va a monetizar, por ejemplo, si el usuario mira un video dentro de una aplicación para dispositivos móviles que también está disponible en una URL equivalente para computadoras de escritorio.* El valor de este parámetro debe estar codificado. Ejemplo de uso url=https%3A%2F%2Fwww.videoad.com%2Fgolf.html * En el caso de las aplicaciones, si no es posible establecer este parámetro en un valor de URL variable, se recomienda que se establezca con el siguiente patrón: url=https%3A%2F%2F<app/bundleid>.adsenseformobileapps.com Requisito Se requiere para la Web y las aplicaciones. Se recomienda para la monetización programática.
wta (¿Por qué este anuncio?)	El parámetro "¿Por qué este anuncio?" admite un valor constante que indica la compatibilidad del reproductor de video para renderizar el texto "¿Por qué este anuncio?". La funcionalidad "¿Por qué este anuncio?" se admite automáticamente cuando se usa el SDK de IMA. Cuando este no se usa, los reproductores de video deben implementar la compatibilidad con Icon y con IconClickFallbackImage de VAST, como se indica en el estándar de VAST de IAB. Las solicitudes de anuncios de audio deben enviar wta=1 si el ícono de AdChoices, como se proporciona en la respuesta de VAST, se renderizará en anuncios complementarios o se proporcionará al usuario de otro modo. Para ser aptas para la demanda de Google y el tráfico de reservación alojado por Google en el EEE, las solicitudes de anuncios deben enviar wta=1 para indicar que el ícono de AdChoices, como se proporciona en la respuesta de VAST, se renderiza en anuncios de video o complementarios, o se proporciona al usuario de otro modo para todas las creatividades de anuncios. Ejemplo de uso Se admite: wta=1 No se admite: wta=0 Requisito Se requiere para Ad Exchange. Se requiere para el tráfico web y de apps del EEE. Se recomienda para la monetización programática.