Параметры URL тегов объявлений VAST

URL тега объявления VAST позволяет проигрывателю получать видео- и аудиообъявления. Его можно составить вручную или изменить существующий URL, используя указанные ниже параметры, а затем проверить с помощью этого инструмента. Вы также можете проверить реализацию тегов с помощью этих примеров.

Общие требования к URL

• Протокол. Теги объявлений VAST поддерживают протоколы http и https. URL отслеживания показов учитывают текущие настройки SSL, возвращая соответственно варианты с https или http. Для переходов по клику и отслеживания кликов используется протокол http, поскольку происходит переадресация с другой страницы.
• Домен. Использование динамических доменов, созданных с помощью одного из динамических методов, такого как макрос "Соответствие по шаблону", запрещено и может привести к ошибке.
• Трафик при трансляциях. URL тегов объявлений для потоковых видео в прямом эфире должны содержать строку /live, чтобы обеспечить обработку больших объемов трафика, когда все рекламные паузы передаются в одно и то же время.

Пример тега объявлений VAST

Обычно URL тега объявления VAST с параметрами и заданными значениями выглядит так:

https://securepubads.g.doubleclick.net/gampad/ads?env=vp&gdfp_req=1&output=vast&iu=/1234/video-demo&sz=400x300&unviewed_position_start=1&ciu_szs=728x90,300x250

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

aconp ad_rule ad_type addtl_consent afvsz allcues an ciu_szs correlator cmsid cust_params description_url dth env excl_cat gdfp_req gdpr gdpr_consent givn

hl iabexcl idtype ipd ipe is_lat iu lip ltd max_ad_duration min_ad_duration mridx msid nofb npa omid_p output paln plcmt

pmad pmnd pmxd pod pp ppt ppid ppos ppsj ptpl ptpln pubf pvid pvid_s pvtf rdid rdp schain scor

sdk_apis sdmax sid ssss sz tfcd trt unviewed_position_start url vad_type vconp vid vid_d vpa vpi vpmute vpos wta

