В этом руководстве показано, как использовать Google Mobile Ads Flutter Plugin для загрузки и отображения объявлений из Moloco с использованием медиации , включая интеграцию с системой назначения ставок. В нем рассматривается, как добавить Moloco в конфигурацию медиации рекламного блока, а также как интегрировать SDK и адаптер Moloco в приложение Flutter.
Поддерживаемые интеграции и форматы рекламы
Адаптер медиации Ad Manager для Moloco обладает следующими возможностями:
| Интеграция | |
|---|---|
| Торги | |
| Водопад | |
| Форматы | |
| Приложение открыто | |
| Баннер | |
| Интерстициальный | |
| Награжден | |
| Вознагражденный интерстициальный | |
| Родной | |
Требования
- Новейший Google Mobile Ads Flutter Plugin
- Flutter 3.7.0 или выше
- Для развертывания на Android
- Android API уровня 23 или выше
- Для развертывания на iOS
- Целевая версия iOS для развертывания — 13.0 или выше.
- Рабочий Flutter-проект, настроенный с использованием Google Mobile Ads Flutter Plugin . Подробности см. в разделе «Настройка Google Mobile Ads Flutter Plugin .
- Организуйте посредничество.
Шаг 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.4.0
Ручная интеграция
Загрузите последнюю версию плагина медиации Google Mobile Ads для Moloco Ads SDK , распакуйте загруженный файл и добавьте распакованную папку плагина (и ее содержимое) в свой проект Flutter. Затем добавьте ссылку на плагин в файл pubspec.yaml , добавив следующую зависимость:
dependencies:
gma_mediation_moloco:
path: path/to/local/package
Шаг 4: Добавьте необходимый код
Для интеграции с Moloco дополнительный код не требуется.
Шаг 5: Протестируйте свою реализацию.
Включить тестовые объявления
Обязательно зарегистрируйте ваше тестовое устройство в Ad Manager.
Проверить тестовые объявления
To verify that you are receiving test ads from Moloco Ads SDK, enable single ad source testing in ad inspector using the Moloco (Bidding) ad source(s).
коды ошибок
Если адаптер не получает объявление от 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
Версия 3.5.0 (в разработке)
Версия 3.4.0
- Обновлена минимальная версия Flutter до 3.38.1.
- Обновлено для поддержки плагина Google Mobile Ads Flutter версии 8.0.0.
- Поддерживает адаптер Moloco Android версии 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.
- Поддерживает адаптер Moloco Android версии 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
- Поддерживает адаптер Moloco Android версии 4.2.0.0 .
- Поддерживает адаптер Moloco для iOS версии 3.13.0.0 .
- Built and tested with the Google Mobile Ads Flutter Plugin version 6.0.0.
Версия 2.0.0
- Поддерживает адаптер Moloco Android версии 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 .
- Built and tested with the Google Mobile Ads Flutter Plugin version 6.0.0.
Версия 1.5.0
- Supports Moloco Android adapter version 3.11.0.0 .
- Поддерживает адаптер Moloco для iOS версии 3.11.0.0 .
- Built and tested with the Google Mobile Ads Flutter Plugin version 6.0.0.
Версия 1.4.0
- Supports Moloco Android adapter version 3.10.0.0 .
- Поддерживает адаптер Moloco для iOS версии 3.10.0.0 .
- Built and tested with the Google Mobile Ads Flutter Plugin version 6.0.0.
Версия 1.3.1
- Supports Moloco Android adapter version 3.9.0.0 .
- Поддерживает адаптер Moloco для iOS версии 3.9.1.0 .
- Built and tested with the Google Mobile Ads Flutter Plugin version 6.0.0.
Версия 1.3.0
- Supports Moloco Android adapter version 3.9.0.0 .
- Поддерживает адаптер Moloco для iOS версии 3.9.0.0 .
- Built and tested with the Google Mobile Ads Flutter Plugin version 6.0.0.
Версия 1.2.0
- Supports Moloco Android adapter version 3.8.0.1 .
- Поддерживает адаптер Moloco для iOS версии 3.8.0.0 .
- Built and tested with the Google Mobile Ads Flutter Plugin version 6.0.0.
Версия 1.1.0
- Supports Moloco Android adapter version 3.7.0.0 .
- Поддерживает адаптер Moloco для iOS версии 3.6.0.0 .
- Built and tested with the Google Mobile Ads Flutter Plugin version 5.3.1.
Версия 1.0.0
- Первый релиз.
- Supports Moloco Android adapter version 3.6.1.0 .
- Поддерживает адаптер Moloco для iOS версии 3.6.0.0 .
- Built and tested with the Google Mobile Ads Flutter Plugin version 5.3.1.