В этом руководстве показано, как использовать GMA Next-Gen SDK для загрузки и отображения рекламы из maio с помощью AdMob Mediation , включая интеграцию по принципу водопада. Также описано, как добавить maio в конфигурацию медиации рекламного блока и как интегрировать SDK и адаптер maio в приложение для Android.
В интерфейсе панели управления maio для надписей, кнопок и описаний используется японский текст, а скриншоты в этом руководстве не переведены. Однако в описаниях и инструкциях этого руководства надписи и кнопки снабжены их английскими эквивалентами. Например, "URL スキーム" означает "URL Scheme".
Поддерживаемые интеграции и форматы рекламы
Адаптер для посредничества на платформе Maio обладает следующими возможностями:
| Интеграция | |
|---|---|
| Торги | |
| Водопад | |
| Форматы | |
| Баннер | |
| Интерстициальный | |
| Награжден | |
| Родной | |
Требования
- Android API уровня 24 или выше
- maio SDK 1.0.7 или выше
Новейшая версия GMA Next-Gen SDK .
Пройдите руководство по началу процесса медиации.
Шаг 1: Настройка параметров в пользовательском интерфейсе Maio.
Сначала зарегистрируйтесь или войдите в свою учетную запись maio. Нажмите кнопку « Управление приложениями» на левой боковой панели и выберите «Новое приложение» .

Выберите вкладку, соответствующую предпочитаемому вами типу объявления .
Интерстициальный
Введите название вашего приложения, выберите платформу и укажите URL-адрес вашего приложения . Выберите тип рекламы «Видеоинтерстициальная реклама », а затем нажмите «Обновить» .

Награжден
Введите название вашего приложения, выберите платформу и укажите URL-адрес вашего приложения . Выберите тип рекламы «Видео-награды» , а затем нажмите «Обновить» .

На странице «Управление приложениями» запишите идентификатор медиафайла . Он понадобится для настройки рекламного блока AdMob в следующем разделе.

На странице «Управление зоной» запишите идентификатор зоны . Он также понадобится для настройки вашего рекламного блока AdMob в следующем разделе.


Шаг 2: Настройка спроса maio в пользовательском интерфейсе AdMob.
Настройте параметры медиации для вашего рекламного блока.
Вам необходимо добавить maio в конфигурацию медиации для вашего рекламного блока.
Сначала войдите в свою учетную запись AdMob . Затем перейдите на вкладку «Медиация» . Если у вас уже есть группа медиации, которую вы хотите изменить, щелкните по ее названию, чтобы отредактировать ее, и перейдите к разделу «Добавить maio в качестве источника рекламы» .
Чтобы создать новую группу медиации, выберите «Создать группу медиации» .

Укажите формат и платформу вашей рекламы, затем нажмите «Продолжить» .

Присвойте вашей группе посредничества название и выберите регионы для таргетирования. Затем установите статус группы посредничества на «Включено» и нажмите «Добавить рекламные блоки» .

Свяжите эту группу медиации с одним или несколькими существующими рекламными блоками AdMob. Затем нажмите «Готово» .

Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками:

Добавьте Maio в качестве источника рекламы.
В разделе «Источники рекламы » на вкладке « Водопад » выберите «Добавить источник рекламы» .
Выберите maio и включите переключатель «Оптимизировать» . Введите API ID и API KEY, полученные в предыдущем разделе, чтобы настроить оптимизацию источника рекламы для maio. Затем введите значение eCPM для maio и нажмите «Продолжить» .

Если у вас уже есть сопоставление для maio, вы можете его выбрать. В противном случае нажмите «Добавить сопоставление» .

Далее введите идентификатор носителя (Media ID) и идентификатор зоны (Zone ID) , полученные в предыдущем разделе. Затем нажмите «Готово» .

Шаг 3: Импортируйте SDK и адаптер Maio.
Интеграция с Android Studio (рекомендуется)
В файле settings.gradle.kts на уровне проекта добавьте следующие репозитории:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile-maio.github.io/maven")
}
}
}
В файл gradle на уровне приложения добавьте следующие зависимости реализации и конфигурации:
Котлин
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02") implementation("com.google.ads.mediation:maio:2.0.8.0") } configurations.configureEach { exclude(group = "com.google.android.gms", module = "play-services-ads") exclude(group = "com.google.android.gms", module = "play-services-ads-lite") }
Классный
dependencies { implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02' implementation 'com.google.ads.mediation:maio:2.0.8.0' } configurations.configureEach { exclude group: 'com.google.android.gms', module: 'play-services-ads' exclude group: 'com.google.android.gms', module: 'play-services-ads-lite' }
Ручная интеграция
- Загрузите последнюю версию Maio Android SDK и добавьте её в свой проект.
- Перейдите к артефактам адаптера maio в репозитории Maven от Google. Выберите последнюю версию, загрузите файл `.aar` адаптера maio и добавьте его в свой проект.
Шаг 4: Добавьте необходимый код
Для интеграции maio с Android дополнительный код не требуется.
Шаг 5: Протестируйте свою реализацию.
Enable test ads
Обязательно зарегистрируйте свое тестовое устройство в AdMob.
Издатели, использующие версию 11.6.0 или выше GMA Next-Gen SDK будут автоматически получать тестовые объявления от maio на телефонах и планшетах, зарегистрированных в качестве тестовых устройств, при отправке запросов.
Проверить тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от maio, включите тестирование одного источника объявлений в инспекторе объявлений, используя источник(и ) объявлений maio (Waterfall ).
коды ошибок
Если адаптер не получает объявление от maio, издатели могут проверить основную причину ошибки в ответе на объявление, используя ResponseInfo.getAdSourceResponses() из следующих классов:
| Формат | Название класса |
|---|---|
| Интерстициальный | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
| Награжден | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
Вот коды и соответствующие сообщения, которые выдает адаптер Maio при неудачной загрузке рекламы:
| Код ошибки | Причина |
|---|---|
| 0-10 | maio вернул ошибку, специфичную для SDK. Более подробную информацию см. в коде и документации maio. |
| 101 | У Майо нет доступной рекламы. |
| 102 | Неверные параметры сервера (например, отсутствует идентификатор размещения). |
| 103 | Контекст, использованный для загрузки рекламы, не являлся экземпляром `Activity`. |