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
- Protocolo de integración de socio de Vungle
- Solicitudes de VAST de muestra
- Parámetros de solicitud de VAST
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
- El socio envía los documentos técnicos de Vungle (si están disponibles).
- 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.
- 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
- 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.
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 |