Чтобы обсудить наши продукты и оставить отзыв о них, присоединяйтесь к официальному каналу Ad Manager Discord на сервере Google Advertising and Measurement Community .

Эта страница переведена с помощью Cloud Translation API.

Интеграция Moloco с торгами

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

Android iOS Unity Flutter

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

Поддерживаемые интеграции и форматы рекламы

Адаптер для посредничества в Moloco обладает следующими возможностями:

Интеграция
Торги
Водопад
Форматы
Приложение открыто
Баннер
Интерстициальный
Награжден
Вознагражденный интерстициальный
Родной

Требования

Целевая версия iOS для развертывания — 12.0 или выше.
Адаптер Moloco версии 3.9.1.0 или выше

Новейший SDK для мобильной рекламы Google
Пройдите руководство по началу процесса медиации.

Шаг 1: Настройка параметров в пользовательском интерфейсе Moloco.

Войдите в издательский портал Moloco.

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

Выберите операционную систему и параметры конфиденциальности для вашего приложения, заполните остальную часть формы, а затем нажмите «Создать» .

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

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

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

Перейдите во вкладку «Объявления» , чтобы просмотреть подробную информацию о созданном вами рекламном блоке. Запишите идентификатор рекламного блока (Ad Unit ID ).

Шаг 2: Настройте запрос Moloco в пользовательском интерфейсе Ad Manager.

Войдите в свой аккаунт в Ad Manager .

Включить безопасный обмен сигналами

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

Передайте защищенный сигнал в запросах на участие в торгах.

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

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

Обеспечьте безопасный обмен сигналами для торгов с использованием SDK.

Перейдите в раздел «Доставка» > «Настройки канала спроса» . На вкладке «Настройки по умолчанию» включите параметр «Разрешить безопасный обмен сигналами для торгов SDK» .

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

Настройка системы торгов Moloco

Перейдите в раздел «Доставка» > «Участники торгов» и нажмите « Перейти к торгам SDK» .

Нажмите «Новый участник торгов» .

Выберите Moloco Ads в качестве участника торгов.

Нажмите «Продолжить» , чтобы включить функцию «SDK Bidding» для этого участника торгов.

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

Настройка сопоставления рекламных блоков

Перейдите в раздел «Доставка» > «Участники торгов» и нажмите « Перейти к торгам SDK» .

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

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

Выберите «Конкретный рекламный блок» . Выберите рекламный блок и формат, тип инвентаря — «Мобильное приложение» , и ваше мобильное приложение . Затем введите ключ приложения и идентификатор рекламного блока, полученные в предыдущем разделе.

Наконец, нажмите «Сохранить» .

Добавьте Moloco Ads в список рекламных партнеров, регулируемых европейскими и американскими государственными нормативными актами.

Чтобы добавить Moloco Ads в список рекламных партнеров, соответствующих европейским и американским государственным нормативным требованиям, в пользовательском интерфейсе Ad Manager, выполните действия, описанные в настройках европейских и американских нормативных требований.

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

Быстрый

import MolocoSDK
// ...

MolocoPrivacySettings.isDoNotSell = true;

Objective-C

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

[MolocoPrivacySettings setIsDoNotSell:YES];

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

Шаг 5: Протестируйте свою реализацию.

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

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

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

Чтобы убедиться, что вы получаете тестовые объявления от 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 .