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
- Das Partner-Integrationsprotokoll von Vungle
- Beispielhafte VAST-Anfragen
- Parameter der VAST-Anfrage
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
- Der Partner verschickt technische Dokumente an Vungle (falls verfügbar).
- 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.
- 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
- 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.
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 |