Параметр	Подробная информация
aconp (Непрерывное воспроизведение аудио)	Рекомендуется в руководстве MRC по работе с данными об аудиорекламе. Параметр "Непрерывное воспроизведение аудио" принимает постоянное значение, которое указывает, будет ли аудиоконтент воспроизводиться непрерывно. Если значение этого параметра неизвестно, задавать его не нужно. Пример использования Непрерывное воспроизведение включено: aconp=2 Непрерывное воспроизведение выключено: aconp=1
ad_rule (Правило для объявлений)	Параметр, относящийся к правилам для объявлений, принимает постоянное значение, которое указывает, что нужно возвращать: креатив VAST или правило для объявлений. По умолчанию настройки правил для объявлений соответствуют параметрам сети Менеджера рекламы. Вы можете переопределить настройки некоторых тегов объявления, следуя примерам ниже. Пример использования Запрос креатива VAST: ad_rule=0 Запрос правил объявлений (VMAP): ad_rule=1 Требования Этот параметр является обязательным при работе с правилами для видеообъявлений.
ad_type (Тип объявления)	Параметры "Тип объявления" принимают постоянное значение, которое указывает, объявления каких типов должны быть возвращены по запросу. Этот параметр обязателен только для аудиообъявлений. Если для параметра ad_type установлено значение audio или audio_video, то у параметра vpmute должно быть значение 0. Примеры использования Допущены только аудиообъявления: ad_type=audio Допущены видеообъявления с возможностью пропуска и без нее: ad_type=video Допущены аудио- и видеообъявления: ad_type=audio_video Если указать это значение, то конкурировать за рекламное место смогут объявления обоих форматов, но размещено будет только одно из них. Тип объявления audio_video предназначен только для размещения видеокреативов в аудиоконтенте, совместимом с видеообъявлениями, или аудиокреативов в ориентированном на прослушивание контенте при воспроизведении в видеопроигрывателях с поддержкой рекламы In-Stream. Примеры подобного контента: трансляции спортивных состязаний, видеопередачи, выпуски новостей. Подробнее об аудиообъявлениях в видеоконтенте… Допущены только видеообъявления с возможностью пропуска: ad_type=skippablevideo Допущены только видеообъявления без возможности пропуска: ad_type=standardvideo Использование Требуется для аудиообъявлений
addtl_consent (Дополнительное согласие)	Параметр, относящийся к дополнительному согласию, принимает переменные значения. Он позволяет издателям обеспечить соответствие своего инвентаря спецификации IAB TCF версии 2.0 и указывать поставщиков рекламных технологий, которые ещё не добавлены в глобальный список поставщиков рекламных технологий от организации IAB Europe, однако входят в аналогичный список от Google. Значения параметра не добавляются автоматически в запросы VAST, но обрабатываются, если они есть в тегах объявления. Дополнительную информацию о том, какие значения принимает этот параметр, можно найти в технической спецификации Google для режима получения дополнительного согласия. Пример использования addtl_consent=1~1.35.41.101
afvsz (Размеры параллельных объявлений)	Параметр "Размеры параллельных объявлений" принимает постоянные значения, которые представляют собой разделенный запятыми список размеров параллельных объявлений, подходящих для показа в рекламном месте для видеообъявления. Это могут быть любые поддерживаемые размеры: 200x200 250x250 300x250 336x280 450x50 468x60 480x90 729x90 Если применяется IMA SDK, то вместо текущих значений в это поле будут внесены все поддерживаемые размеры в соответствии с параметрами nonLinearAdSlotWidth и nonLinearAdSlotHeight. Если нелинейные размеры не поддерживаются, этот параметр можно опустить или оставить пустым. Пример использования Если поддерживаются все размеры: afvsz=200x200,250x250,300x250,336x280, 450x50,468x60,480x90,728x90 Если максимальная ширина составляет 250: afvsz=200x200,250x250 Если максимальная высота составляет 60: afvsz=450x50,468x60 Если максимальная ширина составляет 100: нет поддерживаемых значений   Требования Рекомендуется к использованию при работе с нелинейными видеообъявлениями в случаях, когда не применяется IMA SDK.
allcues (Все временные точки)	Этот параметр поддерживает переменные значения, например список временных точек, разделенный запятыми, с шагом в миллисекунду. Для каждого значения Менеджер рекламы возвращает рекламную паузу. Параметры vid_d и allcues предназначены для показа объявлений в середине ролика без использования передачи контента. Правила для объявлений также должны возвращать видеорекламу для показа в середине ролика. Если в правилах для объявлений используются точки с временным условием (например: "Каждые N секунд" или "В определенные моменты" и т. д.), тогда будут игнорироваться временные точки, передаваемые с помощью параметра allcues. Для видеорекламы в середине ролика должна задаваться определенная длительность, поэтому параметр vid_d тоже будет использоваться. Пример использования Временные точки на 10 и 20 секундах: allcues=10000,20000
ciu_szs (Размеры сопутствующих объявлений)	Параметр "Размеры сопутствующих объявлений" принимает переменные значения, которые представляют собой список размеров, разделенных запятыми. Значения, разделенные вертикальной линией (|), указывают на рекламное место с несколькими размерами. Пример использования ciu_szs=728x90,300x250 Размеры сопутствующих объявлений для рекламного места с несколькими размерами: ciu_szs=728x90,300x200|300x250
cmsid (Идентификатор источника контента) vid (Идентификатор видео)	Параметры "Идентификатор источника контента" и "Идентификатор видео" принимают переменные значения.  Чтобы настроить таргетинг объявлений на видеоконтент, в теге главного объявления должны быть оба эти параметра. Параметр cmsid – это уникальное числовое значение, которое присваивается каждому источнику контента. Чтобы найти его в Менеджере рекламы, нажмите ВидеоИсточники контента, а затем выберите нужный вариант. Параметр vid – это строка или числовое значение, которые позволяют идентифицировать определенное видео. Этот параметр назначается системой управления вашим контентом. Чтобы найти его в Менеджере рекламы, нажмите ВидеоКонтент, а затем выберите нужное видео. Пример использования cmsid=[value]&vid=[value] Если вы создаете тег для динамического размещения объявлений с видео по запросу, необходимо использовать макрос, который будет динамически вставлять правильные идентификаторы источника контента и видео.  Пример: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%% Требования Требуется для таргетинга видеоконтента
correlator (Коррелятор)	Параметр "Коррелятор" принимает переменное значение, которое будет одинаковым для всех запросов, полученных в результате одного просмотра страницы. Этот параметр применяется для реализации конкурентного исключения, в том числе на платформах, которые не используют файлы cookie. Если используется IMA SDK, значение параметра задается автоматически. При этом IMA SDK переопределяет значение, установленное вашим проигрывателем. Если IMA SDK не используется, произвольное положительное целое значение этого параметра не должно повторяться для других просмотров страниц. Пример использования correlator=4345645667 Требования Требуется для сайтов и приложений. Рекомендуется для алгоритмических продаж
cust_params (Специальные пары "ключ-значение")	Параметр "Специальные параметры" принимает переменные значения в виде пар "ключ-значение", которые позволяют настраивать специальный таргетинг (например, на демографические данные, определенные места на веб-странице либо на конкретную страницу или группу страниц). Пример использования Ознакомьтесь с примерами реализации пар "ключ-значение".
description_url (URL описания)	Параметр "URL описания" принимает переменное значение, позволяющее получить информацию о видеоролике, который воспроизводится на странице. Добавьте на страницу от одного до трех абзацев с описанием контента. Например, можно динамически объединить контент страницы из предварительно заданных блоков для параметра description_url. Подробнее о том, как указать уникальный URL описания… Для значения параметра description_url всегда нужно использовать URL-кодирование, если он используется в видеопроигрывателях на веб-страницах, подключенных телевизорах и устройствах OTT. Для рекламы в видеопроигрывателях в мобильных приложениях URL-кодирование не используется. IMA SDK не устанавливает этот параметр автоматически. Его требуется задавать вручную. Примеры использования Пример с кодированием в URL: description_url= https%3A%2F%2Fwww.sample.com%2Fgolf.html Пример без кодирования: description_url= https://www.sample.com/golf.html Требования Обязательно для сайтов, приложений и Ad Exchange Рекомендуется для алгоритмических продаж
dth (Подсказка о типе устройства)	Параметр "Подсказка о типе устройства" принимает постоянное значение, которое помогает точнее распознавать устройства, в частности подключенные телевизоры и телеприставки. Некорректное распознавание устройств может быть обусловлено ошибками со стороны издателей или производителей подключенных телевизоров. Используя этот параметр одновременно с другими сигналами, Google может автоматически помечать ситуации, в которых необходимо повторно классифицировать инвентарь на подключенных телевизорах. Примеры использования Источники запросов: Кнопочный телефон: dth=1. Смартфон: dth=2. Компьютер: dth=3. Планшет: dth=4. Подключенный телевизор: dth=5. Игровая приставка: dth=6. Телеприставка: dth=7. Требования Рекомендуется для алгоритмических продаж при монетизации на подключенных телевизорах. Этот параметр рекомендуется для решений на основе библиотеки программного доступа (PAL) или инвентаря с аутентификацией на стороне издателя (PAI) и не требуется при работе с IMA SDK или DAI SDK.
env (Среда)	Параметр "Среда" принимает постоянное значение, которое указывает на запрос in-stream или запрос от проигрывателя. Допустимые значения: instream (подходит как для видео-, так и для аудиообъявлений) и vp (подходит только для видеообъявлений). Пример использования Видео- и/или аудиообъявления: env=instream Только видеообъявления: env=vp Требования Требуется для сайтов и приложений
excl_cat (Категория исключения)	Параметр "Категория исключения" принимает переменные значения и используется для блокировки всех позиций, которые содержат указанный ярлык для исключения, не допуская их показа по данному запросу объявлений. Параметр работает вместе с cust_params. Пример использования &cust_params=excl_cat%3Dairline_excl_label%7C
gdfp_req (Индикатор набора атрибутов Менеджера рекламы)	Параметр "Индикатор набора атрибутов Менеджера рекламы" принимает постоянное значение, указывающее, что пользователь работает с Менеджером рекламы. Пример использования gdfp_req=1 Требования Требуется для сайтов и приложений
gdpr (Регламент GDPR)	Параметр, относящийся к регламенту GDPR, принимает постоянные значения. Он позволяет издателям обеспечить соответствие своего инвентаря спецификации IAB TCF версии 2.0. Значения параметра не добавляются автоматически в запросы VAST, но обрабатываются, если они есть в тегах объявления. Допустимые значения для этого параметра: "0" и "1". Значение "0" говорит о том, что GDPR не применяется, а "1" – что применяется. Если GDPR применяется, вам необходимо предоставить действительную строку TC с помощью параметра gdpr_consent. Дополнительную информацию о том, какие значения принимает этот параметр, можно найти в общих рекомендациях по внедрению спецификации TCF от IAB версии 2.0 или в разделе этой спецификации, который относится к строке TC. Пример использования GDPR применяется: gdpr=1 GDPR не применяется: gdpr=0
gdpr_consent (Согласие по GDPR)	Параметр, относящийся к запросу согласия в соответствии с регламентом GDPR, принимает переменные значения. Он позволяет издателям обеспечить соответствие своего инвентаря спецификации IAB TCF версии 2.0. Значения параметра не добавляются автоматически в запросы VAST, но обрабатываются, если они есть в тегах объявления. Дополнительную информацию о том, какие значения принимает этот параметр, можно найти в общих рекомендациях по внедрению спецификации TCF от IAB версии 2.0 или в разделе этой спецификации, который относится к строке TC. Пример использования gdpr_consent=GDPR_CONSENT_123
givn paln (Однократно используемое значение для видео)	For integrations that use the Programmatic Access Library (PAL), the video nonce parameter accepts a variable string value. The nonce is URL safe—you don't need to URL-encode it. Note: If you previously provided a nonce using the legacy paln parameter, it is strongly recommended to migrate to the givn parameter and stop sending paln. Do not include both parameters. Usage example You can read more about the value passed to this parameter in the getting started guides for PAL.
hl (Язык)	Параметр "Язык" принимает постоянное значение, используемое для запроса рекламы на этом языке, а также для выбора языка объявлений и видеорекламы, которые показываются при динамическом размещении в видео для Ad Exchange и AdSense. Значением параметра может быть двухбуквенный код по стандарту ISO 639-1 или трехбуквенный код по стандарту ISO 639-2. Ознакомьтесь со списком допустимых кодов. Если этот параметр опущен, то используется языковой таргетинг в Ad Exchange. Пример использования hl=ru Требования Рекомендуется к использованию при работе с алгоритмическими продажами.
iabexcl (Параметр URL для исключений категорий IAB)	Параметр URL iabexcl поддерживает списки категорий с разделителями-запятыми. Пример использования При использовании параметра iabexcl=3,14,527 будет исключаться контент следующих категорий: "Коммерческий грузовой автотранспорт", "Внедорожные транспортные средства" и "Регби". Ознакомьтесь с классификацией контента IAB.
ipd (Домен партнера, который владеет инвентарем)	Параметр inventorypartnerdomain принимает значения переменных, заданных в декларациях inventorypartnerdomain в принадлежащих издателю файлах app-ads.txt или ads.txt. Параметр inventorypartnerdomain основан на спецификации IAB и помогает издателям указывать домен партнера по совместному использованию инвентаря, чтобы обеспечивать валидацию файлов ads.txt и app-ads.txt. При совместном использовании инвентаря особенно важна декларация IPD, так как рекламный инвентарь, из которого исходит запрос, может принадлежать другому партнеру (партнеру по совместному использованию инвентаря). Подробнее о файлах ads.txt и app-ads.txt и партнерах по совместному использованию инвентаря…
ipe (Запрос ping для показа)	Параметр для объекта проверки показов принимает постоянное значение, указывающее на проверки показов и конверсии, источниками которых является сервер, а не клиент. Пример использования Маяки на сервере: ipe=ssb
iu (Рекламный блок)	Параметр "Рекламный блок" принимает переменное значение, которое должно соответствовать текущему рекламному блоку в формате: /network_code/.../ad_unit Пример использования iu=/6062/videodemo Требования Требуется для сайтов и приложений
lip (Последняя позиция в пакете)	Параметр "Последняя позиция в пакете" принимает постоянное значение, которое указывает на запрос из последней позиции в пакете. Этот параметр предназначен только для стандартных пакетов. Пример использования lip=true
ltd (Ограниченный показ рекламы)	Параметр, относящийся к ограниченному показу рекламы, принимает постоянное значение. Оно определяет, будет ли показ объявлений выполняться с ограничениями в случаях, когда пользователи не дают согласие на использование файлов cookie и других локальных идентификаторов. В отличие от других параметров URL, при значении ltd=1 IMA SDK считает, что в запросе нет идентификатора, и не сохраняет его на устройстве. Пример использования ltd=1
min_ad_duration (Минимальная длительность объявления) max_ad_duration (Максимальная длительность объявления)	Параметры продолжительности объявления принимают переменные значения, которые определяют допустимый диапазон продолжительности в миллисекундах. Этот параметр позволяет ограничивать продолжительность определенного объявления по запросу как объявления, так и оптимизированного пакета. Пример использования min_ad_duration=15000&max_ad_duration=30000
mridx (Номер позиции видеообъявления в середине ролика)	Параметр "Номер позиции видеообъявления в середине ролика" принимает переменное значение, соответствующее порядковому номеру объявления в середине ролика (например, номер 1, номер 2 и т. д.). Пример использования mridx=2
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. Обязательный параметр или нет? Оба параметра являются обязательными для приложений Рекомендуется для алгоритмических продаж
nofb (Резервное объявление отключено)	Параметр "Резервное объявление отключено" принимает постоянное значение, указывающее, что запрос объявления не должен возвращать плейлист резервных видеообъявлений. Пример использования Резервное объявление отключено: nofb=1
npa (Неперсонализированная реклама)	Параметр "Неперсонализированная реклама" принимает постоянное значение, указывающее, что запрос объявления должен рассматриваться как неперсонализированный. Чтобы запросить неперсонализированное объявление, задайте параметр npa=1 или просто npa (без определенного значения). Если в запросе этот параметр отсутствует или задан как npa=0, по умолчанию будут запрашиваться персонализированные объявления. Пример использования Неперсонализированная реклама: npa=1
omid_p (Название партнера, использующего OMID API)	Параметр "Название партнера, использующего OMID API" принимает переменное значение, которое включает название и версию системы партнера, применяющего OMID для отслеживания. Этот параметр доступен только издателям, которые хотят при работе с Open Measurement SDK (OM SDK) использовать отслеживание Active View, и не подходит для случаев, в которых используется IMA SDK с автоматически заданными настройками. Чтобы сообщить о поддержке OMID при использовании библиотеки Programmatic Access Library (PAL), необходимо указать название партнера и версию его системы в используемых в API свойствах omidPartnerName и omidPartnerVersion. Если вы не используете библиотеку PAL или IMA, вам необходимо задать параметры omid_p и sdk_apis. Они обеспечивают информацию о поддерживаемых API, в число которых могут входить другие API, перечисленные через запятую. Пример использования При использовании библиотеки PAL: request.omidPartnerName = 'examplepartnername' request.omidPartnerVersion = '1.0.0.0' Без использования библиотеки PAL: omid_p=examplepartnername/1.0.0.0&sdk_apis=7
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 Требования Требуется для сайтов и приложений
plcmt (Место размещения)	Параметр для места размещения принимает постоянное значение, которое указывает, объявлен ли инвентарь In-Stream в соответствии со спецификациями IAB и если да, то как (возможные варианты: In-Stream и сопутствующий). Для запросов рекламы вне проигрывателя это поле заполняется автоматически с учетом объявленного формата инвентаря. При этом вариант в поле переопределяет любые прежние значения, объявленные для контента с поддержкой In-Stream или сопутствующего контента. Пример использования Запрос In-Stream: plcmt=1 Запрос сопутствующего контента: plcmt=2 Использование Обязательно для сайтов и алгоритмических продаж.
pmad (Максимальное количество объявлений в пакете)	Параметр "Максимальное количество объявлений в пакете" принимает переменное значение, которое определяет максимальное количество объявлений в пакете. Этот параметр относится исключительно к оптимизированным пакетам, которые доступны издателям с расширенными возможностями видеорекламы, и не подходит для VMAP (при ad_rule=1). Пример использования pmad=4
pmnd (Минимальная длительность пакета) pmxd (Максимальная длительность пакета)	Параметры продолжительности пакета принимают переменные значения, которые определяют допустимый диапазон продолжительности пакета в миллисекундах. Эти параметры используются для запроса сразу нескольких объявлений. Они относятся только к оптимизированным пакетам, которые доступны издателям с расширенными возможностями видеорекламы, и не подходят для VMAP (при ad_rule=1). Пример использования pmnd=0&pmxd=60000
pod (Номер пакета)	Параметр "Номер пакета" принимает переменное значение, которое соответствует порядковому номеру пакета в видео (например, пакет 1, пакет 2 и т. д.). Пример использования pod=3 Требования Требуется для правильной работы конкурентного исключения, ограничения частоты показов и связанных с ними функций
pp (Профиль креатива)	Параметр "Профиль креатива" принимает переменное значение, которое определяет, какие видео- и аудиокреативы допущены к показу, на основе конфигурации, заданной в профиле креатива. Пример использования pp=creative_profile Требования Рекомендуется для алгоритмических продаж
ppt (Вариант защиты конфиденциальности издателем)	Параметр "Вариант защиты конфиденциальности издателем" принимает постоянное значение, которое указывает, следует ли отключить персонализацию рекламы для определенного запроса объявления. Подробнее о Publisher Privacy Treatment API… Пример использования Параметр, позволяющий отключить персонализацию рекламы: ppt=1
ppid (Идентификатор, назначаемый издателем)	Параметр "Идентификатор, назначаемый издателем" (PPID) принимает переменное значение и используется для ограничения частоты показов, сегментирования аудитории, таргетинга, последовательной ротации объявлений и других средств управления рекламой на разных устройствах. Пример использования ppid=12JD92JD8078S8J29SDOAKC0EF230337
ppos (Позиция в пакете)	Параметр "Позиция в пакете" принимает переменное значение, соответствующее позиции в пакете (например, позиция 1, позиция 2 и т. д.). Этот параметр предназначен только для стандартных пакетов и требуется для автозаполнения сопутствующих объявлений. Пример использования ppos=2 Требования Требуется для правильной работы конкурентного исключения, ограничения частоты показов и связанных с ними функций
ppsj (Объект JSON сигналов, предоставленных издателем)	Параметр JSON из предоставленных издателем сигналов принимает объект JSON, закодированный по алгоритму Base64 и содержащий данные об аудитории и контекстные данные, который был предоставлен издателем для повышения дохода от алгоритмических сделок. Подробнее о сигналах, предоставленных издателем, и поддерживаемых таксономиях… Чтобы узнать больше о действительных парах "ключ-значение" JSON, можно посмотреть пример HTML5 IMA SDK. Пример использования Объект JSON: { "PublisherProvidedTaxonomySignals": [{ "taxonomy": "IAB_AUDIENCE_1_1", "values": ["6", "284"] }] } Значение, закодированное по алгоритму Base64: eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2lnbmFscyI6W3s idGF4b25vbXkiOiJJQUJfQVVESUVOQ0VfMV8xIiwidmFsdWVzIj pbIjEiLCIyODQiXX1dfQ
ptpl (Идентификатор шаблона рекламной паузы) ptpln (Название шаблона рекламной паузы)	Параметры идентификатора и названия шаблона рекламной паузы принимают переменные значения и указывают на то, какой из таких шаблонов будет назначаться запросу оптимизированного пакета. Шаблоны рекламной паузы позволяют настраивать набор рекламных вставок (в том числе специальных) и порядок их показа в рекламной паузе. Для запроса шаблона рекламной паузы необходим лишь один из двух указанных выше параметров (название или идентификатор). Пример использования Подробную информацию о том, как настраивать и запрашивать шаблоны рекламной паузы, можно найти в Справочном центре.
pubf (Общедоступные минимальные цены в тегах Ad Exchange) pvtf (Частные минимальные цены в тегах Ad Exchange)	Параметр pubf является эквивалентом для google_ad_public_floor, а pvtf – для google_ad_private_floor. Эти параметры позволяют добавлять минимальные цены в теги Ad Exchange. Пример использования pubf=123 pvtf=123
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, указывающее подходящую версию ОС. Пример использования Ознакомьтесь с примерами сбрасываемых идентификаторов устройств. Требования Требуется для приложений Рекомендуется для алгоритмических продаж
rdp (Ограничение обработки данных)	Параметр "Ограничение обработки данных" принимает постоянное значение, которое указывает, что запрос объявления должен ограничить обработку данных. При этом должен быть задан вариант rdp=1 или просто rdp (без значения). Если в запросе этот параметр не указан или задан как rdp=0, пользовательские данные будут обрабатываться без ограничений (за исключением случаев, когда такое ограничение задано в настройках сети). Пример использования rdp=1
schain (Цепь поставок)	Параметр, относящийся к цепочке поставок, принимает переменное значение – сериализованный объект SupplyChain. Если этот параметр присутствует, Google добавляет узел в каждый полученный объект schain, прежде чем отправлять его покупателю. В документации IAB описано, как передавать данные SupplyChain с помощью тега (а не OpenRTB). Каким требованиям должен соответствовать объект schain для его корректной обработки Как указано в документации IAB, сериализация объекта SupplyChain зависит от следующих условий: Свойства {SupplyChainObject}!{SupplyChainNode array}. SupplyChainObject и SupplyChainNode разделяются запятой. Эти необязательные поля можно опустить. Элементы SupplyChainNode отделяются восклицательным знаком (!). Если какие-либо символы в значениях свойств требуют кодирования (например, , или !), то их нужно закодировать перед сериализацией. Порядок сериализации Свойства SupplyChainObject сериализуются в таком порядке: ver,complete Свойства SupplyChainNode сериализуются в таком порядке: asi,sid,hp,rid,name,domain,ext Примечание. Содержимое свойства ext зависит от аукциона. Google Менеджер рекламы не обрабатывает это свойство. Примеры сериализации объекта SupplyChain Вот два примера сериализации указанного выше объекта SupplyChain: Сериализация с запятыми вместо пустых необязательных полей 1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,, Сериализация без запятых вместо пустых необязательных полей 1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1 Что такое объект SupplyChain Примеры использования schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,, Если у свойства asi было значение exchange,1, то результат сериализации с экранирующими символами будет таким: 1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1 Требования Параметр schain необходимо использовать издателям, которые собирают информацию о посредниках в цепочке платежей Google Менеджера рекламы. В частности, это издатели, использующие сторонние серверы объявлений.
scor (Коррелятор потоков)	Параметр "Коррелятор потоков" принимает переменное значение, которое должно быть целым числом, сгенерированным для каждого видеопотока. Оно не должно изменяться в рамках трансляции и должно быть уникальным во время просмотра страницы. Параметр используется для конкурентного исключения, ограничения частоты показов и связанных с ними функций, если пользователь смотрит несколько видео на одной странице. Пример использования scor=17 Требования Требуется для правильной работы конкурентного исключения, ограничения частоты показов и связанных с ними функций.
sdk_apis (Фреймворк SDK API)	Значением параметра фреймворка API SDK может быть разделенный запятыми список постоянных целых значений, указывающих на то, какие фреймворки API поддерживает проигрыватель. На сайте GitHub приведен список возможных значений. Параметр совместим с API из библиотеки Programmatic Access Library (PAL), если издатель не работает с IMA SDK. IMA SDK переопределяет любые значения, заданные при помощи значений, которые поддерживаются этим SDK. Пример использования sdk_apis=2,7,9
sdmax (Максимальная продолжительность видеообъявления с возможностью пропуска)	Параметр sdmax в запросе объявления принимает переменное значение, которое позволяет издателям задавать желаемую максимальную продолжительность объявлений с возможностью пропуска. Здесь указывается значение в миллисекундах, которым ограничена максимально возможная продолжительность видео или аудиокреативов с возможностью пропуска в рамках определенного запроса объявления. Параметр sdmax можно использовать как по отдельности для объявлений с возможностью пропуска, так и в сочетании с параметром max_ad_duration для указания разных значений продолжительности для объявлений с возможностью пропуска и без нее. Пример использования Значения параметров: max_ad_duration = 15000 (15 сек.); sdmax = 45000 (45 сек.). Креативы: Креатив А: без возможности пропуска; 30 сек.; Креатив Б: с возможностью пропуска; 30 сек. Результаты: Креатив А не будет допущен к показу, так как для него не предусмотрена возможность пропуска и его продолжительность превышает максимальное значение для рекламы этого типа. Креатив Б с возможностью пропуска будет допущен к показу. Его продолжительность превышает значение параметра max_ad_duration, но соответствует ограничению, заданному для рекламы с возможностью пропуска.
sid (Идентификатор сеанса)	Параметр "Идентификатор сеанса" принимает переменное значение, соответствующее рекламному идентификатору с защитой конфиденциальных данных, который используется только для ограничения частоты показа. Идентификатор сеанса поддерживается в запросах видеообъявлений In-Stream от подключенных телевизоров и на видеоинвентаре In-Stream в мобильных приложениях. На сайтах он сейчас не поддерживается. Согласно специальным требованиям организации IAB значение этого параметра должно быть в формате UUID. Подробнее о сбрасываемых идентификаторах устройств для таргетинга пользователей… Чтобы отключить передачу идентификатора сеанса, присвойте параметру sid нулевое значение. Пример использования 123e4567-e89b-12d3-a456-426614174000 Требования Рекомендуется для алгоритмических продаж
ssss (Источник совмещения на стороне сервера)	Параметр "Источник совмещения на стороне сервера" принимает постоянное значение. Оно должно соответствовать известному значению, которое компания Google предоставила вашему поставщику технологии совмещения видео. Подобные поставщики, применяющие межсерверную интеграцию, получают это значение от Google и могут сообщить его вам. По всем вопросам, связанным со значением этого параметра, обращайтесь к менеджеру вашего аккаунта Google. Пример использования ssss=mystitcher Требования Требуется для реализации на стороне сервера.
sz (Размер)	Параметр "Размер" принимает переменное значение, которое должно соответствовать размеру рекламного места основного видео. Если размеров несколько, они должны быть разделены вертикальной чертой (|). Не добавляйте букву v после размера. Пример использования sz=400x300 Требования Требуется для сайтов и приложений Этот параметр необязателен, если запрашивается только ad_type=audio.
tfcd (Тег ресурса для детей)	Параметр "Предназначенный для детей" принимает постоянное значение, которое маркирует запрос объявления как уместный для детей. Пример использования tfcd=1
trt (Тип трафика)	Параметр "Тип трафика" принимает постоянное значение. От него зависит тип трафика (оплачиваемый или бесплатный), возвращаемого в ответ на запрос. Если в запросе отсутствует этот параметр, IMA SDK не подставляет нужное значение. В этом случае сервер по умолчанию устанавливает значение 0 (неопределенный трафик). Пример использования Запрос оплачиваемого трафика: trt=1 Запрос бесплатного трафика: trt=2
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 Использование Требуется для сайтов и приложений. Рекомендуется для алгоритмических продаж
vad_type (Тип видеообъявления)	Параметр "Тип видеообъявления" принимает постоянное значение, которое указывает, какое объявление – линейное или параллельное – возвращается в ответе на запрос. Пример использования Линейное объявление: vad_type=linear Параллельное объявление: vad_type=nonlinear
vid_d (Длительность видео)	Этот параметр поддерживает переменные значения, которые соответствуют продолжительности контента, заданной в секундах. Параметры vid_d и allcues предназначены для показа объявлений в середине ролика без использования передачи контента. Правила для объявлений также должны возвращать видеорекламу для показа в середине ролика. Пример использования Длительность видеоконтента, равная 90 000 секунд (25 часов): vid_d=90000
vconp (Непрерывный просмотр видео)	Рекомендуется в руководстве MRC по работе с данными о видеорекламе. Параметр "Непрерывное видео" принимает постоянное значение, которое указывает, будет ли видеоконтент воспроизводиться непрерывно, подобно телевещанию. Если значение этого параметра неизвестно, задавать его не нужно. Пример использования Непрерывное воспроизведение включено: vconp=2 Непрерывное воспроизведение выключено: vconp=1
vpa (Автоматическое воспроизведение видео)	Рекомендуется руководством MRC по работе с данными о видеорекламе Параметр, который относится к автоматическому воспроизведению видео, принимает постоянное значение. Оно указывает, будет ли рекламный ролик запускаться самостоятельно или только после нажатия на него. Возможные значения: click (если требуется действие пользователя) и auto (если видео воспроизводится автоматически). Если значение этого параметра неизвестно, задавать его не нужно. Пример использования Автовоспроизведение: vpa=auto Воспроизведение по клику: vpa=click Требования Рекомендуется для алгоритмических продаж
vpi (Внутренняя переадресация плейлиста видео)	Параметр "Внутренняя переадресация плейлиста видео" принимает постоянное значение, которое указывает, нужно ли показывать встроенное объявление из плейлиста VMAP (возвращать тег VAST внутри VMAP). Это параметр можно использовать, чтобы исключить задержки при загрузке ресурсов и обеспечить ограничения частоты показов и конкурентные исключения в видеопотоке. Пример использования Возвращение тегов VAST: vpi=1 Возвращение тегов переадресации: vpi=0
vpmute (Воспроизведение видео без звука)	Рекомендуется руководством MRC по работе с данными о видеорекламе Параметр "Воспроизведение без звука" принимает постоянное значение, которое определяет, будет ли воспроизводиться видеообъявление, если в проигрывателе отключен звук. Пример использования Звук отключен: vpmute=1 Звук включен: vpmute=0 Использование Обязательно для сайтов и алгоритмических продаж.
vpos (Позиция в видео)	Параметр "Позиция в видео" принимает постоянное значение, указывает, откуда направлен запрос объявления: из начала, из середины или из конца видеоролика. Пример использования В начале ролика: vpos=preroll В середине ролика: vpos=midroll В конце ролика: vpos=postroll Требования Рекомендуется для алгоритмических продаж
wta (Почему я вижу эту рекламу?)	Параметр "Почему я вижу эту рекламу?" принимает постоянное значение, которое указывает на то, что в видеопроигрывателе поддерживается пометка рекламы. Если параметр &wta не передается, по умолчанию устанавливается значение &wta=1. При использовании IMA SDK пометка рекламы поддерживается автоматически. Если вы не используете IMA SDK, то в проигрывателе должна быть реализована поддержка Icon и IconClickFallbackImage для VAST в соответствии со стандартом IAB. Издателям, которые не показывают значок "Выбор рекламы", приведенный в ответе VAST, необходимо передавать параметр &wta=0. Если в запросе объявления есть параметр &wta=1 или вообще нет параметра &wta, это означает, что издатель обрабатывает предоставленную информацию о значке "Выбор рекламы". Если значок "Выбор рекламы", указанный в ответе VAST, может появляться в сопутствующих объявлениях или иным образом показываться пользователю, в запросах аудиообъявлений необходимо передавать параметр wta=1. В случае с трафиком из ЕЭЗ креативы для резервирования будут допущены к показу по запросам с параметром &wta=0, только если отключены пометки от Google. Объявление должно соответствовать действующим нормативным требованиям к объявлениям, которые показываются в Европейской экономической зоне (ЕЭЗ). В частности, в таких объявлениях пользователям должна предоставляться возможность пожаловаться на противозаконный контент. Издатели также должны сообщать Google о жалобах пользователей на противозаконный контент при помощи специальной формы. Пример использования Поддерживаются варианты: wta=1 или отсутствие параметра wta Не поддерживается: wta=0 Требования Обязательное требование при размещении рекламы через Ad Exchange Обязательное требование для трафика сайтов и приложений при показе в ЕЭЗ Рекомендуется для алгоритмических продаж