Настройка форматов через UI Inspector

Перед настройкой установите пакет Yandex MobileAds SDK.

Добавление форматов через UI Inspector

  1. Откройте наш репозиторий в GitHub и скачайте архив Source code.zip. В этом архиве находится папка samples c четыремя тестовыми файлами разных форматов:

    • Реклама при открытии приложения;
    • Реклама с вознаграждением;
    • Адаптивный баннер;
    • Межстраничная реклама.

  2. Перенесите все файлы в папку Assets в проекте Unity или через вкладку Inspector — Add Component/Yandex Ads/[тип баннера]. После этого можно прикреплять компоненты на одну из сцен для тестирования функционала:

Адаптивный баннер

Уникальные настройки баннера

  • Виды баннеров — Inline, Sticky.
  • Настройка позиции относительно экрана (Banner Position).
  • Ширина по размеру экрана (Use Screen Width).

Событие

Действия, вызывающие событие

On Ad Successfully Loaded

Завершение загрузки рекламы

On Ad Failed To Load

Не удалось загрузить рекламу

On User Left Application

Пользователь покидает приложение после клика по рекламе

On User Returned To Application

Пользователь возвращается в приложение после клика по рекламе

On Ad Clicked

Пользователь кликает на рекламу

On Ad Impression Recorded

Показ рекламы засчитан
Межстраничная реклама

Событие

Действия, вызывающие событие

On Ad Successfully Loaded

Завершение загрузки рекламы

On Ad Failed To Load

Не удалось загрузить рекламу

On Dismissed

Закрытие рекламы

On Ad Clicked

Пользователь кликает на рекламу

On Ad Impression Recorded

Показ рекламы засчитан

On Ad Shown

Показ рекламы

On Ad Failed To Show

Не удалось показать рекламу
Реклама с вознаграждением

Событие

Действия, вызывающие событие

On Ad Successfully Loaded

Завершение загрузки рекламы

On Ad Failed To Load

Не удалось загрузить рекламу

On Dismissed

Закрытие рекламы

On Ad Clicked

Пользователь кликает на рекламу

On Ad Impression Recorded

Показ рекламы засчитан

On Ad Shown

Показе рекламы

On Ad Failed To Show

Не удалось показать рекламу

On Rewarded

За показ рекламы выдано вознаграждение
Реклама при открытии приложения

Уникальные настройки баннера

  • Show AppOpenAd Once — показывать только один раз за сессию

Событие

Действия, вызывающие событие

On Ad Successfully Loaded

Завершение загрузки рекламы

On Ad Failed To Load

Не удалось загрузить рекламу

On Dismissed

Закрытие рекламы

On Ad Clicked

Пользователь кликает на рекламу

On Ad Impression Recorded

Показ рекламы засчитан

On Ad Shown

Показ рекламы

On Ad Failed To Show

Не удалось показать рекламу

On App State Change

Приложение переходит или выходит в фоновый режим (background mode)

Термины

Холодный старт — старт приложения при отсутствии его в оперативной памяти, создание новой сессии приложения.

Горячий старт — перевод приложения из фонового режима (background mode), когда приложение приостановлено в оперативной памяти, в активный режим (foreground mode).

Особенности подключения рекламы при открытии приложения

  • Загрузка может занимать продолжительное время, поэтому не стоит увеличивать время холодного старта, если реклама не загрузилась.
  • Заранее предзагружайте объявление для последующего показа при горячем старте
  • Не рекомендуется одновременно загружать рекламу App Open Ad и другие форматы рекламы при старте приложения, так как приложение в этот момент может скачивать необходимые для работы данные. Это может перегрузить устройство и интернет-соединение, делая загрузку рекламы более долгой.
  • Если вы получили ошибку в событии OnAdFailedToLoad, не пытайтесь загрузить новое объявление снова. Если все же необходимо это сделать, ограничьте число повторных попыток загрузки рекламы — это поможет избежать постоянных неудачных запросов и проблем с подключением в случае ограничений.

Общие настройки баннеров

  • Имя компонента — может быть любым, не влияет на функционал.

  • Ad Unit Id:

    • development mode — для работы с демоблоками.

    • production mode — для работы с R-M-XXXXXX-Y (уточните реальный ID в интерфейсе Рекламной сети Яндекса). R-M-XXXXXX-Y — это вид рабочего рекламного ID, по которому будут приходить разные креативы.

  • Настройка опций загрузки и показа:

    • Auto Load — моментальная загрузка при автоматической инициализации SDK.
    • Show After Loading — моментальный показ после загрузки рекламы.

  • Публичные методы компонентов идентичны:

    • Load() — ручная загрузка рекламы.
    • Show() — ручной показ рекламы.
    • onDestroy() — удаление рекламного объекта.

  • Обработка событий через Unity Inspector — все события можно связать с методами своих скриптов через инспектор. Нажмите значок плюса, выберите объект и нужный метод.

  • Для всех событий можно создавать public void методы с нужной сигнатурой для параметризованных вызовов.

    Пример:

    public void InterstitialSomeMethod(string message) {
    Debug.Log("Interstitial show msg: " + message);
}
Предыдущая
Ченджлог
Следующая
Реклама при открытии приложения