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

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

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

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

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

an description_url hl idtype is_lat

msid plcmt pp rdid sid url

vpa vpmute vpos wta

 

Параметр	Подробная информация
hl (Язык)	Параметр "Язык" принимает постоянное значение, используемое для запроса рекламы на этом языке, а также для выбора языка объявлений и видеорекламы, которые показываются при динамическом размещении в видео для Ad Exchange и AdSense. Значением параметра может быть двухбуквенный код по стандарту ISO 639-1 или трехбуквенный код по стандарту ISO 639-2. Ознакомьтесь со списком допустимых кодов. Если этот параметр опущен, то используется языковой таргетинг в Ad Exchange. Пример использования hl=ru Требования Рекомендуется к использованию при работе с алгоритмическими продажами.
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 Рекомендуется для алгоритмических продаж
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. Обязательный параметр или нет? Оба параметра являются обязательными для приложений Рекомендуется для алгоритмических продаж
plcmt (Место размещения)	Параметр для места размещения принимает постоянное значение, которое указывает, объявлен ли инвентарь In-Stream в соответствии со спецификациями IAB и если да, то как (возможные варианты: In-Stream и сопутствующий). Для запросов рекламы вне проигрывателя это поле заполняется автоматически с учетом объявленного формата инвентаря. При этом вариант в поле переопределяет любые прежние значения, объявленные для контента с поддержкой In-Stream или сопутствующего контента. Пример использования Запрос In-Stream: plcmt=1 Запрос сопутствующего контента: plcmt=2 Использование Обязательно для сайтов и алгоритмических продаж.
pp (Профиль креатива)	Параметр "Профиль креатива" принимает переменное значение, которое определяет, какие видео- и аудиокреативы допущены к показу, на основе конфигурации, заданной в профиле креатива. Пример использования pp=creative_profile Требования Рекомендуется для алгоритмических продаж
rdid idtype is_lat (Сбрасываемые идентификаторы устройств)	Сбрасываемые идентификаторы устройств принимают переменные значения. В приложениях (работающих не в мобильных или обычных браузерах) SDK передает сбрасываемые идентификаторы устройств для таргетинга в запросы вашего потока с помощью параметров rdid, idtype и is_lat. Для потоков с добавлением маяков на сервере эти параметры нужно передавать явным образом, как и в запросах объявлений на стороне клиента. Подробнее об идентификаторах устройств… Оба эти значения требуются почти для всех видеообъявлений, которые реализуются с помощью алгоритмических продаж. В iOS 14.5 и более поздних версий больше не поддерживается сигнал LAT. Вместо этого сигнала Google полагается на наличие идентификатора IDFA с ненулевым значением, указывающего на то, что пользователь дал согласие на отслеживание на тех версиях iOS, которые совместимы с фреймворком App Tracking Transparency. Поэтому вам потребуется действительное свойство UserAgent, указывающее подходящую версию ОС. Пример использования Ознакомьтесь с примерами сбрасываемых идентификаторов устройств. Требования Требуется для приложений Рекомендуется для алгоритмических продаж
sid (Идентификатор сеанса)	Параметр "Идентификатор сеанса" принимает переменное значение, соответствующее рекламному идентификатору с защитой конфиденциальных данных, который используется только для ограничения частоты показа. Идентификатор сеанса поддерживается в запросах видеообъявлений In-Stream от подключенных телевизоров и на видеоинвентаре In-Stream в мобильных приложениях. На сайтах он сейчас не поддерживается. Согласно специальным требованиям организации IAB значение этого параметра должно быть в формате UUID. Подробнее о сбрасываемых идентификаторах устройств для таргетинга пользователей… Чтобы отключить передачу идентификатора сеанса, присвойте параметру sid нулевое значение. Пример использования 123e4567-e89b-12d3-a456-426614174000 Требования Рекомендуется для алгоритмических продаж
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 Использование Требуется для сайтов и приложений. Рекомендуется для алгоритмических продаж
vpa (Автоматическое воспроизведение видео)	Рекомендуется руководством MRC по работе с данными о видеорекламе Параметр, который относится к автоматическому воспроизведению видео, принимает постоянное значение. Оно указывает, будет ли рекламный ролик запускаться самостоятельно или только после нажатия на него. Возможные значения: click (если требуется действие пользователя) и auto (если видео воспроизводится автоматически). Если значение этого параметра неизвестно, задавать его не нужно. Пример использования Автовоспроизведение: vpa=auto Воспроизведение по клику: vpa=click Требования Рекомендуется для алгоритмических продаж
vpmute (Воспроизведение видео без звука)	Рекомендуется руководством MRC по работе с данными о видеорекламе Параметр "Воспроизведение без звука" принимает постоянное значение, которое определяет, будет ли воспроизводиться видеообъявление, если в проигрывателе отключен звук. Пример использования Звук отключен: vpmute=1 Звук включен: vpmute=0 Использование Обязательно для сайтов и алгоритмических продаж.
vpos (Позиция в видео)	Параметр "Позиция в видео" принимает постоянное значение, указывает, откуда направлен запрос объявления: из начала, из середины или из конца видеоролика. Пример использования В начале ролика: vpos=preroll В середине ролика: vpos=midroll В конце ролика: vpos=postroll Требования Рекомендуется для алгоритмических продаж
wta (Почему я вижу эту рекламу?)	Параметр "Почему я вижу эту рекламу?" принимает постоянное значение, которое определяет, поддерживается ли показ сообщения Почему я вижу эту рекламу? в этом видеопроигрывателе. При использовании IMA SDK показ этого сообщения поддерживается автоматически. Если вы не используете IMA SDK, то видеопроигрыватель должен поддерживать элементы Icon и IconClickFallbackImage в соответствии со стандартом IAB для шаблона VAST. Если значок "Выбор рекламы", указанный в ответе VAST, должен появляться в сопутствующих объявлениях или иным образом показываться пользователю, в запросах аудиообъявлений необходимо передавать параметр wta=1. Чтобы объявления от источников спроса Google или объявления с резервированием и размещением в Google могли показываться в ЕЭЗ, в запросах таких объявлений должен содержаться параметр wta=1. Он подтверждает, что значок "Выбор рекламы", указанный в ответе VAST, появляется в видеообъявлении, сопутствующих объявлениях или иным образом представлен во всех креативах, которые показываются пользователю. Пример использования Поддерживается: wta=1 Не поддерживается: wta=0 Требования Обязательное требование при размещении рекламы через Ad Exchange Обязательное требование для трафика сайтов и приложений при показе в ЕЭЗ Рекомендуется для алгоритмических продаж