В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы из Moloco с помощью медиации , включая интеграцию с функциями назначения ставок. В нём также рассказывается, как добавить Moloco в конфигурацию медиации рекламного блока, а также как интегрировать Moloco SDK и адаптер в приложение iOS.
Поддерживаемые интеграции и форматы рекламы
Адаптер-посредник для Moloco обладает следующими возможностями:
| Интеграция | |
|---|---|
| Торги | |
| Водопад | |
| Форматы | |
| Открыть приложение | |
| Баннер | |
| Интерстициальный | |
| Награжден | |
| Вознагражденный интерстициальный | |
| Родной | |
Требования
Цель развертывания iOS 12.0 или выше
Адаптер Moloco 3.9.1.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 и адаптер
Использование CocoaPods (рекомендуется)
Добавьте следующую строку в Podfile вашего проекта:
pod 'GoogleMobileAdsMediationMoloco'В командной строке выполните:
pod install --repo-update
Шаг 4: Реализуйте настройки конфиденциальности в Moloco SDK
Согласие ЕС и GDPR
Чтобы соответствовать Политике Google в отношении согласия пользователей из ЕС , вы должны предоставить пользователям в Европейской экономической зоне (ЕЭЗ), Великобритании и Швейцарии определённую информацию и получить их согласие на использование файлов cookie или других локальных хранилищ в случаях, предусмотренных законодательством, а также на сбор, передачу и использование персональных данных для персонализации рекламы. Эта политика отражает требования Директивы ЕС о конфиденциальности в электронном виде и Общего регламента по защите данных (GDPR). Вы несёте ответственность за проверку распространения согласия на каждый источник рекламы в вашей цепочке посредников. Google не может автоматически передавать согласие пользователя таким сетям.
Moloco SDK включает флаг hasUserConsent для передачи информации о согласии в Moloco SDK.
В следующем примере кода показано, как передать информацию о согласии в Moloco SDK. Если вы решите установить эти флаги, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.
Быстрый
import MolocoSDK
// ...
MolocoPrivacySettings.hasUserConsent = true;
Objective-C
#import <MolocoSDK/MolocoSDK-Swift.h>
// ...
[MolocoPrivacySettings setHasUserConsent:YES];
Более подробную информацию см. в документации по конфиденциальности Moloco .
Законы США о конфиденциальности
Законы США о конфиденциальности требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (как этот термин определен в законе). Отказ осуществляется через заметную ссылку «Не продавайте мою личную информацию» на главной странице «продающей» стороны. Руководство по соблюдению законов США о конфиденциальности предлагает возможность включить ограниченную обработку данных для показа рекламы Google, но Google не может применить эту настройку к каждой рекламной сети в вашей цепочке посредничества. Поэтому вам необходимо указать каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать инструкциям каждой из этих сетей для обеспечения соблюдения правил.
Moloco SDK включает флаг isDoNotSell для передачи информации о согласии в Moloco SDK.
В следующем примере кода показано, как передать информацию о согласии в Moloco SDK. Если вы решите установить эти флаги, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.
Быстрый
import MolocoSDK
// ...
MolocoPrivacySettings.isDoNotSell = true;
Objective-C
#import <MolocoSDK/MolocoSDK-Swift.h>
// ...
[MolocoPrivacySettings setIsDoNotSell:YES];
Более подробную информацию см. в документации по конфиденциальности Moloco .
Шаг 5: Проверьте свою реализацию
Включить тестовые объявления
Обязательно зарегистрируйте свое тестовое устройство в Ad Manager.
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от Moloco Ads SDK, включите тестирование одного источника объявлений в инспекторе объявлений, используя источник(и ) объявлений Moloco (Bidding ).
Коды ошибок
Если адаптеру не удается получить рекламу от 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 | Moloco SDK вернул ошибку. Подробнее см. в документации Moloco. |
Проверка на стороне сервера с вознаграждением
Если вы проверяете обратные вызовы проверки на стороне сервера (SSV) , идентификатор источника рекламы для Moloco — 8267622065755668722 .
Журнал изменений адаптера-посредника Moloco iOS
Версия 4.0.0.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
- Первоначальный выпуск.
- Добавлена поддержка торгов для форматов баннерной рекламы (включая MREC), полноэкранной рекламы и рекламы с вознаграждением.
- Проверенная совместимость с Moloco SDK версии 3.5.0.
Создано и протестировано с помощью:
- Google Mobile Ads SDK версии 11.13.0.
- Moloco SDK версии 3.5.0.