В этом руководстве рассказывается, как использовать Google Mobile Ads SDK для загрузки и показа объявлений из maio с помощью медиации AdMob, включая интеграцию с каскадом. В этой статье рассказывается, как добавить maio в конфигурацию медиации рекламного блока и как интегрировать maio SDK и адаптер в приложение iOS.
В интерфейсе панели управления maio для меток, кнопок и описаний используется японский язык, поэтому скриншоты в этом руководстве не переведены. В описаниях и инструкциях этого руководства ярлыки и кнопки упоминаются на английском языке. "URL スキーム", например, означает "Схема URL".
Поддерживаемые интеграции и форматы объявлений
Адаптер для медиации maio поддерживает следующие функции:
| Интеграция | |
|---|---|
| Ставки | |
| Водопад | |
| Форматы | |
| Баннер | |
| Межстраничное объявление | |
| Бонус предоставлен | |
| Стандартное | |
Требования
Прежде чем продолжить, убедитесь, что:
- Целевая версия iOS – 15.0 или более поздняя.
Последняя версия Google Mobile Ads SDK.
Шаг 1. Настройте конфигурации в интерфейсе maio
Сначала зарегистрируйтесь или войдите в аккаунт maio. Нажмите кнопку Управление приложениями на боковой панели слева и выберите Новое приложение.

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

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

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

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


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

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

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

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

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

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

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

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

Шаг 3. Импортируйте SDK и адаптер maio
Как использовать Swift Package Manager
Прежде чем продолжить, убедитесь, что у вас установлена минимальная поддерживаемая версия адаптера – 2.2.0.0.
Чтобы добавить зависимость пакета в проект, выполните следующие действия:
В Xcode выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов).
В появившемся окне введите следующий URL пакета:
https://github.com/googleads/googleads-mobile-ios-mediation-maio.gitВ разделе Правило зависимостей выберите Ветвь.
В текстовом поле введите
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
- Адаптер обновлен для использования
didRewardUserAPI. - Теперь требуется 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
- Первый выпуск!
- Добавлена поддержка межстраничных объявлений и видеообъявлений с вознаграждением.