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

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

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

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

Адаптер медиации Менеджера рекламы для рекламного SDK Moloco Ads поддерживает следующие возможности:

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

Требования

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

  • Последняя версия Google Mobile Ads Unity Plugin.
  • Редактор Unity версии 5.6 или более поздней.
  • Плагин Moloco Unity версии 1.2.0 или более поздней.
  • Чтобы развернуть приложение на Android:
    • Android API уровня 24 или более поздней версии.
  • Чтобы развернуть приложение на устройстве iOS:
    • Целевая версия iOS для развертывания – 13.0 или более поздняя.
  • Рабочий проект Unity, настроенный с помощью Google Mobile Ads Unity Plugin. Подробнее о том, как настроить Google Mobile Ads Unity Plugin…
  • Настройте медиацию.

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

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

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

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

    Android

    iOS

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

    Android

    iOS

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

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

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

    Шаг 2. Настройте источник спроса Moloco Ads SDK в интерфейсе Менеджера рекламы

    Как настроить медиацию для рекламного блока

    Android

    Инструкции приведены в разделе "Шаг 2" Android.

    iOS

    Инструкции приведены в разделе "Шаг 2" руководства для iOS.

    Как добавить Moloco Ads в список рекламных партнеров, соблюдающих GDPR и законы штатов США

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

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

    OpenUPM-CLI

    Если у вас установлен OpenUPM-CLI, вы можете добавить в проект плагин медиации Google Mobile Ads SDK и Moloco Ads SDK для Unity, выполнив следующую команду в корневом каталоге проекта:

    openupm add com.google.ads.mobile.mediation.moloco

    OpenUPM

    В редакторе проекта Unity выберите Edit (Изменить) > Project Settings (Настройки проекта) > Package Manager (Менеджер пакетов), чтобы открыть Unity Package Manager Settings (Настройки менеджера пакетов Unity).

    На вкладке Scoped Registries (Реестры с областью действия) добавьте OpenUPM в качестве реестра с областью действия, указав следующие сведения:

    • Название: OpenUPM
    • URL: https://package.openupm.com
    • Области действия: com.google

    Сведения об OpenUPM

    Затем выберите Window (Окно) > Package Manager (Менеджер пакетов), чтобы открыть Unity Package Manager (Менеджер пакетов Unity), и в раскрывающемся меню выберите My Registries (Мои реестры).

    Реестры Unity

    Выберите пакет Google Mobile Ads Moloco Mediation и нажмите Install (Установить).

    Установка из OpenUPM

    Пакет Unity

    Скачайте последнюю версию плагина медиации Google Mobile Ads для рекламного SDK Moloco Ads по ссылке для скачивания в списке изменений и извлеките файл GoogleMobileAdsMolocoMediation.unitypackage из ZIP-архива.

    В редакторе проекта Unity выберите Assets (Объекты) > Import Package (Импортировать пакет) > Custom Package (Специальный пакет) и найдите скачанный файл GoogleMobileAdsMolocoMediation.unitypackage. Убедитесь, что выбраны все файлы, и нажмите Импортировать.

    Импорт из Unity

    Затем выберите Assets (Ресурсы) > External Dependency Manager (Менеджер внешних зависимостей) > Android Resolver (Решатель Android) > Force Resolve (Принудительное разрешение). Библиотека External Dependency Manager выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android приложения Unity.

    Принудительное разрешение

    Шаг 4. Настройте параметры конфиденциальности в Moloco SDK

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

    Адаптер Moloco Ads SDK Unity версии 1.0.0 и более поздних поддерживает передачу сигналов согласия по GDPR от платформ для запросов согласия, интегрированных со спецификацией Transparency and Consent Framework (TCF) от IAB, в Moloco Ads SDK. Дополнительную информацию можно найти в документации по MolocoPrivacy для Android и строке согласия TCF для iOS.

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

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

    Плагин медиации Google Mobile Ads Unity для Moloco Ads SDK включает метод Moloco.SetDoNotSell(bool), который позволяет передавать информацию о согласии в Moloco Ads SDK. В приведенном ниже примере кода показано, как передать информацию о согласии в Moloco Ads SDK. Если вы решите задать эти флаги, рекомендуем сделать это до запроса объявлений через Google Mobile Ads Unity Plugin.

    using GoogleMobileAds.Api.Mediation.Moloco;
// ...

Moloco.SetDoNotSell(true);

    Дополнительную информацию вы найдете в рекомендациях по внедрению рекламного SDK Moloco Ads для Android и iOS.

    Шаг 5. Добавьте обязательный код

    Для интеграции Moloco Ads SDK не требуется дополнительный код.

    Шаг 6. Проверьте реализацию

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

    Зарегистрируйте тестовое устройство в Менеджере рекламы.

    Как проверить тестовые объявления

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

    Коды ошибок

    Если адаптер не получает объявление от Moloco, издатели могут проверить основную ошибку в ответе на запрос объявления с помощью ResponseInfo в следующих классах:

    Android

    com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter

    iOS

    MolocoSDK.MolocoError
GADMediationAdapterMoloco

    Ниже приведены коды и сообщения об ошибках, которые возвращает адаптер Moloco, когда не удается загрузить объявление.

    Android

    Код ошибки Поместье Причина
    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.

    iOS

    Код ошибки Поместье Причина
    101 com.google.ads.mediation.moloco Moloco SDK не поддерживает показ объявлений на устройствах с iOS 12 и более ранними версиями.
    102 com.google.ads.mediation.moloco Ключ приложения Moloco отсутствует или недействителен.
    103 com.google.ads.mediation.moloco Отсутствует или недействителен идентификатор рекламного блока Moloco.
    104 com.google.ads.mediation.moloco Объявление не готово к показу.
    105 com.google.ads.mediation.moloco Не удалось показать объявление.
    106 com.google.ads.mediation.moloco Нет данных для отрисовки объявления.
    От -1 до 5000 Отправлено Moloco SDK Moloco SDK вернул ошибку. Подробная информация приведена в документации Moloco.

    Журнал изменений плагина Moloco Unity Mediation

    Версия 3.11.0 (в процессе)

    Версия 3.10.1

    Версия 3.10.0

    Версия 3.9.1

    Версия 3.9.0

    Версия 3.8.1

    Версия 3.8.0

    Версия 3.7.0

    Версия 3.6.1

    Версия 3.6.0

    Версия 3.5.1

    Версия 3.5.0

    Версия 3.4.1

    Версия 3.4.0

    Версия 3.3.1

    Версия 3.3.0

    Версия 3.2.0

    Версия 3.1.0

    Версия 3.0.0

    Версия 2.2.1

    Версия 2.2.0

    Версия 2.1.0

    Версия 2.0.0

    Версия 1.6.1

    Версия 1.6.0

    Версия 1.5.0

    Версия 1.4.0

    Версия 1.3.1

    Версия 1.3.0

    Версия 1.2.1

    Версия 1.2.0

    Версия 1.1.0

    Версия 1.0.0