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

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

В этом руководстве рассказывается, как с помощью GMA Next-Gen SDK загружать и показывать медийные объявления от Moloco, используя медиацию, а также как настроить интеграцию назначения ставок. В ней рассказывается, как добавить Moloco в конфигурацию медиации рекламного блока, а также как интегрировать SDK и адаптер Moloco в приложение для Android.

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

Адаптер для медиации Moloco поддерживает следующие функции:

Интеграция
Ставки
Водопад
Форматы
Открытие приложения
Баннер
Межстраничное объявление
Бонус предоставлен
Межстраничное объявление с вознаграждением
Стандартное

Требования

Прежде чем продолжить, убедитесь, что:

Шаг 1. Задайте настройки в интерфейсе Moloco

Войдите на портал издателя Moloco.

Перейдите на вкладку Обзор > Приложения и нажмите кнопку Добавить приложение, чтобы создать новое приложение.

Выберите ОС и Настройки конфиденциальности для приложения, заполните остальные поля формы и нажмите Создать.

После создания приложения выберите его на вкладке Приложения, чтобы посмотреть сведения и записать ключ приложения.

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

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

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

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

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

Включить передачу защищенных сигналов

Нажмите Администрирование > Глобальные настройки. Перейдите на вкладку Настройки аккаунта Ad Exchange и включите функцию Передача защищенных сигналов. Нажмите Сохранить.

Как передавать защищенные сигналы в запросах ставок

Нажмите Инвентарь > Защищенные сигналы. В разделе Защищенные сигналы найдите Moloco Ads SDK и включите Интеграцию с приложениями.

Нажмите Сохранить.

Как разрешить передачу защищенных сигналов для назначения ставок в SDK

Нажмите Выполнение > Настройки каналов спроса. На вкладке Настройки по умолчанию сдвиньте переключатель Разрешить передачу защищенных сигналов вправо для назначения ставок в SDK.

Нажмите Сохранить.

Как настроить назначение ставок в Moloco

Перейдите в раздел Выполнение > Системы назначения ставок и нажмите Перейти к назначению ставок в SDK.

Нажмите Новая система назначения ставок.

Выберите Moloco Ads в качестве системы назначения ставок.

Нажмите Продолжить, чтобы включить назначение ставок в SDK для этой системы назначения ставок.

Нажмите Готово.

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

Перейдите в раздел Выполнение > Системы назначения ставок и нажмите Перейти к назначению ставок в SDK.

Выберите компанию для Moloco Ads SDK.

Перейдите на вкладку Сопоставление рекламных блоков и нажмите Новое сопоставление рекламных блоков.

Выберите Определенный рекламный блок. Выберите рекламный блок и формат, а также укажите Мобильное приложение в качестве типа инвентаря и мобильное приложение. Затем введите ключ приложения и идентификатор рекламного блока, полученные в предыдущем разделе.

Нажмите Сохранить.

Как добавить Moloco Ads в список рекламных партнеров, соблюдающих европейские регламенты и законы штатов США

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

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

В файле build.gradle.kts на уровне приложения добавьте следующие зависимости и конфигурации. Используйте последние версии Moloco SDK и адаптера:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:moloco:4.13.0.0")
}

configurations {
    all {
        exclude(group = "com.google.android.gms", module = "play-services-ads")
        exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
    }
}

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

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

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

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

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

В Moloco SDK есть флаг isDoNotSell, который позволяет передавать информацию о согласии в Moloco SDK.

В примере кода ниже показано, как передавать информацию о согласии в Moloco SDK. Если вы решите задать эти флаги, рекомендуем сделать это до того, как запрашивать объявления через GMA Next-Gen SDK.

Kotlin 

val privacySettings = PrivacySettings(isDoNotSell = true)
MolocoPrivacy.setPrivacy(privacySettings)

Java 

PrivacySettings privacySettings =
    new PrivacySettings(
        /* isUserConsent= */ false, /* isAgeRestrictedUser= */ false, /* isDoNotSell= */ true);
MolocoPrivacy.setPrivacy(privacySettings);

Подробнее о Moloco SDK для Android…

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

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

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

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

Чтобы убедиться, что вы получаете тестовые объявления из Moloco Ads SDK, включите тестирование отдельного источника объявлений в инспекторе объявлений, используя источник объявлений Moloco (назначение ставок).

Коды ошибок

Если адаптеру не удается получить объявление от Moloco, вы можете проверить основную ошибку в ответе на запрос объявления, используя ResponseInfo.getAdSourceResponses() в следующих классах:

com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter

Ниже приведены коды и сообщения об ошибках, которые возвращает адаптер Moloco, когда не удается загрузить объявление.

