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

Параметры типа объявлений VAST для аудиообъявлений

Список параметров для внедрения для аудиообъявлений

В этой статье представлен список обязательных и рекомендуемых параметров для тегов объявлений VAST, используемых для аудиообъявлений.

Примечание. Параметры на этой странице представляют собой подраздел полного списка параметров тега объявлений VAST. Некоторые из этих параметров требуются для отдельных функций.

Содержание

Развернуть все Свернуть все

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

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

Требования и рекомендации

Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении аудиорекламы

  • Если в приложении присутствует видеоконтент, установите для этого параметра значение video, audio_video или не добавляйте этот параметр.
  • Если приложение рассчитано только на аудиоконтент, как, например, в случае с радио или приложениями для обработки речи, установите для этого параметра значение audio. Если вы не установите значение для этого параметра, то аудиообъявления не будут возвращаться.

Вернуться к списку

correlator (коррелятор)

Описание

Параметр "Коррелятор" (correlator) принимает переменное значение, которое будет одинаковым для всех запросов, полученных в результате одного просмотра страницы. Этот параметр применяется для внедрения конкурентного исключения, в том числе на платформах, не поддерживающих файлы cookie.

Примеры использования

correlator=4345645667

Требования и рекомендации

Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на мобильных сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на подключенных телевизорах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении аудиорекламы Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении цифровой наружной рекламы

Этот параметр обязателен при показе объявлений на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.

Использование SDK
  • Если используется IMA SDK, значение коррелятора задается автоматически. При этом IMA SDK переопределяет значение, установленное вашим проигрывателем.
  • Если IMA SDK не используется, произвольное положительное целое значение этого параметра не должно повторяться для других просмотров страниц.

Вернуться к списку

env (среда)

Описание

Параметр "Среда" (env) принимает постоянное значение, которое указывает на запрос in-stream или запрос от проигрывателя.

Допустимые значения: instream (подходит как для видео-, так и для аудиообъявлений) и vp (подходит только для видеообъявлений).

Примеры использования

Видео- и/или аудиообъявления:
env=instream

Только видеообъявления:
env=vp

Требования и рекомендации

Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на мобильных сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на подключенных телевизорах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении аудиорекламы Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении цифровой наружной рекламы

Этот параметр обязателен при показе объявлений на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.

Этот параметр необходим для создания точных отчетов по типам запросов с разбивкой данных по категории "Тег видео".

Вернуться к списку

gdfp_req (индикатор набора атрибутов)

Описание

Параметр "Индикатор атрибутов Google Менеджера рекламы" (gdfp_req) принимает постоянное значение, которое указывает, что запрос объявления предназначен для инвентаря Google Менеджера рекламы.

Примеры использования

gdfp_req=1

Требования и рекомендации

Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на мобильных сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на подключенных телевизорах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении аудиорекламы Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении цифровой наружной рекламы

Этот параметр обязателен при показе объявлений на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.

Вернуться к списку

iu (рекламный блок)

Описание

Параметр "Рекламный блок" (iu) принимает переменное значение, которое должно соответствовать текущему рекламному блоку в формате /network_code/.../ad_unit.

Примеры использования

iu=/6062/videodemo

Требования и рекомендации

Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на мобильных сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на подключенных телевизорах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении аудиорекламы Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении цифровой наружной рекламы

Этот параметр обязателен при показе объявлений на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.

Вернуться к списку

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

Требования и рекомендации

Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на мобильных сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на подключенных телевизорах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении аудиорекламы Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении цифровой наружной рекламы

Этот параметр обязателен при показе объявлений на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы. Он нужен для того, чтобы на запрос объявления возвращался корректный ответ.

Использование SDK

Если вы работаете с VAST и в проигрывателе используется IMA SDK, у параметра output в запросе видеообъявления всегда будет значение output=xml_vast4. Это не ведет к проблемам с надежностью, так как в IMA SDK обеспечена совместимость со всеми версиями VAST, которые может использовать любой сторонний сервер объявлений.

Вернуться к списку

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

Требования и рекомендации

Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на мобильных сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на подключенных телевизорах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении аудиорекламы Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении цифровой наружной рекламы

Этот параметр обязателен только при размещении в рамках алгоритмических продаж на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконенте и на инвентаре для цифровой наружной рекламы.

