В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из maio с помощью медиации , а также рассматривается каскадная интеграция. В нем рассказывается, как добавить maio в конфигурацию медиации рекламного блока и как интегрировать SDK и адаптер maio в приложение Android.
В интерфейсе информационной панели maio для меток, кнопок и описаний используется текст на японском языке, а снимки экрана в этом руководстве не переведены. Однако в описаниях и инструкциях данного руководства метки и кнопки обозначаются их английскими эквивалентами. Например, «URL スキーム» — это «Схема URL».
Поддерживаемые интеграции и форматы объявлений
Адаптер-посредник для maio имеет следующие возможности:
Интеграция | |
---|---|
Торги | |
Водопад | |
Форматы | |
Баннер | |
Межстраничный | |
Награжден | |
Родной |
Требования
- Android API уровня 21 или выше
- maio SDK 1.0.7 или выше
Последняя версия Google Mobile Ads SDK
Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе maio.
Сначала зарегистрируйтесь или войдите в свою учетную запись maio. Нажмите кнопку «Управление приложениями» на левой боковой панели и выберите «Новое приложение» .
Выберите вкладку, соответствующую предпочитаемому типу объявления .
Межстраничный
Введите название вашего приложения, выберите платформу и укажите URL-адрес вашего приложения . В качестве типа объявления выберите «Межстраничное видео» и нажмите «Обновить» .
Награжден
Введите название вашего приложения, выберите платформу и укажите URL-адрес вашего приложения . Выберите «Видео-награды» в качестве типа объявления и нажмите «Обновить» .
На странице «Управление приложениями » запишите идентификатор носителя . Это необходимо для настройки рекламного блока Менеджера рекламы в следующем разделе.
На странице «Управление зоной » запишите идентификатор зоны . Это также потребуется для настройки рекламного блока Менеджера рекламы (см. следующий раздел).
Помимо Media ID и Zone ID , вам потребуются API ID и API KEY , чтобы настроить идентификатор рекламного блока для медиации. На странице Reporting API запишите идентификатор API и ключ API .Шаг 2. Настройте спрос maio в интерфейсе Менеджера рекламы.
Настройте параметры медиации для своего рекламного блока
Войдите в свою учетную запись Менеджера рекламы .
Перейдите в раздел «Доставка» > «Группы доходности» и нажмите кнопку «Новая группа доходности» .
Введите уникальное имя для своей группы доходности, установите статус « Активно» , выберите формат объявления и установите тип инвентаря « Мобильное приложение» . В разделе «Таргетинг» > «Инвентарь» выберите рекламный блок в разделе «Инвентарь и мобильное приложение» , к которому вы хотите добавить агрегатор.
Затем нажмите кнопку «Добавить партнера по доходности» .
Если у вас уже есть партнер по доходности для maio, вы можете выбрать его. В противном случае выберите Создать нового партнера по доходности .
Выберите maio в качестве рекламной сети , введите уникальное имя и включите посредничество .
Включите Автоматический сбор данных и введите API ID и API KEY, полученные в предыдущем разделе.
После выбора партнера по доходности выберите Mobile SDK Mediation в качестве типа интеграции , Android в качестве платформы и Активный в качестве статуса . Введите идентификатор носителя и идентификатор зоны, полученные в предыдущем разделе. Затем введите значение цены за тысячу показов по умолчанию .
Когда закончите, нажмите «Сохранить» внизу страницы.
Шаг 3. Импортируйте maio SDK и адаптер.
Интеграция с Android Studio (рекомендуется)
В файле settings.gradle.kts
уровня проекта добавьте следующие репозитории:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile-maio.github.io/maven")
}
}
}
Затем в файл build.gradle.kts
уровня приложения добавьте следующие зависимости и конфигурации реализации. Используйте последние версии maio SDK и адаптера:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.6.0")
implementation("com.google.ads.mediation:maio:1.1.16.3")
}
Ручная интеграция
- Загрузите последнюю версию maio Android SDK и добавьте ее в свой проект.
- Перейдите к артефактам адаптера maio в репозитории Google Maven. Выберите последнюю версию, загрузите файл `.aar' адаптера maio и добавьте его в свой проект.
Шаг 4. Добавьте необходимый код
Для интеграции maio с Android не требуется никакого дополнительного кода.
Шаг 5. Проверьте свою реализацию
Включить тестовые объявления
Обязательно зарегистрируйте тестовое устройство в Менеджере рекламы.
Издатели, использующие Google Mobile Ads SDK версии 11.6.0 или выше, при отправке запросов будут автоматически получать тестовые объявления от maio на телефонах и планшетах, зарегистрированных в качестве тестовых устройств .
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от maio, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений maio (Waterfall) .
Коды ошибок
Если адаптеру не удается получить объявление от maio, издатели могут проверить основную ошибку из ответа на объявление, используя ResponseInfo.getAdapterResponses()
в следующих классах:
Формат | Имя класса |
---|---|
Межстраничный | jp.maio.sdk.android.mediation.admob.adapter.Межстраничное объявление |
Награжден | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
Вот коды и сопутствующие сообщения, выдаваемые адаптером maio, когда объявление не загружается:
Код ошибки | Причина |
---|---|
0-10 | maio вернул ошибку, специфичную для SDK. Дополнительные сведения см. в документации по коду и maio. |
101 | У Майо нет доступного объявления. |
102 | Неверные параметры сервера (например, отсутствует идентификатор места размещения). |
103 | Контекст, используемый для загрузки объявления, не был экземпляром «Активность». |
Журнал изменений адаптера-посредника maio для Android
Версия 1.1.16.3
- Минимальная необходимая версия Google Mobile Ads SDK обновлена до 23.0.0.
- Проверенная совместимость с maio SDK версии 1.1.16.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 23.0.0.
- Maio SDK версии 1.1.16.
Версия 1.1.16.2
- Обновлен адаптер для использования нового класса
VersionInfo
. - Минимальная необходимая версия Google Mobile Ads SDK обновлена до 22.0.0.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 22.0.0.
- Maio SDK версии 1.1.16.
Версия 1.1.16.1
-
compileSdkVersion
иtargetSdkVersion
обновлены до API 31. - Минимальная необходимая версия Google Mobile Ads SDK обновлена до 21.0.0.
- Минимально необходимый уровень Android API обновлен до 19.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 21.0.0.
- Maio SDK версии 1.1.16.
Версия 1.1.16.0
- Обновлены коды ошибок для регистрации дополнительных ошибок maio.
- Проверенная совместимость с maio SDK версии 1.1.16.
- Минимальная необходимая версия Google Mobile Ads SDK обновлена до 20.4.0.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 20.4.0.
- Maio SDK версии 1.1.16.
Версия 1.1.15.0
- Проверенная совместимость с maio SDK версии 1.1.15.
- Минимальная необходимая версия Google Mobile Ads SDK обновлена до 20.0.0.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 20.0.0.
- Maio SDK версии 1.1.15.
Версия 1.1.14.0
- Добавлены стандартизированные коды ошибок и сообщения адаптера.
- Проверена совместимость с maio SDK версии 1.1.14.
- Минимальная необходимая версия Google Mobile Ads SDK обновлена до 19.8.0.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 19.8.0.
- Maio SDK версии 1.1.14.
Версия 1.1.13.0
- Проверена совместимость с maio SDK версии 1.1.13.
- Минимальная необходимая версия Google Mobile Ads SDK обновлена до 19.5.0.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 19.5.0.
- Maio SDK версии 1.1.13.
Версия 1.1.12.0
- Минимальная необходимая версия Google Mobile Ads SDK обновлена до 19.4.0.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 19.4.0.
- Maio SDK версии 1.1.12.
Версия 1.1.11.1
- Чтобы ограничить время ожидания, запросы объявлений теперь будут немедленно завершаться сбоем, если у maio нет объявления, готового к показу.
- Минимальная необходимая версия Google Mobile Ads SDK обновлена до 19.1.0.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 19.1.0.
- Maio SDK версии 1.1.11.
Версия 1.1.11.0
- Проверена совместимость с maio SDK версии 1.1.11.
- Минимальная необходимая версия Google Mobile Ads SDK обновлена до 18.3.0.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 18.3.0.
- Maio SDK версии 1.1.11.
Версия 1.1.10.0
- Проверенная совместимость с maio SDK версии 1.1.10.
- Минимальная необходимая версия Google Mobile Ads SDK обновлена до 18.2.0.
Версия 1.1.8.0
- Проверенная совместимость с maio SDK версии 1.1.8.
- Минимальная необходимая версия Google Mobile Ads SDK обновлена до 18.1.0.
Версия 1.1.7.0
- Исправления ошибок.
- Проверена совместимость с maio SDK версии 1.1.7.
Версия 1.1.6.1
- Обновлен адаптер для поддержки нового Rewarded API.
- Минимальная необходимая версия Google Mobile Ads SDK обновлена до 17.2.0.
Версия 1.1.6.0
- Проверенная совместимость с maio SDK версии 1.1.6.
Версия 1.1.5.0
- Проверенная совместимость с maio SDK версии 1.1.5.
Версия 1.1.4.0
- Проверена совместимость с maio SDK версии 1.1.4.
Версия 1.1.3.1
- Обновлен адаптер для работы с классом экземпляра вместо синглтона.
Версия 1.1.3.0
- Проверена совместимость с maio SDK версии 1.1.3.
Версия 1.1.2.1
- Обновлен адаптер с обновленными функциями инициализации.
Версия 1.1.2.0
- Проверенная совместимость с maio SDK версии 1.1.2.
Версия 1.1.1.1
- Обновлен адаптер для вызова рекламного события
onRewardedVideoComplete()
.
Версия 1.1.1.0
- Проверена совместимость с maio SDK версии 1.1.1.
Версия 1.1.0.0
- Проверенная совместимость с maio SDK версии 1.1.0.
Версия 1.0.8.0
- Проверена совместимость с maio SDK версии 1.0.8.
Версия 1.0.7.1
- Исправлена проблема, которая могла привести к возникновению исключений NullPointerException, когда реклама не загружалась.
Версия 1.0.7.0
- Добавлена возможность включить тестовый режим, добавив идентификатор тестового устройства в
AdRequest
. - Проверена совместимость с maio SDK версии 1.0.7.
Версия 1.0.6.0
- Первый выпуск!
- Добавлена поддержка межстраничных объявлений и видеообъявлений с вознаграждением.