Google Mobile Ads SDK находится в режиме технического обслуживания. Для получения последних обновлений и новых функций выполните миграцию и настройку GMA Next-Gen SDK .

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

Как интегрировать maio с медиацией

Выберите платформу: Android iOS Unity Flutter Android (устаревшая версия)

В этом руководстве рассказывается, как с помощью Google Mobile Ads SDK (Legacy) загружать и показывать рекламу из maio, используя медиацию AdMob и каскадную интеграцию. Вы узнаете, как добавить maio в конфигурацию медиации рекламного блока, а также как интегрировать SDK и адаптер maio в приложение для Android.

В интерфейсе панели управления maio для ярлыков, кнопок и описаний используется японский язык. Скриншоты в этом руководстве не переведены. Однако в описаниях и инструкциях этого руководства ярлыки и кнопки упоминаются с их эквивалентами на английском языке. "URL スキーム," – это "схема URL".

Поддерживаемые интеграции и форматы объявлений

Адаптер медиации для maio имеет следующие возможности:

Интеграция
Ставки
Водопад
Форматы
Баннер
Межстраничное объявление
Бонус предоставлен
Стандартное

Требования

Прежде чем продолжить, убедитесь, что:

Android API уровня 24 или более поздней версии.

maio SDK 1.0.7 или более поздней версии.

Последняя версия Google Mobile Ads SDK (Legacy).
Настройте медиацию AdMob.

Шаг 1. Задайте настройки в интерфейсе maio

Зарегистрируйтесь или войдите в аккаунт maio. Нажмите кнопку Application management (Управление приложениями) на боковой панели слева и выберите New app (Новое приложение).

Выберите вкладку, соответствующую нужному типу объявления.

Межстраничное объявление

Введите название приложения, выберите платформу и укажите URL приложения. В качестве типа объявления выберите Межстраничное видеообъявление и нажмите Обновить.

Бонус предоставлен

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

На странице Application Management (Управление приложениями) запишите значение Media ID (Идентификатор мультимедийного объекта). Он понадобится вам для настройки рекламного блока AdMob в следующем разделе.

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

Чтобы настроить идентификатор рекламного блока для медиации, вам понадобятся не только идентификатор мультимедийного объекта и идентификатор зоны, но и идентификатор API и ключ API. На странице Reporting API запишите идентификатор API и ключ API.

Шаг 2. Настройте спрос maio в интерфейсе AdMob

Как настроить медиацию для рекламного блока

Вам нужно добавить maio в конфигурацию медиации для рекламного блока.

Войдите в аккаунт AdMob. Перейдите на вкладку Медиация. Если вы хотите изменить существующую группу медиации, нажмите на ее название и перейдите к разделу Добавьте maio в качестве источника объявлений.

Чтобы создать новую группу медиации, нажмите Создать группу медиации.

Укажите формат объявления и платформу, а затем нажмите Продолжить.

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

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

Выбранные рекламные блоки появятся на карточке:

Добавьте maio в качестве источника объявлений

На карточке Каскад в разделе Источники объявлений выберите Добавить источник объявлений.

Выберите maio и установите переключатель Оптимизировать в положение "включено". Чтобы настроить оптимизацию источника объявлений для maio, введите идентификатор API и ключ API, полученные в предыдущем разделе. Затем введите значение эффективной цены за тысячу показов для maio и нажмите Продолжить.

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

Затем введите идентификатор мультимедийного объекта и идентификатор зоны, полученные в предыдущем разделе. Затем нажмите Готово.

Примечание. Чтобы собрать достаточно данных для точного расчета эффективной цены за тысячу показов в сети медиации, требуется несколько дней. Пока статус оптимизации источника объявлений – PENDING, вам нужно вручную задать значение эффективной цены за тысячу показов для сети. После этого источник объявлений начнет автоматически обновлять эффективную цену за тысячу показов от вашего имени.

Шаг 3. Импортируйте SDK и адаптер maio

Интеграция с Android Studio (рекомендуется)

В файле settings.gradle.kts на уровне проекта добавьте следующие репозитории:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://imobile-maio.github.io/maven")
    }
  }
}

В файле gradle на уровне приложения добавьте следующие зависимости реализации:

Kotlin

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:maio:2.0.9.1")
}

Groovy

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:maio:2.0.9.1'
}

Интеграция вручную

Скачайте последнюю версию maio Android SDK и добавьте ее в проект.
Перейдите к артефактам адаптера maio в репозитории Google Maven. Выберите последнюю версию, скачайте файл адаптера maio с расширением.aar и добавьте его в проект.

Шаг 4. Добавьте необходимый код

Для интеграции maio в приложение для Android не требуется дополнительный код.

Шаг 5. Протестируйте реализацию

Как включить тестовые объявления

Обязательно зарегистрируйте тестовое устройство в AdMob.

Издатели, использующие Google Mobile Ads SDK (Legacy) версии 11.6.0 или более поздней, будут автоматически получать тестовые объявления от maio на телефоны и планшеты, зарегистрированные как тестовые устройства, при отправке запросов.

Проверьте тестовые объявления

Чтобы проверить, получаете ли вы тестовые объявления от maio, включите тестирование отдельного источника объявлений в инспекторе объявлений, используя источники объявлений maio (каскад).

Коды ошибок

Если адаптер не получает объявление от maio, издатели могут проверить причину ошибки в ответе на запрос объявления, используя ResponseInfo.getAdapterResponses() в следующих классах:

Формат	Название класса
Межстраничное объявление	jp.maio.sdk.android.mediation.admob.adapter.Interstitial
Бонус предоставлен	jp.maio.sdk.android.mediation.admob.adapter.Rewarded

Ниже приведены коды и сообщения, которые возвращает адаптер maio, когда не удается загрузить объявление.

Код ошибки	Причина
0-10	Сеть maio вернула ошибку, связанную с SDK. Дополнительную информацию можно найти в коде и документации maio.
101	В Maio нет доступных объявлений.
102	Недопустимые параметры сервера (например, отсутствует идентификатор места размещения).
103	Контекст, использованный для загрузки объявления, не был экземпляром `Activity`.
104	Запрос обрабатывался с учетом возрастных ограничений, но maio SDK не может получать сигналы, связанные с возрастными ограничениями.

Журнал изменений адаптера maio Android Mediation