Использование в SDK

Если вы используете IMA SDK, значение URL задается автоматически. Если это значение устанавливается вашим проигрывателем, оно будет учитываться в IMA SDK.

Вернуться к списку

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

idtype (тип устройства)

Описание

Параметры сбрасываемого идентификатора устройства (rdid, idtype, is_lat) принимают переменное значение. Это значение также известно как рекламный идентификатор (IFA).

В мобильных приложениях, в которых используется IMA SDK для Android или iOS, IMA SDK передает сбрасываемый идентификатор устройства в ваши запросы на трансляцию с параметрами rdid, idtype и is_lat для таргетинга на пользователей.

Если IMA SDK не применяется или используется веб-маяк на сервере (SSB), эти параметры необходимо передавать как явные. Подробнее об идентификаторах устройств

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

Предупреждение

В iOS 14.5 и более поздних версий больше не поддерживается сигнал LAT. Вместо этого сигнала Google полагается на наличие идентификатора IDFA с ненулевым значением, указывающего на то, что пользователь дал согласие на отслеживание на тех версиях iOS, которые совместимы с фреймворком App Tracking Transparency. Поэтому вам потребуется действительное свойство UserAgent, указывающее подходящую версию ОС.

Примеры использования

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

Требования и рекомендации

Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на мобильных сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на подключенных телевизорах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении аудиорекламы Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении цифровой наружной рекламы

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

При показе на сайтах сбрасываемые идентификаторы устройства не используются.

Использование 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 и более поздних версий больше не поддерживается сигнал LAT. Вместо этого сигнала Google полагается на наличие идентификатора IDFA с ненулевым значением, указывающего на то, что пользователь дал согласие на отслеживание на тех версиях iOS, которые совместимы с фреймворком App Tracking Transparency. Поэтому вам потребуется действительное свойство UserAgent, указывающее подходящую версию ОС.

Примеры использования

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

Требования и рекомендации

Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на мобильных сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на подключенных телевизорах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении аудиорекламы Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении цифровой наружной рекламы

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

При показе на сайтах сбрасываемые идентификаторы устройства не используются.

Использование SDK

IMA SDK передает это поле автоматически, но при использовании PAL SDK издатели передают эти параметры вручную.

Вернуться к списку

plcmt (размещение объявлений)

Описание

Параметр "Место размещения" (plcmt) принимает постоянное значение, которое указывает, объявляется ли видеореклама In-Stream как "Instream" или как "Accompanying (Сопутствующее объявление)" в соответствии со спецификациями IAB.

В запросах, не относящихся к видеорекламе In-Stream, значение параметра автоматически указывается для покупателей на основании заявленного формата инвентаря, который переопределяет любое объявление, объявленное как "Instream" или "Accompanying".

Примеры использования

Запрос In-Stream:
plcmt=1

Запрос сопутствующего контента:
plcmt=2

Требования и рекомендации

Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на мобильных сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на подключенных телевизорах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении аудиорекламы Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении цифровой наружной рекламы

Этот параметр является обязательным при размещении в рамках алгоритмических продаж на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконенте и на инвентаре для цифровой наружной рекламы.

Вернуться к списку

rdid (сбрасываемый идентификатор устройства)

Описание

Параметры сбрасываемого идентификатора устройства (rdid, idtype, is_lat) принимают переменное значение. Это значение также известно как рекламный идентификатор (IFA).

В мобильных приложениях, в которых используется IMA SDK для Android или iOS, IMA SDK передает сбрасываемый идентификатор устройства в ваши запросы на трансляцию с параметрами rdid, idtype и is_lat для таргетинга на пользователей.

Если IMA SDK не применяется или используется веб-маяк на сервере (SSB), эти параметры необходимо передавать как явные. Подробнее об идентификаторах устройств

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

Предупреждение

В iOS 14.5 и более поздних версий больше не поддерживается сигнал LAT. Вместо этого сигнала Google полагается на наличие идентификатора IDFA с ненулевым значением, указывающего на то, что пользователь дал согласие на отслеживание на тех версиях iOS, которые совместимы с фреймворком App Tracking Transparency. Поэтому вам потребуется действительное свойство UserAgent, указывающее подходящую версию ОС.

Примеры использования

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

Требования и рекомендации

Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на мобильных сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на подключенных телевизорах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении аудиорекламы Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении цифровой наружной рекламы

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

