Как экспортировать данные о потоках с динамической вставкой объявлений в реальном времени

Содержание

• Предоставление журналов
• Журнал предоставления манифеста
• Журнал показанной рекламной паузы
  • Структура журнала показанной рекламной паузы
    • Статус объявлений
    • Статус рекламной паузы
• Журнал взаимодействий с сервером объявлений
   

Журналы динамической вставки объявлений в реальном времени позволяют экспортировать данные уровня потока с минимальными задержками, чтобы выявлять и устранять проблемы с показом. В этой статье приведены сведения о предоставлении файлов журналов, определенных полях и известных проблемах.

Предоставление журналов

Файлы журналов отправляются в сегмент хранилища того или иного издателя в Google Cloud примерно раз в пять минут.

Название сегмента указывается в следующем формате: gs://gdai-[NETWORK_CODE].

Названия файлов указываются в следующем формате:

[Log Type]_[Network Code]_[Stream Type]_[Content ID]_[YYYYMMDD]_[HHMMSS]_
[Random Number].gz

Где:

• Элемент Log Type (тип журнала) может принимать одно из трех значений: DAIAdServerInteraction, DAIManifest или DAIServedBreak.
• Network Code – это код сети Менеджера рекламы.
• Stream Type принимает одно из двух значений: VOD или Linear.
• Content ID – это идентификатор источника контента (для видео по запросу) или ключ объекта (для трансляций).
• YYMMDD, HHMMSS – время создания журнала по UTC.
• Random Number представляет собой случайное число.

Файлы заархивированы в формате gzip и содержат данные в виде значений, заключенных в двойные кавычки и разделенных запятыми, по стандарту RFC4180. Согласно пункту 5 раздела 2 спецификации RFC4180, любое поле можно заключить в двойные кавычки, но это необязательно. Все данные в файлах журнала приводятся в двойных кавычках.

Файлы хранятся в сегменте в течение семи дней, а затем удаляются.

Журнал предоставления манифеста

В этом журнале представлена информация о воспроизведении видеопотоков, распределенная по следующим полям:

Поле**	Описание
timestamp INTEGER	Временная метка запроса в UTC (в формате Unix-времени).
entry_id STRING	Уникальный идентификатор записи в журнале. Одна и та же запись может быть приведена в журнале несколько раз. Этот идентификатор позволяет различать подобные записи.
stream_id STRING	Уникальный идентификатор, который назначается каждому потоку (также называется SAM ID).
network_code INTEGER	Код сети издателя.
content INTEGER	Идентификатор источника контента.
vid STRING	Идентификатор видео.
asset_key STRING	Ключ объекта в трансляции.
manifest_type STRING	Тип манифеста для видео: MANIFEST_TYPE_HLS MANIFEST_TYPE_DASH
stream_type STRING	Тип потока: STREAM_TYPE_VOD STREAM_TYPE_LINEAR
request_type STRING	Тип запроса: REQUEST_TYPE_STREAM_CREATE REQUEST_TYPE_MASTER_PLAYLIST REQUEST_TYPE_MEDIA_PLAYLIST REQUEST_TYPE_MPD REQUEST_TYPE_SUBTITLES REQUEST_TYPE_INTERSTITIALS REQUEST_TYPE_IFRAME_PLAYLIST REQUEST_TYPE_AD_METADATA (ID3 events)
beaconing_type STRING	Тип применения маяков для потока: BEACONING_TYPE_SERVER_TRIGGERED – на стороне сервера. BEACONING_TYPE_CLIENT_TRIGGERED – на стороне клиента (IMA SDK). BEACONING_TYPE_CLIENT_INITIATED_SERVER_TRIGGERED – на стороне клиента (DAI API и IMA SDK в ближайшее время).
http_method STRING	Метод, который используется в HTTP-запросе.
user_agent STRING	Агент пользователя устройства.
response_code INTEGER	Код HTTP-ответа.
response_time DOUBLE	Задержка запроса (в секундах).

