Интеграция maio с посредничеством

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

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

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

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

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

Требования

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

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

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

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

Межстраничный

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

Награжден

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

На странице «Управление приложениями» запишите идентификатор носителя . В следующем разделе необходимо настроить рекламный блок Ad Manager .

На странице «Управление зоной» запишите идентификатор зоны . Он также понадобится для настройки рекламного блока Ad Manager в следующем разделе.

Помимо Media ID и Zone ID , вам потребуются API ID и API KEY , чтобы настроить идентификатор рекламного блока для медиации. На странице Reporting API запишите идентификатор API и ключ API .

Шаг 2. Настройте запрос maio в пользовательском интерфейсе Ad Manager

Настройте параметры медиации для своего рекламного блока

Войдите в свою учетную запись Менеджера рекламы .

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

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

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

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

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

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

После выбора партнера по доходности выберите Mobile SDK Mediation в качестве типа интеграции , Android в качестве платформы и Активный в качестве статуса . ВведитеMedia ID and Zone ID полученный в предыдущем разделе. Затем введите значение цены за тысячу показов по умолчанию .

Когда закончите, нажмите «Сохранить» внизу страницы.

Шаг 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.0.0")
    implementation("com.google.ads.mediation:maio:1.1.16.3")
}

Ручная интеграция

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

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

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

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

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

Убедитесь, что вы зарегистрировали свое тестовое устройство дляAd Manager.

Издатели, использующие 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

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