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

Далее: Обязательные параметры для приложений

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

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

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

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

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

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

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

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

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

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

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

Параметр Подробная информация

aconp

_{(Непрерывное воспроизведение аудио)}

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

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

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

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

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

ad_rule

_{(Правило для объявлений)}

Параметр, относящийся к правилам для объявлений, принимает постоянное значение, которое указывает, что нужно возвращать: креатив VAST или правило для объявлений.

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

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

Запрос креатива VAST:
ad_rule=0

Запрос правил объявлений (VMAP):
ad_rule=1

Требования

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

ad_type

_{(Тип объявления)}

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

Этот параметр обязателен только для аудиообъявлений.

Если для параметра ad_type установлено значение audio или audio_video, то у параметра vpmute должно быть значение 0.

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

Допущены только аудиообъявления:
ad_type=audio

Допущены видеообъявления с возможностью пропуска и без нее:
ad_type=video

Допущены аудио- и видеообъявления:
ad_type=audio_video
Если указать это значение, то конкурировать за рекламное место смогут объявления обоих форматов, но размещено будет только одно из них.

Тип объявления audio_video предназначен только для размещения видеокреативов в аудиоконтенте, совместимом с видеообъявлениями, или аудиокреативов в ориентированном на прослушивание контенте при воспроизведении в видеопроигрывателях с поддержкой рекламы In-Stream. Примеры подобного контента: трансляции спортивных состязаний, видеопередачи, выпуски новостей. Подробнее об аудиообъявлениях в видеоконтенте…

Допущены только видеообъявления с возможностью пропуска:
ad_type=skippablevideo

Допущены только видеообъявления без возможности пропуска:
ad_type=standardvideo

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

Обязательно Требуется для аудиообъявлений

addtl_consent

_{(Дополнительное согласие)}

Параметр, относящийся к дополнительному согласию, принимает переменные значения. Он позволяет издателям обеспечить соответствие своего инвентаря спецификации IAB TCF версии 2.0 и указывать поставщиков рекламных технологий, которые ещё не добавлены в глобальный список поставщиков рекламных технологий от организации IAB Europe, однако входят в аналогичный список от Google. Значения параметра не добавляются автоматически в запросы VAST, но обрабатываются, если они есть в тегах объявления.

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

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

addtl_consent=1~1.35.41.101

afvsz

_{(Размеры параллельных объявлений)}

Параметр "Размеры параллельных объявлений" принимает постоянные значения, которые представляют собой разделенный запятыми список размеров параллельных объявлений, подходящих для показа в рекламном месте для видеообъявления.

Это могут быть любые поддерживаемые размеры:

200x200
250x250
300x250
336x280
450x50
468x60
480x90
729x90

Если применяется IMA SDK, то вместо текущих значений в это поле будут внесены все поддерживаемые размеры в соответствии с параметрами nonLinearAdSlotWidth и nonLinearAdSlotHeight.

Если нелинейные размеры не поддерживаются, этот параметр можно опустить или оставить пустым.

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

Если поддерживаются все размеры:
afvsz=200x200,250x250,300x250,336x280, 450x50,468x60,480x90,728x90

Если максимальная ширина составляет 250:
afvsz=200x200,250x250

Если максимальная высота составляет 60:
afvsz=450x50,468x60

Если максимальная ширина составляет 100:
нет поддерживаемых значений

Требования

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

allcues

_{(Все временные точки)}

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

Параметры vid_d и allcues предназначены для показа объявлений в середине ролика без использования передачи контента. Правила для объявлений также должны возвращать видеорекламу для показа в середине ролика.

Если в правилах для объявлений используются точки с временным условием (например: "Каждые N секунд" или "В определенные моменты" и т. д.), тогда будут игнорироваться временные точки, передаваемые с помощью параметра allcues. Для видеорекламы в середине ролика должна задаваться определенная длительность, поэтому параметр vid_d тоже будет использоваться.

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

