Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

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

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

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

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

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

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

Требования

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

Последняя версия GMA Next-Gen SDK.
Настройте медиацию.

Шаг 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

Интеграция с Android Studio (рекомендуется)

В файле 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.12.0.1")
}

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

Согласие пользователей из ЕС и GDPR

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

В Moloco SDK есть флаг isUserConsent для передачи информации о согласии в Moloco SDK.

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

Kotlin

val privacySettings = PrivacySettings(isUserConsent = true)
MolocoPrivacy.setPrivacy(privacySettings)MolocoMediationSnippets.kt

Java

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

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

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

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

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

Kotlin

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

Java

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

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