В этом руководстве показано, как использовать Google Mobile Ads Flutter Plugin для загрузки и отображения рекламы из Moloco Ads SDK с помощью медиации , включая интеграцию с системой назначения ставок. В нем рассматривается, как добавить Moloco Ads SDK в конфигурацию медиации рекламного блока, а также как интегрировать SDK и адаптер Moloco Ads SDK в приложение Flutter.
Поддерживаемые интеграции и форматы рекламы
Адаптер медиации Ad Manager для Moloco Ads SDK обладает следующими возможностями:
| Интеграция | |
|---|---|
| Торги | |
| Водопад | |
| Форматы | |
| Приложение открыто | |
| Баннер | |
| Интерстициальный | |
| Награжден | |
| Вознагражденный интерстициальный | |
| Родной | |
Предварительные требования
Прежде чем продолжить, проверьте следующее:
- Последняя версия Google Mobile Ads Flutter Plugin .
- Версия фреймворка Flutter 3.7.0 или более поздняя.
- Для развертывания на Android
- Android API уровня 24 или более поздней версии.
- Для развертывания на iOS
- Целевая версия iOS — 13.0 или более поздняя.
- Рабочий Flutter-проект, настроенный с использованием Google Mobile Ads Flutter Plugin . Подробности см. в разделе «Настройка Google Mobile Ads Flutter Plugin .
- Организуйте посредничество .
Шаг 1: Настройка параметров в пользовательском интерфейсе Moloco Ads SDK.
Войдите в издательский портал Moloco.
Перейдите в раздел «Обзор» > вкладка «Приложения» , затем нажмите кнопку «Добавить приложение» , чтобы создать новое приложение.
Выберите операционную систему и параметры конфиденциальности для вашего приложения, заполните остальную часть формы, а затем нажмите «Создать» .
Android
iOS
После создания приложения выберите его на вкладке «Приложения» , чтобы просмотреть подробную информацию, и запишите ключ приложения .
Android
iOS
Перейдите во вкладку «Обзор» > «Рекламные блоки» , выберите приложение из выпадающего меню, а затем нажмите «Новый рекламный блок» .
Выберите «Встроенные ставки» в качестве метода аукциона и заполните остальную часть формы. Затем нажмите «Создать» .
Перейдите во вкладку «Объявления» , чтобы просмотреть подробную информацию о созданном вами рекламном блоке. Запишите идентификатор рекламного блока (Ad Unit ID ).
Шаг 2: Настройте запрос Moloco Ads SDK в пользовательском интерфейсе Ad Manager.
Настройте параметры медиации для вашего рекламного блока.
Android
Инструкции см. в шаге 2 руководства для Android .
iOS
Инструкции см. в шаге 2 руководства для iOS .
Add Moloco Ads to GDPR and US state regulations ad partners list
Чтобы добавить Moloco Ads в список рекламных партнеров, соответствующих европейским и американским государственным нормативным требованиям, в пользовательском интерфейсе Ad Manager, выполните действия, описанные в настройках европейских и американских нормативных требований.
Шаг 3: Импортируйте SDK и адаптер Moloco Ads SDK.
Интеграция через pub.dev
Add the following dependency with the latest versions of the Moloco Ads SDK SDK and adapter in your package's pubspec.yaml file:
dependencies:
gma_mediation_moloco: ^3.7.0
Ручная интеграция
Загрузите последнюю версию плагина медиации Google Mobile Ads для Moloco Ads SDK , распакуйте загруженный файл и добавьте распакованную папку плагина (и ее содержимое) в свой проект Flutter. Затем добавьте ссылку на плагин в файл pubspec.yaml , добавив следующую зависимость:
dependencies:
gma_mediation_moloco:
path: path/to/local/package
Шаг 4: Добавьте необходимый код
No additional code is required for Moloco Ads SDK integration.
Шаг 5: Протестируйте свою реализацию.
Включить тестовые объявления
Обязательно зарегистрируйте ваше тестовое устройство в Ad Manager.
Проверить тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от Moloco Ads SDK, включите тестирование по одному источнику объявлений в инспекторе объявлений, используя источники объявлений Moloco (для торгов ).
коды ошибок
If the adapter fails to receive an ad from Moloco, publishers can check the underlying error from the ad response using ResponseInfo under the following classes:
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 does not support serving ads on iOS 12 and below. |
| 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. |
Список изменений адаптера Moloco Flutter Mediation
Версия 3.7.1 (в разработке)
Версия 3.7.0
- Supports Moloco Android adapter version 4.12.0.0 .
- Поддерживает адаптер Moloco для iOS версии 4.10.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 9.1.0.
Версия 3.6.1
- Обновлено для поддержки плагина Google Mobile Ads Flutter версии 9.1.0.
- Добавлена поддержка Swift Package Manager.
- Supports Moloco Android adapter version 4.11.1.0 .
- Поддерживает адаптер Moloco для iOS версии 4.9.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 9.1.0.
Версия 3.6.0
- Supports Moloco Android adapter version 4.11.0.0 .
- Поддерживает адаптер Moloco для iOS версии 4.9.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 9.0.0.
Версия 3.5.1
- Supports Moloco Android adapter version 4.10.1.0 .
- Поддерживает адаптер Moloco для iOS версии 4.8.1.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 9.0.0.
Версия 3.5.0
- Supports Moloco Android adapter version 4.10.0.0 .
- Поддерживает адаптер Moloco для iOS версии 4.8.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 9.0.0.
Версия 3.4.0
- Обновлена минимальная версия Flutter до 3.38.1.
- Обновлено для поддержки плагина Google Mobile Ads Flutter версии 8.0.0.
- Supports Moloco Android adapter version 4.7.0.0 .
- Поддерживает адаптер Moloco для iOS версии 4.5.1.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 8.0.0.
Версия 3.3.0
- Supports Moloco Android adapter version 4.5.0.0 .
- Поддерживает адаптер Moloco для iOS версии 4.3.0.2 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 7.0.0.
Версия 3.2.0
- Supports Moloco Android adapter version 4.4.0.0 .
- Поддерживает адаптер Moloco для iOS версии 4.2.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 7.0.0.
Версия 3.1.0
- Обновлена минимальная версия Flutter до 3.35.1.
- Supports Moloco Android adapter version 4.4.0.0 .
- Поддерживает адаптер Moloco для iOS версии 4.1.2.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 7.0.0.
Версия 3.0.0
- Supports Moloco Android adapter version 4.3.1.0 .
- Поддерживает адаптер Moloco для iOS версии 4.1.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 2.1.0
- Supports Moloco Android adapter version 4.2.0.0 .
- Поддерживает адаптер Moloco для iOS версии 3.13.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 2.0.0
- Supports Moloco Android adapter version 4.0.0.0 .
- Поддерживает адаптер Moloco для iOS версии 3.13.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 1.6.0
- Supports Moloco Android adapter version 3.12.0.0 .
- Поддерживает адаптер Moloco для iOS версии 3.12.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 1.5.0
- Supports Moloco Android adapter version 3.11.0.0 .
- Поддерживает адаптер Moloco для iOS версии 3.11.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 1.4.0
- Supports Moloco Android adapter version 3.10.0.0 .
- Поддерживает адаптер Moloco для iOS версии 3.10.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 1.3.1
- Supports Moloco Android adapter version 3.9.0.0 .
- Поддерживает адаптер Moloco для iOS версии 3.9.1.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 1.3.0
- Supports Moloco Android adapter version 3.9.0.0 .
- Поддерживает адаптер Moloco для iOS версии 3.9.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 1.2.0
- Supports Moloco Android adapter version 3.8.0.1 .
- Поддерживает адаптер Moloco для iOS версии 3.8.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 1.1.0
- Supports Moloco Android adapter version 3.7.0.0 .
- Поддерживает адаптер Moloco для iOS версии 3.6.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 5.3.1.
Версия 1.0.0
- Первый релиз.
- Supports Moloco Android adapter version 3.6.1.0 .
- Поддерживает адаптер Moloco для iOS версии 3.6.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 5.3.1.