Временные точки на 10 и 20 секундах:
allcues=10000,20000

ciu_szs

_{(Размеры сопутствующих объявлений)}

Параметр "Размеры сопутствующих объявлений" принимает переменные значения, которые представляют собой список размеров, разделенных запятыми.

Значения, разделенные вертикальной линией (|), указывают на рекламное место с несколькими размерами.

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

ciu_szs=728x90,300x250

Размеры сопутствующих объявлений для рекламного места с несколькими размерами:
ciu_szs=728x90,300x200|300x250

cmsid

_{(Идентификатор источника контента)}

vid

_{(Идентификатор видео)}

Параметры "Идентификатор источника контента" и "Идентификатор видео" принимают переменные значения.

Чтобы настроить таргетинг объявлений на видеоконтент, в теге главного объявления должны быть оба эти параметра.

Параметр cmsid – это уникальное числовое значение, которое присваивается каждому источнику контента. Чтобы найти его в Менеджере рекламы, нажмите Видео и затем Источники контента, а затем выберите нужный вариант.

Параметр vid – это строка или числовое значение, которые позволяют идентифицировать определенное видео. Этот параметр назначается системой управления вашим контентом. Чтобы найти его в Менеджере рекламы, нажмите Видео и затем Контент, а затем выберите нужное видео.

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

cmsid=[value]&vid=[value]

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

Пример: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%

Требования

Обязательно Требуется для таргетинга видеоконтента

correlator

_{(Коррелятор)}

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

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

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

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

correlator=4345645667

Требования

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

Рекомендуется для алгоритмических продаж

cust_params

_{(Специальные пары "ключ-значение")}

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

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

Ознакомьтесь с примерами реализации пар "ключ-значение".

description_url

_{(URL описания)}

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

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

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

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

Пример с кодированием в URL:
description_url= https%3A%2F%2Fwww.sample.com%2Fgolf.html

Пример без кодирования:
description_url= https://www.sample.com/golf.html

Требования

Обязательно для сайтов, приложений и Ad Exchange

Рекомендуется для алгоритмических продаж

env

_(Среда)

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

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

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

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

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

Требования

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

excl_cat

_{(Категория исключения)}

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

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

&cust_params=excl_cat%3Dairline_excl_label%7C

gdfp_req

_{(Индикатор набора атрибутов Менеджера рекламы)}

Параметр "Индикатор набора атрибутов Менеджера рекламы" принимает постоянное значение, указывающее, что пользователь работает с Менеджером рекламы.

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

gdfp_req=1

Требования

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

gdpr

_{(Регламент GDPR)}

Параметр, относящийся к регламенту GDPR, принимает постоянные значения. Он позволяет издателям обеспечить соответствие своего инвентаря спецификации IAB TCF версии 2.0. Значения параметра не добавляются автоматически в запросы VAST, но обрабатываются, если они есть в тегах объявления.

Допустимые значения для этого параметра: "0" и "1". Значение "0" говорит о том, что GDPR не применяется, а "1" – что применяется. Если GDPR применяется, вам необходимо предоставить действительную строку TC с помощью параметра gdpr_consent.

Дополнительную информацию о том, какие значения принимает этот параметр, можно найти в общих рекомендациях по внедрению спецификации TCF от IAB версии 2.0 или в разделе этой спецификации, который относится к строке TC.

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

GDPR применяется:
gdpr=1

GDPR не применяется:
gdpr=0

gdpr_consent

_{(Согласие по GDPR)}

Параметр, относящийся к запросу согласия в соответствии с регламентом GDPR, принимает переменные значения. Он позволяет издателям обеспечить соответствие своего инвентаря спецификации IAB TCF версии 2.0. Значения параметра не добавляются автоматически в запросы VAST, но обрабатываются, если они есть в тегах объявления.

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

gdpr_consent=GDPR_CONSENT_123

hl

_(Язык)

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

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

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

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

hl=ru

Требования

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

iabexcl

