Guide d'intégration de VAST 2.0 à Vungle

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

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

  1. Le partenaire envoie les documents techniques à Vungle (si disponibles).

  2. 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.

  3. 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

  1. 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.

  • Le partenaire et Vungle rapprochent les diffusions et comparent les divergences.

  • Si des problèmes de suivi, de ciblage ou de différences apparaissent, Vungle et le partenaire travaillent ensemble pour les déboguer jusqu'à ce que chaque problème soit résolu.
  • 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

     

    Vous avez d’autres questions ? Envoyer une demande

    Commentaires