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

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

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

Выберите платформу: Android (бета-версия)

Android iOS Unity Flutter

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

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

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

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

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

Требования

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

maio SDK 1.0.7 или выше

Новейшая версия SDK для мобильной рекламы от Google.
Пройдите руководство по началу процесса медиации.

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

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

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

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

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

Награжден

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

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

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

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

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

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

Войдите в свой аккаунт в Ad Manager .

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

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

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

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

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

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

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

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

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

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

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

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

Затем в файле build.gradle.kts на уровне приложения добавьте следующие зависимости и конфигурации реализации. Используйте последние версии SDK и адаптера maio:

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.9.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.

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

Список изменений адаптера медиации Maio для Android