В этой статье описывается процесс и спецификации Vungle с целью помочь новому партнеру VAST интегрировать его технологию в нашу программную платформу рекламы.
Содержание
- Спецификации ответов VAST
- Протокол интеграции партнера Vungle
- Примеры запросов VAST
- Параметры запроса VAST
Спецификации ответов VAST
Ответ на предложение должен соответствовать следующим требованиям:
- Максимальная длительность показа видео 30 секунд
- Минимальная скорость потока 250 кбит/с
- XML должен содержать:
- один медиафайл формата mp4
- информацию о скорости потока
- информацию о длительности показа видео
- Любое перенаправление может осуществляться максимум один раз
- Время ответа:
- для потоковой передачи: должно быть в пределах 250 мс
- для предварительного кэширования: должно быть в пределах 750 мс
- Должен выполняться переход по рекламной ссылке на целевую страницу
- Должны поддерживаться SSL и ответы с безопасными активами
- Ответ с
‘no-ad’или‘403’в случае отсутствия рекламы - Расширения VAST являются необязательными, но желательными
Vungle возвращает ошибку, если любое из указанных выше требований не удовлетворяется.
Протокол интеграции партнера Vungle
Когда Vungle помогает новому партнеру VAST интегрировать его технологию в нашу программную платформу рекламы, этот процесс делится на два этапа. Первый этап можно описать как общую проверку: Vungle проверяет тег, обеспечивая, что вызовы сервера правильно выполняются и значения правильно заполняются Второй этап включает строгое тестирование, во время которого отыскиваются несоответствия в статистически значимом наборе просмотров, что позволяет согласовать показатели Vungles с партнером.
Этап 1
- Партнер отправляет техническую документацию Vungle (при наличии).
- Партнер отправляет Vungle конечную точку тестирования VAST.
Примечание. На этапе тестирования партнер должен ответить на 100 % запросов Vungle на предложения, чтобы получить значимые результаты тестирования.
- Vungle создает среду тестирования для вызова конечной точки партнера по запросу.
Это используется для проверки значений переменных и маячков отслеживания.
Этап 2
- Vungle работает с партнером для настройки тестовых кампаний.
- Партнер отправляет тестовую конечную точку, имитирующую реальный спрос.
- Vungle настраивает тестовую кампанию для запуска заранее определенного числа просмотров.
Примеры запросов VAST
URL-адрес запроса VAST (тег VAST) с незаполненными параметрами
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-адрес запроса VAST (тег VAST) с заполненными параметрами
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 Параметры запроса VAST
| Имя параметра | Макрос | Значение | Примечания | Пример |
| Категория приложения | {{{pub_app_store_category}}} |
Строка | Список категорий | Игры |
| Имя приложения | {{{pub_app_name}}} |
Строка | Из iTunes или Play store | Family Farm Seaside |
| URL-адрес магазина приложений | {{{pub_app_store_url}}} |
Строка | URL-адрес магазина приложений или содержимого. Зашифровано. | https://play.google.com/store/apps/details?id=com.funplus.familyfarm&hl=en |
| Идентификатор комплекта | {{{pub_market_app_id}}} |
String/Int | Из iTunes или Play store | com.funplus.familyfarm&hl=en (Android) 539920547 (iOS) |
| Город | {{{city}}} |
Строка | Зашифровано | Нью-Йорк |
| Тип подключения | {{{connection_type}}} |
Строка | Wifi, wwan, мобильное | Wifi, wwan, мобильное |
| Страна | {{{country}}} |
Строка | Двухбуквенный код страны | US |
| Значение DNT для устройства | {{{ad_tracking_disabled}}} |
Строка | 'True' определяет, что пользователь не разрешает отслеживание рекламы | True/False |
| Значение DNT для устройства | {{{ad_tracking_enabled}}} |
Строка | 'True' определяет, что пользователь разрешает отслеживание рекламы | True/False |
| Значение DNT для устройства | {{{boolean_number ad_tracking_disabled}}} |
Int | Не отслеживать в двоичной форме | 0 — ложь 1 — истина |
| Идентификатор устройства | {{{device_id}}} |
Строка | Очищено или хэшировано | ab4d6cc4-f57f-4309-9d29-b7fb5e35dd74 |
| Модель устройства | {{{device_model}}} |
Строка | Зашифровано | Amazon,KFFOWI samsung,SM-J700T |
| IP-адрес | {{{ip}}} |
Строка | Адрес протокола Интернета | 95.118.153.77 |
| Язык | {{{language}}} |
Строка | Двухбуквенное обозначение языка из заголовков | 10.2.1 |
| Версия ОС | {{{os_version}}} |
Строка | Версия ОС (например, iOS 7.2) | 2014-12-05T00%3A44%3A19%2B00%3A00 |
| Платформа | {{{device_platform}}} |
Строка | iOS или Android | iOS/Android |
| Высота экрана | {{{screen_height}}} |
Целое число | Высота экрана (в пикселях) | 768 |
| Ориентация экрана | {{{screen_orientation}}} |
Строка | Книжная или альбомная | Книжная/альбомная |
| Ширина экрана | {{{screen_width}}} |
Целое число | Ширина экрана (в пикселях) | 1024 |
| Отметка времени | {{{timestamp}}} |
String/Int | Зашифровано | 2014-12-05T00:44:19+00:00 |
| Агент пользователя | {{{browser_user_agent}}} |
Строка | Агент пользователя из заголовков. Зашифровано. | 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 | {{{vungle_id}}} |
Строка | Идентификатор Vungle Publisher ID для связанной производительности | 5497c989a3b61ba3660001b1 |