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

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

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

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

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


Шаг 2: Настройте запрос maio в пользовательском интерфейсе Ad Manager.
Настройте параметры медиации для вашего рекламного блока.
Войдите в свой аккаунт в Ad Manager .
Перейдите в раздел «Доставка» > «Группы доходности» и нажмите кнопку «Создать новую группу доходности» .

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

Если у вас уже есть партнер по программе Yield для maio, вы можете его выбрать. В противном случае выберите «Создать нового партнера по программе Yield» .
Выберите maio в качестве рекламной сети , введите уникальное имя и включите медиацию .
Включите автоматический сбор данных и введите идентификатор API и ключ API, полученные в предыдущем разделе.

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

После завершения нажмите кнопку «Сохранить» внизу страницы.
Шаг 3: Импортируйте SDK и адаптер Maio.
Используйте менеджер пакетов Swift.
Прежде чем продолжить, у вас должна быть установлена минимальная поддерживаемая версия адаптера 2.2.0.0.
Чтобы добавить зависимость пакета в ваш проект, выполните следующие действия:
В Xcode перейдите в меню Файл > Добавить зависимости пакета... .
В появившемся окне введите следующий URL-адрес пакета:
https://github.com/googleads/googleads-mobile-ios-mediation-maio.gitВ разделе «Правило зависимости» выберите «Ветвь» .
В текстовом поле введите
main.
Используйте CocoaPods
Добавьте следующую строку в файл Podfile вашего проекта:
pod 'GoogleMobileAdsMediationMaio'В командной строке выполните:
pod install --repo-update
Ручная интеграция
- Загрузите последнюю версию SDK maio .
- Загрузите последнюю версию адаптера maio по ссылке для скачивания в списке изменений и подключите файл
maioAdapter.frameworkк вашему проекту.
Шаг 4: Добавьте необходимый код
Интеграция SKAdNetwork
Следуйте документации maio , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.
Шаг 5: Протестируйте свою реализацию.
Включить тестовые объявления
Обязательно зарегистрируйте ваше тестовое устройство в Ad Manager.
Издатели, использующие версию 7.26.0 или выше Google Mobile Ads SDK, будут автоматически получать тестовые объявления от maio на телефонах и планшетах, зарегистрированных в качестве тестовых устройств, при отправке запросов.
Проверить тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от maio, включите тестирование одного источника объявлений в инспекторе объявлений, используя источник(и ) объявлений maio (Waterfall ).
коды ошибок
Если адаптер не получает объявление от maio, издатели могут проверить основную причину ошибки в ответе на объявление, используя GADResponseInfo.adNetworkInfoArray из следующих классов:
| Формат | Название класса |
|---|---|
| Интерстициальный | GADMMaioInterstitialAdapter |
| Награжден | GADMMaioRewardedAdapter |
Вот коды и соответствующие сообщения, которые выдает адаптер Maio при неудачной загрузке рекламы:
| Код ошибки | Причина |
|---|---|
| 0-10 | Функция maio вернула ошибку, специфичную для SDK. Подробнее см. в коде maio. |
| 101 | На данный момент у maio нет доступной рекламы. |
| 102 | Неверные параметры сервера (например, отсутствует идентификатор размещения). |
| 103 | Адаптер Maio не поддерживает запрашиваемый формат рекламы. |
| 104 | Для данной конфигурации сети уже загружена реклама. |
Список изменений адаптера медиации maio для iOS
Версия 2.2.0.1
- Функция торгов удалена, поскольку Maio больше не поддерживает систему торгов.
- Обновите адаптер, чтобы он использовал протокол
GADMediationAdapter.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 12.11.0.
- Версия Maio SDK 2.2.0.
Версия 2.2.0.0
- Подтверждена совместимость с версией 2.2.0 SDK Maio.
Разработано и протестировано с помощью:
- Версия 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
- Подтверждена совместимость с версией SDK maio 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
- Подтверждена совместимость с версией SDK maio 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
- Подтверждена совместимость с версией SDK maio 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
- Подтверждена совместимость с версией SDK maio 2.1.2.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 10.14.0.
- Версия Maio SDK 2.1.2.
Версия 2.1.1.0
- Подтверждена совместимость с версией SDK maio 2.1.1.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 10.12.0.
- Версия Maio SDK 2.1.1.
Версия 2.0.0.0
- Подтверждена совместимость с версией 2.0.0 SDK Maio.
- Удалена зависимость от
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
- Адаптер обновлен для использования API
didRewardUser. - Теперь требуется Google Mobile Ads SDK версии 9.8.0 или выше.
- Подтверждена совместимость с версией SDK maio 1.6.3 и версией SDK maioOB 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
- Подтверждена совместимость с версией SDK maio 1.6.2 и версией SDK maioOB 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
- Подтверждена совместимость с версией SDK maio 1.6.1 и версией SDK maioOB 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
- Подтверждена совместимость с версией SDK maio 1.6.0 и версией SDK maioOB 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
- Подтверждена совместимость с версией SDK maio 1.5.8 и версией SDK maioOB 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
- Подтверждена совместимость с версией SDK maio 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
- Подтверждена совместимость с версией SDK maio 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
- Подтверждена совместимость с версией SDK maio 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
- Подтверждена совместимость с версией SDK maio 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
- Подтверждена совместимость с версией SDK maio 1.5.2.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 7.53.1.
- Версия Maio SDK 1.5.2.
Версия 1.5.1.0
- Подтверждена совместимость с версией SDK maio 1.5.1.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 7.52.0.
- Версия Maio SDK 1.5.1.
Версия 1.5.0.0
- Подтверждена совместимость с версией SDK maio 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
- Подтверждена совместимость с версией SDK maio 1.4.6.
- Адаптер обновлен для использования нового API с системой вознаграждений.
- Теперь требуется Google Mobile Ads SDK версии 7.42.2 или выше.
Версия 1.4.2.0
- Подтверждена совместимость с версией SDK maio 1.4.2.
Версия 1.4.1.0
- Подтверждена совместимость с версией SDK maio 1.4.1.
- Исправлена ошибка, из-за которой адаптер maio мог давать сбой, если AdMob предоставлял несколько MediaId.
Версия 1.4.0.0
- Подтверждена совместимость с версией SDK maio 1.4.0.
Версия 1.3.2.0
- Подтверждена совместимость с версией SDK maio 1.3.2.
Версия 1.3.1.1
- В адаптер добавлен коллбэк
adapterDidCompletePlayingRewardBasedVideoAd:.
Версия 1.3.1.0
- Подтверждена совместимость с версией SDK maio 1.3.1.
Версия 1.3.0.0
- Подтверждена совместимость с версией SDK maio 1.3.0.
Версия 1.2.19.0
- Подтверждена совместимость с версией maio SDK 1.2.19.
Версия 1.2.18.0
- Первый релиз!
- Добавлена поддержка межстраничной рекламы и рекламы в формате видеороликов с вознаграждением.