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

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

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

В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы из Maio с помощью медиации , включая каскадную интеграцию. В нём также рассказывается, как добавить 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-адрес приложения . Выберите «Видеорекорды» в качестве типа рекламы и нажмите «Обновить» .

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

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

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

Шаг 2: Настройте спрос на рекламу в пользовательском интерфейсе Менеджера рекламы

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

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

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

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

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

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

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

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

После выбора партнера по доходности выберите Mobile SDK Mediation в качестве типа интеграции , Android в качестве платформы и Active в качестве статуса . Введите идентификатор медиа и идентификатор зоны, полученные в предыдущем разделе. Затем укажите значение CPM по умолчанию .

По завершении нажмите кнопку «Сохранить» внизу страницы.

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

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

Загрузите последнюю версию maio Android SDK и добавьте ее в свой проект.
Перейдите к артефактам адаптера MAIO в репозитории Maven от Google. Выберите последнюю версию, скачайте файл `.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.Interstitial
Награжден	jp.maio.sdk.android.mediation.admob.adapter.Rewarded

Вот коды и сопроводительные сообщения, выдаваемые адаптером Maio, когда реклама не загружается:

Код ошибки	Причина
0-10	maio вернул ошибку, специфичную для SDK. Подробнее см. код и документацию maio.
101	У Maio нет доступной рекламы.
102	Неверные параметры сервера (например, отсутствует идентификатор размещения).
103	Контекст, использованный для загрузки рекламы, не является экземпляром `Activity`.