В этой статье представлен список обязательных и рекомендуемых параметров для тегов объявлений VAST, используемых при показе цифровой наружной рекламы.
Содержание
- Обязательные параметры для показа объявлений
- Обязательные параметры для алгоритмических продаж
- Рекомендуемые параметры для алгоритмических продаж
Обязательные и рекомендуемые параметры для цифровой наружной рекламы
Обязательные параметры для показа объявлений
correlator (коррелятор)
Описание
Параметр "Коррелятор" (correlator) принимает переменное значение, которое будет одинаковым для всех запросов, полученных в результате одного просмотра страницы. Этот параметр применяется для внедрения конкурентного исключения, в том числе на платформах, не поддерживающих файлы cookie.
Примеры использования
correlator=4345645667
Требования и рекомендации
Этот параметр обязателен при показе объявлений на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
Использование 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.
url (URL)
Описание
Параметр "URL" (url) принимает переменное значение, соответствующее полному URL, с которого поступил запрос. Это значение позволяет покупателям определять контекст запроса. Мы рекомендуем указывать это значение динамически при отправке запроса объявления.
- При показе на сайтах значением этого параметра является URL страницы с видеопроигрывателем.
- При показе на других платформах значением должен быть URL, который наиболее точно соответствует видео- или аудиоинвентарю, на котором размещается реклама. Примером может быть ситуация, когда пользователь смотрит видеоролик в мобильном приложении, который также доступен по URL на сайте*.
Примечание. Параметр url отличается от description_url тем, что url указывает, откуда поступил запрос объявления, а description_url является адресом веб-страницы, которая содержит описание видеоконтента и может быть просканирована поисковыми роботами.
Значение этого параметра должно быть закодировано.
Примеры использования
url=https%3A%2F%2Fexample.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
Требования и рекомендации
Этот параметр является обязательным при размещении в рамках алгоритмических продаж на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконенте и на инвентаре для цифровой наружной рекламы.
Использование этого параметра рекомендовано руководствами по работе с данными о видеорекламе, подготовленными Советом по медиаизмерениям.
Обязательные параметры для алгоритмических продаж
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 издатели передают эти параметры вручную.
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 издатели передают эти параметры вручную.
plcmt (размещение объявлений)
Описание
Параметр "Место размещения" (plcmt) принимает постоянное значение, которое указывает, объявляется ли видеореклама In-Stream как "Instream" или как "Accompanying (Сопутствующее объявление)" в соответствии со спецификациями IAB.
В запросах, не относящихся к видеорекламе In-Stream, значение параметра автоматически указывается для покупателей на основании заявленного формата инвентаря, который переопределяет любое объявление, объявленное как "Instream" или "Accompanying".
Примеры использования
Запрос In-Stream:plcmt=1
Запрос сопутствующего контента:plcmt=2
Требования и рекомендации
Этот параметр является обязательным при размещении в рамках алгоритмических продаж на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконенте и на инвентаре для цифровой наружной рекламы.
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 отправляет этот параметр автоматически.
venuetype (тип места)
Описание
Параметр "Тип места" (venuetype) используется для указания типа места размещения наружной рекламы. Подходящие значения – идентификаторы с целочисленной нумерацией, поддерживаемые классификацией типов мест размещения IAB OpenOOH 1.1.
Примеры использования
Номера отелей:venuetype=80703
Планшеты на задних сиденьях такси:venuetype=103
Требования и рекомендации
Этот параметр является обязательным для алгоритмических продаж при работе с цифровой наружной рекламой.
Рекомендуемые параметры для алгоритмических продаж
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, поскольку в этом случае они задаются автоматически.
