icon

Appodeal

Для модуля рекламной медиации необходимо установить «Plugin Your Games 2.0».
Обязательные разделы документации к изучению «Начало работы» и «Платформы».

Получить модуль рекламной медиации можно в Unity Asset Store или на Boosty.

Appodeal — зарегистрированная торговая марка её правообладателя. Данный проект не связан с Appodeal и не является официальным продуктом. Логотип используется исключительно в информационных целях.

Описание Appodeal

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

Appodeal можно использовать на Android и IOS устройствах, в Google Play, Ru Store и в других аналогичных сторах. Чтобы настроить модуль плагина вам нужно только лишь вставить ключ приложения в соответствующее поле. Остальное — это установить сам SDK Appodel, установить пакет EDM и настроить проект в соответствии с документацией Appodeal. Ниже вы сможете найти короткое разъяснение как это сделать!

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

Заполнить реквизиты для выплаты вам потребуется всего один раз, так как они производятся только через Appodeal, а не от нескольких рекламных сетей. Но в некоторых регионах могут быть трудности с выводом средств, посмотрите условия на официальном сайте, чтобы узнать, подойдут ли они вам.

Помощь в установке SDK Appodeal

Помимо прочтения этой документации, также внимательно прочтите и документацию от Appodeal!

Чтобы не наткнуться на ошибку во время импорта необходимых пакетов, проверьте через Unity Package Manager не установлен ли в вашем проекте пакет Advertisement/Advertisement Legacy Package Manager. Если установлен — удалите.

Сначала необходимо установить EDM (External Dependency Manager) — это инструмент для Unity, который управляет зависимостями плагинов и автоматически загружает нужные библиотеки для Android и IOS. Установите EDM именно .tgz формата и версию как указано в документации Appodeal.

В документации Appodeal мы видим два раздела: UPM дистрибьюция и Manual дистрибьюция. Обязательно выберите вкладку UPM дистрибьюция, которая содержит ссылку на установку новейшей версии SDK Appodeal. Версия Manual отличается и PluginYG её не поддерживает.

Если на вашем компьютере не установлен Git, скачайте его, установите и перезапустите компьютер. После чего вы сможете установить пакет по ссылке, следуя документации Appodeal.

Далее из важного, необходимо изменить версию gradle с помощью корректировки файла, настроить параметры gradle в Player Settings, настроить EDM, для IOS включить разрешение NSAppTransportSecurity.

Чтобы билд собрался и заработал, обязательно требуется либо сразу получить ID от AdMob и заполнить соответствующие поля в настройках Appodeal. Либо отключить AdMob в проекте. Это вполне сгодится, чтобы протестировать приложение. Зайдите в Dependency Manager, отключите Google AdMob и Google Ad Manager и нажмите кнопку Generate. После этого, вы наконец сможете собрать рабочий билд! Но перед началом сборки не соглашайтесь на предложение обновить gradle. Если случайно согласитесь, то снова скорректируйте файл формирующий версию gradle.

У Appodeal есть ещё настройка рекламных сетей, водопадов и прочего, рекомендую вам самостоятельно разобраться в этой теме и качественно настроить проект в конечном итоге.

Чтобы быстро и удобно собирать билды на Android, рекомендую обратить внимание на мой инструмент Android Wi-Fi Connect (ADB Build)

Настройки модуля

Чтобы интегрировать модуль Appodeal в вашу игру, вам необходимо скопировать ключ приложения из личного кабинета Appodeal и вставить его в поле Appodeal App Key в настройках платформы. Это всё что требуется для интеграции самого модуля. Ниже изображение с данным полем, в котором вы сможете посмотреть для примера и другие настройки платформы:
icon
Эти настройки идут по умолчанию. Но настройки по умолчанию не относятся к галочкам слева. Этими галочками можно активировать или деактивировать внесение изменения в ту или иную опцию в списке. Эти галочки имеют одно состояние для всех платформ! Чтобы была возможность выбрать разные параметры для разных платформ. Подробнее читайте в разделе Платформы.

Show First Adv = false — не желательно вызывать рекламу при старте, т.к. она может долго грузиться и открыться в неподходящий момент. Но она будет работать даже при выключенном автоматическом кешировании рекламы.
Save Cloud = false — облачные сохранения выключаем.
Save Local = true — локальные сохранения можете включить, они работают!
Auto Pause Game = false — можно выключить, потому что Appodeal имеет собственную реализацию отключения звука и остановки игры во время просмотра рекламы.
Archiving Build = false — для Appodeal скорее всего мы создаём apk или aap, по этому архивация не нужна.

Поля расположенные ниже (Общие настройки):
Appodeal Testing — оставьте эту опцию включённой на время разработки и тестирования. Перед релизом уберите эту галку, убедитесь, что настоящие показы рекламы работают и тогда можно отправляться в релиз.
Appodeal Auto Cache Adv — автоматическая загрузка и кеширование рекламных объявлений. Когда данная опция включена, вам достаточно только выполнять методы вызова рекламы, но в таком случае контроля над кешированием объявлений нет, что может хуже сказаться на оптимизации приложения. Если хотите ручной контроль, выполняйте метод загрузки рекламы и по желанию воспользуйтесь событиями завершения загрузки рекламного объявления:

YG2.optionalPlatform.LoadInterAdv()
YG2.optionalPlatform.LoadRewardedAdv()
YG2.optionalPlatform.onLoadedInterAdv
YG2.optionalPlatform.onLoadedRewardedAdv
Также есть события клика по рекламе:
YG2.optionalPlatform.onClickedInterAdv
YG2.optionalPlatform.onClickedRewardedAdv

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

Подробнее о том, Какие модули поддерживает та или иная платформа