Ниже описываются причины ошибок VAST, способы тестирования видеообъявлений VAST и пути устранения проблем. Ошибки шаблонов VAST могут быть обусловлены проблемами с запросом объявления, ответом на него, видеопроигрывателем или самим URL.
Медийное объявление, которое показывается на вашем сайте, отрисовывается браузером с использованием кода HTML, JavaScript и CSS. Показ видеообъявлений сложнее. XML-файл VAST – это набор данных, описывающих объявление. Проигрыватель получает и обрабатывает его, чтобы определить, какой медиафайл ему воспроизводить. Затем проигрыватель отправляет ответы серверу объявлений, сообщая, смотрел ли пользователь объявление и как долго.
Кроме того, вы можете протестировать проверенные образцы тегов VAST в собственном проигрывателе.
Чтобы проверить свои видеообъявления, а также получить информацию о запросах из сетей и ответах на них, вы можете использовать инструменты разработчика Chrome или любые сторонние средства.
Отфильтруйте сетевые запросы так, чтобы остались только те, в которых есть ключ env=vp, то есть отправленные на сервер видеообъявлений Менеджера рекламы.
В каждом запросе могут быть параметры, например:
iu– код сети Менеджера рекламы;size– размер запрошенного объявления.
Если в запросе объявления есть что-то непредвиденное, попросите разработчика видеопроигрывателя решить возникшие проблемы.
В ответ на запросы видеообъявлений должны отправляться только XML-файлы VAST. Существуют два типа таких файлов: встроенные и с переадресацией. Тип файла указан в коде XML. Встроенные XML-файлы (пример) содержат список креативов, а XML-файлы с переадресацией (пример) – URI тега объявления VAST, который указывает на URL встроенной версии или выполняет дополнительную переадресацию.
Креативы и медиафайлы
В XML-файле VAST доступен элемент <Creatives> с несколькими вариантами <MediaFiles>. Ваш проигрыватель выбирает подходящие из этих вариантов. Если проигрыватель не может воспроизвести ни один из доступных медиафайлов, объявление пользователю показано не будет. В таком случае обратитесь к трафик-менеджеру или к другому лицу, от которого поступил креатив, и запросите медиафайл, который проигрыватель сможет воспроизвести.
Отслеживание событий
Перед устранением неполадок убедитесь, что события, которые вы хотите отслеживать, точно определены в XML-файле VAST. Например, Менеджер рекламы сможет выяснить, что пользователь взаимодействует с объявлением, только если получит от проигрывателя сообщения с событиями, определенными в XML-файле. Или, например, о том, что пользователь просмотрел объявление полностью, можно узнать, только если в XML-файле определено событие просмотра до конца.
Пустой XML-тег VAST
Если в ответ на запрос вы получили пустой тег VAST, обычно это указывает на то, что на сервере объявлений не было подходящих креативов или же не оказалось объявлений, для которых таргетинг настроен на запросы этого типа. Если в проигрыватель поступают пустые XML-теги VAST, убедитесь, что в запросах объявлений, которые он отправляет, правильно заданы пары "ключ-значение", рекламный блок и размеры. Кроме того, можно проверить настройки таргетинга в Менеджере рекламы и убедиться, что позиции, которые вы ожидаете получить, соответствуют параметрам запроса.
Доля отрисовки креатива
Если общее количество передач кода отличается от общего числа показов более чем на 25 %, это может быть связано с долей отрисовки креатива.
На долю отрисовки креатива могут влиять следующие факторы:
- задержка или сбой сайта или проигрывателя, а также действие пользователя;
- ситуация, в которой посетитель закрыл страницу до начала воспроизведения рекламы в проигрывателе;
- упреждающий запрос.
Если причина в упреждающем запросе, то все в порядке и ничего предпринимать не требуется, однако проблемы с проигрывателем или сайтом необходимо проанализировать и устранить.
Уровни серьезности ошибок видеообъявлений
Иногда ошибки, возникающие во время работы видеопроигрывателя, не препятствуют показу объявления. Такие ошибки считаются потенциально некритическими. При этом из-за критических ошибок видеопроигрыватель останавливает запрос неисправного объявления и либо запрашивает другое, либо возобновляет воспроизведение видеоконтента. Это зависит от реализации проигрывателя.
| Критические ошибки: скорее всего, запрос объявления был отменен. | |
| Потенциально некритические ошибки: возможно, показ объявления был продолжен. |
Ошибки VAST
Вероятная причина ошибки VAST 100
Возможные причины возникновения критической ошибки: ответ покупателя имеет неверный формат, документ XML недействителен или возникла ошибка подключения в результате переадресации URL VAST.
Рекомендуемые действия
| Издатель | Оповестите покупателя. |
| Покупатель | Убедитесь, что у XML-файла VAST правильная структура и что он содержит все необходимые элементы и атрибуты. Подробнее о требованиях к шаблонам VAST рассказывается на сайте IAB. |
Вероятная причина ошибки VAST 101
Это критическая ошибка. Она может возникать, когда в ответе покупателя отсутствуют обязательные элементы или атрибуты XML, или ответ содержит нераспознанные элементы (необходимо соответствие стандарту IAB).
Рекомендуемые действия
| Издатель | Оповестите покупателя. |
| Покупатель | Убедитесь, что у XML-файла VAST правильная структура и что он содержит все необходимые элементы и атрибуты. Подробнее о требованиях к шаблонам VAST читайте на сайте IAB. |
Вероятная причина ошибки VAST 102
Это критическая ошибка. Она может быть связана с тем, что видеопроигрыватель не поддерживает версию VAST, указанную в запросе ставки.
Рекомендуемые действия
| Издатель | Оповестите покупателя. |
| Покупатель | Убедитесь, что в ответ были отправлены только поддерживаемые версии VAST. |
Вероятная причина ошибки VAST 200
Это потенциально некритическая ошибка. Она может быть связана с тем, что тип объявления, указанный в запросе ставки, не соответствует ожидаемому или не поддерживается видеопроигрывателем. Например, так бывает, если отправляется объявление с возможностью пропуска, а проигрыватель настроен только на показ линейных объявлений, или если интервал до пропуска больше, чем нужно.
Рекомендуемые действия
| Издатель | Проверьте наличие ошибок при размещении рекламы или оповестите покупателя. |
| Покупатель | Убедитесь, что в ответ были отправлены только указанные типы объявлений и что линейные креативы с возможностью пропуска будут работать с учетом значения интервала до пропуска. |
Вероятная причина ошибки VAST 201
Это потенциально некритическая ошибка. Она может быть связана с тем, что линейность в ответе покупателя не совпадает с указанной в запросе видеопроигрывателя. Один из возможных сценариев – отправка нелинейного объявления, когда требовалось линейное*.
Рекомендуемые действия
| Издатель | Убедитесь, что линейность объявления соответствует запросу. |
| Покупатель | Убедитесь, что ответ содержит только указанную в запросе линейность. |
*Система RTB сервиса "Авторизованные покупатели" поддерживает только линейные объявления.
Вероятная причина ошибки VAST 202
Это потенциально некритическая ошибка. Она может быть связана с тем, что продолжительность креатива отличается от указанной в запросе. Например, в настройках возвращенного креатива задано значение 30 секунд, а длительность медиафайла составляет 60 секунд.
Рекомендуемые действия
| Издатель | Убедитесь, что продолжительность креатива задана правильно в Менеджере рекламы. |
| Покупатель | Убедитесь, что ответ соответствует максимальной длительности, указанной в запросе. |
Вероятная причина ошибки VAST 203
Это потенциально некритическая ошибка. Она может быть связана с тем, что предоставленные покупателем медиафайлы несовместимы с устройством, с которого отправлен запрос ставки. Обычно это происходит, когда креативы с высоким битрейтом отправляются на мобильные устройства.
Рекомендуемые действия
| Издатель | Оповестите покупателя. |
| Покупатель | Убедитесь, что ваш ответ содержит медиафайлы, совместимые с различными технологиями и устройствами, включая битрейты. |
Вероятная причина ошибки VAST 300
Это критическая ошибка. Она связана с контейнером и не требует действий.
Вероятная причина ошибки VAST 301
Это критическая ошибка, которая возникает, когда тег переадресации VAST не вернул ответ до истечения времени ожидания, указанного в контейнере (по умолчанию оно составляет 5 секунд). Возможно, URI в запросе недействителен, недоступен или не позволяет получить ответ вовремя или же причина в других проблемах, связанных с запросами URI VAST, например с их безопасностью. Также критическая ошибка этого типа иногда возникает из-за медленного интернет-подключения (например, 3G) или просто из-за того, что недостаточно быстро откликнулся покупатель.
Рекомендуемые действия
| Издатель | Используя SDK, увеличьте лимит времени ожидания для своего проигрывателя. |
| Покупатель | Убедитесь, что URI переадресации VAST доступен и нет никаких проблем с протоколом (например, такие проблемы могут возникнуть, если ответы размещены на HTTP-сайте, а передаются на HTTPS-сайт). |
Вероятная причина ошибки VAST 302
Это критическая ошибка. Она возникает, когда был достигнут лимит на количество контейнеров, заданный видеопроигрывателем. Также возможно, что получено слишком много ответов-контейнеров без финального ответа с рекламными материалами, либо возник цикл на основе последовательной цепи (одна сеть выдает отказ и перенаправляет запрос другой и т. д.), либо получено слишком много пустых ответов VAST при подборе резервных видеообъявлений.
Рекомендуемые действия
| Издатель | Используя SDK, увеличьте лимит на количество контейнеров для своего проигрывателя. |
| Покупатель | Убедитесь, что за первой переадресацией VAST не следует ещё одна, перенаправляющая запрос в другую сеть. При большом количестве переадресаций проигрыватель может прервать запрос объявления. |
Вероятная причина ошибки VAST 303
Это критическая ошибка. Она может быть связана с тем, что ответ VAST, полученный после одной или нескольких переадресаций контейнера, не содержит объявлений. К этой категории также относятся пустые ответы VAST, полученные при подборе резервных видеообъявлений.
В сторонних сетях заполняемость может быть ниже 100 %, и в таком случае эта ошибка считается ожидаемой. Например, если предполагается, что сторонняя сеть заполнит 60 % времени, доля ошибок составит 40 %.
Рекомендуемые действия
| Издатель | Убедитесь, что процент ошибок соответствует заполняемости сторонней сетью. Чтобы не терять показы, используйте резервные видеообъявления. |
| Покупатель | Убедитесь, что ставки не отправляются с пустыми ответами VAST, а также что не отправляет пустых ответов агентство или рекламодатель, у которого размещен креатив. |
Вероятная причина ошибки VAST 400
Это критическая ошибка. Она может быть связана с тем, что видеопроигрыватель не может показать линейное объявление. Это случается, если медиафайл не является допустимым видеофайлом указанного формата, если браузер ограничил автовоспроизведение звука или по другой причине.
Рекомендуемые действия
| Издатель | Проверьте, не выдает ли проигрыватель ошибки, разрешите проигрывателю отслеживать ограничение автовоспроизведения или свяжитесь с покупателем. |
| Покупатель | Убедитесь, что ответ VAST содержит корректный креатив. |
Вероятная причина ошибки VAST 401
Это критическая ошибка. Она может быть связана с тем, что по URI медиафайла отсутствует файл.
Рекомендуемые действия
| Издатель | Оповестите покупателя. |
| Покупатель | Убедитесь, что все URI медиафайла в ответе VAST возвращают корректный видеокреатив. |
Вероятная причина ошибки VAST 402
Это критическая ошибка. Она может быть связана с загрузкой или воспроизведением медиафайла. Вероятные причины:
- В IMA SDK задано слишком маленькое значение
loadVideoTimeout. По умолчанию оно составляет 8 секунд. - Низкая скорость подключения или некорректная реализация сайта с конкурирующими запросами, которые вызывают задержки при загрузке медиафайлов.
- Видео запускается на мобильных устройствах автоматически, а должно воспроизводиться по клику (с некоторыми исключениями).
- Видеообъявления показываются в среде с автоматическим воспроизведением (например, в плейлистах), при этом окно неактивно (открыта другая вкладка или окно свернуто)*.
Для предотвращения потери показов в проигрывателях с IMA SDK используйте резервные видеообъявления.
Рекомендуемые действия
| Издатель | Используя SDK, увеличьте лимит времени ожидания для своего проигрывателя. |
| Покупатель | Убедитесь, что все креативы, размещенные в сети доставки контента, возвращаются до того, как указанное время ожидания истечет. |
*Только в браузере Chrome.
Вероятная причина ошибки VAST 403
Это критическая ошибка. Она может быть связана с ответом VAST, в котором для всех доступных медиафайлов указаны неподдерживаемые MIME-типы (например, Flash на мобильных устройствах или WebM на iOS). В результате может быть предпринята попытка показа креатива, который не поддерживается.
Как правило, такая ошибка возникает при показе на смартфонах или планшетах.
Рекомендуемые действия
| Издатель | Убедитесь, что запрашиваемый формат или технология креатива поддерживаются устройством и платформой, на которых используется видеопроигрыватель. Например, креативы VPAID не будут запрашиваться из мобильных приложений. |
| Покупатель | Убедитесь, что все возвращаемые креативы соответствуют формату видео в запросе ставки. |
Вероятная причина ошибки VAST 405
Это критическая ошибка. Она может быть связана с тем, что возвращается креатив, содержащий ошибки. Ошибки могут возникать из-за несоответствия MIME-типа и типа видеофайла, конфигурации CORS в сети доставки контента или по другим причинам, связанным с перекодированием.
Рекомендуемые действия
| Издатель | Оповестите покупателя. |
| Покупатель | Убедитесь, что MIME-типы креативов и конфигурации CDN не содержат ошибок. |
Вероятная причина ошибки VAST 406
Это критическая ошибка. Она возникает, когда ответ VAST получен без обязательного основного файла. Издателям с реализацией объявлений на стороне сервера часто требуются "основные файлы" – высококачественные видеофайлы в формате RAW, которые используются для динамической вставки рекламы или для создания видеофайлов требуемого качества*.
Рекомендуемые действия
| Издатель | Оповестите покупателя. |
| Покупатель | Убедитесь, что основной файл включен в ваш ответ, если этого требует издатель. |
*Особенность VAST 4.
Вероятная причина ошибки VAST 407
Это критическая ошибка. Она возникает, если объявление не показывается потому, что основной файл был скачан впервые. Ошибка также возникает, если перекодирование креатива не завершено, и показывается до тех пор, пока креатив не станет доступен для вставки*.
Рекомендуемые действия
Это ожидаемая в процессе перекодирования ошибка. Ничего предпринимать не нужно.
*Особенность VAST 4.
Вероятная причина ошибки VAST 408
Это критическая ошибка. Она может быть связана с тем, что объявление, возвращенное в ответе VAST, отклонено.
Рекомендуемые действия
| Издатель | Оповестите покупателя. |
| Покупатель | Убедитесь, что ваш ответ VAST содержит только одобренные креативы или что рекламодатели или агентства, у которых размещены креативы, знают об отказе. |
Вероятная причина ошибки VAST 409
Это критическая ошибка. Она может быть связана с тем, что код креатива, заданного в узле InteractiveCreativeFile, не был выполнен.
Рекомендуемые действия
| Издатель | Оповестите покупателя. |
| Покупатель | Убедитесь, что интерактивный креатив, возвращенный в вашем ответе, воспроизводится при запросах без ошибок. |
Вероятная причина ошибки VAST 410
Это критическая ошибка. Она может быть связана с тем, что код, указанный в узле AdVerification, не был выполнен*.
Рекомендуемые действия
| Издатель | Оповестите покупателя. |
| Покупатель | Убедитесь, что код проверки, указанный в ответе, реализован в соответствии со спецификацией поставщика сервиса проверки. |
*Особенность VAST 4.
Вероятная причина ошибки VAST 500
Это критическая ошибка. Она может быть связана с тем, что видеопроигрывателю по неизвестным причинам не удается показать параллельное объявление.
Рекомендуемые действия
| Издатель | Проверьте видеопроигрыватель на наличие ошибок или оповестите покупателя. |
| Покупатель | Убедитесь, что ответ VAST содержит корректный креатив. |
Вероятная причина ошибки VAST 501
Это критическая ошибка. Она может быть связана с тем, что креатив параллельного объявления слишком велик и не помещается в область показа. Это случается, если вы задаете ширину и высоту элемента видеоконтента с помощью стилей CSS.
Рекомендуемые действия
| Издатель | Убедитесь, что заданная ширина и высота соответствуют области показа. Если вы задали ширину и высоту элемента, содержащего видеоконтент, стилями CSS, укажите эти размеры с помощью атрибутов HTML. |
| Покупатель | Сообщите о проблеме издателю. |
Вероятная причина ошибки VAST 502
Это критическая ошибка. Она может быть связана с тем, что ответ покупателя содержит параллельное объявление, но не подходящий креатив.
Рекомендуемые действия
| Издатель | Оповестите покупателя. |
| Покупатель | Убедитесь, что ответ, содержащий параллельное объявление, был отправлен с подходящими креативами. |
Вероятная причина ошибки VAST 503
Это критическая ошибка. Она может быть связана с тем, что издатель запросил медиафайл недопустимого типа или креатив, размер которого превышает размер видеопроигрывателя.
Рекомендуемые действия
| Издатель | Убедитесь, что запрашиваемые размеры креатива и типы медиафайлов поддерживаются видеопроигрывателем. |
| Покупатель | Сообщите о проблеме издателю. |
Вероятная причина ошибки VAST 600
Это потенциально некритическая ошибка. Она может быть связана с тем, что издателю по неизвестным причинам не удается показать сопутствующее объявление.
Рекомендуемые действия
| Издатель | Проверьте наличие ошибок при показе объявлений или оповестите покупателя. |
| Покупатель | Убедитесь, что ответ VAST содержит корректный креатив. |
Вероятная причина ошибки VAST 601
Это потенциально некритическая ошибка. Она может быть связана с тем, что не удалось показать сопутствующее объявление, потому что оно не помещается в область показа.
Рекомендуемые действия
| Издатель | Убедитесь, что размеры запрашиваемого сопутствующего объявления соответствуют размерам рекламного блока, из которого отправляется запрос. |
| Покупатель | Сообщите о проблеме издателю. |
Вероятная причина ошибки VAST 602
Это потенциально некритическая ошибка. Она может быть связана с тем, что издателю не удается выполнить отрисовку креатива сопутствующего объявления, который был получен в ответе VAST.
Рекомендуемые действия
| Издатель | Проверьте наличие ошибок при показе объявлений или оповестите покупателя. |
| Покупатель | Убедитесь, что ответ VAST содержит корректный креатив. |
Вероятная причина ошибки VAST 603
Это потенциально некритическая ошибка. Она может быть связана с тем, что ответ покупателя возвращает сопутствующее объявление, но не подходящий креатив.
Рекомендуемые действия
| Издатель | Оповестите покупателя. |
| Покупатель | Убедитесь, что ответ с сопутствующим объявлением содержит подходящий креатив. |
Вероятная причина ошибки VAST 604
Это потенциально некритическая ошибка. Она может быть связана с тем, что издатель запрашивает неподдерживаемый тип креатива для рекламного места сопутствующего объявления.
Рекомендуемые действия
| Издатель | Убедитесь, что указанные типы креативов поддерживаются для рекламного места сопутствующего объявления. |
| Покупатель | Сообщите о проблеме издателю. |
Вероятная причина ошибки VAST 900
Это потенциально некритическая ошибка. Она может возникать в связи с любой ошибкой VAST 2 и даже в тех случаях, когда отправляется запрос VAST 3 или когда по умолчанию в сети используется VAST 3.
Рекомендуемые действия
| Издатель | Начните запрашивать ответы в формате VAST 3 или включите VAST 3 в своей сети*. |
| Покупатель | Обратитесь к издателю, чтобы точно определить и устранить проблему, или используйте для ответов VAST 3**. |
*В отчетах приводятся сводные данные об ошибках VAST 900. Данный тип ошибки VAST 900 встречается намного чаще, чем неизвестная ошибка VAST 3.
**Инструмент "Распределение ставок в режиме реального времени" не позволяет получить информацию об этом типе ошибок, так как в большинстве случаев они не являются критическими.
Ошибки VAST 900, данные о которых можно получить с помощью указанного инструмента, описываются ниже.
Вероятная причина ошибки VAST 900
Это критическая ошибка. Она может быть связана с неизвестной ошибкой VAST 3, из-за которой, вероятно, был остановлен запрос объявления.
Рекомендуемые действия
| Издатель | Оповестите покупателя*. |
| Покупатель | Обратитесь к издателю, чтобы точно определить и устранить проблему**. |
*В отчетах приводятся сводные данные об ошибках VAST 900. Данный тип ошибки VAST 900 встречается намного реже, чем ошибка VAST 2.
**Это единственный тип ошибок VAST 900, данные о котором можно получить с помощью инструмента "Распределение ставок в режиме реального времени".
Вероятная причина ошибки VAST 901
Это критическая ошибка. Она может быть связана с любым типом ошибок VPAID:
- Не размещен контейнер VPAID платформы продавца.
- Истекло время ожидания, заданное для контейнера VPAID платформы продавца.
- Для показа креативов VPAID потребовался небезопасный режим.
- Тег Авторизованных покупателей для адаптера IMA используется вместе с IMA SDK, и возвращается объявление VPAID (нужен тег, при создании которого был выбран вариант "Direct SDK").
Рекомендуемые действия
| Издатель | Убедитесь, что устройства и проигрыватели поддерживают креативы VPAID. Вы можете использовать профили видеокреативов, чтобы контролировать, какие объявления доступны для показа. |
| Покупатель | Убедитесь, что ответы VAST, которые возвращают контейнеры HTML5 VPAID из IAS/DV/MOAT, содержат объекты формата MP4 и что эти контейнеры не прерывают воспроизведение. Также убедитесь, что вы не назначаете ставки без соответствующего рекламодателя или покупателя и не инициируете перепродажу на стороне клиента. |
Вероятная причина ошибки VAST 1009
Ошибка VAST 1009 регистрируется, когда полученный ответ VAST не содержит видеофайлов или событий отслеживания. Как правило, эта ошибка происходит из-за особенностей настройки рекламного блока издателем или из-за неправильного размещения рекламы в заказе или позиции.
Рекомендуемые действия
| Издатель | Проверьте правильность начальной и конечной даты в заказе или позиции, а также корректность всех пар "ключ-значение", на которые настроен таргетинг. Убедитесь в том, что таргетинг настроен на правильные рекламные блоки и их размер совпадает с размером позиции. |
| Покупатель | Сообщите о проблеме издателю. |
Ошибки IMA SDK
Эти ошибки не являются частью спецификации VAST.
Вероятная причина ошибки IMA SDK 1005
Это критическая ошибка. Она возникает, когда не удалось закодировать или декодировать URL.
Рекомендуемые действия
| Издатель | Проследите, чтобы все специальные символы в строках URL были правильно закодированы. |
| Покупатель | Сообщите о проблеме издателю. |
