Как интегрировать maio с медиацией

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

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

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

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

Интеграция
Ставки
Водопад
Форматы
Баннер
Межстраничное объявление
Бонус предоставлен
Стандартное

Требования

Прежде чем продолжить, убедитесь, что:

  • Целевая версия iOS – 15.0 или более поздняя.

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

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

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

Межстраничное объявление

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

Бонус предоставлен

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

На странице Application Management (Управление приложениями) запишите Media ID (Идентификатор медиаконтента). Он понадобится вам, чтобы настроить рекламный блок AdMob в следующем разделе.

На странице Zone Management (Управление зонами) запишите Zone ID (Идентификатор зоны). Он также понадобится для настройки рекламного блока AdMob в следующем разделе.

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

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

Как настроить медиацию для рекламного блока

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

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

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

Укажите формат и платформу объявления и нажмите Продолжить.

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

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

На карточке "Рекламные блоки" появятся выбранные вами рекламные блоки.

Как добавить maio в качестве источника объявлений


На карточке Каскад в разделе Источники объявлений выберите Добавить источник объявлений.

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




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



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


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

Как использовать Swift Package Manager

Прежде чем продолжить, убедитесь, что у вас установлена минимальная поддерживаемая версия адаптера – 2.2.0.0.

Чтобы добавить зависимость пакета в проект, выполните следующие действия:

  1. В Xcode выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов).

  2. В появившемся окне введите следующий URL пакета:

    https://github.com/googleads/googleads-mobile-ios-mediation-maio.git
    
  3. В разделе Правило зависимостей выберите Ветвь.

  4. В текстовом поле введите main.

Через CocoaPods

  • Добавьте в Podfile проекта следующую строку:

    pod 'GoogleMobileAdsMediationMaio'
    
  • В командной строке выполните следующую команду:

    pod install --repo-update

Настраиваемые вручную интеграции

  • Скачайте последнюю версию maio SDK.
  • Скачайте последнюю версию адаптера maio по ссылке в журнале изменений и добавьте ссылку maioAdapter.framework в свой проект.

Шаг 4. Добавьте обязательный код

Как реализовать SKAdNetwork

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

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

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

Зарегистрируйте тестовое устройство в AdMob.

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

Как проверить тестовые объявления

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

Коды ошибок

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

Формат Название класса
Межстраничное объявление GADMMaioInterstitialAdapter
Бонус предоставлен GADMMaioRewardedAdapter

Ниже приведены коды и сообщения об ошибках, которые возвращает адаптер maio, когда не удается загрузить объявление.

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

История изменений адаптера для медиации maio для iOS

Версия 2.2.3.0

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

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

  • Google Mobile Ads SDK версии 13.9.0.
  • Maio SDK версии 2.2.3.

Версия 2.2.2.0

  • Подтверждена совместимость с maio SDK версии 2.2.2.
  • Теперь требуется минимальная версия iOS 15.0.
  • Минимальная версия iOS была обновлена, чтобы ослабить зависимость Google Mobile Ads SDK и разрешить промежуточные версии.

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

  • Google Mobile Ads SDK версии 13.7.0.
  • Maio SDK версии 2.2.2.

Версия 2.2.1.2

  • Фильтрация запросов с возрастными ограничениями для maio SDK, если для нового параметра ageRestrictedTreatment задано значение GADAgeRestrictedTreatmentChild.

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

  • Google Mobile Ads SDK версии 13.3.0.
  • Maio SDK версии 2.2.1.

Версия 2.2.1.1

  • Фильтровать запросы с возрастными ограничениями для SDK maio, поскольку он не может получать сигналы с возрастными ограничениями.

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

  • Google Mobile Ads SDK версии 13.2.0.
  • Maio SDK версии 2.2.1.

Версия 2.2.1.0

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

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

  • Google Mobile Ads SDK версии 13.1.0.
  • Maio SDK версии 2.2.1.

Версия 2.2.0.3

  • Добавлена поддержка каскадных баннеров.
  • Зависимость Google Mobile Ads SDK обновлена до версии 13.0.0.

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

  • Google Mobile Ads SDK версии 13.0.0.
  • Maio SDK версии 2.2.0.

Версия 2.2.0.2

  • Минимальная версия iOS для CocoaPods теперь 13.0.

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

  • Google Mobile Ads SDK версии 13.0.0.
  • Maio SDK версии 2.2.0.

Версия 2.2.0.1

  • Удалена реализация назначения ставок, так как Maio больше не поддерживает эту функцию.
  • Обновите адаптер, чтобы использовать протокол GADMediationAdapter.

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

  • Google Mobile Ads SDK версии 12.11.0.
  • Maio SDK версии 2.2.0.

Версия 2.2.0.0

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

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

  • Google Mobile Ads SDK версии 12.11.0.
  • Maio SDK версии 2.2.0.

Версия 2.1.6.1

  • Теперь требуется Google Mobile Ads SDK версии 12.0.0 или более поздней.

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

  • Google Mobile Ads SDK версии 12.0.0.
  • Maio SDK версии 2.1.6.

Версия 2.1.6.0

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

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

  • Google Mobile Ads SDK версии 11.13.0.
  • Maio SDK версии 2.1.6.

Версия 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-alpha.

Версия 1.6.3.0

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

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

  • Google Mobile Ads SDK версии 9.12.0.
  • Maio SDK версии 1.6.3.
  • MaioOB SDK версии 2.0.0-alpha.

Версия 1.6.2.0

  • Подтверждена совместимость с maio SDK версии 1.6.2 и maioOB SDK версии 2.0.0-alpha.

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

  • Google Mobile Ads SDK версии 9.5.0.
  • Maio SDK версии 1.6.2.
  • MaioOB SDK версии 2.0.0-alpha.

Версия 1.6.1.0

  • Подтверждена совместимость с maio SDK версии 1.6.1 и maioOB SDK версии 2.0.0-alpha.

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

  • Google Mobile Ads SDK версии 9.2.0.
  • Maio SDK версии 1.6.1.
  • MaioOB SDK версии 2.0.0-alpha.

Версия 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-alpha.

Версия 1.6.0.0

  • Подтверждена совместимость с maio SDK версии 1.6.0 и maioOB SDK версии 2.0.0-alpha.

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

  • Google Mobile Ads SDK версии 8.13.0.
  • Теперь требуется iOS 10.0 или более поздней версии.
  • Maio SDK версии 1.6.0.
  • MaioOB SDK версии 2.0.0-alpha.

Версия 1.5.8.0

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

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

  • Google Mobile Ads SDK версии 8.7.0.
  • Maio SDK версии 1.5.8.
  • MaioOB SDK версии 2.0.0-alpha.

Версия 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 было передано несколько идентификаторов медиаконтента.

Версия 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

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

Версия 1.2.18.0

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