Cet article décrit le processus Vungle et les spécifications permettant aux nouveaux partenaires VAST d'intégrer leur technologie dans notre plate-forme d'annonces programmée.
Contenu
- Spécifications relatives aux réponses VAST
- Protocole d'intégration des partenaires de Vungle
- Exemples de demande VAST
- Paramètres d'une demande VAST
Spécifications relatives aux réponses VAST
La réponse à l'enchère doit être conforme aux spécifications suivantes :
- une durée maximale de vidéo de 30 secondes
- un débit binaire minimal de 250 kb/s.
- l'XML doit comprendre :
- un fichier média .mp4
- les informations sur le débit binaire
- les informations sur la longueur de la vidéo
- Les redirections ne redirigent qu'une fois au maximum
- Temps de réponse :
- pour la diffusion en continue : inférieur ou égal à 250 ms
- pour les vidéos mises en cache avant la diffusion : inférieur ou égal à 750 ms
- doit permettre à tout moment de retourner à la page d'accueil grâce à un clic
- doit prendre en charge SSL et utiliser des ressources sécurisées dans les réponses
- doit répondre avec
« no-ad »ou« 403 »en cas d'absence d'annonce - Les extensions VAST sont facultatives, mais souhaitées
Vungle renvoie une erreur si l'une des conditions ci-dessus n'est pas satisfaite.
Protocole d'intégration des partenaires de Vungle
Le processus Vungle permettant aux nouveaux partenaires VAST d'intégrer leur technologie dans notre plate-forme d'annonces programmée se déroule en deux phases. La première peut être qualifiée de validation générale : Vungle inspecte la balise en s'assurant que les appels du serveur sont correctement déclenchés et les valeurs bien renseignées. La deuxième implique des tests rigoureux, au cours desquels nous recherchons des divergences parmi des impressions importantes sur le plan statistique afin de garantir que les chiffres de Vungle sont conforment à ceux du partenaire.
Phase 1
- Le partenaire envoie les documents techniques à Vungle (si disponibles).
- Le partenaire envoie à Vungle un point de terminaison pour les essais VAST.
Remarque : Au cours de la phase d'essai, le partenaire doit répondre à toutes les demandes d'enchère de Vungle pour générer des résultats d'essais significatifs.
- Vungle construit un environnement de test pour appeler le point de terminaison du partenaire sur demande.
Ceci permet de valider les valeurs des variables et les balises de suivi.
Phase 2
- Vungle travaille avec le partenaire pour mettre en place des campagnes d'essais.
- Le partenaire envoie le point de terminaison de l'essai simulant une demande réelle.
- Vungle met en place une campagne d'essais pour exécuter un nombre prédéterminé d'impressions.
Exemples de demande VAST
Exemple de demande VAST (balise VAST) avec paramètres non renseignés
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}}} Exemple de demande VAST (balise VAST) avec paramètres renseignés
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 Paramètres d'une demande VAST
| Nom du paramètre | Macro | Valeur | Remarques | Exemple |
| App Category | {{{pub_app_store_category}}} |
String | Liste des catégories | Jeu |
| App Name | {{{pub_app_name}}} |
String | Provenant de iTunes ou PlayStore | Family Farm Seaside |
| App Store URL | {{{pub_app_store_url}}} |
String | URL du magasin ou du contenu de l'application. Encodé. | https://play.google.com/store/apps/details?id=com.funplus.familyfarm&hl=en |
| Bundle ID | {{{pub_market_app_id}}} |
String/Int | Provenant de iTunes ou PlayStore | com.funplus.familyfarm&hl=en (Android) 539920547 (iOS) |
| City | {{{city}}} |
String | Encodé | New York |
| Connection Type | {{{connection_type}}} |
String | Wifi, wwan, mobile | Wifi, wwan, mobile |
| Country | {{{country}}} |
String | Code du pays à 2 lettres | États-Unis |
| Device DNT | {{{ad_tracking_disabled}}} |
String | 'True' indique que l'utilisateur n'autorise pas le suivi de l'annonce | True/False |
| Device DNT | {{{ad_tracking_enabled}}} |
String | 'True' indique que l'utilisateur autorise le suivi de l'annonce | True/False |
| Device DNT | {{{boolean_number ad_tracking_disabled}}} |
Int | Ne pas suivre, sous-forme binaire | 0 – False 1 - True |
| Device ID | {{{device_id}}} |
String | En clair ou haché | ab4d6cc4-f57f-4309-9d29-b7fb5e35dd74 |
| Device Model | {{{device_model}}} |
String | Encodé | Amazon, KFFOWI Samsung, SM-J700T |
| IP | {{{ip}}} |
String | Adresse de protocole internet | 95.118.153.77 |
| Language | {{{language}}} |
String | Langue sur deux caractères fournie par les en-têtes | 10.2.1 |
| OS version | {{{os_version}}} |
String | Version du système d'exploitation (p. exemple iOS 7.2) | 2014-12-05T00%3A44%3A19%2B00%3A00 |
| Platform | {{{device_platform}}} |
String | iOS ou Android | iOS/Android |
| Screen Height | {{{screen_height}}} |
Integer | Hauteur d'écran (pixels) | 768 |
| Screen Orientation | {{{screen_orientation}}} |
String | Portrait ou paysage | Portrait/Landscape |
| Screen Width | {{{screen_width}}} |
Integer | Largeur d'écran (pixels) | 1024 |
| Timestamp | {{{timestamp}}} |
String/Int | Encodé | 2014-12-05T00:44:19+00:00 |
| User Agent | {{{browser_user_agent}}} |
String | Agent utilisateur fourni par les en-têtes. Encodé. | 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 |
| Vungle ID | {{{vungle_id}}} |
String | ID de l'annonceur Vungle relatif à la prestation associée | 5497c989a3b61ba3660001b1 |