При показе на сайтах сбрасываемые идентификаторы устройства не используются.

Использование SDK

IMA SDK передает это поле автоматически, но при использовании PAL SDK издатели передают эти параметры вручную.

Вернуться к списку

vpa (автоматическое воспроизведение)

Описание

Параметр, который относится к автоматическому воспроизведению видео (vpa), принимает постоянное значение. Оно указывает, запускается ли рекламный ролик самостоятельно или только после нажатия на него.

Допустимые значения: click (если требуется действие пользователя) и auto (если видео воспроизводится автоматически). Этот параметр не влияет на статус видеопроигрывателя, и управление воспроизведением осуществляется в самом проигрывателе.

Примеры использования

Автовоспроизведение:
vpa=auto

Воспроизведение по клику:
vpa=click

Если значение этого параметра неизвестно, задавать его не нужно.

Требования и рекомендации

Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на мобильных сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на подключенных телевизорах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении аудиорекламы

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

Использование этого параметра рекомендовано руководствами по работе с данными о видеорекламе, подготовленными Советом по медиаизмерениям.

Вернуться к списку

vpmute (воспроизведение без звука)

Описание

Параметр "Воспроизведение видео без звука" (vpmute) принимает постоянное значение, которое указывает, начинается ли воспроизведение объявления, если в видеопроигрывателе выключен звук. Этот параметр не влияет на статус видеопроигрывателя, и управление воспроизведением осуществляется в самом проигрывателе.

Примеры использования

Воспроизведение начинается при отключенном звуке:
vpmute=1

Воспроизведение начинается при включенном звуке:
vpmute=0

Требования и рекомендации

Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на мобильных сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на подключенных телевизорах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении аудиорекламы Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении цифровой наружной рекламы

Этот параметр является обязательным при размещении в рамках алгоритмических продаж на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконенте и на инвентаре для цифровой наружной рекламы.

Использование этого параметра рекомендовано руководствами по работе с данными о видеорекламе, подготовленными Советом по медиаизмерениям.

Вернуться к списку

aconp (непрерывное воспроизведение аудио)

Описание

Параметр "Непрерывное воспроизведение аудио" (aconp) принимает постоянное значение, которое указывает, будет ли аудиоконтент воспроизводиться непрерывно. В Google Менеджер рекламы этот параметр позволяет подбирать самые удобные объявления.

Примеры использования

Непрерывное воспроизведение включено:
aconp=2

Непрерывное воспроизведение выключено:
aconp=1

Если вам неизвестно, непрерывно ли воспроизводится объявление, задайте для данного параметра значение aconp=0 или совсем не указывайте его.

Требования и рекомендации

Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на мобильных сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на подключенных телевизорах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении аудиорекламы Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении цифровой наружной рекламы

Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при алгоритмических продажах на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.

Использование этого параметра рекомендовано руководствами по работе с данными об аудиорекламе, подготовленными Советом по медиаизмерениям.

Вернуться к списку

an (название приложения)

Описание

Параметры "Идентификатор приложения" (msid) и "Название приложения" (an) принимают переменные значения, которые нужно указывать в запросах, отправляемых из мобильных приложений и с подключенных телевизоров, поскольку это требуется при размещении большинства видеообъявлений с алгоритмической продажей.

Название приложения должно быть удобочитаемым для человека. В случае с iOS и tvOS пакет SDK не может получить доступ к идентификатору приложения. При этом параметр msid не передается, а SDK отправляет набор App Bundle с помощью параметра an.

Примеры использования

msid=com.package.publisher&an=sample%20app

Идентификаторы приложений имеют разные варианты наименования и форматы. Ознакомьтесь с инструкциями от IAB по работе с данными, необходимыми для идентификации приложения, или примерами часто используемых уникальных идентификаторов.

Если у платформы нет магазина приложений, IAB рекомендует издателям использовать идентификатор следующего формата: com.publisher.deviceplatform.

Требования и рекомендации

Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на мобильных сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на подключенных телевизорах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении аудиорекламы Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении цифровой наружной рекламы

Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при алгоритмических продажах в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.

Для безопасности бренда и обеспечения большей прозрачности для покупателей настоятельно рекомендуем включать информацию о приложении.

Использование 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.

