Структура тегов в AdSense для видео и AdSense для игр значительно отличается от той, которая используется для контента. Чтобы эти платформы работали, требуется тег для интерактивной медиарекламы (IMA). Система будет показывать объявления только при вызове из проигрывателя или загрузчика игры, интегрированного с IMA SDK или совместимого с VAST и VPAID (например, через адаптер IMA).
Теги AdSense для видео обычно создаются с помощью специального генератора. В этой статье вы найдете полный список настроек для них. Обязательных параметров для показа видеотега AdSense немного, но к ним можно добавить дополнительные: идентификаторы каналов, минимальную и максимальную длительность объявления, язык и т. д.
| Параметр тега объявления IMA | Обязательный параметр? |
|---|---|
| ad_type | Да. |
| client | Да. |
| description_url | Да. Необходимо использовать кодировку URL. |
| channel | Нет. Рекомендуется использовать при наличии. |
| adsafe | Нет. Рекомендуется. |
| videoad_start_delay | Нет. Рекомендуется. |
| hl | Нет. Рекомендуется. |
| max_ad_duration | Нет. Рекомендуется. |
| min_ad_duration | Нет. Рекомендуется. |
| sdmax | Нет. Рекомендуется. |
| adtest | Нет. |
| cust_age | Нет. |
| cust_gender | Нет. |
| host | Нет. |
| h_ch | Нет. |
| overlay | Нет. |
Базовый URL
Следующий URL является основой для всех описанных ниже параметров запроса:
https://googleads.g.doubleclick.net/pagead/ads?
ad_type
Тип: строка. Указывает желаемый тип объявления. Чтобы указать несколько типов, их нужно объединить с помощью знака подчеркивания: _.
Значения
- video: любые видеообъявления (эквивалентно standardvideo_skippablevideo_bumpervideo);
- skippablevideo: только видеообъявления с возможностью пропуска (для получения таких объявлений издателю может потребоваться дополнительное разрешение);
- bumpervideo: 6-секундные видеообъявления без возможности пропуска;
- standardvideo: только видеообъявления без возможности пропуска;
- image: графические объявления, которые могут поместиться в нелинейное рекламное место;
- text: текстовые объявления.
Примеры
- &ad_type=video_text_image
- Объявления всех форматов.
- &ad_type=video_text
- Текстовые и видеообъявления любого формата.
- &ad_type=standardvideo_image
- Только стандартные графические и видеообъявления без возможности пропуска.
client
Тип: строка. Идентификатор веб-ресурса издателя.
Пример: &client=ca-video-afvtest
description_url
Тип: строка. Полный URL страницы, описывающей видео. Значение параметра description_url можно задать динамически, используя возможности серверного языка программирования, или вручную, воспользовавшись онлайн-инструментом кодирования URL.
Пример: &description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalue%26key2%3Dvalue2
Пример URL
Этот URL содержит все требуемые параметры: https://googleads.g.doubleclick.net/pagead/ads?client=ca-video- afvtest&ad_type=video&description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalu e%26key2%3Dvalue2
Он запрашивает видеообъявления для издателя ca-video-afvtest. URL описания: http://myurl.com/page?key=value&key2=value2
channel
Тип: строка. Список разделенных плюсами каналов, используемых в AdSense для таргетинга и создания отчетов. В одном запросе объявления может быть передано до пяти каналов.
Пример: &channel=mychannel+otherchannel+targetingchannel
adsafe
Тип: строка. Параметр, который используется для фильтрации объявлений. Значение по умолчанию: high.
Значения:
- high (значение по умолчанию): будут показаны только объявления, подходящие для любой аудитории. Объявления, которые не подходят для семейного просмотра или предназначены только для взрослых, показаны не будут.
- medium: могут быть показаны объявления, которые рекламируют азартные игры или лекарства, отпускаемые по рецепту. Реклама, предназначенная только для взрослых, не будет показана.
Пример: &adsafe=high
adtest
Тип: строка. Указывает, является ли данная реализация тестовой. Допустимые значения: on или off. При значении on показы и клики не учитываются в аккаунте AFV. Этот параметр должен ОБЯЗАТЕЛЬНО использоваться при тестировании. Если он не задан, то по умолчанию устанавливается значение off.
Значения:
- off (значение по умолчанию): средства за рекламу списываются обычным образом. Это значение нужно использовать в рабочей версии.
- on: показы и клики не регистрируются.
Пример: &adtest=on
videoad_start_delay
Тип: целое число. Время, с которого начинается показ объявления (в миллисекундах). По умолчанию используется значение для воспроизведения в середине ролика (то есть "1").
Значения:
- -1 – указывает, что объявление должно быть показано в конце ролика.
- 0 – указывает, что объявление должно быть показано до начала воспроизведения ролика.
- Любое целое положительное число – указывает, что объявление должно быть показано в середине ролика по прошествии заданного количества миллисекунд.
Пример:
- &videoad_start_delay=-1 – показ в конце ролика.
- &videoad_start_delay=15000 – показ объявления начнется через 15 секунд после начала воспроизведения ролика.
cust_age
Тип: целое число. Возраст пользователя. Поддерживается как точный возраст, так и возрастная группа, указанная с помощью com.google.ads.ima.api.Demographics.
Пример:
- &cust_age=1001 – возраст от 18 до 24 лет.
- &cust_age=38 – точный возраст, 38 лет.
cust_gender
Тип: целое число. Пол пользователя, как определено в com.google.ads.ima.api.Demographics.
Значения:
- 1 – мужской
- 2 – женский
Пример:
- &cust_gender=1 – мужской.
- &cust_gender=2 – женский.
host
Тип: строка. Идентификатор хоста, который используется для трехстороннего распределения дохода.
Пример: &host=ca-host-test – распределяет доход с хостом.
h_ch
Тип: строка. Список, состоящий из разделенных плюсами строк, обозначающих идентификаторы каналов таргетинга и отчетности AdSense для хоста.
Пример: &h_ch=channel1+channel2+channel3 – отчетность и таргетинг для этих дополнительных каналов хоста.
ht_id
Тип: число. Идентификатор уровня, который показывает распределение дохода между издателем и хостом.
Пример: &ht_id=2 – хост второго уровня.
hl
Тип: строка. Код языка. Указывается в запросах, чтобы получать объявления на нужном языке. Может быть представлен в формате ISO 639-1 (две буквы) или ISO 639-2 (три буквы). Допустимые коды перечислены здесь.
Пример:
- &hl=en – английский.
- &hl=es – испанский.
max_ad_duration
Тип: целое число. Указывает максимальную продолжительность возвращаемого видео в миллисекундах. Если значение не задано, по умолчанию оно равно 100 секундам.
Пример: &max_ad_duration=30000 – максимальная продолжительность объявления без возможности пропуска равняется 30 секундам.
min_ad_duration
Тип: целое число. Указывает минимальную продолжительность возвращаемого видео в миллисекундах. Если значение не указано, предполагается, что продолжительность – 0 секунд.
Пример:
- &min_ad_duration=15000 – продолжительность возвращаемого видео без возможности пропуска должна быть не менее 15 секунд.
- &min_ad_duration=0 – продолжительность будет ограничиваться лишь значением max_ad_duration.
sdmax
Тип: целое число. Указывает максимальную продолжительность видео для объявлений с возможностью пропуска в миллисекундах. По умолчанию продолжительность не ограничена.
Пример: &sdmax=120000 – продолжительность возвращаемого объявления с возможностью пропуска не может превышать двух минут.
overlay
Тип: целое число. Используется для ограничения размера оверлея только до нелинейного оверлея в нижней трети видеоконтента. По умолчанию ограничения отсутствуют
Пример:
- &overlay=1 – в запросе объявлений допускаются только оверлеи размером не более 1/3 размера видеоконтента. Оверлеи, занимающие все рекламное место, нельзя запросить.
- &overlay=0 – значение по умолчанию. Ограничение на размер оверлея не задано. При показе размеры оверлеев определяются параметрами AdsRequest.nonLinearAdSlotWidth и adsRequest.nonLinearAdSlotHeight.