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

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

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

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

Поддерживаемые интеграции и форматы рекламы

Адаптер для посредничества на платформе Maio обладает следующими возможностями:

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

Требования

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

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

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

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

Интерстициальный

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

Награжден

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

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

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

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

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

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

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

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

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

Укажите формат и платформу вашей рекламы, затем нажмите «Продолжить» .

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

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

Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками:

Добавьте Maio в качестве источника рекламы.


В разделе «Источники рекламы » на вкладке « Водопад » выберите «Добавить источник рекламы» .

Выберите maio и включите переключатель «Оптимизировать» . Введите API ID и API KEY, полученные в предыдущем разделе, чтобы настроить оптимизацию источника рекламы для maio. Затем введите значение eCPM для maio и нажмите «Продолжить» .



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

Далее введите идентификатор носителя (Media ID) и идентификатор зоны (Zone ID) , полученные в предыдущем разделе. Затем нажмите «Готово» .


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

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

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

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

Котлин

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:maio:2.0.8.0")
}

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

Классный

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:maio:2.0.8.0'
}

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

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

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

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

Enable test ads

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

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

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

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

коды ошибок

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