Интегрируйте maio с медиацией

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

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

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

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

Интеграция
Торги
Водопад
Форматы
Баннер
Межстраничный
Награжден
Родной

Требования

  • Android API уровня 21 или выше
  • maio SDK 1.0.7 или выше

Шаг 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 и адаптер.

В файле 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

  • Первый выпуск!
  • Добавлена ​​поддержка межстраничных объявлений и видеообъявлений с вознаграждением.