Структура тегов в AdSense для видео и AdSense для игр значительно отличается от используемой в AdSense для контента. Чтобы эти платформы работали, требуется тег для интерактивной медиарекламы (IMA). Система будет показывать объявления только при вызове из проигрывателя или загрузчика игры, интегрированного с SDK IMA или совместимого с 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 | Нет |
Базовый 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-games-pub-4968145218643279
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 – продолжительность возвращаемого объявления с возможностью пропуска не может превышать двух минут.
