В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из Moloco с использованием медиации , включая интеграцию с системой назначения ставок. В нем рассматривается, как добавить Moloco в конфигурацию медиации рекламного блока, а также как интегрировать SDK и адаптер Moloco в приложение Flutter.
Поддерживаемые интеграции и форматы рекламы
Адаптер медиации Ad Manager для Moloco обладает следующими возможностями:
| Интеграция | |
|---|---|
| Торги | |
| Водопад | |
| Форматы | |
| Приложение открыто | |
| Баннер | |
| Интерстициальный | |
| Награжден | |
| Вознагражденный интерстициальный | |
| Родной | |
Требования
- Новейший SDK для мобильной рекламы Google
- Flutter 3.7.0 или выше
- Для развертывания на Android
- Android API уровня 23 или выше
- Для развертывания на iOS
- Целевая версия iOS для развертывания — 12.0 или выше.
- Рабочий проект Flutter, настроенный с использованием Google Mobile Ads SDK. Подробности см. в разделе «Начало работы» .
- Заполните руководство по началу медиации.
Шаг 1: Настройка параметров в пользовательском интерфейсе Moloco.
Войдите в издательский портал Moloco.
Перейдите в раздел «Обзор» > вкладка «Приложения» , затем нажмите кнопку «Добавить приложение» , чтобы создать новое приложение.
Выберите операционную систему и параметры конфиденциальности для вашего приложения, заполните остальную часть формы, а затем нажмите «Создать» .
Android
iOS
После создания приложения выберите его на вкладке «Приложения» , чтобы просмотреть подробную информацию, и запишите ключ приложения .
Android
iOS
Перейдите во вкладку «Обзор» > «Рекламные блоки» , выберите приложение из выпадающего меню, а затем нажмите «Новый рекламный блок» .
Выберите «Встроенные ставки» в качестве метода аукциона и заполните остальную часть формы. Затем нажмите «Создать» .
Перейдите во вкладку «Объявления» , чтобы просмотреть подробную информацию о созданном вами рекламном блоке. Запишите идентификатор рекламного блока (Ad Unit ID ).
Шаг 2: Настройте запрос Moloco в пользовательском интерфейсе Ad Manager.
Настройте параметры медиации для вашего рекламного блока.
Android
Инструкции см. в шаге 2 руководства для Android .
iOS
Инструкции см. в шаге 2 руководства для iOS .
Добавьте Moloco Ads в список рекламных партнеров, соответствующих требованиям GDPR и законодательства штатов США.
Чтобы добавить Moloco Ads в список рекламных партнеров, соответствующих европейским и американским государственным нормативным требованиям, в пользовательском интерфейсе Ad Manager, выполните действия, описанные в настройках европейских и американских нормативных требований.
Шаг 3: Импортируйте SDK Moloco и адаптер.
Интеграция через pub.dev
Добавьте следующую зависимость с последними версиями SDK и адаптера Moloco Ads в файл pubspec.yaml вашего пакета:
dependencies:
gma_mediation_moloco: ^3.0.0
Ручная интеграция
Загрузите последнюю версию плагина медиации Google Mobile Ads для Moloco Ads SDK , распакуйте загруженный файл и добавьте распакованную папку плагина (и ее содержимое) в свой проект Flutter. Затем добавьте ссылку на плагин в файл pubspec.yaml , добавив следующую зависимость:
dependencies:
gma_mediation_moloco:
path: path/to/local/package
Шаг 4: Добавьте необходимый код
Для интеграции с Moloco дополнительный код не требуется.
Шаг 5: Протестируйте свою реализацию.
Включить тестовые объявления
Обязательно зарегистрируйте ваше тестовое устройство в Ad Manager.
Проверить тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от Moloco Ads SDK, включите тестирование по одному источнику объявлений в инспекторе объявлений, используя источники объявлений Moloco (для торгов ).
коды ошибок
Если адаптер не получает объявление от Moloco, издатели могут проверить основную причину ошибки в ответе на объявление, используя класс ResponseInfo из следующих разделов:
Android
com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter
iOS
MolocoSDK.MolocoError
GADMediationAdapterMoloco
Вот коды и соответствующие сообщения, которые выдает адаптер Moloco, когда реклама не загружается:
Android
| Код ошибки | Домен | Причина |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | Отсутствует или недействителен ключ приложения Moloco. |
| 102 | com.google.ads.mediation.moloco | Отсутствует или недействителен идентификатор рекламного блока Moloco. |
| 103 | com.google.ads.mediation.moloco | Объект объявления Moloco, возвращенный Moloco, оказался пустым (null). |
| от -1 до 5000 | com.moloco.sdk | Moloco SDK вернул ошибку. Дополнительные сведения см. в документации Moloco. |
iOS
| Код ошибки | Домен | Причина |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | Moloco SDK не поддерживает показ рекламы на iOS 12 и более ранних версиях. |
| 102 | com.google.ads.mediation.moloco | Отсутствует или недействителен ключ приложения Moloco. |
| 103 | com.google.ads.mediation.moloco | Отсутствует или недействителен идентификатор рекламного блока Moloco. |
| 104 | com.google.ads.mediation.moloco | Рекламное объявление пока не готово к показу. |
| 105 | com.google.ads.mediation.moloco | Реклама не отобразилась. |
| 106 | com.google.ads.mediation.moloco | Данные для отображения рекламы недоступны. |
| от -1 до 5000 | Отправлено с помощью Moloco SDK | Moloco SDK вернул ошибку. Дополнительные сведения см. в документации Moloco. |
Вознаграждение за проверку на стороне сервера
Если вы используете обратные вызовы проверки на стороне сервера (SSV) , идентификатор источника рекламы для Moloco будет равен 8267622065755668722 .
Список изменений адаптера Moloco Flutter Mediation
Версия 2.0.0 (в разработке)
Версия 1.6.0
- Поддерживает адаптер Moloco Android версии 3.12.0.0 .
- Поддерживает адаптер Moloco для iOS версии 3.12.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 1.5.0
- Поддерживает адаптер Moloco Android версии 3.11.0.0 .
- Поддерживает адаптер Moloco для iOS версии 3.11.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 1.4.0
- Поддерживает адаптер Moloco Android версии 3.10.0.0 .
- Поддерживает адаптер Moloco для iOS версии 3.10.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 1.3.1
- Поддерживает адаптер Moloco Android версии 3.9.0.0 .
- Поддерживает адаптер Moloco для iOS версии 3.9.1.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 1.3.0
- Поддерживает адаптер Moloco Android версии 3.9.0.0 .
- Поддерживает адаптер Moloco для iOS версии 3.9.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 1.2.0
- Поддерживает адаптер Moloco для Android версии 3.8.0.1 .
- Поддерживает адаптер Moloco для iOS версии 3.8.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 1.1.0
- Поддерживает адаптер Moloco Android версии 3.7.0.0 .
- Поддерживает адаптер Moloco для iOS версии 3.6.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 5.3.1.
Версия 1.0.0
- Первый релиз.
- Поддерживает адаптер Moloco Android версии 3.6.1.0 .
- Поддерживает адаптер Moloco для iOS версии 3.6.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 5.3.1.