Код ошибки Поместье Причина
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 Moloco SDK вернул ошибку. Подробную информацию можно найти в документации Moloco.

Журнал изменений адаптера Moloco Android Mediation

Версия 4.13.0.0

  • Подтверждена совместимость с Moloco SDK 4.13.0.

Разработано и протестировано с помощью:

  • Google Mobile Ads SDK версии 25.5.0.
  • Google Mobile Ads Next-Gen SDK версии 1.5.0.
  • Moloco SDK версии 4.13.0.

Версия 4.12.0.1

  • Закрепите зависимость Kotlin адаптера на версии 1.9.0 (минимальная версия Kotlin, поддерживаемая GMA NextGen SDK).

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 25.4.0.
  • Google Mobile Ads Next-Gen SDK версии 1.4.0.
  • Версия Moloco SDK 4.12.0.

Версия 4.12.0.0

  • Подтверждена совместимость с Moloco SDK 4.12.0.

Разработано и протестировано с помощью:

  • Google Mobile Ads SDK версии 25.4.0.
  • Google Mobile Ads Next-Gen SDK версии 1.4.0.
  • Moloco SDK версии 4.12.0.

Версия 4.11.1.0

  • Теперь регистрируется показ объявления, когда нативное объявление появляется на экране.
  • Фиксированные баннеры, вызывающие обратный вызов onAdOpened при нажатии, а не при показе.
  • Подтверждена совместимость с Moloco SDK 4.11.1.

Разработано и протестировано с помощью:

  • Google Mobile Ads SDK версии 25.4.0.
  • Google Mobile Ads Next-Gen SDK версии 1.3.1.
  • Moloco SDK версии 4.11.1.

Версия 4.11.0.0

  • В адаптер медиации Moloco добавлена поддержка адаптивных баннеров.
  • Подтверждена совместимость с Moloco SDK 4.11.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 25.4.0.
  • Google Mobile Ads Next-Gen SDK версии 1.3.1.
  • Moloco SDK версии 4.11.0.

Версия 4.10.1.0

  • Подтверждена совместимость с Moloco SDK версии 4.10.1.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 25.4.0.
  • Google Mobile Ads Next-Gen SDK версии 1.2.1.
  • Moloco SDK версии 4.10.1.

Версия 4.10.0.0

  • Сопоставляется с настройками возрастных ограничений Moloco AgeRestrictedTreatment.
  • Подтверждена совместимость с Moloco SDK 4.10.0.

Разработано и протестировано с помощью:

  • Google Mobile Ads SDK версии 25.4.0.
  • Google Mobile Ads Next-Gen SDK версии 1.2.1.
  • Moloco SDK версии 4.10.0.

Версия 4.9.0.0

  • Подтверждена совместимость с Moloco SDK версии 4.9.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 25.3.0.
  • Google Mobile Ads Next-Gen SDK версии 1.1.1.
  • Moloco SDK версии 4.9.0.

Версия 4.9.0.0 (в процессе)

Версия 4.8.1.0

  • Подтверждена совместимость с Moloco SDK 4.8.1.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 25.2.0.
  • Google Mobile Ads Next-Gen SDK версии 1.0.1.
  • Moloco SDK версии 4.8.1.

Версия 4.8.0.0

  • Теперь в Moloco.initialize() передается контекст приложения, а не контекст действия, чтобы избежать утечки памяти.
  • Подтверждена совместимость с Moloco SDK 4.8.0.

Разработано и протестировано с помощью:

  • Google Mobile Ads SDK версии 25.2.0.
  • Google Mobile Ads Next-Gen SDK версии 0.25.0-beta01.
  • Moloco SDK версии 4.8.0.

Версия 4.7.0.0

  • Добавлено свойство для создания адаптера с зависимостью GMA Next-Gen SDK.
  • Подтверждена совместимость с Moloco SDK 4.7.0.

Разработано и протестировано с помощью:

  • Google Mobile Ads SDK версии 25.1.0.
  • Google Mobile Ads Next-Gen SDK версии 0.25.0-beta01.
  • Moloco SDK версии 4.7.0.

Версия 4.6.0.0

  • Подтверждена совместимость с Moloco SDK 4.6.0.

Разработано и протестировано с помощью:

  • Google Mobile Ads SDK версии 24.9.0.
  • Moloco SDK версии 4.6.0.

Версия 4.5.0.0

  • Подтверждена совместимость с Moloco SDK 4.5.0.

Разработано и протестировано с помощью:

  • Google Mobile Ads SDK версии 24.9.0.
  • Moloco SDK версии 4.5.0.

