В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из maio с помощью агрегатора AdMob , а также рассматривается каскадная интеграция. В нем рассказывается, как добавить maio в конфигурацию медиации рекламного блока и как интегрировать SDK и адаптер maio в приложение iOS.
В интерфейсе информационной панели maio для меток, кнопок и описаний используется текст на японском языке, а снимки экрана в этом руководстве не переведены. Однако в описаниях и инструкциях данного руководства метки и кнопки обозначаются их английскими эквивалентами. Например, «URL スキーム» — это «Схема URL».
Поддерживаемые интеграции и форматы объявлений
Адаптер-посредник для maio имеет следующие возможности:
Интеграция | |
---|---|
Торги | |
Водопад | |
Форматы | |
Баннер | |
Межстраничный | |
Награжден | |
Родной |
Требования
- Цель развертывания iOS 12.0 или выше
Последняя версия Google Mobile Ads SDK
Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе maio.
Сначала зарегистрируйтесь или войдите в свою учетную запись maio. Нажмите кнопку «Управление приложениями» на левой боковой панели и выберите «Новое приложение» .
Выберите вкладку, соответствующую предпочитаемому типу объявления .
Межстраничный
Введите название вашего приложения, выберите платформу и укажите URL-адрес вашего приложения . В качестве типа объявления выберите «Межстраничное видео» и нажмите «Обновить» .
Награжден
Введите название вашего приложения, выберите платформу и укажите URL-адрес вашего приложения . Выберите «Видео-награды» в качестве типа объявления и нажмите «Обновить» .
На странице «Управление приложениями » запишите идентификатор носителя . В следующем разделе необходимо настроить рекламный блок AdMob.
На странице «Управление зоной » запишите идентификатор зоны . Это также потребуется для настройки рекламного блока AdMob в следующем разделе.
(Только для Waterfall) Помимо идентификатора носителя и идентификатора зоны , вам потребуются идентификатор API и ключ API , чтобы настроить идентификатор рекламного блока для медиации. На странице Reporting API запишите идентификатор API и ключ API .Шаг 2. Настройте запрос maio в интерфейсе AdMob.
Настройте параметры медиации для своего рекламного блока
Вам необходимо добавить maio в конфигурацию медиации для вашего рекламного блока.
Сначала войдите в свою учетную запись AdMob . Далее перейдите на вкладку «Медиация» . Если у вас есть существующая группа медиации, которую вы хотите изменить, нажмите на название этой группы медиации, чтобы изменить ее, и перейдите к пункту «Добавить maio в качестве источника объявлений» .
Чтобы создать новую группу медиации, выберите Создать группу медиации .
Введите формат объявления и платформу, затем нажмите «Продолжить» .
Дайте группе медиации название и выберите целевые местоположения. Затем установите статус группы медиации на «Включено » и нажмите «Добавить рекламные блоки» .
Свяжите эту группу медиации с одним или несколькими существующими рекламными блоками AdMob. Затем нажмите Готово .
Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками:
Добавьте maio в качестве источника рекламы
Под карточкой «Водопад» в разделе « Источники объявлений » выберите «Добавить источник объявлений» . Затем выберите майо .
Выберите maio и включите переключатель «Оптимизировать» . Введите идентификатор API и ключ API, полученные в предыдущем разделе, чтобы настроить оптимизацию источника рекламы для maio. Затем введите значение эффективной цены за тысячу показов для maio и нажмите «Продолжить» .
Если у вас уже есть сопоставление для maio, вы можете выбрать его. В противном случае нажмите «Добавить сопоставление» .
Затем введите идентификатор носителя и идентификатор зоны, полученные в предыдущем разделе. Затем нажмите Готово .
Шаг 3. Импортируйте maio SDK и адаптер.
Использование CocoaPods (рекомендуется)
Добавьте следующую строку в подфайл вашего проекта:
pod 'GoogleMobileAdsMediationMaio'
Из командной строки выполните:
pod install --repo-update
Ручная интеграция
- Загрузите последнюю версию maio SDK .
- Загрузите последнюю версию адаптера maio по ссылке в журнале изменений и свяжите
maioAdapter.framework
с вашим проектом.
Шаг 4. Добавьте необходимый код
Интеграция со SKAdNetwork
Следуйте документации maio , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist
вашего проекта.
Шаг 5. Проверьте свою реализацию
Включить тестовые объявления
Обязательно зарегистрируйте тестовое устройство в AdMob.
Издатели, использующие 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
- Первый выпуск!
- Добавлена поддержка межстраничных объявлений и видеообъявлений с вознаграждением.