В этом руководстве показано, как использовать GMA Next-Gen SDK для загрузки и отображения рекламы из maio с помощью медиации , включая интеграцию по принципу водопада. В нем рассказывается, как добавить 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-адрес вашего приложения . Выберите тип рекламы «Видео-награды» , а затем нажмите «Обновить» .
На странице «Управление приложениями» запишите идентификатор медиафайла (Media ID ). Он понадобится для настройки рекламного блока в Ad Manager в следующем разделе.
На странице «Управление зонами» запишите идентификатор зоны . Он также понадобится для настройки рекламного блока в Ad Manager в следующем разделе.
Шаг 2: Настройте запрос maio в пользовательском интерфейсе Ad Manager.
Настройте параметры медиации для вашего рекламного блока.
Войдите в свой аккаунт в Ad Manager .
Перейдите в раздел «Доставка» > «Группы доходности» и нажмите кнопку «Создать новую группу доходности» .
Введите уникальное имя для вашей группы доходности, установите статус «Активный» , выберите формат объявления и тип инвентаря «Мобильное приложение» . В разделе «Таргетинг > Инвентарь» выберите рекламный блок в разделе «Инвентарь и мобильное приложение» , к которому вы хотите добавить медиацию.
Далее нажмите кнопку «Добавить партнера по доходности» .
If you already have a Yield partner for maio, you can select it. Otherwise, select Create a new yield partner .
Выберите maio в качестве рекламной сети , введите уникальное имя и включите медиацию .
Включите автоматический сбор данных и введите идентификатор API и ключ API, полученные в предыдущем разделе.
После выбора партнера Yield выберите тип интеграции «Mobile SDK Mediation» , платформу «Android» и статус «Active» . Введите идентификаторы Media ID и Zone ID , полученные в предыдущем разделе. Затем введите значение CPM по умолчанию .
После завершения нажмите кнопку «Сохранить» внизу страницы.
Шаг 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: Протестируйте свою реализацию.
Включить тестовые объявления
Обязательно зарегистрируйте ваше тестовое устройство в Ad Manager.
Издатели, использующие версию 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`. |