Требования и рекомендации

Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на мобильных сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на подключенных телевизорах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении аудиорекламы Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении цифровой наружной рекламы

Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при алгоритмических продажах на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.

Использование SDK

Этот параметр рекомендуется для решений на основе библиотеки программного доступа (PAL) или инвентаря с аутентификацией на стороне издателя (PAI) и не требуется при работе с IMA SDK или DAI SDK.

Вернуться к списку

givn (однократное воспроизведение видео)

Описание

Если вы работаете с библиотекой Programmatic Access Library (PAL), то параметр с однократно используемым числом для видеообъявления принимает переменное строковое значение.

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

Примечание. Если ранее вы добавляли однократно используемое число, используя устаревший параметр paln, то мы рекомендуем отказаться от него и перейти на параметр givn. Также не следует добавлять оба этих параметра.

Примеры использования

Более подробную информацию о том, какое значение передается при использовании этого параметра, можно найти в руководстве по началу работы с библиотекой PAL.

Требования и рекомендации

Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на мобильных сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на подключенных телевизорах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении аудиорекламы Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении цифровой наружной рекламы

Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при алгоритмических продажах на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.

Вернуться к списку

hl (язык)

Описание

Параметр "Язык" (hl) принимает постоянное значение, используемое для запроса рекламы на этом языке, а также для выбора языка, который используется при выборе и отрисовке объявлений при динамическом размещении видеорекламы с помощью Ad Exchange и AdSense.

Примеры использования

Запрос объявлений на итальянском языке:
hl=it

Значением параметра может быть двухбуквенный код по стандарту ISO 639-1 или трехбуквенный код по стандарту ISO 639-2. Ознакомьтесь со списком допустимых кодов.

Если этот параметр не указан, то используется языковой таргетинг в Ad Exchange.

Требования и рекомендации

Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на мобильных сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на подключенных телевизорах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении аудиорекламы Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении цифровой наружной рекламы

Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при алгоритмических продажах на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.

Вернуться к списку

msid (идентификатор приложения)

Описание

Параметры "Идентификатор приложения" (msid) и "Название приложения" (an) принимают переменные значения, которые нужно указывать в запросах, отправляемых из мобильных приложений и с подключенных телевизоров, поскольку это требуется при размещении большинства видеообъявлений с алгоритмической продажей.

Название приложения должно быть удобочитаемым для человека. В случае с iOS и tvOS пакет SDK не может получить доступ к идентификатору приложения. При этом параметр msid не передается, а SDK отправляет набор App Bundle с помощью параметра an.

Примеры использования

msid=com.package.publisher&an=sample%20app

Идентификаторы приложений имеют разные варианты наименования и форматы. Ознакомьтесь с инструкциями от IAB по работе с данными, необходимыми для идентификации приложения, или примерами часто используемых уникальных идентификаторов.

Если у платформы нет магазина приложений, IAB рекомендует издателям использовать идентификатор следующего формата: com.publisher.deviceplatform.

Требования и рекомендации

Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на мобильных сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на подключенных телевизорах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении аудиорекламы Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении цифровой наружной рекламы

Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при алгоритмических продажах в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.

Для безопасности бренда и обеспечения большей прозрачности для покупателей настоятельно рекомендуем включать информацию о приложении.

Использование 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'

Требования и рекомендации

Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на мобильных сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на подключенных телевизорах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении аудиорекламы Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении цифровой наружной рекламы

Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при алгоритмических продажах на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.

Использование SDK
  • Этот параметр доступен только издателям, которые хотят при работе с Open Measurement SDK (OM SDK) использовать отслеживание Active View.
  • Чтобы при использовании библиотеки Programmatic Access Library (PAL) сообщить о поддержке OMID, необходимо указать название организации-партнера (omidPartnerName) и версию ее системы (omidPartnerVersion). Если вы не используете PAL или IMA SDK, вам потребуется задать параметры omid_p и sdk_apis.
  • Они не нужны, если вы используете IMA SDK, поскольку в этом случае они задаются автоматически.

Вернуться к списку

sid (идентификатор сеанса)

Описание

Параметр "Идентификатор сеанса" (sid) принимает переменное значение, соответствующее рекламному идентификатору, который используется только для ограничения частоты показа и не нарушает конфиденциальность.

