Эта страница переведена с помощью Cloud Translation API.

Интеграция Moloco с торгами

Выберите платформу: Android

This guide shows you how to use Google Mobile Ads SDK to load and display ads from Moloco using mediation , covering bidding integrations. It covers how to add Moloco to an ad unit's mediation configuration, and how to integrate the Moloco SDK and adapter into an Android app.

Поддерживаемые интеграции и форматы рекламы

Адаптер для посредничества в Moloco обладает следующими возможностями:

Интеграция
Торги
Водопад
Форматы
Приложение открыто
Баннер
Интерстициальный
Награжден
Вознагражденный интерстициальный
Родной

Требования

Android API уровня 23 или выше
Адаптер Moloco версии 3.8.0.0 или выше.

Новейший Google Mobile Ads SDK
Пройдите руководство по началу процесса медиации.

Шаг 1: Настройка параметров в пользовательском интерфейсе Moloco.

Войдите в издательский портал Moloco.

Navigate to Overview > Apps tab, then click the Add App button to create a new app.

Select the OS and Privacy Settings for your app, fill out the rest of the form, and then click Create .

Once your app is created, select it from the Apps tab to view the details and take note of the App Key .

Navigate to the Overview > Ad Units tab, select the app from the drop-down menu, and then click New Ad Unit .

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

Перейдите во вкладку «Объявления» , чтобы просмотреть подробную информацию о созданном вами рекламном блоке. Запишите идентификатор рекламного блока (Ad Unit ID ).

Шаг 2: Настройте запрос Moloco в пользовательском интерфейсе Ad Manager.

Войдите в свой аккаунт в Ad Manager .

Включить безопасный обмен сигналами

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

Передайте защищенный сигнал в запросах на участие в торгах.

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

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

Обеспечьте безопасный обмен сигналами для торгов с использованием SDK.

Перейдите в раздел «Доставка» > «Настройки канала спроса» . На вкладке «Настройки по умолчанию» включите параметр «Разрешить безопасный обмен сигналами для торгов SDK» .

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

Настройка системы торгов Moloco

Navigate to Delivery > Bidders , and click Go to SDK Bidding .

Нажмите «Новый участник торгов» .

Выберите Moloco Ads в качестве участника торгов.

Нажмите «Продолжить» , чтобы включить функцию «SDK Bidding» для этого участника торгов.

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

Настройка сопоставления рекламных блоков

Перейдите в раздел «Доставка» > «Участники торгов» и нажмите « Перейти к торгам SDK» .

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

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

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

Наконец, нажмите «Сохранить» .

Добавьте Moloco Ads в список рекламных партнеров, регулируемых европейскими и американскими государственными нормативными актами.

Чтобы добавить Moloco Ads в список рекламных партнеров, соответствующих европейским и американским государственным нормативным требованиям, в пользовательском интерфейсе Ad Manager, выполните действия, описанные в настройках европейских и американских нормативных требований.

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

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

In your app-level build.gradle.kts file, add the following implementation dependencies and configurations. Use the latest versions of the Moloco SDK and adapter:

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

Шаг 4: Внедрите настройки конфиденциальности в Moloco SDK.

Согласие ЕС и GDPR

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

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

The following sample code shows how to pass consent information to the Moloco SDK. If you choose to set these flags, it is recommended that you do so prior to requesting ads through Google Mobile Ads SDK .

Котлин

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.

Котлин

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: Протестируйте свою реализацию.

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

Make sure you register your test device for Ad Manager.

Проверить тестовые объявления

Чтобы убедиться, что вы получаете тестовые объявления от 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, возвращенный Moloco, оказался пустым (null).
от -1 до 5000	com.moloco.sdk	Moloco SDK returned an error. See Moloco's documentation for more details.

Вознаграждение за проверку на стороне сервера

Если вы используете обратные вызовы проверки на стороне сервера (SSV) , идентификатор источника рекламы для Moloco будет равен 8267622065755668722 .