Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

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

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

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

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

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

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

Требования

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

Целевая версия iOS – 13.0 или более поздняя.
Адаптер Moloco версии 3.9.1.0 или более поздней.

Последняя версия Google Mobile Ads SDK.
Настройте медиацию AdMob.

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

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

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

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

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

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

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

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

Шаг 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

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

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

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

В Xcode выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов).
В появившемся окне введите следующий URL пакета:
```
https://github.com/googleads/googleads-mobile-ios-mediation-moloco.git
```
В разделе Правило зависимостей выберите Ветвь.
В текстовом поле введите main.

Через CocoaPods

Добавьте в Podfile проекта следующую строку:
```
pod 'GoogleMobileAdsMediationMoloco'
```
В командной строке выполните следующую команду:
```
pod install --repo-update
```

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

Согласие пользователей из ЕС и GDPR

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

В Moloco SDK есть флаг hasUserConsent для передачи информации о согласии в Moloco SDK.

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

Swift

import MolocoSDK
// ...

MolocoPrivacySettings.hasUserConsent = true;

Objective-C

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

[MolocoPrivacySettings setHasUserConsent:YES];

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

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

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

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

Swift

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