--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://ads.yandex.com/helpcenter/en/easy/integration/unity/formats/UI-inspector.md - https://ads.yandex.com/helpcenter/ru/easy/integration/unity/formats/UI-inspector.md - https://ads.yandex.com/helpcenter/zh/easy/integration/unity/formats/UI-inspector.md - href: ru/easy/integration/unity/formats/UI-inspector.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://ads.yandex.com/helpcenter/ru/llms.txt # Настройка форматов через UI Inspector Перед настройкой установите [пакет Yandex MobileAds SDK](https://ads.yandex.com/helpcenter/ru/easy/integration/unity/integration/mediation.md). ## Добавление форматов через UI Inspector {#add} 1. Откройте наш [репозиторий в GitHub](https://github.com/yandexmobile/yandex-ads-unity-plugin/releases) и скачайте архив `Source code.zip`. В этом архиве находится папка `samples` c четыремя тестовыми файлами разных форматов: - Реклама при открытии приложения; - Реклама с вознаграждением; - баннер; - Межстраничная реклама. 2. Перенесите все файлы в папку `Assets` в проекте Unity или через вкладку **Inspector** — `Add Component/Yandex Ads/[тип баннера]`. После этого можно прикреплять компоненты на одну из сцен для тестирования функционала: ![](https://doc-static.yandex.net/support/RSYA-RMP/gif/unity_demo_samples_setup.gif) {% cut "Баннер" %} **Уникальные настройки баннера** - Виды баннеров — 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` | Показ рекламы засчитан || |# {% endcut %} {% cut "Межстраничная реклама" %} #| || **Событие** | **Действия, вызывающие событие** || || `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` | Не удалось показать рекламу || |# {% endcut %} {% cut "Реклама с вознаграждением" %} #| || **Событие** | **Действия, вызывающие событие** || || `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` | За показ рекламы выдано вознаграждение || |# {% endcut %} {% cut "Реклама при открытии приложения" %} **Уникальные настройки баннера** - `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) || |# {% endcut %} ## Термины {#terms} **Холодный старт** — старт приложения при отсутствии его в оперативной памяти, создание новой сессии приложения. **Горячий старт** — перевод приложения из фонового режима (background mode), когда приложение приостановлено в оперативной памяти, в активный режим (foreground mode). ## Особенности подключения рекламы при открытии приложения - Загрузка может занимать продолжительное время, поэтому не стоит увеличивать время холодного старта, если реклама не загрузилась. - Заранее предзагружайте объявление для последующего показа при горячем старте - Не рекомендуется одновременно загружать рекламу App Open Ad и другие форматы рекламы при старте приложения, так как приложение в этот момент может скачивать необходимые для работы данные. Это может перегрузить устройство и интернет-соединение, делая загрузку рекламы более долгой. - Если вы получили ошибку в событии `OnAdFailedToLoad`, не пытайтесь загрузить новое объявление снова. Если все же необходимо это сделать, ограничьте число повторных попыток загрузки рекламы — это поможет избежать постоянных неудачных запросов и проблем с подключением в случае ограничений. ## Общие настройки баннеров {#common-settings} - Имя компонента — может быть любым, не влияет на функционал. - `Ad Unit Id`: - **development mode** — для работы с [демоблоками](https://ads.yandex.com/helpcenter/ru/easy/integration/unity/testing.md#blocks). - **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 методы с нужной сигнатурой для параметризованных вызовов. Пример: ```C# public void InterstitialSomeMethod(string message) { Debug.Log("Interstitial show msg: " + message); } ```