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

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

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

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

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

Требования

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

  • Целевая версия iOS – 13.0 или более поздняя.

  • Адаптер Moloco версии 3.9.1.0 или более поздней.

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

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

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

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

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

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

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

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

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

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

Как включить передачу защищенных сигналов

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

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

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

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

Как разрешить передачу защищенных сигналов для назначения ставок в SDK

Нажмите Выполнение > Настройки каналов спроса. На вкладке Настройки по умолчанию включите параметр Разрешить передачу защищенных сигналов для назначения ставок в SDK.

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

Как настроить назначение ставок Moloco

Перейдите в раздел Выполнение > Системы назначения ставок и нажмите Перейти к назначению ставок в SDK.

Нажмите Новая система назначения ставок.

Выберите Moloco Ads в качестве системы назначения ставок.

Нажмите Продолжить, чтобы включить назначение ставок в SDK для этой системы назначения ставок.

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

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

Перейдите в раздел Выполнение > Системы назначения ставок и нажмите Перейти к назначению ставок в SDK.

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

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

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

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

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

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

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

Как использовать Swift Package Manager

Прежде чем продолжить, убедитесь, что у вас установлена минимальная поддерживаемая версия адаптера – 4.1.0.0.

Чтобы добавить зависимость пакета в проект, выполните следующие действия:

  1. В Xcode выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов).

  2. В появившемся окне введите следующий URL пакета:

    https://github.com/googleads/googleads-mobile-ios-mediation-moloco.git
    
  3. В разделе Правило зависимостей выберите Ветвь.

  4. В текстовом поле введите main.

Через CocoaPods

  • Добавьте в Podfile проекта следующую строку:

    pod 'GoogleMobileAdsMediationMoloco'
    
  • В командной строке выполните следующую команду:

    pod install --repo-update

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

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

Адаптер Moloco Ads SDK для iOS версии 3.5.0.0 и более поздних поддерживает передачу сигналов согласия по GDPR от платформ для управления согласием, интегрированных с Transparency and Consent Framework (TCF) от IAB, в Moloco Ads SDK. Подробнее о строке согласия TCF…

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

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

В Moloco SDK есть флаг isDoNotSell, который позволяет передавать информацию о согласии в Moloco SDK.

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

Swift

import MolocoSDK
// ...

MolocoPrivacySettings.isDoNotSell = true;

Objective-C

#import <MolocoSDK/MolocoSDK-Swift.h>
// ...

[MolocoPrivacySettings setIsDoNotSell:YES];

Дополнительную информацию можно найти в документации о конфиденциальности Moloco.

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

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

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

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

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

Коды ошибок

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

MolocoSDK.MolocoError
GADMediationAdapterMoloco

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

Код ошибки Поместье Причина
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 SDK Moloco вернул ошибку. Подробная информация приведена в документации Moloco.

История изменений адаптера медиации Moloco для iOS

Версия 4.11.0.0

  • Подтверждена совместимость с Moloco SDK версии 4.11.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 13.11.0.
  • Moloco SDK версии 4.11.0.

Версия 4.10.0.0

  • Подтверждена совместимость с Moloco SDK версии 4.10.0.
  • Добавлена информация о том, что Moloco SDK может отслеживать показы нативных объявлений.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 13.9.0.
  • Moloco SDK версии 4.10.0.

Версия 4.9.1.0

  • Подтверждена совместимость с Moloco SDK версии 4.9.1.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 13.8.0.
  • Moloco SDK версии 4.9.1.

Версия 4.9.0.0

  • Подтверждена совместимость с Moloco SDK версии 4.9.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 13.7.0.
  • Moloco SDK версии 4.9.0.

Версия 4.8.1.1

  • Добавлена поддержка размеров адаптивных баннеров.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 13.6.0.
  • Moloco SDK версии 4.8.1.

Версия 4.8.1.0

  • Подтверждена совместимость с Moloco SDK версии 4.8.1.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 13.6.0.
  • Moloco SDK версии 4.8.1.

Версия 4.8.0.0

  • Подтверждена совместимость с Moloco SDK версии 4.8.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 13.6.0.
  • Moloco SDK версии 4.8.0.

Версия 4.7.0.0

  • Подтверждена совместимость с Moloco SDK версии 4.7.0.
  • Обновите минимальную версию iOS, чтобы ослабить зависимость Google Mobile Ads SDK и разрешить промежуточные версии.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 13.5.0.
  • Moloco SDK версии 4.7.0.

Версия 4.6.1.1

  • Теперь адаптер пересылает флаг ageRestrictedTreatment из Google Mobile Ads SDK в COPPA API Moloco SDK.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 13.3.0.
  • Moloco SDK версии 4.6.1.

Версия 4.6.1.0

  • Подтверждена совместимость с Moloco SDK версии 4.6.1.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 13.3.0.
  • Moloco SDK версии 4.6.1.

Версия 4.6.0.0

  • Подтверждена совместимость с Moloco SDK версии 4.6.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 13.2.0.
  • Moloco SDK версии 4.6.0.

