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