Начать

Выберите платформу: Android iOS Unity Flutter

Плагин Google Mobile Ads для Unity позволяет разработчикам Unity показывать мобильную рекламу Google в приложениях Android и iOS без необходимости написания кода на Java или Objective-C. Плагин предоставляет интерфейс C# для запроса рекламы, который используется скриптами C# в вашем проекте Unity.

Это руководство предназначено для издателей, желающих монетизировать приложение Unity.

Предпосылки

  • Используйте Unity Editor 2019.4 или выше.
  • Для развертывания на iOS
    • Xcode 16.0 или выше
    • Целевая версия iOS 12.0 или выше
    • CocoaPods
  • Для развертывания на Android
    • Минимальный уровень Android API — 23 или выше
    • Целевой уровень Android API 34 или выше

Уровень API Android настраивается в разделе «Настройки проекта» > «Проигрыватель» > «Android» > «Другие настройки» > «Другие настройки» .

Импортируйте плагин Mobile Ads for Unity

OpenUPM-CLI

Если у вас установлен OpenUPM CLI , вы можете установить реестр OpenUPM с помощью следующей команды:

openupm add com.google.ads.mobile

Удалить ресурсы плагина .unitypackage

При переходе с использования .unitypackage на использование OpenUPM необходимо вручную удалить ресурсы из старого расположения. Удалите следующие каталоги, импортированные из .unitypackage :

  • Assets/ExternalDependencyManager
  • Активы/GoogleMobileAds
  • Assets/Plugins/Android/googlemobileads-unity.aar
  • Активы/Плагины/Android/GoogleMobileAdsPlugin
  • Активы/Плагины/iOS/GADUAdNetworkДополнения
  • Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM

  1. Откройте настройки менеджера пакетов , выбрав пункт меню Unity Правка > Настройки проекта > Менеджер пакетов .

  2. Добавьте OpenUPM как область реестра в окно диспетчера пакетов:

    Name: OpenUPM
URL: https://package.openupm.com
Scopes: com.google

  3. Откройте меню менеджера пакетов , выбрав в меню Unity пункт Окно > Менеджер пакетов .

  4. В раскрывающемся списке области действия менеджера выберите «Мои реестры» .

  5. Выберите пакет Google Mobile Ads for Unity из списка пакетов и нажмите «Установить» .

Удалить ресурсы плагина .unitypackage

При переходе с использования .unitypackage на использование OpenUPM необходимо вручную удалить ресурсы из старого расположения. Удалите следующие каталоги, импортированные из .unitypackage :

  • Assets/ExternalDependencyManager
  • Активы/GoogleMobileAds
  • Assets/Plugins/Android/googlemobileads-unity.aar
  • Активы/Плагины/Android/GoogleMobileAdsPlugin
  • Активы/Плагины/iOS/GADUAdNetworkДополнения
  • Assets/Plugins/iOS/unity-plugin-library.a

Импорт из GitHub

  1. Загрузите последнюю версию .unitypackage с GitHub.
  2. Импортируйте файл .unitypackage , выбрав пункт меню Unity «Активы» > «Импорт пакета» > «Пользовательский пакет» и импортировав все элементы.

Включить внешние зависимости

Плагин Google Mobile Ads для Unity распространяется вместе с библиотекой Unity Play Services Resolver . Эта библиотека предназначена для использования любым плагином Unity, которому требуется доступ к библиотекам Android, таким как AAR или iOS CocoaPods. Она предоставляет плагинам Unity возможность объявлять зависимости, которые затем автоматически разрешаются и копируются в ваш проект Unity.

Выполните следующие шаги, чтобы убедиться, что ваш проект включает все зависимости:

Андроид

Перейдите в Настройки проекта > Плеер > Android > Настройки публикации > Сборка и выберите:

  • Пользовательский основной шаблон Gradle
  • Пользовательский шаблон свойств Gradle

В редакторе Unity выберите Assets > External Dependency Manager > Android Resolver > Resolve, чтобы библиотека Unity External Dependency Manager скопировала объявленные зависимости в каталог Assets/Plugins/Android вашего приложения Unity.

iOS

Unity для iOS использует CocoaPods для определения и управления зависимостями. Ознакомьтесь с документацией CocoaPods, чтобы узнать о конкретных требованиях или инструкциях по устранению неполадок, связанных с зависимостями iOS.

Зависимости плагина Google Mobile Ads Unity перечислены в Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml .

Установите идентификатор вашего приложения AdMob

В редакторе Unity выберите в меню Активы > Google Mobile Ads > Настройки .

Введите идентификатор приложения AdMob для Android и iOS в каждое поле.

Инициализируйте SDK

Перед загрузкой рекламы ваше приложение должно инициализировать Google Mobile Ads SDK, вызвав MobileAds.Initialize() . Это необходимо сделать только один раз, в идеале при запуске приложения.

Вот пример вызова MobileAds.Initialize() :

MobileAds.Initialize((InitializationStatus initstatus) =>
{
    if (initstatus == null)
    {
        Debug.LogError("Google Mobile Ads initialization failed.");
        return;
    }

    Debug.Log("Google Mobile Ads initialization complete.");

    // Google Mobile Ads events are raised off the Unity Main thread. If you need to
    // access UnityEngine objects after initialization,
    // use MobileAdsEventExecutor.ExecuteInUpdate(). For more information, see:
    // https://developers.google.com/admob/unity/global-settings#raise_ad_events_on_the_unity_main_thread
});
GoogleMobileAdsController.cs

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

Выберите формат рекламы

Google Mobile Ads SDK теперь включен в ваше приложение Unity при развертывании на платформах Android и iOS. Теперь вы готовы к размещению рекламы. AdMob предлагает множество различных форматов рекламы, поэтому вы можете выбрать тот, который обеспечит наилучший пользовательский опыт.

Баннерные рекламные блоки отображают прямоугольные объявления, занимающие часть макета приложения. Они могут автоматически обновляться через заданный промежуток времени. Это означает, что пользователи видят новую рекламу через регулярные промежутки времени, даже оставаясь на одном и том же экране вашего приложения. Кроме того, это самый простой в реализации формат рекламы.

Внедрение баннерной рекламы

Интерстициальный

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

Внедрение межстраничной рекламы

Родной

Нативная реклама — это реклама, в которой вы можете настраивать отображение таких элементов, как заголовки и призывы к действию, в своих приложениях. Создавайте естественные, ненавязчивые рекламные объявления, которые сделают ваш опыт взаимодействия с пользователем более насыщенным.

Внедрите нативную рекламу

Награжден

Рекламные блоки с вознаграждением позволяют пользователям играть в игры, проходить опросы или смотреть видео, зарабатывая внутриигровые награды, такие как монеты, дополнительные жизни или баллы. Вы можете установить разные награды для разных рекламных блоков и указать их стоимость и предметы, которые получит пользователь.

Внедрение объявлений с вознаграждением

Вознагражденный интерстициальный

Вознаграждаемая полноэкранная реклама — это новый тип формата поощрительной рекламы, который позволяет предлагать вознаграждения, например монеты или дополнительные жизни, за рекламу, которая автоматически появляется во время естественных переходов в приложении.

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

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

Внедрение вознагражденной межстраничной рекламы

Приложение открыто

Открытие приложения — это формат рекламы, который появляется при открытии приложения или переходе обратно в него. Реклама накладывается на экран загрузки.

Реализуйте рекламу при открытии приложения