Обязательные параметры для приложений

Возможность реализации решений для видеорекламы на базе тегов для источников спроса Ad Exchange без использования IMA SDK находится на стадии бета-тестирования и может быть недоступна в вашей сети. За дополнительной информацией обращайтесь к менеджеру своего аккаунта.

Ниже представлен список параметров URL для тегов объявлений VAST. Эти параметры требуются используемым в приложениях решениям для видеорекламы на основе тегов, если они не интегрированы с IMA SDK.

Ознакомьтесь с обязательными параметрами для сайтов и рекомендуемыми параметрами для алгоритмических продаж.

 Ссылки на описания отдельных параметров

an correlator description_url env gdfp_req idtype

is_lat iu msid output pvid pvid_s

rdid sz unviewed_position_start url wta

 

Параметр	Подробная информация
correlator (Коррелятор)	Параметр "Коррелятор" принимает переменное значение, которое будет одинаковым для всех запросов, полученных в результате одного просмотра страницы. Этот параметр применяется для реализации конкурентного исключения, в том числе на платформах, которые не используют файлы cookie. Если используется IMA SDK, значение параметра задается автоматически. При этом IMA SDK переопределяет значение, установленное вашим проигрывателем. Если IMA SDK не используется, произвольное положительное целое значение этого параметра не должно повторяться для других просмотров страниц. Пример использования correlator=4345645667 Требования Требуется для сайтов и приложений. Рекомендуется для алгоритмических продаж
description_url (URL описания)	Параметр "URL описания" принимает переменное значение, позволяющее получить информацию о видеоролике, который воспроизводится на странице. Обычно это адрес страницы, на которой расположен проигрыватель, но допускается и адрес страницы с информацией о видео. Всегда нужно кодировать значение параметра description_url для видеопроигрывателей на веб-страницах, подключенных телевизоров/устройств OTT и не кодировать для рекламы в видеопроигрывателях в мобильных приложениях. IMA SDK не устанавливает этот параметр автоматически. Его требуется задавать вручную. Примеры использования Пример с кодированием в URL: description_url= https%3A%2F%2Fwww.sample.com%2Fgolf.html Пример без кодирования: description_url= https://www.sample.com/golf.html Требования Обязательно для сайтов, приложений и Ad Exchange Рекомендуется для алгоритмических продаж
env (Среда)	Параметр "Среда" принимает постоянное значение, которое указывает на запрос in-stream или запрос от проигрывателя. Допустимые значения: instream (подходит как для видео-, так и для аудиообъявлений) и vp (подходит только для видеообъявлений). Пример использования Видео- и/или аудиообъявления: env=instream Только видеообъявления: env=vp Требования Требуется для сайтов и приложений
gdfp_req (Индикатор набора атрибутов Менеджера рекламы)	Параметр "Индикатор набора атрибутов Менеджера рекламы" принимает постоянное значение, указывающее, что пользователь работает с Менеджером рекламы. Пример использования gdfp_req=1 Требования Требуется для сайтов и приложений
iu (Рекламный блок)	Параметр "Рекламный блок" принимает переменное значение, которое должно соответствовать текущему рекламному блоку в формате: /network_id/.../ad_unit Пример использования iu=/6062/videodemo Требования Требуется для сайтов и приложений
msid (Идентификатор приложения) an (Название приложения)	Параметры для названия и идентификатора приложения принимают переменные значения, которые нужно добавлять к запросам от мобильных приложений и подключенных телевизоров. Эти параметры являются обязательными почти для всех видеообъявлений, которые размещаются с помощью алгоритмических продаж. IMA SDK автоматически присваивает значения обоим этим параметрам, но на платформах, не поддерживающих SDK, такие значения нужно указывать вручную. Это относится к случаям, когда используются прямые VAST-вызовы, библиотека программного доступа или инвентарь с аутентификацией на стороне издателя. Название приложения должно быть удобочитаемым для человека. В случае с iOS и tvOS пакет SDK не может получить доступ к идентификатору приложения. При этом параметр msid не передается, а SDK отправляет набор App Bundle с помощью параметра an. Пример использования msid=com.package.publisher&an=sample%20app Идентификаторы приложений имеют разные варианты наименования и форматы. Ознакомьтесь с инструкциями от IAB по работе с данными, необходимыми для идентификации приложения, или примерами часто используемых уникальных идентификаторов. Если у платформы нет магазина приложений, IAB рекомендует издателям использовать идентификатор следующего формата: com.publisher.deviceplatform. Обязательный параметр или нет? Оба параметра являются обязательными для приложений Рекомендуется для алгоритмических продаж
output (Формат вывода объявления)	Параметр "Формат вывода объявления" принимает постоянное значение, которое должно соответствовать формату вывода объявления. Используйте output=vast для версии VAST, настроенной в вашей сети по умолчанию. Для определенных тегов объявлений и разделов сайта можно запросить специальные версии VAST или VMAP. Если вы работаете с VAST и в проигрывателе используется IMA SDK, у параметра output в запросе видеообъявления всегда будет значение xml_vast4. Это не вызовет проблем при обработке рекламы, так как в SDK обеспечена обратная совместимость со всеми версиями VAST, которые может использовать любой сторонний сервер объявлений. Используйте значение параметра output=vmap, чтобы выбрать версию VMAP, настроенную в вашей сети по умолчанию (например, VMAP 1). Если вы возвращаете ответ VAST внутри VMAP, то можете указать нужную версию VAST с помощью значений xml_vmap1_vast3 или xml_vmap1_vast4. Пример использования VAST вашей сети по умолчанию: output=vast VAST 4: output=xml_vast4 VMAP вашей сети по умолчанию: output=vmap VMAP 1: output=xml_vmap1 VMAP 1, возвращающий VAST 4: output=xml_vmap1_vast4 Требования Требуется для сайтов и приложений
pvid (Идентификатор набора приложений) pvid_s (Область действия набора приложений)	Значения идентификаторов наборов приложений применяются при размещении рекламы в случаях, когда пользователи отказались от персонализации рекламы на устройствах Android. Параметр pvid принимает переменное значение, относящееся к идентификатору набора приложений для Android, а параметр pvid_s – постоянное значение, которое представляет область действия идентификатора набора приложений (scope_app или scope_developer). IMA/PAL SDK передает значение этого поля автоматически, однако издатели, которые не работают с SDK, при получении запроса объявления должны вызывать SDK набора приложений и отправлять эти параметры вручную. Сведения о том, как найти идентификатор набора приложений, представлены в документации для разработчиков Android. Пример использования pvid=[AppSetID_value] pvid_s=scope_app Требования Требуется для приложений Рекомендуется для алгоритмических продаж
rdid idtype is_lat (Сбрасываемые идентификаторы устройств)	Сбрасываемые идентификаторы устройств принимают переменные значения. В приложениях (работающих не в мобильных или обычных браузерах) SDK передает сбрасываемые идентификаторы устройств для таргетинга в запросы вашего потока с помощью параметров rdid, idtype и is_lat. Для потоков с добавлением маяков на сервере эти параметры нужно передавать явным образом, как и в запросах объявлений на стороне клиента. Подробнее об идентификаторах устройств… Оба эти значения требуются почти для всех видеообъявлений, которые реализуются с помощью алгоритмических продаж. В iOS 14.5 и более поздних версий больше не поддерживается сигнал LAT. Вместо этого сигнала Google полагается на наличие идентификатора IDFA с ненулевым значением, указывающего на то, что пользователь дал согласие на отслеживание на тех версиях iOS, которые совместимы с фреймворком App Tracking Transparency. Поэтому вам потребуется действительное свойство UserAgent, указывающее подходящую версию ОС. Пример использования Ознакомьтесь с примерами сбрасываемых идентификаторов устройств. Требования Требуется для приложений Рекомендуется для алгоритмических продаж
sz (Размер)	Параметр "Размер" принимает переменное значение, которое должно соответствовать размеру рекламного места основного видео. Если размеров несколько, они должны быть разделены вертикальной чертой (|). Не добавляйте букву v после размера. Пример использования sz=400x300 Требования Требуется для сайтов и приложений Этот параметр необязателен, если запрашивается только ad_type=audio.
unviewed_position_start (Отложенные показы)	Параметр "Отложенные показы" принимает постоянное значение, указывающее на отложенные показы видео. Пример использования unviewed_position_start=1 Требования Требуется для сайтов и приложений
url (URL)	Параметр URL принимает переменное значение, которое должно соответствовать полному URL, с которого поступил запрос. Это значение позволяет покупателям определить источник запроса и понять его контекст. Мы рекомендуем указывать это значение динамически при отправке запроса объявления. При показе рекламы на сайтах таким значением является URL страницы, на которой размещен проигрыватель. Если вы используете IMA SDK, то значение URL задается автоматически. Если это значение устанавливается вашим проигрывателем, то IMA SDK не будет переопределять его. В случае с приложением для мобильных устройств или подключенных телевизоров (например, если пользователь смотрит в мобильном приложении видео, которое также доступно на сайте для компьютеров) в качестве такого значения необходимо указать точный URL, по которому размещен инвентарь для видео- или аудиорекламы*. Значение этого параметра должно быть закодировано. Пример использования url=https%3A%2F%2Fwww.videoad.com%2Fgolf.html *Если инвентарь находится в приложении, то не получится указать для этого параметра переменное значение, соответствующее URL. В этом случае мы рекомендуем использовать следующий синтаксис: url=https%3A%2F%2F<app/bundleid>.adsenseformobileapps.com Использование Требуется для сайтов и приложений. Рекомендуется для алгоритмических продаж
wta (Почему я вижу эту рекламу?)	Параметр "Почему я вижу эту рекламу?" принимает постоянное значение, которое определяет, поддерживается ли показ сообщения Почему я вижу эту рекламу? в этом видеопроигрывателе. При использовании IMA SDK показ этого сообщения поддерживается автоматически. Если вы не используете IMA SDK, то видеопроигрыватель должен поддерживать элементы Icon и IconClickFallbackImage в соответствии со стандартом IAB для шаблона VAST. Если значок "Выбор рекламы", указанный в ответе VAST, должен появляться в сопутствующих объявлениях или иным образом показываться пользователю, в запросах аудиообъявлений необходимо передавать параметр wta=1. Чтобы объявления от источников спроса Google или объявления с резервированием и размещением в Google могли показываться в ЕЭЗ, в запросах таких объявлений должен содержаться параметр wta=1. Он подтверждает, что значок "Выбор рекламы", указанный в ответе VAST, появляется в видеообъявлении, сопутствующих объявлениях или иным образом представлен во всех креативах, которые показываются пользователю. Пример использования Поддерживается: wta=1 Не поддерживается: wta=0 Требования Обязательное требование при размещении рекламы через Ad Exchange Обязательное требование для трафика сайтов и приложений при показе в ЕЭЗ Рекомендуется для алгоритмических продаж