Журнал показанной рекламной паузы

В этом журнале представлена информация о рекламных паузах, которые были показаны на клиентских устройствах при динамической вставке объявлений. Дополнительные сведения о формате этой информации в журнале и ее примеры можно найти в статье Структура журнала показанной рекламной паузы.

Поле**	Описание
timestamp INTEGER	Временная метка запроса в UTC (в формате Unix-времени).
entry_id STRING	Уникальный идентификатор записи в журнале. Одна и та же запись может быть приведена в журнале несколько раз. Этот идентификатор позволяет различать подобные записи.
stream_id STRING	Уникальный идентификатор, который назначается каждому потоку (также называется SAM ID).
network_code STRING	Код сети издателя.
content INTEGER	Идентификатор источника контента .
vid STRING	Идентификатор видео .
asset_key STRING	Ключ объекта в трансляции .
break_id STRING	Идентификатор показанной рекламной паузы. В случае с видео по запросу речь идет об идентификаторе рекламной паузы VMAP. Примеры: preroll-1, midroll-2. В рамках трансляции этот идентификатор представляет собой последовательный номер, присвоенный рекламное паузе при динамической вставке объявлений. Примеры: "0000000001", "0000000024".
expected_break_duration DOUBLE	Продолжительность объявлений, запрошенных при динамической вставке объявлений. Это значение определяется тем, сколько продлится рекламная пауза по оценке динамической вставки объявлений.
actual_break_duration DOUBLE	Общее время, заполненное динамическое вставкой объявлений, в рамках показа контента. В эту величину входит продолжительность рекламы и иного контента, который был показан с помощью динамической вставки объявлений во время рекламной паузы.
ads_duration DOUBLE	Продолжительность объявлений в рекламной паузе. В случае с видео по запросу это значение также соответствует фактической продолжительности рекламной паузы.
slate_duration DOUBLE	Продолжительность объявления, показанного во время рекламной паузы.
ads_status STRING	Статус вставки объявления в рекламной паузе. Дополнительные сведения можно найти в статье Структура журнала показанной рекламной паузы.
slate_status STRING	Статус вставки рекламной паузы в рекламной паузе. Дополнительные сведения можно найти в статье Структура журнала показанной рекламной паузы.
выполнено BOOLEAN	Информация о том, завершен ли показ пакета объявлений. В случае с трансляциями HLS это означает, что при динамической вставке объявлений был добавлен маркер cue in, который сигнализирует об окончании показа пакета объявлений. А в рамках трансляций DASH речь идет о прекращении пакета объявлений.

Структура журнала показанной рекламной паузы

В таких журналах приведена информация о рекламных паузах, показанных на клиентских устройствах с помощью динамической вставки объявлений. Информация о журналах, связанных с динамической вставкой объявлений в разных условиях, приведена в таблицах Статус объявлений и Статус рекламной паузы ниже. Подробнее о журналах показанных рекламных пауз в трансляциях…

Статус объявлений

Ниже приведен список статусов объявлений и их описания.

Статус объявлений	Описание
ADS_STATUS_INSERTED	Вставка рекламы выполнена.
ADS_STATUS_DROPPED_UNKNOWN	Пакет объявлений отклонен по неизвестной причине.
ADS_STATUS_ALL_ADS_MISSING	Пакет объявлений отклонен, так как в нем нет объявлений.
ADS_STATUS_TOO_MANY_MIDROLLS	Пакет объявлений отклонен, так как сервер объявлений возвращает слишком много пакетов видеорекламы в середине ролика и имеющихся рекламных пауз для них недостаточно.
ADS_STATUS_OUT_OF_WINDOW	На время запроса рекламная пауза частично или полностью находится за пределами окна совмещения, поэтому будут совмещены не объявления, а основной контент.
ADS_STATUS_DISABLED	Объявления в трансляции отключены.
ADS_STATUS_DROPPED_FOR_PREROLL	Этот пакет видеорекламы в середине ролика отклонен, так как выполняется рекламная пауза с видеорекламой в начале ролика.
ADS_STATUS_EXPIRED	Срок действия пакета объявлений, так как запрос объявления не был выполнен вовремя и объявление не удалось совместить с контентом.
ADS_STATUS_HOLIDAY	Пакет объявлений отклонен, так как сейчас проходит период без рекламы.
ADS_STATUS_DROPPED_SLATE_UNAVAILABLE	Объявления были отклонены, так как в рекламной паузе произошла ошибка. Чтобы узнать больше, посмотрите информацию о статусе рекламной паузы.

