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

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

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

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

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

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

Требования

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

  • Android API уровня 24 или более поздней версии.

  • Адаптер Moloco 3.8.0.0 или более поздней версии.

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

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

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

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

После создания приложения выберите его на вкладке Apps (Приложения), чтобы посмотреть сведения о нем, и запишите App Key (Ключ приложения).

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

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

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

Шаг 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 на уровне приложения добавьте следующие зависимости и конфигурации. Используйте последние версии SDK и адаптера Moloco:

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:moloco:4.13.0.0")
}

Шаг 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. Если вы решите установить эти пометки, рекомендуем сделать это до запроса объявлений через Google Mobile Ads SDK (Legacy).

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.getAdapterResponses() в следующих классах:

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

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

Версия 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.