Чтобы обсудить наши продукты и оставить отзыв о них, присоединяйтесь к официальному каналу Ad Manager Discord на сервере Google Advertising and Measurement Community .

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

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

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

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

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

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

Требования

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

Последняя версия Google Mobile Ads SDK
Завершите руководство по началу работы с посредничеством.

Шаг 1: Настройка конфигураций в Moloco UI

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

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

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

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

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

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

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

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

Войдите в свою учетную запись Менеджера рекламы .

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

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

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

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

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

Разрешить безопасный обмен сигналами для SDK Bidding

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

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

Настроить торги Moloco

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Котлин

import com.moloco.sdk.publisher.privacy.MolocoPrivacy
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings
// ...

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

Ява

import com.moloco.sdk.publisher.privacy.MolocoPrivacy;
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings;
// ...

// Moloco does not support setting one flag at a time in Java.
PrivacySettings privacySettings = new PrivacySettings(
    /* isUserConsent */         true,
    /* isAgeRestrictedUser */   false,
    /* isDoNotSell */           false);
MolocoPrivacy.setPrivacy(privacySettings);

Более подробную информацию см. в документации Moloco SDK Android .

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

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

Moloco SDK включает флаг isDoNotSell для передачи информации о согласии в Moloco SDK.

Котлин

import com.moloco.sdk.publisher.privacy.MolocoPrivacy
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings
// ...

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

Ява

import com.moloco.sdk.publisher.privacy.MolocoPrivacy;
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings;
// ...

// Moloco does not support setting one flag at a time in Java.
PrivacySettings privacySettings = new PrivacySettings(
    /* isUserConsent */         false,
    /* isAgeRestrictedUser */   false,
    /* isDoNotSell */           true);
MolocoPrivacy.setPrivacy(privacySettings);

Более подробную информацию см. в документации Moloco SDK Android .

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

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

Обязательно зарегистрируйте свое тестовое устройство в Ad Manager.

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

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

Коды ошибок

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

Проверка на стороне сервера с вознаграждением

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