Статус рекламной паузы

Ниже приведены статусы рекламной паузы и их описания.

Журнал взаимодействий с сервером объявлений

В этом журнале представлена информация о взаимодействиях с сервером объявлений при показе рекламы. Дополнительные сведения о формате этой информации в журнале и примеры можно найти в статье Структура журнала взаимодействий с сервером объявлений.

Поле**	Описание
timestamp INTEGER	Временная метка запроса в UTC (в формате Unix-времени).
entry_id STRING	Уникальный идентификатор записи в журнале. Одна и та же запись может быть приведена в журнале несколько раз. Этот идентификатор позволяет различать подобные записи.
stream_id STRING	Уникальный идентификатор, который назначается каждому потоку (также называется SAM ID).
network_code INTEGER	Код сети Менеджера рекламы.
content INTEGER	Идентификатор источника контента.
vid STRING	Идентификатор видео.
asset_key STRING	Ключ объекта в трансляции.
pod_id INTEGER	Идентификатор рекламной паузы: Идентификатор рекламной паузы, соответствующий спецификации VMAP (в видео по запросу). Последовательный номер рекламной паузы (в трансляции).
ad_server_host_name STRING	Название домена сервера объявлений.
response_time DOUBLE	Задержка запроса (в секундах).
response_type STRING	Тип ответа: VAST VMAP UNKNOWN (используется в случаях, когда получен недопустимый ответ или превышено время ожидания ответа)
response_code INTEGER	Код HTTP-ответа.
row_type STRING	Тип записи в файле журнала: PRIMARY_REQUEST AD_POD WRAPPER INLINE Все типы файлов журналов приведены в примере ответа VMAP.
vast_error_code STRING	Код ошибки VAST.
prefetch_stage STRING	Этап предзагрузки (если она включена).
ad_position STRING	Позиция определенного объявления в пакете. Выбранным объявлениям назначаются значения, начиная с единицы. В случае с объявлениями из подборок и пропущенными объявлениями это поле оставляется пустым.
ad_id STRING	Идентификатор объявления *.
ad_system STRING	Рекламная система *.
ad_title STRING	Заголовок объявления *.
creative_id STRING	Идентификатор креатива *.
creative_ad_id STRING	Идентификатор объявления креатива *.
universal_ad_id_registry STRING	Реестр универсального идентификатора объявления *.
universal_ad_id_value STRING	Значение универсального идентификатора объявления *.
creative_duration DOUBLE	Продолжительность креатива.
mezzanine_uri STRING	URL основного файла* Все составляющие строки URI подвергаются экранированию, кроме символов, которые не зарезервированы в спецификации RFC3986.
media_uri STRING	Первый элемент из узла MediaFiles*. Все составляющие строки URI подвергаются экранированию, кроме символов, которые не зарезервированы в спецификации RFC3986.
break_start_uri STRING	Элемент, который используется для отслеживания начала рекламной паузы. Данные берутся из ответа VMAP. Все составляющие строки URI экранируются, кроме символов, которые не зарезервированы в спецификации RFC3986.
google_video_id STRING	Уникальный идентификатор креатива, связанного с этим объявлением.

* Значения, которые относятся к шаблону VAST.

** Поля, которые не применимы к той или иной строке, можно оставить пустыми.