AdSense для игр

Параметры тегов IMA в AdSense для игр

Структура тегов в 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 – продолжительность возвращаемого объявления с возможностью пропуска не может превышать двух минут.


Эта информация оказалась полезной?
Как можно улучшить эту статью?

Требуется помощь?

Войдите в свой аккаунт, чтобы мы могли предоставить вам дополнительные варианты поддержки и быстрее решить вашу проблему.