_{(Параметр URL для исключений категорий IAB)}

Параметр URL iabexcl поддерживает списки категорий с разделителями-запятыми.

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

При использовании параметра iabexcl=3,14,527 будет исключаться контент следующих категорий: "Коммерческий грузовой автотранспорт", "Внедорожные транспортные средства" и "Регби".

Ознакомьтесь с классификацией контента IAB.

ipd

_{(Домен партнера, который владеет инвентарем)}

Параметр inventorypartnerdomain принимает значения переменных, заданных в декларациях inventorypartnerdomain в принадлежащих издателю файлах app-ads.txt или ads.txt.

Параметр inventorypartnerdomain основан на спецификации IAB и помогает издателям указывать домен партнера по совместному использованию инвентаря, чтобы обеспечивать валидацию файлов ads.txt и app-ads.txt.

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

Подробнее о файлах ads.txt и app-ads.txt и партнерах по совместному использованию инвентаря…

ipe

_{(Запрос ping для показа)}

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

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

Маяки на сервере:
ipe=ssb

iu

_{(Рекламный блок)}

Параметр "Рекламный блок" принимает переменное значение, которое должно соответствовать текущему рекламному блоку в формате:

/network_id/.../ad_unit

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

iu=/6062/videodemo

Требования

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

lip

_{(Последняя позиция в пакете)}

Параметр "Последняя позиция в пакете" принимает постоянное значение, которое указывает на запрос из последней позиции в пакете.

Этот параметр предназначен только для стандартных пакетов.

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

lip=true

ltd

_{(Ограниченный показ рекламы)}

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

В отличие от других параметров URL, при значении ltd=1 IMA SDK считает, что в запросе нет идентификатора, и не сохраняет его на устройстве.

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

ltd=1

min_ad_duration

_{(Минимальная длительность объявления)}

max_ad_duration

_{(Максимальная длительность объявления)}

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

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

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

min_ad_duration=15000&max_ad_duration=30000

mridx

_{(Номер позиции видеообъявления в середине ролика)}

Параметр "Номер позиции видеообъявления в середине ролика" принимает переменное значение, соответствующее порядковому номеру объявления в середине ролика (например, номер 1, номер 2 и т. д.).

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

mridx=2

msid

_{(Идентификатор приложения)}

an

_{(Название приложения)}

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

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

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

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

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

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

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

Обязательный параметр или нет?

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

Рекомендуется для алгоритмических продаж

nofb

_{(Резервное объявление отключено)}

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

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

Резервное объявление отключено:
nofb=1

npa

_{(Неперсонализированная реклама)}

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

Чтобы запросить неперсонализированное объявление, задайте параметр npa=1 или просто npa (без определенного значения). Если в запросе этот параметр отсутствует или задан как npa=0, по умолчанию будут запрашиваться персонализированные объявления.

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

Неперсонализированная реклама:
npa=1

omid_p

_{(Название партнера, использующего OMID API)}

Параметр "Название партнера, использующего OMID API" принимает переменное значение, которое включает название и версию системы партнера, применяющего OMID для отслеживания.

Этот параметр доступен только издателям, которые хотят при работе с Open Measurement SDK (OM SDK) использовать отслеживание Active View, и не подходит для случаев, в которых используется IMA SDK с автоматически заданными настройками.

Чтобы сообщить о поддержке OMID при использовании библиотеки Programmatic Access Library (PAL), необходимо указать название партнера и версию его системы в используемых в API свойствах omidPartnerName и omidPartnerVersion. Если вы не используете библиотеку PAL или IMA, вам необходимо задать параметры omid_p и sdk_apis. Они обеспечивают информацию о поддерживаемых API, в число которых могут входить другие API, перечисленные через запятую.

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

При использовании библиотеки PAL:
request.omidPartnerName = 'examplepartnername' request.omidPartnerVersion = '1.0.0.0'

Без использования библиотеки PAL:
omid_p=examplepartnername/1.0.0.0&sdk_apis=7

