Начать

Выберите платформу: 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 :

  • Активы/Внешний менеджер зависимостей
  • Активы/GoogleMobileAds
  • Активы/Плагины/Android/googlemobileads-unity.aar
  • Активы/Плагины/Android/GoogleMobileAdsPlugin
  • Активы/Плагины/iOS/GADUAdNetworkДополнения
  • Активы/Плагины/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 для Unity из списка пакетов и нажмите « Установить» .

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

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

  • Активы/Внешний менеджер зависимостей
  • Активы/GoogleMobileAds
  • Активы/Плагины/Android/googlemobileads-unity.aar
  • Активы/Плагины/Android/GoogleMobileAdsPlugin
  • Активы/Плагины/iOS/GADUAdNetworkДополнения
  • Активы/Плагины/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() . Это нужно сделать только один раз, в идеале при запуске приложения.

Вот пример того, как вызвать Initialize() внутри метода Start() скрипта, прикрепленного к GameObject :

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(initStatus => { });
    }
}

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

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

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

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

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

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

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

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

Родной

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

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

Награжден

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

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

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

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

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

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

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

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

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

Внедрите рекламу при открытии приложения

,
Выберите платформу: 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 :

  • Активы/Внешний менеджер зависимостей
  • Активы/GoogleMobileAds
  • Активы/Плагины/Android/googlemobileads-unity.aar
  • Активы/Плагины/Android/GoogleMobileAdsPlugin
  • Активы/Плагины/iOS/GADUAdNetworkДополнения
  • Активы/Плагины/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 для Unity из списка пакетов и нажмите « Установить» .

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

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

  • Активы/Внешний менеджер зависимостей
  • Активы/GoogleMobileAds
  • Активы/Плагины/Android/googlemobileads-unity.aar
  • Активы/Плагины/Android/GoogleMobileAdsPlugin
  • Активы/Плагины/iOS/GADUAdNetworkДополнения
  • Активы/Плагины/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() . Это нужно сделать только один раз, в идеале при запуске приложения.

Вот пример того, как вызвать Initialize() внутри метода Start() скрипта, прикрепленного к GameObject :

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(initStatus => { });
    }
}

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

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

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

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

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

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

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

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

Родной

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

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

Награжден

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

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

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

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

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

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

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

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

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

Внедрите рекламу при открытии приложения