В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы из Maio с помощью медиации , включая каскадную интеграцию. В нём также рассказывается, как добавить Maio в конфигурацию медиации рекламного блока, а также как интегрировать Maio SDK и адаптер в приложение iOS.
Интерфейс панели управления Maio использует японский текст для надписей, кнопок и описаний, и скриншоты в этом руководстве не переведены. Однако в описаниях и инструкциях данного руководства надписи и кнопки обозначаются их английскими эквивалентами. Например, «URL スキーム» — это «URL Scheme».
Поддерживаемые интеграции и форматы рекламы
Адаптер-посредник для maio имеет следующие возможности:
Интеграция | |
---|---|
Торги | |
Водопад | |
Форматы | |
Баннер | |
Интерстициальный | |
Награжден | |
Родной |
Требования
- Цель развертывания iOS 12.0 или выше
Последняя версия Google Mobile Ads SDK
Завершить посредничество . Руководство по началу работы.
Шаг 1: Настройка конфигураций в пользовательском интерфейсе Maio
Сначала зарегистрируйтесь или войдите в свою учётную запись Maio. Нажмите кнопку «Управление приложениями» на левой боковой панели и выберите «Новое приложение» .
Выберите вкладку, соответствующую предпочитаемому вами типу объявления .
Интерстициальный
Введите название приложения, выберите платформу и укажите URL-адрес приложения . Выберите «Видеообъявление» в качестве типа рекламы и нажмите «Обновить» .
Награжден
Введите название приложения, выберите платформу и укажите URL-адрес приложения . Выберите «Видеорекорды» в качестве типа рекламы и нажмите «Обновить» .
На странице управления приложениями запишите идентификатор медиа . Он понадобится для настройки рекламного блока Менеджера рекламы в следующем разделе.
На странице «Управление зоной» запишите идентификатор зоны . Он также понадобится для настройки рекламного блока Ad Manager в следующем разделе.
Шаг 2: Настройте спрос на рекламу в пользовательском интерфейсе Менеджера рекламы
Настройте параметры медиации для вашего рекламного блока
Войдите в свою учетную запись Менеджера рекламы .
Перейдите в раздел Доставка > Группы доходности и нажмите кнопку Новая группа доходности .
Введите уникальное название для группы доходности, установите статус « Активно» , выберите формат рекламы и тип инвентаря «Мобильное приложение» . В разделе «Таргетинг» > «Инвентарь» выберите рекламный блок в разделе «Инвентарь» и «Мобильное приложение» , к которому вы хотите добавить медиацию.
Затем нажмите кнопку Добавить партнера по доходности .
Если у вас уже есть партнёр по доходности для maio, вы можете выбрать его. В противном случае выберите «Создать нового партнёра по доходности» .
Выберите maio в качестве рекламной сети , введите уникальное имя и включите посредничество .
Включите автоматический сбор данных и введите API ID и API KEY, полученные в предыдущем разделе.
После выбора партнера по доходности выберите Mobile SDK Mediation в качестве типа интеграции , iOS в качестве платформы и Active в качестве статуса . Введите идентификатор медиа и идентификатор зоны, полученные в предыдущем разделе. Затем укажите значение CPM по умолчанию .
По завершении нажмите кнопку «Сохранить» внизу страницы.
Шаг 3: Импортируйте maio SDK и адаптер
Использование CocoaPods (рекомендуется)
Добавьте следующую строку в Podfile вашего проекта:
pod 'GoogleMobileAdsMediationMaio'
В командной строке выполните:
pod install --repo-update
Ручная интеграция
- Загрузите последнюю версию maio SDK .
- Загрузите последнюю версию адаптера maio по ссылке в журнале изменений и добавьте
maioAdapter.framework
в свой проект.
Шаг 4: Добавьте необходимый код
Интеграция SKAdNetwork
Следуйте документации maio , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist
вашего проекта.
Шаг 5: Проверьте свою реализацию
Включить тестовые объявления
Обязательно зарегистрируйте свое тестовое устройство в Ad Manager.
Издатели, использующие версию Google Mobile Ads SDK 7.26.0 или выше, будут автоматически получать тестовые объявления от maio на телефоны и планшеты, зарегистрированные в качестве тестовых устройств, при отправке запросов.
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от Maio, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений Maio (Waterfall ).
Коды ошибок
Если адаптеру не удается получить рекламу от maio, издатели могут проверить основную ошибку в ответе на рекламу, используя GADResponseInfo.adNetworkInfoArray
в следующих классах:
Формат | Имя класса |
---|---|
Интерстициальный | GADMMaioInterstitialAdapter |
Награжден | GADMMaioRewardedAdapter |
Вот коды и сопроводительные сообщения, выдаваемые адаптером Maio, когда реклама не загружается:
Код ошибки | Причина |
---|---|
0-10 | maio вернул ошибку, специфичную для SDK. Подробнее см. в коде maio. |
101 | У maio пока нет доступной рекламы. |
102 | Неверные параметры сервера (например, отсутствует идентификатор размещения). |
103 | Адаптер maio не поддерживает запрошенный формат рекламы. |
104 | Для этой конфигурации сети уже загружено объявление. |
Журнал изменений адаптера-посредника Maio iOS
Следующая версия
- Включите -fobjc-arc и -fstack-protector-all.
Версия 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-альфа.
Версия 1.6.3.0
- Обновлен адаптер для использования API
didRewardUser
. - Теперь требуется 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-альфа.
Версия 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-альфа.
Версия 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-альфа.
Версия 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-alpha.
Создано и протестировано с помощью:
- 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-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-альфа.
Версия 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
- Первый релиз!
- Добавлена поддержка полноэкранной рекламы и видеорекламы с вознаграждением.