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

Выберите платформу: Android (бета-версия)Новый Android iOS Unity Flutter

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

В интерфейсе панели управления maio для надписей, кнопок и описаний используется японский текст, а скриншоты в этом руководстве не переведены. Однако в описаниях и инструкциях этого руководства надписи и кнопки снабжены их английскими эквивалентами. Например, "URL スキーム" означает "URL Scheme".

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

Адаптер для посредничества на платформе Maio обладает следующими возможностями:

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

Требования

  • Целевая версия iOS для развертывания — 12.0 или выше.

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

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

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

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

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

Награжден

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

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

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

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

Шаг 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.

Чтобы добавить зависимость пакета в ваш проект, выполните следующие действия:

  1. В Xcode перейдите в меню Файл > Добавить зависимости пакета... .

  2. В появившемся окне введите следующий URL-адрес пакета:

    https://github.com/googleads/googleads-mobile-ios-mediation-maio.git
    
  3. В разделе «Правило зависимости» выберите «Ветвь» .

  4. В текстовом поле введите 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

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