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

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

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

В этом руководстве описано, как с помощью GMA Next-Gen SDK загружать и показывать рекламу из maio, используя медиацию и каскадную интеграцию. Вы узнаете, как добавить maio в конфигурацию медиации рекламного блока, а также как интегрировать SDK и адаптер maio в приложение для Android.

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

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

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

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

Требования

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

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

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

Последняя версия GMA Next-Gen SDK.
Настройте медиацию.

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

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

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

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

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

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

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

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

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

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

Шаг 2. Настройте спрос maio в интерфейсе Менеджера рекламы

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

Войдите в аккаунт Менеджера рекламы.

Перейдите в раздел Выполнение > Группы доходности и нажмите кнопку Новая группа доходности.

Укажите уникальное название группы доходности, установите для нее статус Активно, выберите формат объявлений и задайте тип инвентаря Мобильное приложение. В разделе Таргетинг > Инвентарь выберите рекламный блок в разделах Инвентарь и Мобильное приложение, для которого нужно настроить медиацию.

Нажмите кнопку Добавить партнера по группе доходности.

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

Выберите maio в качестве рекламной сети, введите уникальное название и включите медиацию.

Включите Автоматический сбор данных и введите идентификатор API и ключ API, полученные в предыдущем разделе.

Выбрав партнера по группе доходности, укажите Медиация с использованием Mobile SDK в качестве типа интеграции, Android в качестве платформы и Активно в качестве статуса. Введите идентификатор медиаресурса и идентификатор зоны, полученные в предыдущем разделе. Затем укажите цену за тысячу показов по умолчанию.

Нажмите Сохранить внизу страницы.

Шаг 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.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:maio:2.0.9.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0'
    implementation 'com.google.ads.mediation:maio:2.0.9.1'
}

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 в репозитории Google Maven. Выберите последнюю версию, скачайте файл адаптера maio с расширением.aar и добавьте его в проект.

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

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

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

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

Убедитесь, что вы зарегистрировали тестовое устройство в Менеджере рекламы.

Издатели, использующие GMA Next-Gen SDK версии 11.6.0 или более поздней, будут автоматически получать тестовые объявления от maio на телефоны и планшеты, зарегистрированные как тестовые устройства, при отправке запросов.

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

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

Коды ошибок

Если адаптер не получает объявление от 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	В Maio нет доступных объявлений.
102	Недопустимые параметры сервера (например, отсутствует идентификатор места размещения).
103	Контекст, использованный для загрузки объявления, не был экземпляром `Activity`.
104	Запрос обрабатывался с учетом возрастных ограничений, но maio SDK не может получать сигналы, связанные с возрастными ограничениями.

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