output

_{(Формат вывода объявления)}

Параметр "Формат вывода объявления" принимает постоянное значение, которое должно соответствовать формату вывода объявления.

Используйте output=vast для версии VAST, настроенной в вашей сети по умолчанию. Для определенных тегов объявлений и разделов сайта можно запросить специальные версии VAST или VMAP.

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

Используйте значение параметра output=vmap, чтобы выбрать версию VMAP, настроенную в вашей сети по умолчанию (например, VMAP 1). Если вы возвращаете ответ VAST внутри VMAP, то можете указать нужную версию VAST с помощью значений xml_vmap1_vast3 или xml_vmap1_vast4.

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

VAST вашей сети по умолчанию:
output=vast

VAST 4:
output=xml_vast4

VMAP вашей сети по умолчанию:
output=vmap

VMAP 1:
output=xml_vmap1

VMAP 1, возвращающий VAST 4:
output=xml_vmap1_vast4

Требования

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

plcmt

_{(Место размещения)}

Параметр для места размещения принимает постоянное значение, которое указывает, объявлен ли инвентарь In-Stream в соответствии со спецификациями IAB и если да, то как (возможные варианты: In-Stream и сопутствующий).

Для запросов рекламы вне проигрывателя это поле заполняется автоматически с учетом объявленного формата инвентаря. При этом вариант в поле переопределяет любые прежние значения, объявленные для контента с поддержкой In-Stream или сопутствующего контента.

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

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

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

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

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

pmad

_{(Максимальное количество объявлений в пакете)}

Параметр "Максимальное количество объявлений в пакете" принимает переменное значение, которое определяет максимальное количество объявлений в пакете.

Этот параметр относится исключительно к оптимизированным пакетам, которые доступны издателям с расширенными возможностями видеорекламы, и не подходит для VMAP (при ad_rule=1).

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

pmad=4

pmnd

_{(Минимальная длительность пакета)}

pmxd

_{(Максимальная длительность пакета)}

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

Эти параметры используются для запроса сразу нескольких объявлений. Они относятся только к оптимизированным пакетам, которые доступны издателям с расширенными возможностями видеорекламы, и не подходят для VMAP (при ad_rule=1).

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

pmnd=0&pmxd=60000

pod

_{(Номер пакета)}

Параметр "Номер пакета" принимает переменное значение, которое соответствует порядковому номеру пакета в видео (например, пакет 1, пакет 2 и т. д.).

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

pod=3

Требования

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

pp

_{(Профиль креатива)}

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

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

pp=creative_profile

Требования

Рекомендуется для алгоритмических продаж

ppt

_{(Вариант защиты конфиденциальности издателем)}

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

Подробнее о Publisher Privacy Treatment API…

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

Параметр, позволяющий отключить персонализацию рекламы:
ppt=1

ppid

_{(Идентификатор, назначаемый издателем)}

Параметр "Идентификатор, назначаемый издателем" (PPID) принимает переменное значение и используется для ограничения частоты показов, сегментирования аудитории, таргетинга, последовательной ротации объявлений и других средств управления рекламой на разных устройствах.

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

ppid=12JD92JD8078S8J29SDOAKC0EF230337

ppos

_{(Позиция в пакете)}

Параметр "Позиция в пакете" принимает переменное значение, соответствующее позиции в пакете (например, позиция 1, позиция 2 и т. д.).

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

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

ppos=2

Требования

ppsj

_{(Объект JSON сигналов, предоставленных издателем)}

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

Подробнее о сигналах, предоставленных издателем, и поддерживаемых таксономиях…

Чтобы узнать больше о действительных парах "ключ-значение" JSON, можно посмотреть
пример HTML5 IMA SDK.

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

Объект JSON:
{ "PublisherProvidedTaxonomySignals": [{ "taxonomy": "IAB_AUDIENCE_1_1", "values": ["6", "284"] }] }

