В этой статье приведен полный список параметров, которые могут использоваться в тегах объявлений VAST. Эта информация может оказаться полезной, если вам потребуются дополнительные сведения об отдельных параметрах.
Открыть индекс параметров, приведенных в алфавитном порядке, с возможностью перехода по кликуСодержание
- Обязательные параметры для показа объявлений
- Обязательные параметры для алгоритмических продаж
- Рекомендуемые параметры для алгоритмических продаж
- Другие параметры
Списки параметров по способу внедрения рекламы
Если вы используете определенный способ внедрения рекламы, то можете добавить списки специальных параметров, которые описывают особенности использования, и требования для этого способа внедрения. Составлять списки специальных параметров можно:
для сайта; для мобильных приложений; для подключенных телевизоров; для аудиообъявлений; для цифровой наружной рекламы.
Все параметры
Обязательные параметры для показа объявлений
Перечисленные ниже параметры необходимы для показа объявлений в рамках большинства типов внедрения. Однако в некоторых случаях те или иные параметры не являются обязательными. Ориентируйтесь на точный список параметров, систематизированный по типам внедрения.
correlator (коррелятор)
Описание
Параметр "Коррелятор" (correlator) принимает переменное значение, которое будет одинаковым для всех запросов, полученных в результате одного просмотра страницы. Этот параметр применяется для внедрения конкурентного исключения, в том числе на платформах, не поддерживающих файлы cookie.
Примеры использования
correlator=4345645667
Требования и рекомендации
Этот параметр обязателен при показе объявлений на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
Использование SDK
- Если используется IMA SDK, значение коррелятора задается автоматически. При этом IMA SDK переопределяет значение, установленное вашим проигрывателем.
- Если IMA SDK не используется, произвольное положительное целое значение этого параметра не должно повторяться для других просмотров страниц.
description_url (URL описания)
Описание
Параметр "URL описания" (description_url) принимает переменное значение, позволяющее получить информацию о видеоролике, который воспроизводится на странице.
URL описания должен указывать на видео, которое воспроизводится на определенной странице веб-приложения, мобильного приложения или ТВ-приложения. Он не должен являться доменом верхнего уровня для всех видео или всех запросов объявлений. Пример. Если на странице https://www.sample.com/golf.html показываются видео о футболе, укажите этот URL как значение параметра description_url.
Примеры использования
Для значения параметра description_url всегда нужно использовать кодировку URL, если он относится к веб-страницам с видеоконтентом, подключенным телевизорам и устройствам OTT. Параметр description_url не используется при показе рекламы в видеопроигрывателях в мобильных приложениях.
Пример с кодировкой:description_url=
https%3A%2F%2Fwww.sample.com%2Fgolf.html
Пример без кодировки:description_url=
https://www.sample.com/golf.html
Требования и рекомендации
Этот параметр требуется для показа объявлений на сайтах и в мобильных приложениях. Он также необходим, если для динамического размещения используется Ad Exchange или AdSense.
Этот параметр рекомендуется при алгоритмических продажах.
Использование SDK
IMA SDK не устанавливает этот параметр автоматически. Его требуется задавать вручную.
Подробнее о том, как задавать данный параметр для IMA SDK на вашей платформе, описано в руководстве по IMA SDK.
env (среда)
Описание
Параметр "Среда" (env) принимает постоянное значение, которое указывает на запрос in-stream или запрос от проигрывателя.
Допустимые значения: instream (подходит как для видео-, так и для аудиообъявлений) и vp (подходит только для видеообъявлений).
Примеры использования
Видео- и/или аудиообъявления:env=instream
Только видеообъявления:env=vp
Требования и рекомендации
Этот параметр обязателен при показе объявлений на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
Этот параметр необходим для создания точных отчетов по типам запросов с разбивкой данных по категории "Тег видео".
gdfp_req (индикатор набора атрибутов)
Описание
Параметр "Индикатор атрибутов Google Менеджера рекламы" (gdfp_req) принимает постоянное значение, которое указывает, что запрос объявления предназначен для инвентаря Google Менеджера рекламы.
Примеры использования
gdfp_req=1
Требования и рекомендации
Этот параметр обязателен при показе объявлений на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
iu (рекламный блок)
Описание
Параметр "Рекламный блок" (iu) принимает переменное значение, которое должно соответствовать текущему рекламному блоку в формате /network_code/.../ad_unit.
Примеры использования
iu=/6062/videodemo
Требования и рекомендации
Этот параметр обязателен при показе объявлений на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
output (вывод)
Описание
Параметр "Формат вывода" (output) принимает постоянное значение, которое должно быть связано с тем, в каком формате выводится объявление.
Примеры использования
Используется версия VAST сети по умолчанию:
output=vast
Используется VAST 4 (можно задать определенные версии для тех или иных тегов):
output=xml_vast4
Используется настройка VMAP, по умолчанию заданная в сети:
output=vmap
Используется VMAP 1:
output=xml_vmap1
Используется VMAP 1, возвращается VAST 4 (если вы возвращаете VAST внутри VMAP):
output=xml_vmap1_vast4
Требования и рекомендации
Этот параметр обязателен при показе объявлений на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы. Он нужен для того, чтобы на запрос объявления возвращался корректный ответ.
Использование SDK
Если вы работаете с VAST и в проигрывателе используется IMA SDK, у параметра output в запросе видеообъявления всегда будет значение output=xml_vast4. Это не ведет к проблемам с надежностью, так как в IMA SDK обеспечена совместимость со всеми версиями VAST, которые может использовать любой сторонний сервер объявлений.
sz (размер)
Описание
Параметр "Размер" (sz) принимает переменное значение, которое должно соответствовать размеру рекламного места основного видео.
Если размеров несколько, они должны быть разделены вертикальной чертой (|).
Не добавляйте букву v после размера.
Примеры использования
Один размер: sz=400x300.
Несколько размеров: sz=300x250|400x300.
Требования и рекомендации
Этот параметр является обязательным при показе объявлений на сайтах, в мобильных приложениях, на подключенных телевизорах и инвентаре для цифровой наружной рекламы.
Этот параметр необязателен, только если в запросе указывается значение ad_type=audio.
unviewed_position_start (отложенные показы)
Описание
Параметр "Отложенные показы" (unviewed_position_start) принимает постоянное значение, которое сообщает о возможности отложенных показов видео.
Примеры использования
unviewed_position_start=1
Требования и рекомендации
Этот параметр является обязательным при размещении объявлений на сайтах и в мобильных приложениях, если возможны отложенные показы.
url (URL)
Описание
Параметр "URL" (url) принимает переменное значение, соответствующее полному URL, с которого поступил запрос. Это значение позволяет покупателям определить источник запроса и узнать, при каких обстоятельствах он был выполнен. Мы рекомендуем указывать это значение динамически при отправке запроса объявления.
- При показе на сайтах значением этого параметра является URL страницы с видеопроигрывателем.
- При показе на других платформах значением должен быть URL, который наиболее точно соответствует видео- или аудиоинвентарю, на котором размещается реклама. Примером может быть ситуация, когда пользователь смотрит видеоролик в мобильном приложении, который также доступен по URL на сайте*.
Примечание. Параметр url отличается от description_url тем, что url указывает, откуда поступил запрос объявления, а description_url является адресом веб-страницы, которая содержит описание видеоконтента и может быть просканирована поисковыми роботами.
Значение этого параметра должно быть закодировано.
Примеры использования
url=https%3A%2F%2Fwww.example.com%2Fvideo.html
* Если показ выполняется в приложении и для этого параметра невозможно задать переменное значение URL, мы рекомендуем использовать такой шаблон: url=https%3A%2F%2F<app/bundleid>.example.com
Требования и рекомендации
Этот параметр обязателен при показе объявлений на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
Использование SDK
Если вы используете IMA SDK, значение URL задается автоматически. Если это значение устанавливается вашим проигрывателем, то IMA SDK не будет переопределять его.
vpmute (воспроизведение без звука)
Описание
Параметр "Воспроизведение видео без звука" (vpmute) принимает постоянное значение, которое указывает, начинается ли воспроизведение объявления, если в видеопроигрывателе выключен звук. Этот параметр не влияет на статус видеопроигрывателя, и управление воспроизведением осуществляется в самом проигрывателе.
Примеры использования
Воспроизведение начинается при отключенном звуке:vpmute=1
Воспроизведение начинается при включенном звуке:vpmute=0
Требования и рекомендации
Этот параметр является обязательным при размещении в рамках алгоритмических продаж на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконенте и на инвентаре для цифровой наружной рекламы.
Использование этого параметра рекомендовано руководствами по работе с данными о видеорекламе, подготовленными Советом по медиаизмерениям.
Обязательные параметры для алгоритмических продаж
ott_placement (пользовательские форматы)
Описание
Параметр места размещения OTT (ott_placement) принимает постоянное значение, которое указывает, что объявление запрашивается по технологии ОТТ для места размещения вне проигрывателя.
В примерах ниже используются места размещения следующих форматов:
- Пауза. Объявление Out-Stream, которое показывается как оверлей поверх видеоконтента, когда пользователь приостанавливает воспроизведение.
- Главный экран. Объявление, которое появляется на главном экране подключенного телевизора или приложения с технологией OTT. Может показываться как masthead, баннер или плитка.
- Картинка в картинке. Видеообъявление In-Stream, которое показывается в отдельном видеопроигрывателе рядом с основным контентом. Обычно для него требуется сжатие видеоконтента и загрузка второго видеопроигрывателя.
- L-баннер. Медийное объявление In-Stream, при показе которого основное видео сжимается, а объявление окружает его. Например, оно часто показывается в окне в форме буквы L.
- Оверлей. Любой формат объявления In-Stream, который показывается поверх видеоконтента, но не занимает весь экран. Это может быть медийное или видеообъявление.
Примеры использования
Поддерживаемые форматы и соответствующие значения:
Пауза:ott_placement=1
Главный экран:ott_placement=2
Картинка в картинке:ott_placement=3
L-баннер:ott_placement=4
Оверлей:ott_placement=5
Специальный или другой формат:ott_placement=99
Требования и рекомендации
Этот параметр требуется только при размещении в рамках алгоритмических продаж на сайтах, в мобильных приложениях и на подключенных телевизорах у издателей, которые монетизируют нестандартные места размещения объявлений при потоковой передаче по технологии OTT.
plcmt (размещение объявлений)
Описание
Параметр "Место размещения" (plcmt) принимает постоянное значение, которое указывает, объявляется ли видеореклама In-Stream как "Instream" или как "Accompanying (Сопутствующее объявление)" в соответствии со спецификациями IAB.
В запросах, не относящихся к видеорекламе In-Stream, значение параметра автоматически указывается для покупателей на основании заявленного формата инвентаря, который переопределяет любое объявление, объявленное как "Instream" или "Accompanying".
Примеры использования
Запрос In-Stream:plcmt=1
Запрос сопутствующего контента:plcmt=2
Требования и рекомендации
Этот параметр является обязательным при размещении в рамках алгоритмических продаж на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконенте и на инвентаре для цифровой наружной рекламы.
venuetype (тип места)
Описание
Параметр "Тип места" (venuetype) используется для указания типа места размещения наружной рекламы. Подходящие значения – идентификаторы с целочисленной нумерацией, поддерживаемые классификацией типов мест размещения IAB OpenOOH 1.1.
Примеры использования
Номера отелей:venuetype=80703
Планшеты на задних сиденьях такси:venuetype=103
Требования и рекомендации
Этот параметр является обязательным для алгоритмических продаж при работе с цифровой наружной рекламой.
vpa (автоматическое воспроизведение)
Описание
Параметр, который относится к автоматическому воспроизведению видео (vpa), принимает постоянное значение. Оно указывает, запускается ли рекламный ролик самостоятельно или только после нажатия на него.
Допустимые значения: click (если требуется действие пользователя) и auto (если видео воспроизводится автоматически). Этот параметр не влияет на статус видеопроигрывателя, и управление воспроизведением осуществляется в самом проигрывателе.
Примеры использования
Автовоспроизведение:vpa=auto
Воспроизведение по клику:vpa=click
Если значение этого параметра неизвестно, задавать его не нужно.
Требования и рекомендации
Этот параметр является обязательным при показе рекламы в рамках алгоритмических продаж на сайтах, в мобильных приложениях, на подключенных телевизорах и в аудиоконтенте.
Использование этого параметра рекомендовано руководствами по работе с данными о видеорекламе, подготовленными Советом по медиаизмерениям.
Рекомендуемые параметры для алгоритмических продаж
aconp (непрерывное воспроизведение аудио)
Описание
Параметр "Непрерывное воспроизведение аудио" (aconp) принимает постоянное значение, которое указывает, будет ли аудиоконтент воспроизводиться непрерывно. В Google Менеджер рекламы этот параметр позволяет подбирать самые удобные объявления.
Примеры использования
Непрерывное воспроизведение включено:
aconp=2
Непрерывное воспроизведение выключено:
aconp=1
Если вам неизвестно, непрерывно ли воспроизводится объявление, задайте для данного параметра значение aconp=0 или совсем не указывайте его.
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при алгоритмических продажах на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
Использование этого параметра рекомендовано руководствами по работе с данными об аудиорекламе, подготовленными Советом по медиаизмерениям.
an (название приложения)
Описание
Параметры "Идентификатор приложения" (msid) и "Название приложения" (an) принимают переменные значения, которые нужно указывать в запросах, отправляемых из мобильных приложений и с подключенных телевизоров, поскольку это требуется при размещении большинства видеообъявлений с алгоритмической продажей.
Название приложения должно быть удобочитаемым для человека. В случае с iOS и tvOS пакет SDK не может получить доступ к идентификатору приложения. При этом параметр msid не передается, а SDK отправляет набор App Bundle с помощью параметра an.
Примеры использования
msid=com.package.publisher&an=sample%20app
Идентификаторы приложений имеют разные варианты наименования и форматы. Ознакомьтесь с инструкциями от IAB по работе с данными, необходимыми для идентификации приложения, или примерами часто используемых уникальных идентификаторов.
Если у платформы нет магазина приложений, IAB рекомендует издателям использовать идентификатор следующего формата: com.publisher.deviceplatform.
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при алгоритмических продажах в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
Для безопасности бренда и обеспечения большей прозрачности для покупателей настоятельно рекомендуем включать информацию о приложении.
Использование SDK
IMA SDK автоматически присваивает значения обоим этим параметрам, но на платформах, не поддерживающих SDK, такие значения нужно указывать вручную. Это относится к случаям, когда используются прямые VAST-вызовы, библиотека программного доступа или инвентарь с аутентификацией на стороне издателя.
Примечание. Если используется HTML5 IMA SDK, информация о приложении не используется.
dth (подсказка о типе устройства)
Описание
Параметр "Подсказка о типе устройства" (dth) принимает постоянное значение, которое помогает точнее распознавать устройства, в частности подключенные телевизоры и телеприставки.
Некорректное распознавание устройств может быть обусловлено ошибками со стороны издателей или производителей подключенных телевизоров. Используя этот параметр одновременно с другими сигналами, Google может автоматически помечать ситуации, в которых необходимо повторно классифицировать инвентарь на подключенных телевизорах.
Примеры использования
Источники запросов:
- Кнопочный телефон:
dth=1. - Смартфон:
dth=2. - Компьютер:
dth=3. - Планшет:
dth=4. - Подключенный телевизор:
dth=5. - Игровая приставка:
dth=6. - Телеприставка:
dth=7.
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при алгоритмических продажах на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
Использование SDK
Этот параметр рекомендуется для решений на основе библиотеки программного доступа (PAL) или инвентаря с аутентификацией на стороне издателя (PAI) и не требуется при работе с IMA SDK или DAI SDK.
givn (однократное воспроизведение видео)
Описание
Если вы работаете с библиотекой Programmatic Access Library (PAL), то параметр с однократно используемым числом для видеообъявления принимает переменное строковое значение.
Однократно используемое число не требует кодирования при добавлении в URL.
Примечание. Если ранее вы добавляли однократно используемое число, используя устаревший параметр paln, то мы рекомендуем отказаться от него и перейти на параметр givn. Также не следует добавлять оба этих параметра.
Примеры использования
Более подробную информацию о том, какое значение передается при использовании этого параметра, можно найти в руководстве по началу работы с библиотекой PAL.
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при алгоритмических продажах на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
hl (язык)
Описание
Параметр "Язык" (hl) принимает постоянное значение, используемое для запроса рекламы на этом языке, а также для выбора языка, который используется при выборе и отрисовке объявлений при динамическом размещении видеорекламы с помощью Ad Exchange и AdSense.
Примеры использования
Запрос объявлений на итальянском языке:
hl=it
Значением параметра может быть двухбуквенный код по стандарту ISO 639-1 или трехбуквенный код по стандарту ISO 639-2. Ознакомьтесь со списком допустимых кодов.
Если этот параметр не указан, то используется языковой таргетинг в Ad Exchange.
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при алгоритмических продажах на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
msid (идентификатор приложения)
Описание
Параметры "Идентификатор приложения" (msid) и "Название приложения" (an) принимают переменные значения, которые нужно указывать в запросах, отправляемых из мобильных приложений и с подключенных телевизоров, поскольку это требуется при размещении большинства видеообъявлений с алгоритмической продажей.
Название приложения должно быть удобочитаемым для человека. В случае с iOS и tvOS пакет SDK не может получить доступ к идентификатору приложения. При этом параметр msid не передается, а SDK отправляет набор App Bundle с помощью параметра an.
Примеры использования
msid=com.package.publisher&an=sample%20app
Идентификаторы приложений имеют разные варианты наименования и форматы. Ознакомьтесь с инструкциями от IAB по работе с данными, необходимыми для идентификации приложения, или примерами часто используемых уникальных идентификаторов.
Если у платформы нет магазина приложений, IAB рекомендует издателям использовать идентификатор следующего формата: com.publisher.deviceplatform.
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при алгоритмических продажах в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
Для безопасности бренда и обеспечения большей прозрачности для покупателей настоятельно рекомендуем включать информацию о приложении.
Использование SDK
IMA SDK автоматически присваивает значения обоим этим параметрам, но на платформах, не поддерживающих SDK, такие значения нужно указывать вручную. Это относится к случаям, когда используются прямые VAST-вызовы, библиотека программного доступа или инвентарь с аутентификацией на стороне издателя.
Примечание. Если используется HTML5 IMA SDK, информация о приложении не используется.
omid_p (партнер OMID)
Описание
Параметр "Название партнера, использующего OMID API" (omid_p) принимает переменное значение, которое включает название организации-партнера, применяющей OMID для отслеживания, и версию ее системы.
Параметр "Поддерживаемые SDK API" (sdk_apis) принимает переменное значение: либо название одного поддерживаемого API, либо их список, разделенный запятыми.
Эти параметры – части набора параметров, которые обеспечивают видимость и проверку объявлений.
Примеры использования
Без использования библиотеки PAL:omid_p=examplepartnername/1.0.0.0&sdk_apis=7
Список возможных значений приведен на сайте GitHub.
При использовании библиотеки PAL:request.omidPartnerName = 'examplepartnername'
request.omidPartnerVersion = '1.0.0.0'
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при алгоритмических продажах на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
Использование SDK
- Этот параметр доступен только издателям, которые хотят при работе с Open Measurement SDK (OM SDK) использовать отслеживание Active View.
- Чтобы при использовании библиотеки Programmatic Access Library (PAL) сообщить о поддержке OMID, необходимо указать название организации-партнера (
omidPartnerName) и версию ее системы (omidPartnerVersion). Если вы не используете PAL или IMA SDK, вам потребуется задать параметрыomid_pиsdk_apis. - Они не нужны, если вы используете IMA SDK, поскольку в этом случае они задаются автоматически.
rdid (сбрасываемый идентификатор устройства)
Описание
Параметры сбрасываемого идентификатора устройства (rdid, idtype, is_lat) принимают переменное значение. Это значение также известно как рекламный идентификатор (IFA).
В мобильных приложениях, в которых используется IMA SDK для Android или iOS, IMA SDK передает сбрасываемый идентификатор устройства в ваши запросы на трансляцию с параметрами rdid, idtype и is_lat для таргетинга на пользователей.
Если IMA SDK не применяется или используется веб-маяк на сервере (SSB), эти параметры необходимо передавать как явные. Подробнее об идентификаторах устройств…
Оба эти значения требуются почти для всех видеообъявлений, которые размещаются в рамках алгоритмических продаж.
|
В iOS 14.5 и более поздних версий больше не поддерживается сигнал |
Примеры использования
Ознакомьтесь с примерами сбрасываемых идентификаторов устройств.
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, он необходим при размещении объявлений в рамках алгоритмических продаж в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
При показе на сайтах сбрасываемые идентификаторы устройства не используются.
Использование SDK
IMA SDK передает это поле автоматически, но при использовании PAL SDK издатели передают эти параметры вручную.
sid (идентификатор сеанса)
Описание
Параметр "Идентификатор сеанса" (sid) принимает переменное значение, соответствующее рекламному идентификатору, который используется только для ограничения частоты показа и не нарушает конфиденциальность.
Идентификатор сеанса поддерживается в запросах видеообъявлений In-Stream от подключенных телевизоров и от видеоинвентаря In-Stream в мобильных приложениях. На сайтах он в настоящее время не поддерживается.
Чтобы отключить передачу идентификатора сеанса, присвойте параметру sid нулевое значение.
Примеры использования
sid=123e4567-e89b-12d3-a456-426614174000
Согласно специальным требованиям организации IAB, значение этого параметра должно быть указано в формате UUID. Подробнее о сбрасываемых идентификаторах устройств для таргетинга на пользователей…
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-то способа внедрения рекламы, он необходим при размещении объявлений в рамках алгоритмических продаж на инвентаре для цифровой наружной рекламы.
Этот параметр рекомендуется при размещении в рамках алгоритмических продаж в мобильных приложениях, на подключенных телевизорах и в аудиоконтенте.
Использование SDK
IMA SDK отправляет этот параметр автоматически.
vconp (непрерывное воспроизведение видео)
Описание
Параметр "Непрерывный просмотр видео" (vconp) принимает постоянное значение, которое указывает, будет ли проигрыватель воспроизводить видео непрерывно, как при вещании по телевизору.
Примеры использования
Непрерывное воспроизведение включено:vconp=2
Непрерывное воспроизведение выключено:vconp=1
Если значение этого параметра неизвестно, задавать его не нужно.
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при размещении объявлений в рамках алгоритмических продаж на сайтах, в мобильных приложениях, на подключенных телевизорах и в аудиоконтенте.
Использование этого параметра рекомендовано руководствами по работе с данными о видеорекламе, подготовленными Советом по медиаизмерениям.
vid_d (продолжительность видео)
Описание
Параметр "Длительность видео" (vid_d) принимает переменное значение, которое указывает на длительность контента в секундах.
- Параметры
vid_dиallcuesпредназначены для показа объявлений в середине ролика без использования передачи контента. - Правила для объявлений обязательны, если вы намерены показывать рекламу в середине видео. Если в правилах для объявлений используются точки с временным условием (например: "Каждые N секунд" или "В определенные моменты" и т. д.), то будут игнорироваться временные точки, передаваемые с помощью параметра
allcues. Для видеорекламы в середине ролика должна задаваться определенная длительность, поэтому параметрvid_dтоже будет использоваться.
Примеры использования
Длительность видеоконтента, равная 90 000 секунд (25 часов):vid_d=90000
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при размещении объявлений в рамках алгоритмических продаж на сайтах, в мобильных приложениях и на подключенных телевизорах.
vpos (фрагменты видео)
Описание
Параметр "Позиция видео" (vpos) принимает постоянное значение, которое указывает, где должно быть размещено объявление: в начале, в середине или в конце видеоролика.
Примеры использования
Размещение в начале ролика:vpos=preroll
Размещение в середине ролика:vpos=midroll
Размещение в конце ролика:vpos=postroll
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при размещении объявлений в рамках алгоритмических продаж на сайтах, в мобильных приложениях, на подключенных телевизорах и в аудиоконтенте.
Если используются правила для объявлений, этот параметр не требуется, поскольку он добавляется сервером объявлений автоматически.
wta (почему пользователь видит эту рекламу)
Описание
Параметр "Почему я вижу эту рекламу?" (wta) принимает постоянное значение, которое указывает на то, что в видеопроигрывателе поддерживается пометка рекламы.
Примеры использования
Если проигрыватель должен отображать значок "Выбор рекламы" из ответа VAST, используйте следующее значение:
wta=1(также можно опустить параметрwtaили передаватьwtaбез значения).Если значок "Выбор рекламы" из ответа VAST будет добавлен в сопутствующее объявление или показан пользователю иным образом, в запросе аудиорекламы должен быть задан параметр
wta=1.
Если значок "Выбор рекламы" из ответа VAST не должен показываться в проигрывателе, используйте следующее значение:
wta=0
Требования и рекомендации
Хотя ни один из вариантов реализации и не требует задавать этот параметр, его рекомендуется использовать при алгоритмических продажах на сайтах, в мобильных приложениях, на подключенных телевизорах и аудиоинвентаре.
Если этот параметр используется, происходит следующее:
- При значении
&wta=0нельзя использовать некоторые типы персонализации для трафика из источников спроса Google. - При значении
&wta=0нельзя показывать креативы с включенными пометками рекламы, если трафик происходит из ЕЭЗ, а реклама размещается в рамках резервирования или гарантированных кампаний с алгоритмической продажей, управляемых издателем.
Объявления, которые показываются в Европейской экономической зоне (ЕЭЗ), должны соответствовать действующим нормативным требованиям. В частности, пользователям должна предоставляться возможность пожаловаться на противозаконный контент. Издатели обязаны уведомлять Google о любом противозаконном контенте, используя форму Сообщить о контенте в Google.
Использование SDK
При использовании IMA SDK пометка рекламы поддерживается автоматически. Если вы не работаете с IMA SDK, то в проигрывателе должна быть реализована поддержка объектов VASTIcon и IconClickFallbackImage в соответствии со стандартом IAB.Другие параметры
Приведенные ниже параметры не являются строго обязательными при показе рекламы, но могут потребоваться для отдельных функций или типов внедрения рекламы.
ad_rule (правило для объявлений)
Описание
Параметр "Правило для объявлений" (ad_rule) принимает постоянное значение, которое указывает, что нужно возвращать: креатив VAST или правило для объявлений.
По умолчанию настройки правил для объявлений соответствуют параметрам сети Google Менеджера рекламы, поэтому все запросы могут быть запросами правил для объявления. Если используются настройки размещения, то для тега объявлений не нужно задавать параметр ad_rule. Чтобы эти настройки не применялись к запросам объявления, то переопределите настройки, задав значение параметра ad_rule=0. Если правила для объявлений не заданы по умолчанию, вы можете включить или отключить их, задав значения параметра ad_rule=1 и ad_rule=0 соответственно.
Примеры использования
Если настройка правил для объявления отключена:
- Запрос креатива VAST:
ad_rule=0или параметр отсутствует
Если настройка правил для объявления включена:
- Запрос креатива VAST:
ad_rule=0 - Запрос правил объявлений (VMAP):
ad_rule=1или параметр отсутствует
Если вы не хотите использовать правила для объявлений, то можете добавить параметры тегов объявлений и указать рекламные паузы и продолжительность пакета объявлений для тегов VAST с помощью параметров pmnd, pmxd и pmad.
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, он необходим для корректной работы правил для видеообъявлений.
addtl_consent (дополнительное согласие)
Описание
Параметр "Дополнительное согласие" (addtl_consent) принимает переменные значения. Он позволяет издателям обеспечить соответствие своего инвентаря спецификации IAB TCF версии 2.0 и указывать поставщиков рекламных технологий, которые ещё не добавлены в глобальный список поставщиков рекламных технологий от организации IAB Europe, однако входят в аналогичный список от Google.
Дополнительную информацию о том, какие значения принимает этот параметр, можно найти в технической спецификации Google для режима получения дополнительного согласия.
Пример использования
addtl_consent=1~1.35.41.101
adtest (проверка объявления)
Описание
При помощи параметра adtest (adtest) вы можете указать, что запросы, которые используются при тестировании негарантированного инвентаря для заполнения, не должны считаться недействительным трафиком и не влияют на доход.
Если в рамках тестирования установить для этого параметра значение on, то статистика по показам рекламы и кликам вестись не будет. Чтобы счета выставлялись в обычном режиме, когда тестирование не проводится, установите значение off. Это же значение задается по умолчанию, если поле не заполнено.
Примечание. При тестировании позиций с прямой продажей необходимо использовать не параметр adtest, а тестовые позиции, которые не влияют на доход.
Примеры использования
Параметр включен:adtest=on
Параметр выключен:adtest=off
ad_type (тип объявления)
Описание
Параметр "Тип объявления" (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
Требования и рекомендации
- Если в приложении присутствует видеоконтент, установите для этого параметра значение
video,audio_videoили не добавляйте этот параметр. - Если приложение рассчитано только на аудиоконтент, как, например, в случае с радио или приложениями для обработки речи, установите для этого параметра значение
audio. Если вы не установите значение для этого параметра, то аудиообъявления не будут возвращаться.
afvsz (размеры параллельных объявлений)
Описание
Параметр "Размеры параллельных объявлений" (afvsz) принимает постоянные значения, которые представляют собой разделенный запятыми список размеров параллельных объявлений, подходящих для показа в рекламном месте для видеообъявления.
Это могут быть любые поддерживаемые размеры:
200x200250x250300x250336x280450x50468x60480x90729x90
Если применяется 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 (все метки)
Описание
Параметр "Все метки" (allcues) принимает переменные значения, которые представляют собой список временных точек, указанных в миллисекундах и разделенных запятыми. Для каждого значения Google Менеджер рекламы возвращает рекламную паузу.
- Параметры
vid_dиallcuesпредназначены для показа рекламы в середине видео без использования передачи контента. - Правила для объявлений также должны возвращать видеорекламу для показа в середине ролика. Если в правилах для объявлений используются точки с временным условием (например: "Каждые N секунд" или "В определенные моменты" и т. д.), тогда будут игнорироваться временные точки, передаваемые с помощью параметра
allcues. Для видеорекламы в середине ролика должна задаваться определенная длительность, поэтому параметрvid_dтоже будет использоваться.
Примеры использования
Временные точки на 10 и 20 секундах:allcues=10000,20000
ciu_szs (размеры сопутствующих креативов)
Описание
Параметр "Размеры сопутствующих объявлений" (ciu_szs) принимает переменные значения, которые представляют собой список размеров, разделенных запятыми.
Значения, разделенные вертикальной линией (|), указывают на рекламное место с несколькими размерами.
Примеры использования
ciu_szs=728x90,300x250
Размеры сопутствующих объявлений для рекламного места с несколькими размерами:ciu_szs=728x90,300x200|300x250
cmsid (идентификатор источника контента)
Описание
Параметры "Идентификатор источника контента" (cmsid) и "Идентификатор видео" (vid) принимают переменные значения.
Чтобы можно было настраивать таргетинг объявлений на видеоконтент, в теге главного объявления должны быть оба эти параметра.
- Параметр
cmsid– это уникальное числовое значение, которое присваивается каждому источнику контента. Для поиска источника контента в Google Менеджере рекламы нажмите Видео > Источники контента, а затем выберите нужный по его названию. - Параметр
vid– это строка или числовое значение, которые позволяют идентифицировать определенное видео. Этот параметр назначается вашей системой управления контентом. Для поиска видео в Google Менеджере рекламы нажмите Видео > Контент, а затем выберите нужное.
Примеры использования
cmsid=[value]&vid=[value]
Если вы создаете тег для видео по запросу с динамической вставкой объявлений, необходимо использовать макрос, который будет динамически вставлять правильные идентификаторы источника контента и видео.
Пример: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%
Требования и рекомендации
Хотя эти параметры не являются обязательными для какого-либо способа внедрения рекламы или типа транзакций, они необходимы для таргетинга на видеоконтент.
cust_params (специальные параметры)
Описание
Параметр "Специальные параметры" (cust_params) принимает переменные значения в виде пар "ключ-значение", которые позволяют настраивать специальный таргетинг (например, на демографические данные, определенные места на веб-странице или на ту или иную страницу или группу страниц).
Примеры использования
Ознакомьтесь с примерами внедрения пар "ключ-значение".
excl_cat (категории исключений)
Описание
Параметр "Категория исключения" (excl_cat) принимает переменные значения и используется для блокировки всех позиций, которые содержат в запросе объявлений указанный ярлык для исключения. Параметр cust_params применяется при настройке исключений и ярлыков для исключений.
Примеры использования
Чтобы настроить категорию исключения для двух ярлыков исключений (airline_excl_label и train_excl_label), отделите ярлыки друг от друга с помощью вертикальной линии (|):
excl_cat=airline_excl_label%7Ctrain_excl_label
Затем примените кодировку URL и укажите в кодируемой строке параметр cust_params:
&cust_params=excl_cat%3Dairline_excl_label%7Ctrain_excl_label
gdpr (регламент 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" (gdpr_consent) принимает переменные значения. Он позволяет издателям обеспечить соответствие своего инвентаря спецификации IAB TCF версии 2.0. Значения параметра не добавляются автоматически в запросы VAST, но обрабатываются, если они есть в тегах объявления.
Дополнительную информацию о том, какие значения принимает этот параметр, можно найти в общих рекомендациях по внедрению спецификации TCF от IAB версии 2.0 или в разделе этой спецификации, который относится к строке TC.
Примеры использования
gdpr_consent=GDPR_CONSENT_123
iabexcl (URL исключений IAB)
Описание
Параметр "URL исключений IAB" (iabexcl) принимает переменные значения, которые представлены в виде списка категорий, разделенного запятыми.
Примеры использования
При использовании параметра iabexcl=3,14,527 будет исключаться контент следующих категорий: "Коммерческий грузовой автотранспорт", "Внедорожные транспортные средства" и "Регби".
Вы можете скачать список категорий классификации контента от IAB и их идентификаторов.
idtype (тип устройства)
Описание
Параметры сбрасываемого идентификатора устройства (rdid, idtype, is_lat) принимают переменное значение. Это значение также известно как рекламный идентификатор (IFA).
В мобильных приложениях, в которых используется IMA SDK для Android или iOS, IMA SDK передает сбрасываемый идентификатор устройства в ваши запросы на трансляцию с параметрами rdid, idtype и is_lat для таргетинга на пользователей.
Если IMA SDK не применяется или используется веб-маяк на сервере (SSB), эти параметры необходимо передавать как явные. Подробнее об идентификаторах устройств…
Оба эти значения требуются почти для всех видеообъявлений, которые размещаются в рамках алгоритмических продаж.
|
В iOS 14.5 и более поздних версий больше не поддерживается сигнал |
Примеры использования
Ознакомьтесь с примерами сбрасываемых идентификаторов устройств.
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, он необходим при размещении объявлений в рамках алгоритмических продаж в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
При показе на сайтах сбрасываемые идентификаторы устройства не используются.
Использование SDK
IMA SDK передает это поле автоматически, но при использовании PAL SDK издатели передают эти параметры вручную.
ipd (домен партнера по инвентарю)
Описание
Параметр inventorypartnerdomain (ipd) принимает значения переменных, заданных в декларациях inventorypartnerdomain в принадлежащих издателю файлах app-ads.txt или ads.txt.
Параметр inventorypartnerdomain основан на спецификации IAB и помогает издателям указывать домен партнера по совместному использованию инвентаря, чтобы обеспечивать валидацию файлов ads.txt и app-ads.txt.
При совместном использовании инвентаря особенно важна декларация IPD, так как рекламный инвентарь, из которого исходит запрос, может принадлежать другому партнеру (партнеру по совместному использованию инвентаря).
Подробнее о файлах ads.txt и app-ads.txt и партнерах по совместному использованию инвентаря…
Примеры использования
Параметрinventorypartnerdomain — это файл в формате app-ads.txt, который указывает на партнерский файл .txt, позволяющий монетизировать инвентарь. Значение параметра ipd должно соответствовать значению в файле app-ads.txt в соответствующем объекте inventorypartnerdomain.Требования и рекомендации
Этот параметр является обязательным для издателей, которые хотят получать доход от инвентаря, которым они не владеют.
ipe (объект запроса показа)
Описание
Параметр "Объект проверки показов" (ipe) принимает постоянное значение, указывающее на проверки показов и конверсии, источниками которых является сервер, а не клиент.
Этот параметр используется, когда один сервер отправляет запрос проверки показов или пиксели отслеживания на другой сервер.
Примеры использования
Маяки на сервере:ipe=ssb
is_lat (ограничение отслеживания рекламы)
Описание
Параметры сбрасываемого идентификатора устройства (rdid, idtype, is_lat) принимают переменное значение. Это значение также известно как рекламный идентификатор (IFA).
В мобильных приложениях, в которых используется IMA SDK для Android или iOS, IMA SDK передает сбрасываемый идентификатор устройства в ваши запросы на трансляцию с параметрами rdid, idtype и is_lat для таргетинга на пользователей.
Если IMA SDK не применяется или используется веб-маяк на сервере (SSB), эти параметры необходимо передавать как явные. Подробнее об идентификаторах устройств…
Оба эти значения требуются почти для всех видеообъявлений, которые размещаются в рамках алгоритмических продаж.
|
В iOS 14.5 и более поздних версий больше не поддерживается сигнал |
Примеры использования
Ознакомьтесь с примерами сбрасываемых идентификаторов устройств.
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, он необходим при размещении объявлений в рамках алгоритмических продаж в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
При показе на сайтах сбрасываемые идентификаторы устройства не используются.
Использование SDK
IMA SDK передает это поле автоматически, но при использовании PAL SDK издатели передают эти параметры вручную.
lip (последняя позиция в пакете)
Описание
Параметр "Последняя позиция в пакете" (lip) принимает постоянное значение, которое указывает на запрос из последней позиции в пакете для таргетинга или отчетности.
Примечание. Этот параметр не применим к оптимизированным пакетам и игнорируется, если они используются.
Примеры использования
lip=1
ltd (ограниченный показ рекламы)
Описание
Параметр, относящийся к ограниченному показу рекламы (ltd), принимает постоянное значение. Оно определяет, будет ли показ объявлений выполняться с ограничениями в случаях, когда пользователи не дают согласие на использование файлов cookie и других локальных идентификаторов.
Этот параметр указывает, что запрашивается реклама с ограниченным показом, и отличается от параметра is_lat. Он отключает персонализацию и использование идентификаторов для этих целей.
ltd=1 IMA SDK считает, что в запросе нет идентификатора, и не сохраняет его на устройстве.Примеры использования
ltd=1
max_ad_duration (максимальная длительность объявления)
Описание
Параметры "Минимальная длительность объявления" (min_ad_duration) и "Максимальная длительность объявления" (max_ad_duration) принимают переменные значения, которые в сочетании задают диапазон возможной продолжительности объявления, выраженный в миллисекундах.
Этот параметр можно использовать, чтобы ограничить длительность креативов в соответствии со значениями, которые заданы в запросах оптимизированных пакетов или в рекламных тегах для отдельных объявлений.
Примеры использования
min_ad_duration=15000&max_ad_duration=30000
min_ad_duration (минимальная длительность объявления)
Описание
Параметры "Минимальная длительность объявления" (min_ad_duration) и "Максимальная длительность объявления" (max_ad_duration) принимают переменные значения, которые в сочетании задают диапазон возможной продолжительности объявления, выраженный в миллисекундах.
Этот параметр можно использовать, чтобы ограничить длительность креативов в соответствии со значениями, которые заданы в запросах оптимизированных пакетов или в рекламных тегах для отдельных объявлений.
Примеры использования
min_ad_duration=15000&max_ad_duration=30000
mridx (количество рекламы в середине видео)
Описание
Параметр "Номер позиции видеообъявления в середине ролика" (mridx) принимает переменное значение, соответствующее порядковому номеру объявления в середине ролика (например, номер 1, номер 2 и т. д.).
Примеры использования
mridx=2
Требования и рекомендации
Хотя этот параметр не требуется для показа определенного типа объявлений или транзакций, он необходим, если нужно настроить таргетинг на место размещения в середине видео, а также для создания отчетов и прогнозов по такой рекламе.
nofb (без резервных объявлений)
Описание
Параметр "Отсутствие резервного объявления" (nofb) принимает постоянное значение, которое указывает, что запрос объявления не должен возвращать плейлист из резервных видеообъявлений.
Примеры использования
Резервные объявления отключены:nofb=1
Вы можете на уровне запроса отключить единичные резервные объявления и оптимизированные подборки объявлений из пакета, передав значение nofb=1.
npa (неперсонализированная реклама)
Описание
Параметр "Неперсонализированная реклама" (npa) принимает постоянное значение, указывающее, что при запросе объявления не должна выполняться персонализация.
Чтобы запросить неперсонализированное объявление, задайте параметр npa=1 или просто npa (без определенного значения). Если в запросе этот параметр отсутствует или задан как npa=0, по умолчанию будут запрашиваться персонализированные объявления.
Примеры использования
Неперсонализированная реклама:npa=1
Требования и рекомендации
Этот параметр требуется, только если пользователь отключил персонализацию. Издатели должны убедиться, что они точно передают данные о статусе персонализации пользователя, если он может его контролировать.
ott_placement (пользовательские форматы)
Описание
Параметр места размещения OTT (ott_placement) принимает постоянное значение, которое указывает, что объявление запрашивается по технологии ОТТ для места размещения вне проигрывателя.
В примерах ниже используются места размещения следующих форматов:
- Пауза. Объявление Out-Stream, которое показывается как оверлей поверх видеоконтента, когда пользователь приостанавливает воспроизведение.
- Главный экран. Объявление, которое появляется на главном экране подключенного телевизора или приложения с технологией OTT. Может показываться как masthead, баннер или плитка.
- Картинка в картинке. Видеообъявление In-Stream, которое показывается в отдельном видеопроигрывателе рядом с основным контентом. Обычно для него требуется сжатие видеоконтента и загрузка второго видеопроигрывателя.
- L-баннер. Медийное объявление In-Stream, при показе которого основное видео сжимается, а объявление окружает его. Например, оно часто показывается в окне в форме буквы L.
- Оверлей. Любой формат объявления In-Stream, который показывается поверх видеоконтента, но не занимает весь экран. Это может быть медийное или видеообъявление.
Примеры использования
Поддерживаемые форматы и соответствующие значения:
Пауза:ott_placement=1
Главный экран:ott_placement=2
Картинка в картинке:ott_placement=3
L-баннер:ott_placement=4
Оверлей:ott_placement=5
Специальный или другой формат:ott_placement=99
Требования и рекомендации
Этот параметр требуется только при размещении в рамках алгоритмических продаж на сайтах, в мобильных приложениях и на подключенных телевизорах у издателей, которые монетизируют нестандартные места размещения объявлений при потоковой передаче по технологии OTT.
paln (разовый доступ к библиотеке алгоритмических продаж; поддержка прекращена)
Описание
Если вы работаете с библиотекой Programmatic Access Library (PAL), то параметр с однократно используемым числом для видеообъявления принимает переменное строковое значение.
Однократно используемое число не требует кодирования при добавлении в URL.
Примечание. Если ранее вы добавляли однократно используемое число, используя устаревший параметр paln, то мы рекомендуем отказаться от него и перейти на параметр givn. Также не следует добавлять оба этих параметра.
Примеры использования
Более подробную информацию о том, какое значение передается при использовании этого параметра, можно найти в руководстве по началу работы с библиотекой PAL.
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при алгоритмических продажах на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
pmad (максимальное количество объявлений в пакете)
Описание
Параметр "Максимальное количество объявлений в пакете" (pmad) принимает переменное значение, которое указывает на максимальное количество объявлений в пакете.
Этот параметр ограничивает общее количество объявлений в оптимизированном пакете, который доступен издателям с расширенными возможностями видеорекламы.
Этот параметр не поддерживается при работе с VMAP (если указано значение ad_rule=1).
Примеры использования
pmad=4
pmnd (минимальная длительность пакета)
Описание
Параметры "Минимальная длительность пакета" (pmnd) и "Максимальная длительность пакета" (pmxd) принимают переменные значения, которые в сочетании задают диапазон возможной продолжительности пакета, выраженный в миллисекундах.
Эти параметры используются при запросе нескольких объявлений в оптимизированном пакете, который доступен издателям с расширенными возможностями видеорекламы. Если действуют правила для объявлений, Google Менеджер рекламы автоматически добавляет эту информацию.
Этот параметр не поддерживается при работе с VMAP (если указано значение ad_rule=1).
Примеры использования
pmnd=0&pmxd=60000
pmxd (максимальная длительность пакета)
Описание
Параметры "Минимальная длительность пакета" (pmnd) и "Максимальная длительность пакета" (pmxd) принимают переменные значения, которые в сочетании задают диапазон возможной продолжительности пакета, выраженный в миллисекундах.
Эти параметры используются при запросе нескольких объявлений в оптимизированном пакете, который доступен издателям с расширенными возможностями видеорекламы. Если действуют правила для объявлений, Google Менеджер рекламы автоматически добавляет эту информацию.
Этот параметр не поддерживается при работе с VMAP (если указано значение ad_rule=1).
Примеры использования
pmnd=0&pmxd=60000
pmxfwt (максимальное время принудительного просмотра пакета)
Описание
Параметр максимального обязательного времени просмотра (pmxfwt) принимает значение переменной, которая указывает максимальную длительность просмотра пакета без возможности пропуска в миллисекундах.
Если у вас поддерживаются пакеты, где есть видеобъявления, которые можно пропустить и которые пропустить нельзя, и вы хотите ограничить для пользователей время просмотра рекламы, используйте этот параметр, чтобы указать максимальное время обязательного просмотра.
Примечание. Параметр максимальной длительности пакета (pmxd) заменяет этот параметр при определении максимальной общей длительности пакета (включая полную длительность объявлений с возможностью пропуска).
Пример использования
pmxfwt=30000
pod (номер пакета)
Описание
Параметр "Номер пакета" (pod) принимает переменное значение, которое соответствует порядковому номеру пакета в видео (например, пакет 1, пакет 2 и т. д.).
Примеры использования
pod=3
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы или типа транзакций, он нужен, чтобы одно и то же объявление можно было показывать в разных пакетах или чтобы корректно использовать конкурентные исключения, ограничение частоты показов и другие связанные с ними функции.
pp (профиль креатива)
Описание
Параметр "Профиль креатива" (pp) принимает переменное значение, которое определяет, какие видео- и аудиокреативы допущены к показу, на основе конфигурации, заданной в профиле видео- или аудиокреатива.
Примеры использования
pp=creative_profile
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, он позволяет контролировать использование медиафайлов для креативов, размещенных в Google Менеджере рекламы, при работе с профилями видео- и аудиокреативов. При переадресации и в объявлениях с алгоритмической продажей он обеспечивает передачу информации о требованиях, но позволяет не ограничиваться медиафайлами, выбранными в профиле креатива.
ppt (условия конфиденциальности издателя)
Описание
Параметр "Вариант защиты конфиденциальности издателем" (ppt) принимает постоянное значение, которое указывает, следует ли отключить персонализацию рекламы для определенного запроса объявления.
Этот параметр позволяет принудительно запросить неперсонализированную рекламу, которая отличается от объявлений, запрашиваемых с использованием параметров npa=1 и rdp=1. Он влияет как на резервирование, так и на спрос на основе алгоритмических продаж.
Подробнее о Publisher Privacy Treatment API…
Примеры использования
Значение, позволяющее отключить персонализацию рекламы:ppt=1
ppid (идентификаторы, назначаемые издателем)
Описание
Параметр "Идентификатор, назначаемый издателем" (ppid) принимает переменное значение и используется для ограничения частоты показов, сегментирования аудитории, таргетинга, последовательной ротации объявлений и других средств управления рекламой на разных устройствах, что позволяет учитывать особенности аудитории при размещении рекламы.
Подробнее об идентификаторах, назначаемых издателем…
Примеры использования
ppid=12JD92JD8078S8J29SDOAKC0EF230337
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы или типа транзакций, он необходим, если вам нужен постоянный идентификатор, не зависящий от платформы. Его можно использовать, когда нет других идентификаторов, и передавать покупателям.
ppos (позиция в пакете)
Описание
Параметр "Позиция в пакете" (ppos) принимает переменное значение, соответствующее позиции в пакете (например, позиция 1, позиция 2 и т. д.).
Этот параметр предназначен только для стандартных пакетов и требуется при использовании сопутствующих объявлений для автозаполнения. Если действуют правила для объявлений, Google Менеджер рекламы автоматически добавляет эту информацию.
Примеры использования
ppos=2
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы или типа транзакций, он необходим при использовании стандартных пакетов, когда нужна настройка таргетинга позиции, или создании прогноза и отчетов по стандартным пакетам. Он также необходим, чтобы корректно использовались конкурентные исключения, ограничение частоты показов и связанные с ними функции.
ppsj (сигналы в формате JSON, предоставленные издателем)
Описание
Параметр "Сигналы, предоставленные издателем, в формате JSON" (ppsj) принимает переменное значение, представляющее собой JSON-объект, закодированный по алгоритму Base64. Он содержит данные об аудитории и контекстные данные, предоставленные издателем и позволяющие повысить доходы от алгоритмических продаж.
Этот параметр можно использовать, чтобы отправлять определенные сигналы покупателям/участникам аукциона.
Подробнее о сигналах, предоставленных издателем, и поддерживаемых таксономиях…
Примеры использования
Объект JSON:
{
"PublisherProvidedTaxonomySignals": [{
"taxonomy": "IAB_AUDIENCE_1_1",
"values": ["6", "284"]
}]
}
Применяется значение, закодированное по алгоритму Base64:
eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2l
nbmFscyI6W3sidGF4b25vbXkiOiJJQUJfQVVESUVOQ0V
fMV8xIiwidmFsdWVzIjpbIjEiLCIyODQiXX1dfQ
Чтобы узнать больше о действительных парах "ключ-значение" JSON, можно посмотреть
пример сигнала на HTML5 от IMA SDK.
ptpl (идентификатор шаблона рекламной паузы)
Описание
Параметры идентификатора и названия шаблона рекламной паузы (ptpl и ptpln) принимают переменные значения и указывают на то, какой из таких шаблонов будет использоваться в запросе оптимизированного пакета.
Шаблоны рекламной паузы позволяют настраивать набор рекламных вставок (в том числе специальных) и порядок их показа в рекламной паузе.
Для запроса шаблона рекламной паузы требуется только один из этих параметров.
Примеры использования
Подробнее о том, как настроить и запросить шаблоны рекламной паузы…
Требования и рекомендации
Эти параметры требуются, только если вы запрашиваете шаблон рекламной паузы напрямую.
ptpln (название шаблона рекламной паузы)
Описание
Параметры идентификатора и названия шаблона рекламной паузы (ptpl и ptpln) принимают переменные значения и указывают на то, какой из таких шаблонов будет использоваться в запросе оптимизированного пакета.
Шаблоны рекламной паузы позволяют настраивать набор рекламных вставок (в том числе специальных) и порядок их показа в рекламной паузе.
Для запроса шаблона рекламной паузы требуется только один из этих параметров.
Примеры использования
Подробнее о том, как настроить и запросить шаблоны рекламной паузы…
Требования и рекомендации
Эти параметры требуются, только если вы запрашиваете шаблон рекламной паузы напрямую.
pubf (общедоступные минимальные цены в тегах Ad Exchange)
Описание
Параметры "Общедоступная цена для Ad Exchange" (pubf) и "Частная цена для Ad Exchange" (pvtf) принимают переменные значения, которые используются для добавления минимальных цен в теги Ad Exchange.
Эти параметры эквивалентны вариантам google_ad_public_floor и google_ad_private_floor.
Примеры использования
Общедоступная минимальная цена:pubf=123
Частная минимальная цена:pvtf=123
Требования и рекомендации
Эти параметры доступны только издателям в Европейской экономической зоне (ЕЭЗ) или Швейцарии, которым разрешено использовать функцию "Минимальная цена".
Подробнее о том, как подать запрос…
pvid (идентификатор набора приложений)
Описание
Параметр "Идентификатор набора приложений" (pvid) принимает переменное значение, которое представляет идентификатор набора приложений Android, а параметр "Область действия набора приложений" (pvid_s) принимает постоянное значение, которое представляет область действия идентификаторов набора приложений (либо scope_app, либо scope_developer).
Сведения о том, как найти идентификатор набора приложений, представлены в документации для разработчиков Android.
Примеры использования
pvid=[AppSetID_value]
pvid_s=scope_app
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при алгоритмических продажах в мобильных приложениях на устройствах Android.
Использование SDK
IMA/PAL SDK передает значение этого поля автоматически, однако издатели, которые не работают с SDK, при получении запроса объявления должны вызывать SDK набора приложений и отправлять эти параметры вручную.
pvid_s (область настроек приложения)
Описание
Параметр "Идентификатор набора приложений" (pvid) принимает переменное значение, которое представляет идентификатор набора приложений Android, а параметр "Область действия набора приложений" (pvid_s) принимает постоянное значение, которое представляет область действия идентификаторов набора приложений (либо scope_app, либо scope_developer).
Сведения о том, как найти идентификатор набора приложений, представлены в документации для разработчиков Android.
Примеры использования
pvid=[AppSetID_value]
pvid_s=scope_app
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при алгоритмических продажах в мобильных приложениях на устройствах Android.
Использование SDK
IMA/PAL SDK передает значение этого поля автоматически, однако издатели, которые не работают с SDK, при получении запроса объявления должны вызывать SDK набора приложений и отправлять эти параметры вручную.
pvtf (частные минимальные цены в тегах Ad Exchange)
Описание
Параметры "Общедоступная цена для Ad Exchange" (pubf) и "Частная цена для Ad Exchange" (pvtf) принимают переменные значения, которые используются для добавления минимальных цен в теги Ad Exchange.
Эти параметры эквивалентны вариантам google_ad_public_floor и google_ad_private_floor.
Примеры использования
Общедоступная минимальная цена:pubf=123
Частная минимальная цена:pvtf=123
Требования и рекомендации
Эти параметры доступны только издателям в Европейской экономической зоне (ЕЭЗ) или Швейцарии, которым разрешено использовать функцию "Минимальная цена".
Подробнее о том, как подать запрос…
rdp (ограничение обработки данных)
Описание
Параметр "Ограничение обработки данных" (rdp) принимает постоянное значение, которое указывает, что в рамках запроса объявления должна быть ограничена обработка данных.
Вы можете включить на уровне сети настройку Ограничение обработки данных.
Примеры использования
Обработка данных ограничивается:rdp=1 или rdp (без заданного значения)
Обработка данных не ограничивается:rdp=0
schain (цепь поставок)
Описание
Параметр, относящийся к цепочке поставок (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
Примеры использования
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
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы или типа транзакций, он необходим издателям, которые пользуются услугами посредников для обработки платежа после отправки запроса в Google Менеджер рекламы. В частности, это издатели, использующие сторонние серверы объявлений.
scor (коррелятор потоков)
Описание
Параметр "Коррелятор потоков" (scor) принимает переменное значение, которое должно быть целым числом и создаваться отдельно для каждого видеопотока.
Параметры score и correlator могут не иметь одинаковое целочисленное значение. Однако у них должны сохраняться прежние значения во время воспроизведения каждого видеопотока: это позволяет идентифицировать уникальные просмотры.
Примеры использования
scor=17
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-то способа внедрения рекламы или типа транзакций, его рекомендуется использовать при показе объявлений на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
Этот параметр используется для конкурентного исключения, ограничения частоты показов и смежных функций, когда пользователь просматривает много видео на одной и той же странице.
sdk_apis (фреймворк SDK API)
Описание
В качестве значения для параметра фреймворка API SDK (sdk_apis) может использоваться разделенный запятыми список постоянных целых значений, указывающих на то, какие фреймворки API поддерживает проигрыватель.
Требования и рекомендации
Использование SDK
Этот параметр используется издателями, которые работают с библиотекой PAL. Если вы используете IMA SDK и попытаетесь указать значения для этого параметра, то они будут переопределены на варианты, поддерживаемые в IMA SDK.
sdmax (максимальная длительность объявления с возможностью пропуска)
Описание
Параметр "Максимальная длительность рекламы с возможностью пропуска" (sdmax) принимает переменное значение, которое позволяет издателям указывать желаемую максимальную длительность объявлений, от просмотра которых пользователи могут отказываться.
Здесь указывается значение в миллисекундах, которое является максимально возможной продолжительностью видео- или аудиокреативов с возможностью пропуска, которые возвращаются в ответ на определенный запрос объявления.
Параметр sdmax можно использовать как отдельно при запросах объявлений с возможностью пропуска, так и в сочетании с параметром max_ad_duration для указания разных значений продолжительности, если нужно показывать объявления с возможностью пропуска и без нее.
Примеры использования
Значения параметров:
max_ad_duration= 15000 (15 сек.);sdmax= 45000 (45 сек.).
Креативы:
- Креатив А: без возможности пропуска; 30 сек.;
- Креатив Б: с возможностью пропуска; 30 сек.
Результаты:
- Креатив А не будет допущен к показу, так как для него не предусмотрена возможность пропуска и его продолжительность превышает максимальное значение для рекламы этого типа.
- Креатив Б с возможностью пропуска будет допущен к показу. Его продолжительность превышает значение параметра
max_ad_duration, но соответствует ограничению, заданному для рекламы с возможностью пропуска.
ssss (источник совмещения на стороне сервера)
Описание
Параметр "Источник совмещения на стороне сервера" (ssss) принимает постоянное значение. Оно должно соответствовать значению, которое компания Google предоставила вашему поставщику технологии совмещения видео и которое можно распознать.
Поставщики технологии совмещения видео, использующие межсерверную интеграцию, получают это значение от Google и могут сообщить его вам. По всем вопросам, связанным со значением этого параметра, обращайтесь к менеджеру вашего аккаунта Google.
Примеры использования
ssss=mystitcher
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы или типа транзакций, его необходимо использовать, если размещение рекламы реализовано на стороне сервера.
tfcd (тег ресурса для детей)
Описание
Параметр "Пометка контента, предназначенного для детей" (tfcd) принимает постоянное значение, которое указывает на то, что запрашивается реклама, которая будет показываться детям.
Примеры использования
tfcd=1
trt (тип трафика)
Описание
Параметр "Тип трафика" (trt) принимает постоянное значение. От него зависит тип трафика (оплачиваемый или бесплатный), возвращаемого в ответ на запрос.
Примеры использования
Запрос оплачиваемого трафика:trt=1
Запрос бесплатного трафика:trt=2
Требования и рекомендации
Использование SDK
Если в запросе отсутствует этот параметр, IMA SDK не подставляет нужное значение. В этом случае сервер по умолчанию устанавливает значение 0 (неопределенный трафик).
us_privacy (строка US privacy от IAB)
Описание
Организация IAB прекратила поддержку строкиus_national, заменив ее на глобальную платформу конфиденциальности (GPP). Однако в целях обратной совместимости Менеджер рекламы продолжает считывать и обрабатывать эту строку при ее получении. Мы рекомендуем издателям отказаться от строки us_national и перейти на GPP или другое решение для настройки конфиденциальности.
vad_type (тип видеообъявления)
Описание
Параметр "Тип видеообъявления" (vad_type) принимает постоянное значение, которое указывает, какое объявление – линейное или параллельное – возвращается в ответе на запрос.
Примеры использования
Линейное объявление:vad_type=linear
Параллельное объявление:vad_type=nonlinear
vid (идентификатор видео)
Описание
Параметры "Идентификатор источника контента" (cmsid) и "Идентификатор видео" (vid) принимают переменные значения.
Чтобы можно было настраивать таргетинг объявлений на видеоконтент, в теге главного объявления должны быть оба эти параметра.
- Параметр
cmsid– это уникальное числовое значение, которое присваивается каждому источнику контента. Для поиска источника контента в Google Менеджере рекламы нажмите Видео > Источники контента, а затем выберите нужный по его названию. - Параметр
vid– это строка или числовое значение, которые позволяют идентифицировать определенное видео. Этот параметр назначается вашей системой управления контентом. Для поиска видео в Google Менеджере рекламы нажмите Видео > Контент, а затем выберите нужное.
Примеры использования
cmsid=[value]&vid=[value]
Если вы создаете тег для видео по запросу с динамической вставкой объявлений, необходимо использовать макрос, который будет динамически вставлять правильные идентификаторы источника контента и видео.
Пример: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%
Требования и рекомендации
Хотя эти параметры не являются обязательными для какого-либо способа внедрения рекламы или типа транзакций, они необходимы для таргетинга на видеоконтент.
vpi (встроенный плейлист видео)
Описание
Параметр "Внутренняя переадресация плейлиста видео" (vpi) принимает постоянное значение, которое сообщает, нужно ли показывать встроенное объявление из плейлиста VMAP (возвращать тег VAST внутри VMAP).
Это параметр можно использовать, чтобы исключить задержки при загрузке ресурсов и обеспечить ограничения частоты показов и конкурентные исключения в видеопотоке.
Примеры использования
Возвращается тег VAST:vpi=1
Возвращается тег переадресации:vpi=0