Идентификатор сеанса поддерживается в запросах видеообъявлений In-Stream от подключенных телевизоров и от видеоинвентаря In-Stream в мобильных приложениях. На сайтах он в настоящее время не поддерживается.

Чтобы отключить передачу идентификатора сеанса, присвойте параметру sid нулевое значение.

Примеры использования

sid=123e4567-e89b-12d3-a456-426614174000

Согласно специальным требованиям организации IAB, значение этого параметра должно быть указано в формате UUID. Подробнее о сбрасываемых идентификаторах устройств для таргетинга на пользователей

Требования и рекомендации

Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на мобильных сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на подключенных телевизорах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении аудиорекламы Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении цифровой наружной рекламы

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

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

Использование SDK

IMA SDK отправляет этот параметр автоматически.

Вернуться к списку

vconp (непрерывное воспроизведение видео)

Описание

Параметр "Непрерывный просмотр видео" (vconp) принимает постоянное значение, которое указывает, будет ли проигрыватель воспроизводить видео непрерывно, как при вещании по телевизору.

Примеры использования

Непрерывное воспроизведение включено:
vconp=2

Непрерывное воспроизведение выключено:
vconp=1

Если значение этого параметра неизвестно, задавать его не нужно.

Требования и рекомендации

Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на мобильных сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на подключенных телевизорах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении аудиорекламы

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

Использование этого параметра рекомендовано руководствами по работе с данными о видеорекламе, подготовленными Советом по медиаизмерениям.

Вернуться к списку

vpos (фрагменты видео)

Описание

Параметр "Позиция видео" (vpos) принимает постоянное значение, которое указывает, где должно быть размещено объявление: в начале, в середине или в конце видеоролика.

Примеры использования

Размещение в начале ролика:
vpos=preroll

Размещение в середине ролика:
vpos=midroll

Размещение в конце ролика:
vpos=postroll

Требования и рекомендации

Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на мобильных сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на подключенных телевизорах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении аудиорекламы

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

Если используются правила для объявлений, этот параметр не требуется, поскольку он добавляется сервером объявлений автоматически.

Вернуться к списку

wta (почему пользователь видит эту рекламу)

Описание

Параметр "Почему я вижу эту рекламу?" (wta) принимает постоянное значение, которое указывает на то, что в видеопроигрывателе поддерживается пометка рекламы.

Примеры использования

Если проигрыватель должен отображать значок "Выбор рекламы" из ответа VAST, используйте следующее значение:

  • wta=1 (также можно опустить параметр wta или передавать wta без значения).

    Если значок "Выбор рекламы" из ответа VAST будет добавлен в сопутствующее объявление или показан пользователю иным образом, в запросе аудиорекламы должен быть задан параметр wta=1.

Если значок "Выбор рекламы" из ответа VAST не должен показываться в проигрывателе, используйте следующее значение:

  • wta=0

Требования и рекомендации

Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на мобильных сайтах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении рекламы на подключенных телевизорах Нажмите, чтобы ознакомиться с параметрами шаблона VAST, необходимыми или рекомендуемыми при размещении аудиорекламы

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

Если этот параметр используется, происходит следующее:

  • При значении &wta=0 нельзя использовать некоторые типы персонализации для трафика из источников спроса Google.
  • При значении &wta=0 нельзя показывать креативы с включенными пометками рекламы, если трафик происходит из ЕЭЗ, а реклама размещается в рамках резервирования или гарантированных кампаний с алгоритмической продажей, управляемых издателем.

Объявления, которые показываются в Европейской экономической зоне (ЕЭЗ), должны соответствовать действующим нормативным требованиям. В частности, пользователям должна предоставляться возможность пожаловаться на противозаконный контент. Издатели обязаны уведомлять Google о любом противозаконном контенте, используя форму Сообщить о контенте в Google.

Использование SDK
При использовании IMA SDK пометка рекламы поддерживается автоматически. Если вы не работаете с IMA SDK, то в проигрывателе должна быть реализована поддержка объектов VAST Icon и IconClickFallbackImage в соответствии со стандартом IAB.

Вернуться к списку

Эта информация оказалась полезной?

Как можно улучшить эту статью?
Поиск
Очистить поле поиска
Закрыть поиск
Главное меню
17835027810854256609
true
Поиск по Справочному центру
true
true
true
true
true
148
false
false
false
false