Значение, закодированное по алгоритму Base64:
eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2lnbmFscyI6W3s idGF4b25vbXkiOiJJQUJfQVVESUVOQ0VfMV8xIiwidmFsdWVzIj pbIjEiLCIyODQiXX1dfQ

ptpl

_{(Идентификатор шаблона рекламной паузы)}

ptpln

_{(Название шаблона рекламной паузы)}

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

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

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

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

pubf

_{(Общедоступные минимальные цены в тегах Ad Exchange)}

pvtf

_{(Частные минимальные цены в тегах Ad Exchange)}

Параметр pubf является эквивалентом для google_ad_public_floor, а pvtf – для google_ad_private_floor. Эти параметры позволяют добавлять минимальные цены в теги Ad Exchange.

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

pubf=123 pvtf=123

pvid

_{(Идентификатор набора приложений)}

pvid_s

_{(Область действия набора приложений)}

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

Параметр pvid принимает переменное значение, относящееся к идентификатору набора приложений для Android, а параметр pvid_s – постоянное значение, которое представляет область действия идентификатора набора приложений (scope_app или scope_developer).

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

Сведения о том, как найти идентификатор набора приложений, представлены в документации для разработчиков Android.

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

pvid=[AppSetID_value] pvid_s=scope_app

Требования

Обязательно Требуется для приложений

Рекомендуется для алгоритмических продаж

rdid
idtype
is_lat

_{(Сбрасываемые идентификаторы устройств)}

Сбрасываемые идентификаторы устройств принимают переменные значения.

В приложениях (работающих не в мобильных или обычных браузерах) SDK передает сбрасываемые идентификаторы устройств для таргетинга в запросы вашего потока с помощью параметров rdid, idtype и is_lat. Для потоков с добавлением маяков на сервере эти параметры нужно передавать явным образом, как и в запросах объявлений на стороне клиента. Подробнее об идентификаторах устройств…

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

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

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

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

Требования

Обязательно Требуется для приложений

Рекомендуется для алгоритмических продаж

rdp

_{(Ограничение обработки данных)}

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

При этом должен быть задан вариант rdp=1 или просто rdp (без значения). Если в запросе этот параметр не указан или задан как rdp=0, пользовательские данные будут обрабатываться без ограничений (за исключением случаев, когда такое ограничение задано в настройках сети).

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

rdp=1

scor

_{(Коррелятор потоков)}

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

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

scor=17

Требования

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

sdk_apis

_{(Фреймворк SDK API)}

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

На сайте GitHub приведен список возможных значений.

Параметр совместим с API из библиотеки Programmatic Access Library (PAL), если издатель не работает с IMA SDK. IMA SDK переопределяет любые значения, заданные при помощи значений, которые поддерживаются этим SDK.

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

sdk_apis=2,7,9

sdmax

_{(Максимальная продолжительность видеообъявления с возможностью пропуска)}

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

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

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

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

Значения параметров:

max_ad_duration = 15000 (15 сек.);
sdmax = 45000 (45 сек.).

Креативы:

Креатив А: без возможности пропуска; 30 сек.;
Креатив Б: с возможностью пропуска; 30 сек.

Результаты:

Креатив А не будет допущен к показу, так как для него не предусмотрена возможность пропуска и его продолжительность превышает максимальное значение для рекламы этого типа.
Креатив Б с возможностью пропуска будет допущен к показу. Его продолжительность превышает значение параметра max_ad_duration, но соответствует ограничению, заданному для рекламы с возможностью пропуска.

sid

_{(Идентификатор сеанса)}

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

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

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

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

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

123e4567-e89b-12d3-a456-426614174000

Требования

Рекомендуется для алгоритмических продаж

ssss

_{(Источник совмещения на стороне сервера)}

Параметр "Источник совмещения на стороне сервера" принимает постоянное значение. Оно должно соответствовать известному значению, которое компания Google предоставила вашему поставщику технологии совмещения видео.

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

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

