Перейти к разделу: Структура записей журнала | Ответ VMAP со встроенным кодом VAST | Ответ VMAP без встроенного кода VAST | Отдельные запросы VAST
Информация о взаимодействиях с сервером объявлений для динамической вставки хранится в специальных журналах. В этой статье описана структура записей журнала и приведены примеры того, как запросы VMAP указываются в выходных файлах журналов.
Запросы VMAP и структура записей журнала
В ответ на запросы VMAP могут возвращаться пакеты объявлений со встроенными ответами VAST, без встроенных ответов VAST или с отдельными запросами VAST. Структура записи журнала зависит от ответа VMAP.
Необязательно все пакеты в запросе VMAP должны содержать только код VAST или только URL переадресации VAST. Возможны ситуации, при которых часть пакетов содержит код VAST, а другая чаcть – URL переадресации VAST.
Поля в записях журналов
Во всех записях о взаимодействии с сервером объявлений есть указанные ниже поля (в порядке следования). Некоторые поля могут быть пустыми. В Справочном центре есть статья о полях записей.
"timestamp","entry_id","stream_id","network_code","content","vid","asset_key","pod_id","ad_server_host_name","response_time","response_type",
"response_code","row_type","vast_error_code","prefetch_stage","ad_position","ad_id","ad_system","ad_title","creative_id","creative_ad_id","universal_ad_id_registry","universal_ad_id_value","creative_duration"
Структура и поля журнала взаимодействий
Ответ VMAP, в котором есть встроенный код VAST
На иллюстрации ниже показано дерево ответа VMAP со встроенным кодом VAST. В журналах взаимодействий с сервером объявлений хранятся записи о каждом узле дерева.
-
P – исходный запрос VMAP к серверу объявлений. В ответ получены два пакета встроенных объявлений (Pod-1 и Pod-2):
-
В коде VAST из пакета Pod-1 содержатся два объявления-контейнера (W-1 и W-2) и встроенное объявление (Ad-3):
- В контейнере W-1 находится ещё один контейнер (W-1-2), который возвратил встроенное объявление (Ad-1).
- В контейнере W-2 находится встроенное объявление (Ad-2).
-
В коде VAST из пакета Pod-2 содержатся два объявления-контейнера (W-3 и W-4):
- По запросу к контейнеру W-3 не получен ответ в заданное время.
- В контейнере W-4 находится встроенное объявление (Ad-4).
-
Всего пакет Pod-1 содержит три встроенных объявления (Ad-1, Ad-2 и Ad-3). Пакет Pod-2 содержит одно встроенное объявление (Ad-4). Если не будет ошибок, все конечные узлы дерева вернут встроенные объявления.
Конечные узлы дерева всегда порождаются родительскими ответами.
Так, если узел с контейнером содержал встроенное объявление, то в записи об узле с контейнером будут значения полей ad_server_host_name, response_time, ad_system, а также (но необязательно) полей ad_position и ad_id. Каждый конечный узел ниже узла контейнера будет содержать информацию об объявлении и креативе для каждого встроенного объявления в контейнере. Она указывается в полях ad_position, ad_id, ad_system, ad_title, creative_id, creative_ad_id, universal_ad_id_registry, universal_ad_id_value и creative_duration.
Пример записи об ответе VMAP со встроенным кодом VAST
Предположим, есть трансляция с такими данными:
- Идентификатор трансляции:
12345abc-0abc-1234-5678-9abc12345def. - Код сети:
12345678. - Код CMS:
12345. - Идентификатор видео:
sample-vid.
В записях об узлах может быть такая информация:
Узел P
"1629979322398140","ZmMyNmUwMTAtOGU2Ni00ZjFkLTgzYmUtNTMxNDA3NGExMDgx","12345abc-0abc-1234-5678-9abc12345def","12345678","12345","sample-vid","","","pubads.g.doubleclick.net","0.058311558","VMAP","200","PRIMARY_REQUEST","","PREFETCH_STAGE_NONE","","","","","","","","",""
Посмотреть поля записи журнала
В записи журнала об узле P:
- Поле
pod_idпустое (""), так как это исходный запрос VMAP. - Поле
row_typeсодержит значениеPRIMARY_REQUEST. - Поле
ad_positionпустое (""). - Все поля, относящиеся к объявлению и креативу, пустые (
"").
Узел Pod-1
"1629979322398140","YTZlMjY5OTUtODliMy00MmI0LWE3OTUtMzc0NjAwZWViMjFm","12345abc-0abc-1234-5678-9abc12345def","12345678","12345","sample-vid","","midroll-1","","","","","AD_POD","","PREFETCH_STAGE_NONE","","","","","","","","",""
Посмотреть поля записи журнала
В записи журнала об узле Pod-1:
- Поле
pod_idсодержит значениеmidroll-1, полученное от сервера объявлений. - Поле
row_typeсодержит значениеAD_POD. - Поле
ad_server_host_nameпустое (""), так как информация о пакете отправлена в исходном запросе как встроенный код VAST. - Поле
ad_positionпустое (""). - Все поля, относящиеся к объявлению и креативу, пустые (
"").
Узел W-1
"1629979322398140","MTRmN2YxNzgtNTY2NS00NGYyLWI5NDMtNGYzYjU5NGNhNTIz","12345abc-0abc-1234-5678-9abc12345def","12345678","12345","sample-vid","","midroll-1","pubads.g.doubleclick.net","0.048344558","VAST","200","WRAPPER","","PREFETCH_STAGE_NONE","1","4617730256","GDFP","","138228457230","","GDFP","138228457232",""
Посмотреть поля записи журнала
Узел W-1-2
"1629979322398140","YTFkYTA5YTItYzgxMC00NTUwLTlmZDctZjU0NjhjY2E5YWRm","12345abc-0abc-1234-5678-9abc12345def","12345678","12345","sample-vid","","midroll-1","pubads.g.doubleclck.net","0.042344558","VAST","200","WRAPPER","","PREFETCH_STAGE_NONE","1","4617730126","GDFP","","138228457230","","GDFP","138228457232",""
Посмотреть поля записи журнала
В записи журнала об узле W-1-2:
- Поле
ad_server_host_nameсодержит значениеpubads.g.doubleclick.net. - Поле
response_timeсодержит значение0.042344558.
Узел Ad-1
"1629979322398140","NTYyMDc4ZWYtODRkOS00MjFkLWI0NDEtNTY3OTEwZWVmZDQ0","12345abc-0abc-1234-5678-9abc12345def","12345678","12345","sample-vid","","midroll-1","","","","","INLINE","","PREFETCH_STAGE_NONE","1","4617730730","GDFP","LI first position in midroll","138228457232","","GDFP","138228457232","30.000000000"
Посмотреть поля записи журнала
Ad-1 – это встроенное объявление, помещенное в контейнер W-1-2. В записи журнала об узле Ad-1:
- Поле
pod_idсодержит значениеmidroll-1. - Поле
row_typeсодержит значениеINLINE. - Поле
ad_server_host_nameпустое (""). - Поле
ad_positionсодержит значение1.
Узел W-2
"1629979322398140","MmEzNjAwMTUtZTE1MS00ZTA0LTlhNWYtYmJmMzFkY2Y3YmJi","12345abc-0abc-1234-5678-9abc12345def","12345678","12345","sample-vid","","midroll-1","pubads.g.doubleclick.net","0.034534558","VAST","200","WRAPPER","","PREFETCH_STAGE_NONE","2","4617730256","GDFP","","138228457230","","GDFP","138228457232",""
Посмотреть поля записи журнала
Узел Ad-2
"1629979322398140","MjIzYzYyNzItZWU0Zi00NGM2LWIxYWYtZTdiYjkxMzZmYWFl","12345abc-0abc-1234-5678-9abc12345def","12345678","12345","sample-vid","","midroll-1","","","","","INLINE","","PREFETCH_STAGE_NONE","2","4617858678","GDFP","LI second position in midroll","138228457232","","GDFP","138228457232","30.000000000"
Посмотреть поля записи журнала
Узел Ad-3
"1629979322398140","ZTgwMWVkYzYtMmNkMS00NmUyLTk1ZDMtMTA3ZTM0ODQ5Yjhj","12345abc-0abc-1234-5678-9abc12345def","12345678","12345","sample-vid","","midroll-1","","","","","INLINE","","PREFETCH_STAGE_NONE","3","4617858678","GDFP","LI third position in midroll","138228457232","","GDFP","138228457232","30.000000000"
Посмотреть поля записи журнала
Узел Pod-2
"1629979322398140","NTg1ZjMwZDQtYWY5Mi00ZjA0LWI0YTMtZWYxNmIwZTNkYWZj","12345abc-0abc-1234-5678-9abc12345def","12345678","12345","sample-vid","","preroll","","","","","AD_POD","","PREFETCH_STAGE_NONE","","","","","","","",""
Посмотреть поля записи журнала
Узел W-3
"1629979322398140","MGFmZTE4ZGYtZGZiYS00NTU1LWIzOWQtZjAyY2FhZmY4ZmM0","12345abc-0abc-1234-5678-9abc12345def","12345678","12345","sample-vid","","preroll","pubads.g.doubleclick.net","5.000000000","","","WRAPPER","301","PREFETCH_STAGE_NONE","0","","","","","","","",""
Посмотреть поля записи журнала
В записи журнала об узле W-3:
- Поле
vast_error_codeсодержит значение301, так как для запроса было превышено время ожидания. - Поле
ad_positionсодержит значение0. - Поле
response_typeпустое (""), так как для запроса превышено время ожидания.
Узел W-4
"1629979322398140","MzI3NTg1Y2UtNGQyMy00NGE4LTg3YTItNGI2ZWJiMjM1YTQ1","12345abc-0abc-1234-5678-9abc12345def","12345678","12345","sample-vid","","preroll","pubads.g.doubleclick.net","0.042344558","VAST","200","WRAPPER","","PREFETCH_STAGE_NONE","1","4617730126","GDFP","","138228457230","","GDFP","138228457232",""
Посмотреть поля записи журнала
Узел Ad-4
"1629979322398140","MmEwZTU2YmMtOGQ4NS00NjgxLTlhMzEtMGQ2MmRhZTZhZjc0","12345abc-0abc-1234-5678-9abc12345def","12345678","12345","sample-vid","","preroll","","","","","INLINE","","PREFETCH_STAGE_NONE","1","4617731672","GDFP","LI first position in midroll","138228457232","","GDFP","138228457232","30.000000000"
Посмотреть поля записи журнала
В записи об узле Ad-4:
- Поле
ad_positionсодержит значение1.
Ответ VMAP, в котором нет встроенного кода VAST (с URL переадресации VAST)
Дерево ответа VMAP может содержать не встроенный код VAST, а URL переадресации VAST. Независимо от способа получения ответа (встроенный код или URL переадресации) узлы дерева почти одинаковы.
Единственное различие: если ответ получен через переадресацию, в соответствующей записи AD_POD будут содержаться значения полей ad_server_host_name, response_time и response_type. Это признак того, что была выполнена дополнительная переадресация.
В примерах записей ниже информация о дополнительной переадресации выделена.
Пример записи журнала об ответе VMAP без встроенного кода VAST
Предположим, есть трансляция с такими данными:
- Идентификатор трансляции:
12345abc-0abc-1234-5678-9abc12345def. - Код сети:
12345678. - Код CMS:
12345. - Идентификатор видео:
sample-vid.
В записях об узлах может быть такая информация:
Узел Pod-1
"1629979322398140","Nzg0MDczZGMtNzA5Yy00ODllLTgxZTAtNDBlZmMyMmU5OTE5","12345abc-0abc-1234-5678-9abc12345def","12345678","12345","sample-vid","","midroll-1","adpodreq1.example.com","0.234231433","VAST","200","AD_POD","","PREFETCH_STAGE_NONE","","","","","","","",""
Посмотреть поля записи журнала
В ответах VMAP без встроенного кода VAST дочерние узлы контейнеров и объявлений работают так же, как и в случае со встроенным кодом VAST.
Отдельные запросы VAST
Большинство запросов VAST отправляются системами динамической вставки объявлений в линейные видеопотоки и прямые трансляции, поэтому в записях о них поля cms_id и vid пустые, а в поле asset_key есть значение.
Пример записи об отдельном запросе VAST
Предположим, есть трансляция с такими данными:
- Идентификатор трансляции:
d07258a5-0abc-47e8-954d-e61fdaeb739c. - Код сети:
51636543. - Ключ объекта:
asset_key.
В записях об узлах может быть такая информация:
Узел P
"1629979322398140","Nzg0MDczZGMtNzA5Yy00ODllLTgxZTAtNDBlZmMyMmU5OTE5","d07258a5-0abc-47e8-954d-e61fdaeb739c","51636543","","","asset_key","363","pubads.g.doubleclick.net","0.058311558","VAST","200","PRIMARY_REQUEST","","PREFETCH_STAGE_NONE","","","","","","","","",""
Посмотреть поля записи журнала
В записи журнала об узле P:
- Поле
pod_idпустое (""), так как это исходный запрос VMAP. - Поле
row_typeсодержит значениеPRIMARY_REQUEST. - Поле
ad_positionпустое (""). - Все поля, относящиеся к объявлению и креативу, пустые (
"").
Узел Pod-1
"1629979322398140","ZmMwYzA4N2ItNmUxOC00OTgxLWE4OTYtZmUxZTc1NGJlYThk","d07258a5-0abc-47e8-954d-e61fdaeb739c","51636543","","","asset_key","363","","","","","AD_POD","","PREFETCH_STAGE_NONE","","","","","","","","",""
Посмотреть поля записи журнала
В записи журнала об узле P-1:
- Поле
pod_idсодержит значение363в соответствии с уведомлением о рекламной паузе. - Поле
row_typeсодержит значениеAD_POD. - Поля
ad_server_host_name,response_timeиresponse_typeпустые (""), так как информация о пакете получена через исходный запрос. - Поле
ad_positionпустое (""). - Все поля для информации о креативе и объявлении пустые (
"").
Узел W-1
"1629979322398140","NWY4YTM0YTYtZTgwMy00YWYyLWE3N2UtNTVmMzA0ZDNhYzQ4","d07258a5-0abc-47e8-954d-e61fdaeb739c","51636543","","","asset_key","363","pubads.g.doubleclick.net","0.048344558","VAST","200","WRAPPER","","PREFETCH_STAGE_NONE","1","4617730256","GDFP","","138228457230","","GDFP","138228457232",""
Посмотреть поля записи журнала
Узел W-1-2
"1629979322398140","ZTY3ZWViZmUtNzg1Ny00MmFhLWE0ZTctNjE2YzQyNjA3NmQx","d07258a5-0abc-47e8-954d-e61fdaeb739c","51636543","","","asset_key","363","pubads.g.doubleclick.net","0.042344558","VAST","200","WRAPPER","","PREFETCH_STAGE_NONE","1","4617730126","GDFP","","138228457230","","GDFP","138228457232",""
Посмотреть поля записи журнала
Узел Ad-1
"1629979322398140","MGRjMzg3OTctM2U3NS00NWE4LWFkMWEtNzg4YTg1ZmE0NTI2","d07258a5-0abc-47e8-954d-e61fdaeb739c","51636543","","","asset_key","363","","","","","INLINE","","PREFETCH_STAGE_NONE","1","4617730730","GDFP","LI Sponsorship - CT External_Home - CH DFP - first position in midroll","138228457232","","GDFP","138228457232","30.000000000"
Посмотреть поля записи журнала
В записи журнала об узле Ad-1:
- Поле
pod_idсодержит значение363в соответствии с уведомлением о рекламной паузе. - Поле
row_typeсодержит значениеINLINE. - Поле
ad_server_host_nameпустое (""). - Поле
ad_positionсодержит значение1.
Узел W-2
"1629979322398140","ZjcxMWYyOTYtMmI4ZC00NDYxLTg4NDUtZmFhNGUxM2NlZThl","d07258a5-0abc-47e8-954d-e61fdaeb739c","51636543","","","asset_key","363","pubads.g.doubleclick.net","0.034534558","VAST","200","WRAPPER","","PREFETCH_STAGE_NONE","2","4617730256","GDFP","","138228457230","","GDFP","138228457232",""
Посмотреть поля записи журнала
Узел Ad-2
"1629979322398140","NjEyY2QxNWQtNDQ3NS00MzRiLWI2YTAtNTU5NDI5MDZiZTR","d07258a5-0abc-47e8-954hd-e61fdaeb739c","51636543","","","asset_key","363","","","","","INLINE","","PREFETCH_STAGE_NONE","2","4617858678","GDFP","LI Sponsorship - CT External_Home - CH DFP - first position in midroll","138228457232","","GDFP","138228457232","30.000000000"
Посмотреть поля записи журнала
Узел Ad-3
"1629979322398140","NWJlMTQzY2EtOTI4NS00OWY0LThlZjYtODU1ZDk2YjU4Nzlm","d07258a5-0abc-47e8-954d-e61fdaeb739c","51636543","","","asset_key","363","","","","","INLINE","","PREFETCH_STAGE_NONE","3","4617858678","GDFP","LI Sponsorship - CT External_Home - CH DFP - first position in midroll","138228457232","","GDFP","138228457232","30.000000000"
