Краткое техническое руководство по началу работы с AdSense для игр

В этом руководстве рассказывается, как интегрировать пакет IMA HTML5 SDK от Google для показа рекламы в браузерных играх на базе HTML5 с помощью AdSense.

Общие сведения о настройке

Для показа объявлений AdSense для игр используется технология Google Interactive Media Ads Software Development Kit (IMA HTML5 SDK). Этот пакет SDK позволяет запрашивать объявления AdSense с помощью JavaScript и обеспечивает тесную интеграцию контента и рекламы.

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

Запрос и показ объявлений с помощью IMA HTML5 SDK происходит следующим образом: вначале создается запрос объявления, затем полученное объявление загружается и в нужное время воспроизводится. Для тестирования интеграции можно использовать идентификатор издателя по умолчанию ca-games-pub-4968145218643279.

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

Доступны два варианта интеграции: простая и расширенная.

Простая интеграция

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

Если вы хотите использовать простую интеграцию, подайте заявку.

Расширенная интеграция

Если вам нужна интеграция с более широкими возможностями настройки, вам необходимо реализовать в своей игре на базе HTML5 полнофункциональное решение на основе IMA HTML5 SDK. Такое решение будет более гибким (например, оно позволит использовать некоторые функции Google Менеджера рекламы), но и более сложным.

Как начать расширенную интеграцию

Сначала интегрируйте IMA HTML5 SDK в свою игру.

1. Настройка интеграции IMA HTML5 SDK

   Настройте интеграцию IMA HTML5 SDK с игрой согласно рекомендациям на сайте Google Developers. Рекомендуем использовать следующие статьи: Начало работы, Пример кода и Полный справочник по API.

2. Настройка контейнера объявлений (AdDisplayContainer)

   Поскольку IMA HTML5 SDK подходит как для видео, так и для игр, объект AdDisplayContainer можно настроить несколькими способами.

   Чтобы настроить объект AdDisplayContainer для работы с AdSense для игр, просто передайте ссылку на раздел div, где будет содержаться объявление.

   Пример:

   var adDisplayContainer = new google.ima.AdDisplayContainer(document.getElementById('adContainer'));

3. Настройка запроса объявления (AdsRequest)

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

   Пример:

   // Запрос объявлений AdSense для игр
var adsRequest = new google.ima.AdsRequest();
 
// Настройка тега объявлений AdSense для игр
adsRequest.adTagUrl = 'https://googleads.g.doubleclick.net/pagead/ads?ad_type=video_image_text&client=ca-games-pub-4968145218643279&videoad_start_delay=0&description_url=http%3A%2F%2Fwww.google.com&max_ad_duration=20000&adtest=on';
 
// Принудительный показ графических или текстовых объявлений на все рекламное место
adsRequest.forceNonLinearFullSlot = true;
 
// Указание размеров линейных и нелинейных рекламных мест
adsRequest.linearAdSlotWidth = {ширина_блока_игры};
adsRequest.linearAdSlotHeight = {высота_блока_игры};
adsRequest.nonLinearAdSlotWidth = {ширина_блока_игры};
adsRequest.nonLinearAdSlotHeight = {высота_блока_игры};

4. Настройка ожидания событий и создание обратных вызовов

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

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

   Название события	Описание
   AdEvent.Type.CLICK	Вызывается, когда пользователь нажимает на объявление.
   AdEvent.Type.COMPLETE	Вызывается, когда воспроизведение объявления завершено.
   AdEvent.Type.LOADED	Вызывается, когда объявление готово к показу.
   AdEvent.Type.SKIPPED	Вызывается, когда пользователь пропускает объявление.
   AdEvent.Type.START	Вызывается, когда начинается воспроизведение объявления.
   AdEvent.Type.USER_CLOSE	Вызывается, когда пользователь закрывает объявление.
   AdErrorEvent.Type.AD_ERROR	Вызывается, когда возникает ошибка. Существует множество типов ошибок: например, сбой при загрузке файлов объявления или получение пустого ответа на запрос объявления. Полный список возможных ошибок приведен в справочнике по API.