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

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

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

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

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

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

Требования

  • Цель развертывания iOS 12.0 или выше

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

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

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

Межстраничный

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

Награжден

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

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

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

(Только для Waterfall) Помимо идентификатора носителя и идентификатора зоны , вам потребуются идентификатор API и ключ API , чтобы настроить идентификатор рекламного блока для медиации. На странице Reporting API запишите идентификатор API и ключ API .

Шаг 2. Настройте спрос maio в интерфейсе Менеджера рекламы.

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

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

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

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

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

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

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

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

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

Когда закончите, нажмите «Сохранить» внизу страницы.

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

  • Добавьте следующую строку в подфайл вашего проекта:

    pod 'GoogleMobileAdsMediationMaio'
    
  • Из командной строки выполните:

    pod install --repo-update

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

  • Загрузите последнюю версию maio SDK .
  • Загрузите последнюю версию адаптера maio по ссылке в журнале изменений и свяжите maioAdapter.framework с вашим проектом.

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

Интеграция со SKAdNetwork

Следуйте документации maio , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.

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

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

Обязательно зарегистрируйте тестовое устройство в Менеджере рекламы.

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

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

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

Коды ошибок

Если адаптеру не удается получить объявление от maio, издатели могут проверить основную ошибку из ответа на объявление, используя GADResponseInfo.adNetworkInfoArray в следующих классах:

Формат Имя класса
Межстраничный GADMMaioМежстраничный адаптер
Награжден GADMMaioRewardedАдаптер

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

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

Журнал изменений адаптера-посредника maio iOS

Версия 2.1.5.1

  • Обновлен CFBundleShortVersionString , чтобы иметь три компонента вместо четырех.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 11.10.0.
  • Maio SDK версии 2.1.5.

Версия 2.1.5.0

  • Проверенная совместимость с maio SDK версии 2.1.5.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 11.6.0.
  • Maio SDK версии 2.1.5.

Версия 2.1.4.0

  • Проверенная совместимость с maio SDK версии 2.1.4.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 11.2.0.
  • Maio SDK версии 2.1.4.

Версия 2.1.3.0

  • Проверена совместимость с maio SDK версии 2.1.3.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 11.1.0.
  • Maio SDK версии 2.1.3.

Версия 2.1.2.1

  • Теперь требуется Google Mobile Ads SDK версии 11.0 или выше.
  • Info.plist включен в рамки MaioAdapter.xcframework .

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 11.0.1.
  • Maio SDK версии 2.1.2.

Версия 2.1.2.0

  • Проверена совместимость с maio SDK версии 2.1.2.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.14.0.
  • Maio SDK версии 2.1.2.

Версия 2.1.1.0

  • Проверена совместимость с maio SDK версии 2.1.1.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.12.0.
  • Maio SDK версии 2.1.1.

Версия 2.0.0.0

  • Проверенная совместимость с maio SDK версии 2.0.0.
  • Удалена зависимость от MaioOB SDK .
  • Удалена поддержка архитектуры armv7 .
  • Теперь требуется минимальная версия iOS 12.0.
  • Теперь требуется Google Mobile Ads SDK версии 10.4.0 или выше.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.10.0.
  • Maio SDK версии 2.0.0.

Версия 1.6.3.1

  • Теперь требуется Google Mobile Ads SDK версии 10.0.0 или выше.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.0.0.
  • Maio SDK версии 1.6.3.
  • MaioOB SDK версии 2.0.0-альфа.

Версия 1.6.3.0

  • Обновлен адаптер для использования API didRewardUser .
  • Теперь требуется Google Mobile Ads SDK версии 9.8.0 или выше.
  • Проверенная совместимость с maio SDK версии 1.6.3 и maioOB SDK версии 2.0.0-альфа.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 9.12.0.
  • Maio SDK версии 1.6.3.
  • MaioOB SDK версии 2.0.0-альфа.

Версия 1.6.2.0

  • Проверенная совместимость с maio SDK версии 1.6.2 и maioOB SDK версии 2.0.0-альфа.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 9.5.0.
  • Maio SDK версии 1.6.2.
  • MaioOB SDK версии 2.0.0-альфа.

Версия 1.6.1.0

  • Проверенная совместимость с maio SDK версии 1.6.1 и maioOB SDK версии 2.0.0-альфа.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 9.2.0.
  • Maio SDK версии 1.6.1.
  • MaioOB SDK версии 2.0.0-альфа.

Версия 1.6.0.1

  • Подтверждена совместимость с Google Mobile Ads SDK версии 9.0.0.
  • Теперь требуется Google Mobile Ads SDK версии 9.0.0 или выше.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 9.0.0.
  • Maio SDK версии 1.6.0.
  • MaioOB SDK версии 2.0.0-альфа.

