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

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

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

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

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

Требования

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

  • Последняя версия Google Mobile Ads SDK for React Native.
  • Фреймворк React Native версии 0.85.0 или более поздней.
  • Развертывание на устройствах Android:
    • Android API уровня 24 или более поздней версии.
  • Чтобы развернуть приложение на iOS:
    • iOS 13.0 или более поздней версии.
  • Работающий проект React Native, настроенный с помощью Google Mobile Ads SDK for React Native. Подробнее о том, как настроить Google Mobile Ads SDK for React Native…
  • Настройте медиацию AdMob.

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

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

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

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

Android

iOS

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

Android

iOS

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

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

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

Шаг 2. Настройте спрос Moloco Ads SDK в интерфейсе AdMob

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

Android

Инструкции приведены в шаге 2 руководства для Android.

iOS

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

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

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

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

В корневом каталоге проекта установите Google Mobile Ads SDK for React Native адаптер медиации для Moloco Ads SDK. Выполните следующие действия:

  1. Скопируйте tar-файл адаптера Google Mobile Ads SDK for React Native из каталога gma-sdk-react-native/adapters/moloco/ в каталог local_packages/ проекта. Если у вас нет папки adapters, ознакомьтесь с разделом Предварительные требования.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/moloco/gma-mediation-moloco-0.1.0.tgz local_packages/

    Замените EXTRACT_DIR путем к каталогу, в который вы распаковали архив.

  2. Установите пакет адаптера с помощью предпочитаемого менеджера пакетов:

    npm

    npm install ./local_packages/gma-mediation-moloco-0.1.0.tgz

    пряжа

    yarn add ./local_packages/gma-mediation-moloco-0.1.0.tgz

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

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

Адаптер Moloco Ads SDK React Native версии 0.1.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 SDK for React Native.

import { MolocoMediation } from '@google/gma-mediation-moloco';
// ...

MolocoMediation.setDoNotSell(true);

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

Шаг 5. Добавьте необходимый код

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

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

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

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

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

Чтобы убедиться, что вы получаете тестовые объявления из 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 был нулевым.
104 com.google.ads.mediation.moloco Не удалось инициализировать Moloco SDK.
От -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.

Версия 0.1.0

  • Первый выпуск.