Инструмент YouTube VAST QA позволяет проверить, соответствуют ли теги VAST нашим требованиям к показу сторонних объявлений, а также просмотреть эти объявления в проигрывателе YouTube.
Одобренные сторонние поставщики
Сторонние объявления In-Stream и сопутствующие баннеры должны предоставляться поставщиком, утвержденным YouTube. При этом следует использовать линейный тег VAST (подробная информация приведена в таблице ниже). Обратите внимание, что показ внешних объявлений, нарушающих наши правила, может быть ограничен или приостановлен.
Элементы кода XML для объявлений In-Stream в ответах сервера объявлений VAST
| Элемент | Атрибуты | Значения | Обязательно | Поддерживается | Примечания |
|---|---|---|---|---|---|
| VAST | Корневой узел | Да | Да | ||
| version | Строка (3.0) | Да | Да | Необходима поддержка VAST 2.* или 3.0 | |
| Ad | ID | Строка | Да | Да | Элемент верхнего уровня, в котором содержатся все объявления из ответа |
| InLine | Нет | Нет | Да | Да | Элемент второго уровня, в котором содержатся все данные одного объявления |
| AdSystem | Нет | Строка | Да | Да | Указывает исходный сервер объявлений |
| version | Строка | Рекомендовано | Да | Внутренняя версия, используемая сервером объявлений | |
| AdTitle | Нет | Строка | Нет | Да | Название объявления |
| Description | Нет | Строка | Нет | Да | Подробное описание объявления |
| Survey | Нет | URI | Нет | Нет | URI запроса к поставщику исследования. В этом узле система YouTube поддерживает только пиксели отслеживания исследований от сертифицированных поставщиков. Опросы и приглашения к опросу в настоящее время нельзя показывать через код XML шаблона VAST. |
| Error | Нет | URI | Нет | Да | URI запроса, если объявление не отображается из-за ошибки. В таком случае система YouTube обрабатывает только запрос, информация об ошибке не передается. |
| Impression | Нет | URI | Да | Да | URI для отслеживания показов |
| Creatives | Нет | Нет | Да | Да | Контейнер для одного или нескольких элементов объявлений |
| Creative | Да | Да | Включает отдельный элемент объявления | ||
| ID | Строка | Нет | Да | Необязательный идентификатор | |
| sequence | Целое число | Нет | Да | Предпочтительный порядок показа нескольких объявлений | |
| AdID | Строка | Нет | Да | Идентификатор объявления (ранее – ISCI) | |
| Linear | Да | Да | |||
| skipoffset | 00:00:05 | Нет | Да | Поддерживается только версия VAST 3.0 | |
| Duration | Нет | Время | Да | Да | |
| TrackingEvents | Нет | Да | |||
| Tracking | URI | Нет | Да | URI для отслеживания различных событий при воспроизведении | |
| event | creativeView, start, firstQuartile, midpoint, thirdQuartile, complete, mute, unmute, pause, rewind, resume, fullscreen, expand, collapse, acceptInvitation, close acceptInvitationLinear closeLinear progress skip |
Нет |
Да (для значений start, firstQuartile, midpoint, thirdQuartile, complete). Значение skip поддерживается только в VAST 3.0. |
Название события, которое нужно отслеживать, для элемента Linear. Значение creativeView всегда должно запрашиваться при его наличии. | |
| AdParameters | Строка | Нет | Нет | Данные для передачи в видеообъявление | |
| VideoClicks | Да | Да | |||
| ClickThrough | Нет | URI | Да | Да | URI целевой страницы для клика по видео |
| ClickTracking | URI | Нет | Да | URI запроса отслеживания клика по видео | |
| CustomClick | URI | Нет | Да | URI запроса персонализированных событий, например кликов по определенной зоне видео | |
| ID | Строка | Нет | Нет | Необязательный идентификатор | |
| MediaFiles | Да | Да | |||
| MediaFile | URI |
Да Требуется по крайней мере два отдельных узла MediaFile (по одному для видеоформатов MP4 и WebM). |
Да | Местоположение линейного файла | |
| delivery | progressive | Да | Да | Метод показа объявления (потоковая передача не является предпочтительным методом в YouTube) | |
| type | Строка | Да (MP4 и WebM) | Да | Тип MIME. В частности, video/x-ms-wmv для Windows Media. | |
| bitrate | Целое число | Да | Да | Битрейт кодированного видео (кбит/с) | |
| width | Целое число (480) | Да | Да | Размеры видео в пикселях | |
| height | Целое число (360) | Да | Да | Размеры видео в пикселях | |
| scalable | Логическое значение | Нет | Нет | Указывает, можно ли увеличивать видео (включено в YouTube по умолчанию) | |
| maintainAspectRatio | Логическое значение | Нет | Да | ||
| apiFramework | Строка | Нет | Нет | Определяет метод коммуникации в случаях, если элемент MediaFile является интерактивным | |
| CompanionAds | Нет | Да | |||
| Companion | Нет | Да | Любое количество сопутствующих объявлений любого размера | ||
| ID | Строка | Нет | Да | Необязательный идентификатор | |
| width | Целое число (300) | Да (при показе сопутствующего элемента) | Да | Размеры сопутствующего баннера (в пикселях) | |
| height | Целое число (60) | Да (при показе сопутствующего баннера) | Да | Размеры сопутствующего баннера (в пикселях) | |
| expandedWidth | Целое число | Нет | Нет | Размеры в пикселях расширяемого сопутствующего объявления в развернутом состоянии (не поддерживаются для объявлений In-Stream в YouTube) | |
| expandedHeight | Целое число | Нет | Нет | Размеры в пикселях расширяемого сопутствующего объявления в развернутом состоянии (не поддерживаются для объявлений In-Stream в YouTube) | |
| apiFramework | Строка | Нет | Нет | Определяет метод коммуникации с сопутствующим баннером | |
| StaticResource | URI | Нет | Да | URI статичного файла, например изображения | |
| creativeType | Строка | Да (при показе сопутствующего баннера через StaticResource) | Да | Тип MIME для статичного ресурса (поддерживаются только типы графических файлов) | |
| IFrameResource | Нет | URI | Нет | Да | Источник URI, который используется окном iframe для показа сопутствующего баннера |
| HTMLResource | Нет | CDATA | Нет | Нет | HTML для показа сопутствующего баннера |
| JavaScriptResource | Нет | CDATA | Нет | Нет | JavaScript для показа сопутствующего баннера |
| TrackingEvents | Нет | Нет | |||
| Tracking | URI | Нет | Нет | URI для показа сопутствующего баннера | |
| event | creativeView | Да (при показе сопутствующего баннера) | Нет | Значение creativeView всегда должно запрашиваться при его наличии. Событие creativeView является единственным поддерживаемым для сопутствующих баннеров. | |
| CompanionClickThrough | Нет | URI | Да (при показе статичного изображения без прописанного URL перехода) |
Да | URI целевой страницы для клика по сопутствующему баннеру |
| AltText | Нет | Строка | Нет | Да | Альтернативный текст для показа в HTML-среде |
| AdParameters | Строка | Нет | Нет | Данные для передачи в сопутствующий баннер | |
| NonLinearAds | Нет | Нет | В настоящее время не поддерживается (только для линейных объявлений In-Stream) | ||
| Extensions | Нет | Нет | |||
| Extension | type | Любое | Нет | Нет | Можно указывать любой действительный код XML, он не будет учтен |
| Wrapper | Нет | Нет | Нет | Нет | Элемент второго уровня, окружающий оболочку объявления, указывающую на второй сервер объявлений |