Чтобы обсудить наши продукты и оставить отзыв, присоединяйтесь к официальному каналу AdMob Discord на сервере Google Advertising and Measurement Community .

Эта страница переведена с помощью Cloud Translation API.

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

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

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

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

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

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

Требования

Android API уровня 23 или выше

maio SDK 1.0.7 или выше

Последняя версия Google Mobile Ads SDK
Завершить посредничество . Руководство по началу работы.

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

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

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

Примечание : Оптимизация источника объявлений может занять несколько дней, чтобы собрать достаточно данных для точного расчёта eCPM для медиационной сети. В настоящее время оптимизация источника объявлений имеет статус PENDING , поэтому вам необходимо вручную задать значение eCPM для сети. После того, как eCPM будет рассчитан, источник объявлений автоматически начнёт обновлять eCPM от вашего имени.

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

Интеграция с Android Studio (рекомендуется)

В файле 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:24.4.0")
    implementation("com.google.ads.mediation:maio:2.0.5.0")
}

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

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

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

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

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

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

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

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

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

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

Коды ошибок

Если адаптеру не удается получить рекламу от 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`.