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

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

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

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

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

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

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

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

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

Требования

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

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

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

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

Шаг 1. Настройте конфигурации в интерфейсе maio

Сначала зарегистрируйтесь или войдите в аккаунт maio. Нажмите кнопку Управление приложениями на боковой панели слева и выберите Новое приложение.

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

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

Введите название приложения, выберите платформу и укажите 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 и включите переключатель Оптимизировать. Введите идентификатор API и ключ API, полученные в предыдущем разделе, чтобы настроить оптимизацию источников объявлений для maio. Затем введите эффективную цену за тысячу показов для 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.

Издатели, использующие версию 11.6.0 или более позднюю версию Google Mobile Ads SDK (Legacy), будут автоматически получать тестовые объявления от 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	В запросе была указана обработка с учетом возрастных ограничений, но SDK maio не может получать сигналы с возрастными ограничениями