Как интегрировать Moloco с медиацией

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

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

Поддерживаемые интеграции и форматы объявлений

Адаптер медиации Менеджера рекламы для 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

Перейдите на вкладку Обзор > Рекламные блоки, выберите приложение в раскрывающемся меню и нажмите Новый рекламный блок.

Выберите Назначение ставок в приложении в качестве метода аукциона и заполните остальные поля формы. Затем нажмите Создать.

Перейдите на вкладку Рекламные блоки и найдите созданный вами рекламный блок, чтобы посмотреть его сведения. Запишите идентификатор рекламного блока.

Шаг 2. Настройте источник спроса Moloco Ads SDK в интерфейсе Менеджера рекламы

Как настроить медиацию для рекламного блока

Android

Инструкции приведены в разделе "Шаг 2" Android.

iOS

Инструкции приведены в разделе "Шаг 2" руководства для iOS.

Как добавить Moloco Ads в список рекламных партнеров для GDPR и законов штатов США

Чтобы добавить Moloco Ads в список рекламных партнеров, соблюдающих европейские регламенты и законы штатов США, в интерфейсе Менеджера рекламы, выполните инструкции из разделов Настройки европейских регламентов и Настройки законов штатов США.

Шаг 3. Импортируйте Moloco Ads SDK и адаптер

Интеграция через pub.dev

Добавьте в файл pubspec.yaml пакета следующую зависимость с последними версиями Moloco Ads SDK и адаптера:

dependencies:
  gma_mediation_moloco: ^3.7.1

Интеграция с настройкой вручную

Скачайте последнюю версию плагина медиации Google Mobile Ads для Moloco Ads SDK, извлеките скачанный файл и добавьте извлеченную папку плагина (и ее содержимое) в проект Flutter. Затем добавьте в файл pubspec.yaml следующую зависимость:

dependencies:
  gma_mediation_moloco:
    path: path/to/local/package

Шаг 4. Настройте параметры конфиденциальности в Moloco SDK

Чтобы соблюдать правила Google в отношении согласия пользователей из ЕС, вы должны предоставлять определенную информацию пользователям из Европейской экономической зоны (ЕЭЗ), Великобритании и Швейцарии и получать их согласие на использование файлов cookie или других решений, предназначенных для локального хранения данных, в случаях, предусмотренных законом, а также на сбор, передачу и использование персональных данных для персонализации рекламы. Эти правила отражают требования, изложенные в Директиве ЕС о конфиденциальности и электронных средствах связи и Генеральном регламенте ЕС о защите персональных данных (GDPR). Вы должны убедиться, что согласие передается каждому источнику объявлений в цепочке медиации.

Адаптер Moloco Ads SDK для Flutter версии 1.0.0 и более поздних поддерживает передачу сигналов согласия по GDPR от платформ для запросов согласия, интегрированных со спецификацией Transparency and Consent Framework (TCF) от IAB, в Moloco Ads SDK. Дополнительную информацию можно найти в документации по MolocoPrivacy для Android и строке согласия TCF для iOS.

Законы штатов США о конфиденциальности

Законы штатов США о конфиденциальности требуют предоставлять пользователям право запретить "продажу" их "личной информации" (эти термины определены в тексте закона). Компания, подпадающая под действие закона, обязана разместить на главной странице "продавца" заметную ссылку с текстом "Запретить продажу личных данных". В руководстве по соблюдению законов штатов США о конфиденциальности можно включить ограничение обработки данных для показа объявлений Google, но Google не может применить эту настройку ко всем рекламным сетям в цепочке медиации. Поэтому вам необходимо определить, какие рекламные сети в вашей цепочке медиации могут участвовать в продаже личной информации, и следовать инструкциям каждой из этих сетей, чтобы обеспечить соблюдение требований.

Плагин медиации Google Mobile Ads Unity для Moloco Ads SDK включает метод Moloco.SetDoNotSell(bool), который позволяет передавать информацию о согласии в Moloco Ads SDK. В приведенном ниже примере кода показано, как передать информацию о согласии в Moloco Ads SDK. Если вы решите задать эти флаги, рекомендуем сделать это до запроса объявлений через Google Mobile Ads Flutter Plugin.

import 'package:gma_mediation_moloco/gma_mediation_moloco.dart';
// ...

GmaMediationMoloco.setDoNotSell(true);

Подробные инструкции по реализации рекламного SDK Moloco Ads для Android и iOS приведены в рекомендациях.

Шаг 5. Добавьте обязательный код

Для интеграции Moloco Ads SDK не требуется дополнительный код.

Шаг 6. Проверьте реализацию

Как включить тестовые объявления

Зарегистрируйте тестовое устройство в Менеджере рекламы.

Как проверить тестовые объявления

Чтобы убедиться, что вы получаете тестовые объявления из 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, возвращенный в ответе, имеет значение null.
От -1 до 5000 com.moloco.sdk SDK Moloco вернул ошибку. Подробная информация приведена в документации 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 SDK Moloco вернул ошибку. Подробная информация приведена в документации Moloco.

Журнал изменений адаптера медиации Moloco для Flutter

Версия 3.7.1

Версия 3.7.0

Версия 3.6.1

Версия 3.6.0

Версия 3.5.1

Версия 3.5.0

Версия 3.4.0

Версия 3.3.0

Версия 3.2.0

Версия 3.1.0

Версия 3.0.0

Версия 2.1.0

Версия 2.0.0

Версия 1.6.0

Версия 1.5.0

Версия 1.4.0

Версия 1.3.1

Версия 1.3.0

Версия 1.2.0

Версия 1.1.0

Версия 1.0.0