Как настроить плагин Google Mobile Ads для Unity

Выберите платформу: Android iOS Unity Flutter Android (устаревшая версия)

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

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

Требования

  • Используйте Unity Editor 2019.4 или более позднюю версию.
    • Рекомендуем использовать версию 2022.2 или более позднюю.
  • Чтобы развернуть приложение на устройстве iOS:
    • Xcode 16.0 или более поздней версии.
    • Целевая ОС – iOS 13.0 или более поздняя версия.
    • CocoaPods
  • Чтобы развернуть приложение на устройстве Android:
    • Минимальный уровень API Android 24 или выше
    • Целевой уровень API Android 35 или более поздний

Уровень API Android задается в разделе Project Settings > Player > Android > Other Settings > Other Settings.

Как импортировать плагин Mobile Ads для Unity

OpenUPM-CLI

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

openupm add com.google.ads.mobile

Как удалить объекты плагина .unitypackage

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

  • Assets/ExternalDependencyManager
  • Assets/GoogleMobileAds
  • Assets/Plugins/Android/googlemobileads-unity.aar
  • Assets/Plugins/Android/GoogleMobileAdsPlugin
  • Assets/Plugins/iOS/GADUAdNetworkExtras
  • Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM с интерфейсом

  1. Откройте настройки менеджера пакетов, выбрав в меню Unity Edit > Project Settings > Package Manager (Правка > Настройки проекта > Менеджер пакетов).

  2. Добавьте OpenUPM в качестве реестра с областью действия в окне Package Manager (Менеджер пакетов):

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

  3. Откройте меню менеджера пакетов, выбрав в меню Unity Window > Package Manager (Окно > Менеджер пакетов).

  4. В раскрывающемся списке выберите Мои реестры.

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

Как удалить объекты плагина .unitypackage

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

  • Assets/ExternalDependencyManager
  • Assets/GoogleMobileAds
  • Assets/Plugins/Android/googlemobileads-unity.aar
  • Assets/Plugins/Android/GoogleMobileAdsPlugin
  • Assets/Plugins/iOS/GADUAdNetworkExtras
  • Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM

  1. Получите тег версии последнего выпуска. Тег, возвращенный без префикса v, является версией Google Mobile Ads Unity Plugin.

    • macOS и Linux

      curl -sS https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest | jq -r '.tag_name'

    • Windows PowerShell

      (Invoke-RestMethod -Uri "https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest").tag_name

  2. Измените файл Packages/manifest.json, чтобы добавить реестр OpenUPM с областью действия и зависимость, используя версию, полученную с помощью предыдущей команды:

    {
  "scopedRegistries": [
    {
      "name": "google",
      "url": "https://package.openupm.com",
      "scopes": [
        "com.google"
      ]
    }
  ],
  "dependencies": {
    "com.google.ads.mobile": "11.5.0"
  }
}

Как удалить объекты плагина .unitypackage

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

  • Assets/ExternalDependencyManager
  • Assets/GoogleMobileAds
  • Assets/Plugins/Android/googlemobileads-unity.aar
  • Assets/Plugins/Android/GoogleMobileAdsPlugin
  • Assets/Plugins/iOS/GADUAdNetworkExtras
  • Assets/Plugins/iOS/unity-plugin-library.a

Как импортировать данные из GitHub

  1. Скачайте выпуск .unitypackage с GitHub.
  2. Импортируйте файл .unitypackage, выбрав в меню Unity Assets > Import package > Custom Package и импортировав все объекты.

Как задать идентификатор приложения AdMob

В редакторе Unity выберите в меню Assets > Google Mobile Ads > Settings (Объекты > Мобильные объявления в Google > Настройки).

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

Google Mobile Ads Unity Plugin сохраняет эти настройки в виде текста в файле конфигурации Assets/GoogleMobileAds/Resources/GoogleMobileAdsSettings.asset.

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

Перед загрузкой объявлений инициализируйте Google Mobile Ads Unity Plugin в приложении, вызвав 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.");

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects on the main thread here.
    });
});

Взаимодействие с объектами Unity в основном потоке

Google Mobile Ads Unity Plugin вызывает события объявлений в фоновом потоке. Если обратные вызовы объявлений взаимодействуют с объектами Unity, например UnityEngine, явно запланируйте эту работу в основном потоке Unity, используя метод MobileAdsEventExecutor.ExecuteInUpdate. Подробнее о том, как вызывать события объявлений в основном потоке Unity…

Выберите формат объявления

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

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

Как размещать баннеры

Межстраничное объявление

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

Как размещать межстраничные объявления

Стандартное

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

Как размещать нативные объявления

Бонус предоставлен

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

Как реализовать объявления с вознаграждением

Межстраничные объявления с вознаграждением

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

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

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

Как добавить межстраничные объявления с вознаграждением

Запуск приложения

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

Как реализовать объявления при запуске приложения