Guía de integración de VAST 2.0 de Vungle

En este artículo se describe el proceso y las especificaciones de Vungle para ayudar a un nuevo socio de VAST a integrar su tecnología en nuestra plataforma de anuncios programáticos.

Contenido

Especificaciones de respuesta de VAST

La respuesta de la puja debe atenerse a las siguientes especificaciones:

  • Duración máxima del video de 30 segundos
  • Tasa de bits mínima de 250 kbps.
  • XML debe contener:
        • un archivo multimedia .mp4
        • información de la tasa de bits
        • información de la duración del video
  • Cualquier redireccionamiento solo puede redirigir un máximo de una vez
  • Tiempo de respuesta:
        • para streaming: debe estar dentro de los 250 ms
        • para almacenado en caché previamente: debe estar dentro de los 750 ms
  • Debe hacer clic para acceder a una página de destino
  • Debe admitir SSL y responder con recursos seguros
  • Responda con ‘no-ad’ o ‘403’ en el caso de que no haya ningún anuncio
  • Las extensiones de VAST son opcionales, pero se recomiendan

Vungle devuelve un error si no se cumple con alguno de los requisitos anteriores.

Protocolo de integración de socio de Vungle

Cuando Vungle ayuda a un nuevo socio de VAST a integrar su tecnología en nuestra plataforma de anuncios programáticos, el proceso se divide en dos fases. La primera fase se puede describir como una validación general: Vungle inspecciona la etiqueta, asegurándose de que las llamadas del servidor se efectúen correctamente y que los valores se completen correctamente. La segunda fase involucra una prueba rigurosa, durante la cual buscamos discrepancias entre un conjunto estadísticamente significativo de impresiones para garantizar que los números de Vungle se alineen con los del socio.

Fase 1

  1. El socio envía los documentos técnicos de Vungle (si están disponibles).

  2. El socio envía a Vungle un punto de conexión de VAST de prueba. 
    Nota: Durante la fase de prueba, el socio debe responder el 100% de las solicitudes de puja de Vungle para generar resultados de prueba significativos.

  3. Vungle crea un entorno de prueba para llamar al punto de conexión del socio a pedido.
    Esto se utiliza para validar los valores variables y hacer un seguimiento de los beacons.

Fase 2

  1. Vungle trabaja con el socio para configurar las campañas de prueba.
  • El socio envía puntos de conexión de prueba que simulan una demanda real.
  • Vungle configura una campaña de prueba para ejecutar una cantidad predeterminada de impresiones.

  • El socio y Vungle reconcilian la entrega y comparan las discrepancias.

  • Si ocurre algún problema con el seguimiento, la asignación o discrepancias, Vungle y el socio trabajarán juntos para depurarlos hasta que cada problema se resuelva.
  • Solicitudes de VAST de muestra

    URL de solicitud de VAST de muestra (etiqueta de VAST) con parámetros sin rellenar

    https://partner.com/vast2/6524rgww153hifw/?duration=15&app_name={{{pub_app_name}}}&app_id={{{market_id}}}&rtb_type=instream_mobile_vast_inter&user_id={{{device_id}}}&ua={{{browser_user_agent}}}&random={{{timestamp}}}&ip_address={{{ip}}} 

    URL de solicitud de VAST de muestra (etiqueta de VAST) con parámetros rellenos

    https://partner.com/vast2/124765432/?duration=15&app_name=My%20Talking%20Tom%20Free%20for%20Android&app_id=com.outfit7.mytalkingtomfree&rtb_type=instream_mobile_vast_inter&user_id=6df43c89-9e3d-43fb-a1e9-bacd51932d41&ua=Mozilla%2F5.0%20(Linux%3B%20Android%204.4.2%3B%20SPH-L720%20Build%2FKOT49H)%20AppleWebKit%2F537.36%20(KHTML%2C%20like%20Gecko)%20Version%2F4.0%20Chrome%2F30.0.0.0%20Mobile%20Safari%2F537.36&random=2015-01-27T21%3A30%3A34%2B00%3A00&ip_address=66.87.114.254 

    Parámetros de solicitud de VAST

    Nombre del parámetro Macro Valor Notas Ejemplo
    Categoría de la aplicación {{{pub_app_store_category}}} Cadena Lista de categorías Juegos
    Nombre de la aplicación {{{pub_app_name}}} Cadena De iTunes o Play store Family Farm Seaside
    URL de la tienda de aplicaciones {{{pub_app_store_url}}} Cadena URL de la tienda de aplicaciones o el contenido. Codificado. https://play.google.com/store/apps/details?id=com.funplus.familyfarm&hl=en
    ID del paquete {{{pub_market_app_id}}} Cadena/Entero De iTunes o Play store com.funplus.familyfarm&hl=en (Android)
    539920547 (iOS)
    Ciudad {{{city}}} Cadena Codificado Nueva York
    Tipo de conexión {{{connection_type}}} Cadena Wifi, wwan, móvil Wifi, wwan, móvil
    País {{{country}}} Cadena Código de país de dos letras US
    DNT del dispositivo {{{ad_tracking_disabled}}} Cadena 'True' indica que el usuario no permite el seguimiento de anuncios Verdadero/falso
    DNT del dispositivo {{{ad_tracking_enabled}}} Cadena 'True' indica que el usuario permite el seguimiento de anuncios Verdadero/falso
    DNT del dispositivo {{{boolean_number ad_tracking_disabled}}} Entero No realice el seguimiento, en forma binaria 0 – Falso
    1 - Verdadero
    ID del dispositivo {{{device_id}}} Cadena Borrar o con hash ab4d6cc4-f57f-4309-9d29-b7fb5e35dd74
    Modelo del dispositivo {{{device_model}}} Cadena Codificado Amazon,KFFOWI
    samsung,SM-J700T
    IP {{{ip}}} Cadena Dirección de Protocolo de Internet 95.118.153.77
    Idioma {{{language}}} Cadena Idioma de dos caracteres de los encabezados 10.2.1
    Versión del SO {{{os_version}}} Cadena Versión del SO (ie iOS 7.2) 2014-12-05T00%3A44%3A19%2B00%3A00
    Plataforma {{{device_platform}}} Cadena iOS o Android iOS/Android
    Altura de la pantalla {{{screen_height}}} Entero Altura de la pantalla (píxeles) 768
    Orientación de la pantalla {{{screen_orientation}}} Cadena Vertical u horizontal Vertical/horizontal
    Ancho de la pantalla {{{screen_width}}} Entero Ancho de la pantalla (píxeles) 1024
    Marca de tiempo {{{timestamp}}} Cadena/Entero Codificado 2014-12-05T00:44:19+00:00
    Agente del usuario {{{browser_user_agent}}} Cadena UA de los encabezados. Codificado. Mozilla/5.0 (Linux; Android 5.1.1; VF-1397 Build/LMY47V; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/55.0.2883.91 Safari/537.36
    ID de Vungle {{{vungle_id}}} Cadena ID del editor de Vungle para asociar el rendimiento 5497c989a3b61ba3660001b1

     

    ¿Tiene más preguntas? Enviar una solicitud

    Comentarios