Начать

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

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

Предварительные условия

• Используйте Unity 2019.4 или новее.
• Развертывание на iOS
  • Xcode 16.0 или выше
  • Целевая iOS 12.0 или более поздняя версия
  • Какао-стручки
• Развертывание на Android
  • Минимальный уровень Android API 23 или выше.
  • Целевой Android API уровня 34 или выше.

• Рекомендуется: создайте учетную запись AdMob и зарегистрируйте приложение для Android или iOS.

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

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

OpenUPM-CLI

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

openupm add com.google.ads.mobile

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

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

• Активы/ExternalDependencyManager
• Активы/GoogleMobileAds
• Активы/Плагины/Android/googlemobileads-unity.aar
• Активы/Плагины/Android/GoogleMobileAdsPlugin
• Активы/Плагины/iOS/GADUAdNetworkExtras
• Активы/Плагины/iOS/unity-plugin-library.a

ОпенУПМ

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

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 :

• Активы/ExternalDependencyManager
• Активы/GoogleMobileAds
• Активы/Плагины/Android/googlemobileads-unity.aar
• Активы/Плагины/Android/GoogleMobileAdsPlugin
• Активы/Плагины/iOS/GADUAdNetworkExtras
• Активы/Плагины/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.

Важно! Используйте последнюю версию Google Mobile Ads SDK, чтобы иметь доступ ко всем функциям соблюдения конфиденциальности.

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

Андроид

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

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

В редакторе Unity выберите «Активы» > «Диспетчер внешних зависимостей» > «Android Resolver» > «Разрешить» , чтобы библиотека Unity «Диспетчер внешних зависимостей» скопировала объявленные зависимости в каталог 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() . Это необходимо сделать только один раз, в идеале при запуске приложения.

Внимание! Объявления могут быть предварительно загружены с помощью Google Mobile Ads SDK или SDK партнеров-посредников после вызова MobileAds.Initialize() . Если вам необходимо получить согласие от пользователей в Европейской экономической зоне (ЕЭЗ), установите любые флаги, специфичные для запроса, например tagForChildDirectedTreatment или tag_for_under_age_of_consent , или выполните иное действие перед загрузкой рекламы. Обязательно сделайте это перед инициализацией Google Mobile Ads SDK.

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

Баннер

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

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

Межстраничный

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

Внедрите межстраничную рекламу

Родной

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

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

Награжден

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

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

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

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

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

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

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

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

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

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