Версия 4.5.1.0

  • Подтверждена совместимость с Moloco SDK версии 4.5.1.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 13.2.0.
  • Moloco SDK версии 4.5.1.

Версия 4.5.0.0

  • Подтверждена совместимость с Moloco SDK версии 4.5.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 13.1.0.
  • Moloco SDK версии 4.5.0.

Версия 4.4.1.0

  • Подтверждена совместимость с Moloco SDK версии 4.4.1.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 13.1.0.
  • Moloco SDK версии 4.4.1.

Версия 4.4.0.0

  • Подтверждена совместимость с Moloco SDK версии 4.4.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 13.1.0.
  • Moloco SDK версии 4.4.0.

Версия 4.3.0.2

  • Зависимость Google Mobile Ads SDK обновлена до версии 13.0.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 13.0.0.
  • Moloco SDK версии 4.3.0.

Версия 4.3.0.1

  • Минимальная версия iOS для CocoaPods теперь 13.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 13.0.0.
  • Moloco SDK версии 4.3.0.

Версия 4.3.0.0

  • Подтверждена совместимость с Moloco SDK версии 4.3.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 12.14.0.
  • Moloco SDK версии 4.3.0.

Версия 4.2.0.0

  • Подтверждена совместимость с Moloco SDK версии 4.2.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 12.14.0.
  • Moloco SDK версии 4.2.0.

Версия 4.1.2.0

  • Подтверждена совместимость с Moloco SDK версии 4.1.2.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 12.14.0.
  • Moloco SDK версии 4.1.2.

Версия 4.1.0.0

  • Подтверждена совместимость с Moloco SDK версии 4.1.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 12.14.0.
  • Moloco SDK версии 4.1.0.

Версия 3.13.0.0

  • Включает Info.plist в рамках.
  • Подтверждена совместимость с Moloco SDK версии 3.13.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 12.9.0.
  • Moloco SDK версии 3.13.0.

Версия 3.12.1.0

  • Подтверждена совместимость с Moloco SDK версии 3.12.1.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 12.8.0.
  • Moloco SDK версии 3.12.1.

Версия 3.12.0.0

  • Подтверждена совместимость с Moloco SDK версии 3.12.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 12.8.0.
  • Moloco SDK версии 3.12.0.

Версия 3.11.0.0

  • Подтверждена совместимость с Moloco SDK версии 3.11.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 12.6.0.
  • Moloco SDK версии 3.11.0.

Версия 3.10.1.0

  • Подтверждена совместимость с Moloco SDK версии 3.10.1.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 12.6.0.
  • Moloco SDK версии 3.10.1.

Версия 3.10.0.0

  • Подтверждена совместимость с Moloco SDK версии 3.10.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 12.5.0.
  • Moloco SDK версии 3.10.0.

Версия 3.9.1.0

  • Добавлена поддержка водяных знаков для форматов объявлений с назначением ставок.
  • Устранена проблема с загрузкой баннеров MREC.
  • Подтверждена совместимость с Moloco SDK версии 3.9.1.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 12.3.0.
  • Moloco SDK версии 3.9.1.

Версия 3.9.0.0

  • Название платформы медиации теперь задается при инициализации Moloco SDK.
  • Подтверждена совместимость с Moloco SDK версии 3.9.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 12.3.0.
  • Moloco SDK версии 3.9.0.

Версия 3.8.0.0

  • Включены флаги -fobjc-arc и -fstack-protector-all.
  • Исправлена проблема с получением рейтинга для нативных объявлений.
  • Подтверждена совместимость с Moloco SDK версии 3.8.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 12.2.0.
  • Moloco SDK версии 3.8.0.

Версия 3.7.2.0

  • Подтверждена совместимость с Moloco SDK версии 3.7.2.
  • Добавлена поддержка назначения ставок для формата нативного объявления.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 12.1.0.
  • Moloco SDK версии 3.7.2.

Версия 3.7.1.0

  • Подтверждена совместимость с Moloco SDK версии 3.7.1.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 12.1.0.
  • Moloco SDK версии 3.7.1.

Версия 3.7.0.0

  • Подтверждена совместимость с Moloco SDK версии 3.7.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 12.0.0.
  • Moloco SDK версии 3.7.0.

Версия 3.6.0.1

  • Адаптер обновлен, чтобы получать версию Moloco SDK из основного потока.
  • Теперь требуется Google Mobile Ads SDK версии 12.0.0 или более поздней.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 12.0.0.
  • Moloco SDK версии 3.6.0.

Версия 3.6.0.0

  • Подтверждена совместимость с Moloco SDK версии 3.6.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 11.13.0.
  • Moloco SDK версии 3.6.0.

Версия 3.5.0.0

  • Первый выпуск.
  • Добавлена поддержка назначения ставок для баннеров (включая прямоугольные медийные объявления), межстраничных объявлений и объявлений с вознаграждением.
  • Подтверждена совместимость с Moloco SDK версии 3.5.0.

Создано и протестировано с использованием:

  • Google Mobile Ads SDK версии 11.13.0.
  • Moloco SDK версии 3.5.0.