AdSense для игр

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

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

Краткий обзор

Для показа объявлений 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 для игр.

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

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

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

О том, как реализовать расширенную интеграцию с помощью IMA HTML5 SDK, читайте далее в этой статье.

Расширенная интеграция с помощью IMA HTML5 SDK: начало работы

Первый шаг – это интеграция SDK IMA HTML5 в вашей игре.

  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, убедитесь, что вы правильно настроили нужные параметры и свойства, чтобы объявления предоставлялись и отображались корректно.

    Пример:

    // Request AdSense for games ads.
    var adsRequest = new google.ima.AdsRequest();
     
    // Setup AdSense for games ad tag
    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';
     
    // Force image/text ads to render with Full-Slot UI
    adsRequest.forceNonLinearFullSlot = true;
     
    // Specify the linear and nonlinear slot sizes.
    adsRequest.linearAdSlotWidth = {your_game_width};
    adsRequest.linearAdSlotHeight = {your_game_height};
    adsRequest.nonLinearAdSlotWidth = {your_game_width};
    adsRequest.nonLinearAdSlotHeight = {your_game_height};

  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.

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

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

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