Версия 4.4.0.0

  • Подтверждена совместимость с Moloco SDK 4.4.0.

Разработано и протестировано с помощью:

  • Google Mobile Ads SDK версии 24.9.0.
  • Moloco SDK версии 4.4.0.

Версия 4.3.1.0

  • Подтверждена совместимость с Moloco SDK 4.3.1.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 24.8.0.
  • Moloco SDK версии 4.3.1.

Версия 4.2.1.0

  • Подтверждена совместимость с Moloco SDK 4.2.1.

Разработано и протестировано с помощью:

  • Google Mobile Ads SDK версии 24.7.0.
  • Moloco SDK версии 4.2.1.

Версия 4.2.0.0

  • Проверена совместимость с Moloco SDK 4.2.0.

Разработано и протестировано с помощью:

  • Google Mobile Ads SDK версии 24.7.0.
  • Moloco SDK версии 4.2.0.

Версия 4.1.1.0

  • Подтверждена совместимость с Moloco SDK 4.1.1.

Разработано и протестировано с помощью:

  • Google Mobile Ads SDK версии 24.7.0.
  • Moloco SDK версии 4.1.1.

Версия 4.1.0.0

  • Подтверждена совместимость с Moloco SDK 4.1.0.

Разработано и протестировано с помощью:

  • Google Mobile Ads SDK версии 24.6.0.
  • Moloco SDK версии 4.1.0.

Версия 4.0.0.0

  • Подтверждена совместимость с Moloco SDK 4.0.0.

Разработано и протестировано с помощью:

  • Google Mobile Ads SDK версии 24.5.0.
  • Moloco SDK версии 4.0.0.

Версия 3.12.1.0

  • Подтверждена совместимость с Moloco SDK 3.12.1.

Разработано и протестировано с помощью:

  • Google Mobile Ads SDK версии 24.5.0.
  • Moloco SDK версии 3.12.1.

Версия 3.12.0.0

  • Подтверждена совместимость с Moloco SDK 3.12.0.

Разработано и протестировано с помощью:

  • Google Mobile Ads SDK версии 24.4.0.
  • Moloco SDK версии 3.12.0.

Версия 3.11.0.0

  • Подтверждена совместимость с Moloco SDK 3.11.0.

Разработано и протестировано с помощью:

  • Google Mobile Ads SDK версии 24.4.0.
  • Moloco SDK версии 3.11.0.

Версия 3.10.0.0

  • Подтверждена совместимость с Moloco SDK 3.10.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 24.3.0.
  • Moloco SDK версии 3.10.0.

Версия 3.9.0.0

  • Проверена совместимость с Moloco SDK версии 3.9.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 24.2.0.
  • Moloco SDK версии 3.9.0.

Версия 3.8.0.1

  • Добавлена поддержка среднего прямоугольного баннера.

Разработано и протестировано с помощью:

  • Google Mobile Ads SDK версии 24.1.0.
  • Moloco SDK версии 3.8.0.

Версия 3.8.0.0

  • Добавлена поддержка назначения ставок для формата нативных объявлений.
  • Подтверждена совместимость с Moloco SDK 3.8.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 24.1.0.
  • Moloco SDK версии 3.8.0.

Версия 3.7.2.0

  • Подтверждена совместимость с Moloco SDK 3.7.2.

Разработано и протестировано с помощью:

  • Google Mobile Ads SDK версии 24.0.0.
  • Moloco SDK версии 3.7.2.

Версия 3.7.1.0

  • Минимальный уровень Android API теперь 23.
  • Минимальная версия Google Mobile Ads SDK теперь 24.0.0.
  • Подтверждена совместимость с Moloco SDK 3.7.1.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 24.0.0.
  • Moloco SDK версии 3.7.1.

Версия 3.7.0.0

  • Подтверждена совместимость с Moloco SDK 3.7.0.

Разработано и протестировано с помощью:

  • Google Mobile Ads SDK версии 23.6.0.
  • Moloco SDK версии 3.7.0.

Версия 3.6.1.0

  • Подтверждена совместимость с Moloco SDK 3.6.1.

Разработано и протестировано с помощью:

  • Google Mobile Ads SDK версии 23.6.0.
  • Moloco SDK версии 3.6.1.

Версия 3.6.0.0

  • Подтверждена совместимость с Moloco SDK 3.6.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 23.6.0.
  • Moloco SDK версии 3.6.0.

Версия 3.5.0.0

  • Первый выпуск.
  • Добавлена поддержка назначения ставок для баннеров, межстраничных объявлений и объявлений с вознаграждением.
  • Подтверждена совместимость с Moloco SDK 3.5.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 23.6.0.
  • Moloco SDK версии 3.5.0.