Vungle VAST 2.0 Integrationsleitfaden

Dieser Artikel beschreibt den Vungle-Vorgang und die Spezifikationen, um einen neuen VAST-Partner bei der Integration seiner Technologie in unsere programmatische Werbeplattform zu unterstützen.

Inhalt

Spezifikationen zur VAST-Antwort

Die Gebotsantwort muss den folgenden Spezifikationen gerecht werden:

  • Maximale Videodauer von 30 Sekunden
  • Minimale Bitrate von 250 kbps
  • XML muss beinhalten:
        • eine .mp4-Mediendatei
        • Bitrate-Informationen
        • Informationen zur Videolänge
  • Weiterleitungen können höchstens einmal weiterleiten
  • Antwortzeit:
        • bei Streams: muss innerhalb von 250 ms liegen
        • vorgeladen: muss innerhalb von 750 ms liegen
  • Muss bis zur Landing-Page durchklicken
  • Muss SSL unterstützen und mit sicheren Assets antworten
  • Antworten mit ‘no-ad’ oder ‘403’ im Fall von keiner Werbung
  • VAST-Erweiterungen sind optional, werden aber vorgezogen.

Vungle gibt einen Fehler zurück, falls einer der obengenannten Anforderungen nicht nagekommen wird.

Das Partner-Integrationsprotokoll von Vungle

Wenn Vungle einen neuen VAST-Partner bei der Integration seiner Technologie in unsere programmatische Werbeplattform unterstützt, wird der Vorgang in zwei Phasen unterteilt. Die erste Phase kann als allgemeine Validierung beschrieben werden: Vungle überprüft das Tag und stellt sicher, dass die Server-Calls richtig versendet werden und, dass die Werte richtig ausgefüllt werden. Die zweite Phase umfasst ausgiebige Tests, bei denen wir nach Diskrepanzen in einer statistisch bedeutsamen Teilmenge an Impressionen suchen, um für eine Übereinstimmung zwischen den Zahlen von Vungle und denen des Partners sorgen.

Phase 1

  1. Der Partner verschickt technische Dokumente an Vungle (falls verfügbar).

  2. Der Partner verschickt einen testweisen VAST-Endpunkt an Vungle.
    Hinweis: Während der Testphase muss der Partner auf 100 % der Gebotsanfragen von Vungle antworten, um signifikante Testergebnisse zu generieren.

  3. Vungle baut eine Testumgebung um den Endpunkt des Partners auf Abfrage zu rufen.
    Dies wird zur Validierung von variablen Werten und von Verfolgungsmarkern verwendet.

Phase 2

  1. Vungle arbeitet mit dem Partner zusammen, um Testkampagnen einzurichten.
  • Der Partner verschickt einen Test-Endpunkt, der eine echte Nachfrage simuliert.
  • Vungle richtet eine Testkampagne ein, um eine zuvor bestimmte Anzahl an Impressionen zu starten.

  • Der Partner und Vungle besprechen die Übermittlung und vergleichen Diskrepanzen.

  • Falls jegliche Probleme bei der Verfolgung, Zielsetzung oder Diskrepanz auftreten, arbeiten Vungle und der Partner zusammen an der Behandlung des Problems, bis es gelöst ist.
  • Beispielhafte VAST-Anfragen

    Beispielhafte VAST-Anfrage-URL (VAST-Tag) mit nicht ausgefüllten Parametern

    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}}} 

    Beispielhafte VAST-Anfrage-URL (VAST-Tag) mit ausgefüllten Parametern

    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 

    Parameter der VAST-Anfrage

    Parametername Makro Wert Hinweise Beispiel
    App-Kategorie {{{pub_app_store_category}}} String Liste von Kategorien Spiele
    App-Name {{{pub_app_name}}} String Von iTunes oder aus dem Play Store Family Farm Seaside
    App Store-URL {{{pub_app_store_url}}} String App-Store- oder Inhalts-URL. Kodiert. https://play.google.com/store/apps/details?id=com.funplus.familyfarm&hl=en
    Bundle-ID {{{pub_market_app_id}}} String/Int Von iTunes oder aus dem Play Store com.funplus.familyfarm&hl=en (Android)
    539920547 (iOS)
    Stadt {{{city}}} String Kodiert New York
    Verbindungstyp {{{connection_type}}} String Wifi, wwan, mobile Wifi, wwan, mobile
    Land {{{country}}} String Ländercode mit zwei Buchstaben US
    Geräte-DNT {{{ad_tracking_disabled}}} String 'True' bedeutet, dass der Nutzer der Werbungsverfolgung nicht zustimmt. True/False
    Geräte-DNT {{{ad_tracking_enabled}}} String 'True' bedeutet, dass der Nutzer der Werbungsverfolgung zustimmt. True/False
    Geräte-DNT {{{boolean_number ad_tracking_disabled}}} Int Schutz vor Aktivitäten-Verfolgung in binärer Form 0 – False
    1 – True
    Geräte-ID {{{device_id}}} String Klartext oder Gehasht ab4d6cc4-f57f-4309-9d29-b7fb5e35dd74
    Gerätemodell {{{device_model}}} String Kodiert Amazon,KFFOWI
    samsung,SM-J700T
    IP {{{ip}}} String Internet Protocol Address 95.118.153.77
    Sprache {{{language}}} String Zweibuchstabige Sprache aus den Headern 10.2.1
    Betriebssystem-Version {{{os_version}}} String Version des Betriebssystems (z.B. iOS 7.2) 2014-12-05T00%3A44%3A19%2B00%3A00
    Plattform {{{device_platform}}} String iOS oder Android iOS/Android
    Bildschirmhöhe {{{screen_height}}} Integer Bildschirmhöhe (Pixel) 768
    Bildschirmausrichtung {{{screen_orientation}}} String Hoch- oder Querformat Hochformat/Querformat
    Bildschirmbreite {{{screen_width}}} Integer Bildschirmbreite (Pixel) 1024
    Zeitstempel {{{timestamp}}} String/Int Kodiert 2014-12-05T00:44:19+00:00
    User-Agent {{{browser_user_agent}}} String UA aus en Headern. Kodiert. 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 Vungle Herausgeber-ID zur Assoziation mit Leistung 5497c989a3b61ba3660001b1

     

    Haben Sie Fragen? Anfrage einreichen

    Kommentare