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

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

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

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

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

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

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

Требования

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

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 и ключ API .

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

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

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

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

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

Введите формат объявления и платформу, затем нажмите «Продолжить» .

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

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

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

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

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

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

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

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

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

Шаг 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: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. Проверьте свою реализацию

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

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

Издатели, использующие 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	Контекст, используемый для загрузки объявления, не был экземпляром «Активность».