Версия 1.6.0.0

  • Проверенная совместимость с maio SDK версии 1.6.0 и maioOB SDK версии 2.0.0-альфа.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 8.13.0.
  • Теперь требуется минимальная версия iOS 10.0.
  • Maio SDK версии 1.6.0.
  • MaioOB SDK версии 2.0.0-альфа.

Версия 1.5.8.0

  • Проверенная совместимость с maio SDK версии 1.5.8 и maioOB SDK версии 2.0.0-альфа.
  • В адаптер добавлена ​​возможность назначения ставок для форматов межстраничной рекламы и рекламы с вознаграждением.
  • Слабая зависимость от Google Mobile Ads SDK версии 8.0.0 или выше.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 8.7.0.
  • Maio SDK версии 1.5.8.
  • MaioOB SDK версии 2.0.0-альфа.

Версия 1.5.6.1

  • Добавлены стандартизированные коды ошибок и сообщения адаптера.
  • Обновлен адаптер для использования формата .xcframework .
  • Исправлена ​​ошибка, из-за которой рекламные события с вознаграждением иногда не пересылались.
  • Теперь требуется Google Mobile Ads SDK версии 8.3.0 или выше.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 8.3.0.
  • Maio SDK версии 1.5.6.

Версия 1.5.6.0

  • Проверенная совместимость с maio SDK версии 1.5.6.
  • Теперь требуется Google Mobile Ads SDK версии 7.68.0 или выше.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 7.68.0.
  • Maio SDK версии 1.5.6.

Версия 1.5.5.0

  • Проверена совместимость с maio SDK версии 1.5.5.
  • Теперь требуется Google Mobile Ads SDK версии 7.64.0 или выше.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 7.64.0.
  • Maio SDK версии 1.5.5.

Версия 1.5.4.0

  • Проверенная совместимость с maio SDK версии 1.5.4.
  • Теперь требуется Google Mobile Ads SDK версии 7.60.0 или выше.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 7.60.0.
  • Maio SDK версии 1.5.4.

Версия 1.5.3.1

  • Чтобы ограничить время ожидания, запросы объявлений теперь будут немедленно завершаться сбоем, если у maio нет объявления, готового к показу.
  • Удалена поддержка архитектуры i386.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 7.58.0.
  • Maio SDK версии 1.5.3.

Версия 1.5.3.0

  • Проверена совместимость с maio SDK версии 1.5.3.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 7.55.1.
  • Maio SDK версии 1.5.3.

Версия 1.5.2.1

  • Исправлена ​​проблема, из-за которой адаптер не вызывал обратный вызов -rewardedAdDidPresent:

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 7.53.1.
  • Maio SDK версии 1.5.2.

Версия 1.5.2.0

  • Проверенная совместимость с maio SDK версии 1.5.2.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 7.53.1.
  • Maio SDK версии 1.5.2.

Версия 1.5.1.0

  • Проверенная совместимость с maio SDK версии 1.5.1.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 7.52.0.
  • Maio SDK версии 1.5.1.

Версия 1.5.0.0

  • Проверенная совместимость с maio SDK версии 1.5.0.

Создан и протестирован с

  • Google Mobile Ads SDK версии 7.51.0.
  • Maio Ads SDK версии 1.5.0.

Версия 1.4.8.0

  • Проверена совместимость с maio SDK версии 1.4.8.

Версия 1.4.6.0

  • Проверена совместимость с maio SDK версии 1.4.6.
  • Обновлен адаптер для использования нового API с вознаграждением.
  • Теперь требуется Google Mobile Ads SDK версии 7.42.2 или выше.

Версия 1.4.2.0

  • Проверена совместимость с maio SDK версии 1.4.2.

Версия 1.4.1.0

  • Проверена совместимость с maio SDK версии 1.4.1.
  • Исправлена ​​проблема, из-за которой адаптер maio мог выйти из строя, если из AdMob было предоставлено несколько MediaId.

Версия 1.4.0.0

  • Проверена совместимость с maio SDK версии 1.4.0.

Версия 1.3.2.0

  • Проверенная совместимость с maio SDK версии 1.3.2.

Версия 1.3.1.1

  • Добавлен adapterDidCompletePlayingRewardBasedVideoAd: обратный вызов адаптеру.

Версия 1.3.1.0

  • Проверена совместимость с maio SDK версии 1.3.1.

Версия 1.3.0.0

  • Проверенная совместимость с maio SDK версии 1.3.0.

Версия 1.2.19.0

  • Проверена совместимость с maio SDK версии 1.2.19.

Версия 1.2.18.0

  • Первый выпуск!
  • Добавлена ​​поддержка межстраничных объявлений и видеообъявлений с вознаграждением.