Технические требования к операторам для интеграции с сервисом DRON.Market
Технические требования к операторам для интеграции с сервисом DRON.Market
Система DRON.Market работает с оборудованием оператора по упрощенной реализации протокола VAST4.

Для получения тестового доступа в систему оператору следует обратиться в техническую поддержку сервиса или написать на почту tech@dron.digital.

Сотрудник оператора заходит на демостенд сервиса под одним из тестовых аккаунтов "оператора".

В интерфейсе оператора DRON.Market пользователь может добавлять и настраивать тестовые дисплеи.

Для добавления нового дисплея в разделе "Конструкции" следует нажать на кнопку "Добавить конструкцию" и задать ей обязательные параметры:
  • геокоординаты
  • адрес
  • тип экрана
  • разрешение экрана
  • уникальный идентификатор (UID), с помощью которого DRON.Market сможет однозначно идентифицировать плеер дисплея.
UID стандартного формата можно сгенерировать, например, здесь: https://www.uuidgenerator.net
Подробнее о формате: https://en.wikipedia.org/wiki/Universally_unique_identifier).

После добавления, новый дисплей должен быть одобрен администратором сервиса. На демостенде любой пользователь может зайти в интерфейс администратора и самостоятельно одобрить дисплей (или провести модерацию добавленного контента).

Когда дисплей одобрен - оператор может прописать ссылку на получение контента в своем плеере.

Ссылка имеет следующий вид: http://адрес.демостенда.сервиса/api/v1/vast/UID, где UID — это введенный ранее уникальный идентификатор дисплея.
В случае отсутствия контента, который система DRON.Market в данный момент готова отдать плееру будет возвращен следующий ответ:
<VAST version="4.0">
<Ad id="2019_1_404">
<InLine>
<AdSystem>
<![CDATA[ DRONexch ]]>
</AdSystem>
<AdTitle>
<![CDATA[ 404: no content found ]]>
</AdTitle>
</InLine>
</Ad>
</VAST>
В случае наличия контента:
<VAST version="4.0">
<Ad id="2019_1">
<InLine>
<AdSystem>
<![CDATA[ DRONexch ]]>
</AdSystem>
<AdTitle>
<![CDATA[ testovaya ]]>
</AdTitle>
<Creatives>
<Creative id="4" adid="4_19">
<Linear>
<TrackingEvents>
<Tracking event="start">
<![CDATA[
https://адрес.демостенда.сервиса/api/v1/player_callbacks/tracking/19?uid=B197D1E9-1B37-40C0-AB8D-31AF7A35EA40&oid=4&bid=124&rid=afedc628-940c-4638-8e10-f4670cca0be0&event=start
]]>
</Tracking>
<Tracking event="complete">
<![CDATA[
https://адрес.демостенда.сервиса/api/v1/player_callbacks/tracking/19?uid=B197D1E9-1B37-40C0-AB8D-31AF7A35EA40&oid=4&bid=124&rid=afedc628-940c-4638-8e10-f4670cca0be0&event=complete
]]>
</Tracking>
</TrackingEvents>
<Duration>00:00:07</Duration>
<MediaFiles>
<MediaFile id="19" delivery="progressive" type="video/mp4" height="1080" width="1920">
<![CDATA[
https://адрес.демостенда.сервиса/storage/19/201903265c99dc2967c3d.mp4
]]>
</MediaFile>
</MediaFiles>
</Linear>
</Creative>
</Creatives>
</InLine>
</Ad>
</VAST>
Секция MediaFile содержит ссылку на файл креатива.
В секции Tracking - ссылки на события плеера:
  • к ссылке из секции <Tracking event="start"> плеер должен обратиться GET запросом при начале проигрывания креатива
  • к ссылке из секции <Tracking event="complete"> плеер должен обратиться GET запросом по завершению проигрывания
Чтобы контент был доступен для отдачи в VAST пользователь должен создать рекламную кампанию, загрузить свой медиаконент в сервис DRON.Market из интерфейса рекламодателя и пройти модерацию.

На демостенде любой пользователь может авторизоваться как рекламодатель и разместить свой контент.

После добавления контента и прохождения модерации (интерфейс модератора или интерфейс администратора сервиса), рекламодатель включает контент в ротацию и запускает рекламную кампанию.

Плеер оператора получает по запросу на доступный контент — ссылку на скачивание.