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

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

Интеграция Moloco с посредничеством

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

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

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

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

Требования

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

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

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

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

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

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

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

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

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

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

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

Настройте параметры медиации для вашего рекламного блока

Вам необходимо добавить Moloco Ads SDK в конфигурацию медиации для вашего рекламного блока.

Сначала войдите в свой аккаунт AdMob . Затем перейдите на вкладку «Медиация» . Если у вас есть группа медиации, которую вы хотите изменить, нажмите на её название, чтобы отредактировать её, и перейдите к разделу «Добавить Moloco Ads SDK в качестве источника рекламы» .

Чтобы создать новую группу посредничества, выберите Создать группу посредничества .

Введите формат и платформу рекламы, затем нажмите «Продолжить» .

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

Свяжите эту группу медиации с одним или несколькими существующими рекламными блоками AdMob. Затем нажмите «Готово» .

Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками:

Добавьте Moloco Ads SDK в качестве источника рекламы

В разделе «Источники рекламы» на вкладке « Торги » выберите «Добавить источник рекламы» . Затем выберите Moloco Ads SDK .

Нажмите «Как подписать партнерское соглашение» и настроить партнерство по торгам с помощью Moloco Ads SDK.

Нажмите «Подтвердить и согласиться» , затем нажмите «Продолжить» .

Если у вас уже есть сопоставление для Moloco Ads SDK, вы можете выбрать его. В противном случае нажмите «Добавить сопоставление» .

Затем введите ключ приложения и идентификатор рекламного блока, полученные в предыдущем разделе. Нажмите «Готово» .

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

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

Шаг 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: Проверьте свою реализацию

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

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

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

Чтобы убедиться, что вы получаете тестовые объявления от 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 .