ssss=mystitcher

Требования

Обязательно Требуется для реализации на стороне сервера.

sz

_{(Размер)}

Параметр "Размер" принимает переменное значение, которое должно соответствовать размеру рекламного места основного видео.

Если размеров несколько, они должны быть разделены вертикальной чертой (|).

Не добавляйте букву v после размера.

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

sz=400x300

Требования

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

Этот параметр необязателен, если запрашивается только ad_type=audio.

tfcd

_{(Тег ресурса для детей)}

Параметр "Предназначенный для детей" принимает постоянное значение, которое маркирует запрос объявления как уместный для детей.

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

tfcd=1

trt

_{(Тип трафика)}

Параметр "Тип трафика" принимает постоянное значение. От него зависит тип трафика (оплачиваемый или бесплатный), возвращаемого в ответ на запрос.

Если в запросе отсутствует этот параметр, IMA SDK не подставляет нужное значение. В этом случае сервер по умолчанию устанавливает значение 0 (неопределенный трафик).

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

Запрос оплачиваемого трафика:
trt=1

Запрос бесплатного трафика:
trt=2

unviewed_position_start

_{(Отложенные показы)}

Параметр "Отложенные показы" принимает постоянное значение, указывающее на отложенные показы видео.

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

unviewed_position_start=1

Требования

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

url

_(URL)

Параметр URL принимает переменное значение, которое должно соответствовать полному URL, с которого поступил запрос. Это значение позволяет покупателям определить источник запроса и понять его контекст. Мы рекомендуем указывать это значение динамически при отправке запроса объявления.

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

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

Значение этого параметра должно быть закодировано.

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

url=https%3A%2F%2Fwww.videoad.com%2Fgolf.html

*Если инвентарь находится в приложении, то не получится указать для этого параметра переменное значение, соответствующее URL. В этом случае мы рекомендуем использовать следующий синтаксис:
url=https%3A%2F%2F<app/bundleid>.adsenseformobileapps.com

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

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

Рекомендуется для алгоритмических продаж

vad_type

_{(Тип видеообъявления)}

Параметр "Тип видеообъявления" принимает постоянное значение, которое указывает, какое объявление – линейное или параллельное – возвращается в ответе на запрос.

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

Линейное объявление:
vad_type=linear

Параллельное объявление:
vad_type=nonlinear

vid_d

_{(Длительность видео)}

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

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

Длительность видеоконтента, равная 90 000 секунд (25 часов):
vid_d=90000

vconp

_{(Непрерывный просмотр видео)}

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

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

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

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

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

vpa

_{(Автоматическое воспроизведение видео)}

Рекомендуется руководством MRC по работе с данными о видеорекламе

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

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

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

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

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

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

Требования

Рекомендуется для алгоритмических продаж

vpi

_{(Внутренняя переадресация плейлиста видео)}

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

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

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

Возвращение тегов VAST:
vpi=1

Возвращение тегов переадресации:
vpi=0

vpmute

_{(Воспроизведение видео без звука)}

Рекомендуется руководством MRC по работе с данными о видеорекламе

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

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

Звук отключен:
vpmute=1

Звук включен:
vpmute=0

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

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

vpos

_{(Позиция в видео)}

Параметр "Позиция в видео" принимает постоянное значение, указывает, откуда направлен запрос объявления: из начала, из середины или из конца видеоролика.

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

В начале ролика:
vpos=preroll

В середине ролика:
vpos=midroll

В конце ролика:
vpos=postroll

Требования

Рекомендуется для алгоритмических продаж

wta

_{(Почему я вижу эту рекламу?)}

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

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

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

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

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

Поддерживается:
wta=1

Не поддерживается:
wta=0

Требования

Обязательное требование при размещении рекламы через Ad Exchange

Обязательное требование для трафика сайтов и приложений при показе в ЕЭЗ

Рекомендуется для алгоритмических продаж

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

Как можно улучшить эту статью?