Руководство по интеграции VAST 2.0

В этой статье описывается процесс и спецификации Vungle с целью помочь новому партнеру VAST интегрировать его технологию в нашу программную платформу рекламы.

Содержание

Спецификации ответов VAST

Ответ на предложение должен соответствовать следующим требованиям:

  • Максимальная длительность показа видео 30 секунд
  • Минимальная скорость потока 250 кбит/с
  • XML должен содержать:
        • один медиафайл формата mp4
        • информацию о скорости потока
        • информацию о длительности показа видео
  • Любое перенаправление может осуществляться максимум один раз
  • Время ответа:
        • для потоковой передачи: должно быть в пределах 250 мс
        • для предварительного кэширования: должно быть в пределах 750 мс
  • Должен выполняться переход по рекламной ссылке на целевую страницу
  • Должны поддерживаться SSL и ответы с безопасными активами
  • Ответ с ‘no-ad’ или ‘403’ в случае отсутствия рекламы
  • Расширения VAST являются необязательными, но желательными

Vungle возвращает ошибку, если любое из указанных выше требований не удовлетворяется.

Протокол интеграции партнера Vungle

Когда Vungle помогает новому партнеру VAST интегрировать его технологию в нашу программную платформу рекламы, этот процесс делится на два этапа. Первый этап можно описать как общую проверку: Vungle проверяет тег, обеспечивая, что вызовы сервера правильно выполняются и значения правильно заполняются Второй этап включает строгое тестирование, во время которого отыскиваются несоответствия в статистически значимом наборе просмотров, что позволяет согласовать показатели Vungles с партнером.

Этап 1

  1. Партнер отправляет техническую документацию Vungle (при наличии).

  2. Партнер отправляет Vungle конечную точку тестирования VAST. 
    Примечание. На этапе тестирования партнер должен ответить на 100 % запросов Vungle на предложения, чтобы получить значимые результаты тестирования.

  3. Vungle создает среду тестирования для вызова конечной точки партнера по запросу.
    Это используется для проверки значений переменных и маячков отслеживания.

Этап 2

  1. Vungle работает с партнером для настройки тестовых кампаний.
  • Партнер отправляет тестовую конечную точку, имитирующую реальный спрос.
  • Vungle настраивает тестовую кампанию для запуска заранее определенного числа просмотров.

  • Партнер и 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

     

    Была ли эта статья полезной?
    Пользователи, считающие этот материал полезным: 0 из 0
    Еще есть вопросы? Отправить запрос

    Комментарии