Интегрируйте maio с медиацией

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

Интерфейс панели управления Maio использует японский текст для надписей, кнопок и описаний, и скриншоты в этом руководстве не переведены. Однако в описаниях и инструкциях данного руководства надписи и кнопки обозначаются их английскими эквивалентами. Например, «URL スキーム» — это «URL Scheme».

Поддерживаемые интеграции и форматы рекламы

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

Интеграция
Торги
Водопад
Форматы
Баннер
Интерстициальный
Награжден
Родной

Требования

  • Цель развертывания iOS 12.0 или выше

Шаг 1: Настройка конфигураций в пользовательском интерфейсе Maio

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

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

Интерстициальный

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

Награжден

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

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

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

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

Шаг 2: Настройте спрос Maio в пользовательском интерфейсе AdMob

Настройте параметры медиации для вашего рекламного блока

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

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

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

Введите формат и платформу рекламы, затем нажмите «Продолжить» .

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

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

Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками:

Добавить maio как источник рекламы


На карточке «Водопад» в разделе «Источники рекламы» выберите «Добавить источник рекламы» .

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



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

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


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

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

    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 в следующих классах:

Формат Имя класса
Интерстициальный 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

  • Первый релиз!
  • Добавлена поддержка полноэкранной рекламы и видеорекламы с вознаграждением.