Интегрируйте Chartboost с медиацией

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

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

Адаптер медиации Менеджера рекламы для Chartboost имеет следующие возможности:

Интеграция
Торги
Водопад
Форматы
Баннер
Межстраничный
Награжден

Требования

• Юнити 4 или выше
• Последняя версия Google Mobile Ads SDK
• Развертывание на Android
  • Android API уровня 21 или выше
• Развертывание на iOS
  • Цель развертывания iOS 12.0 или выше
• Рабочий проект Unity, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе « Начало работы ».
• Пройдите руководство по началу работы с медиацией

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

Зарегистрируйте учетную запись Chartboost и войдите в нее, как только ваша учетная запись будет подтверждена. Затем перейдите на вкладку «Управление приложениями» .

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

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

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

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

Андроид

iOS

Менеджеру рекламы требуется идентификатор пользователя Chartboost и подпись пользователя для настройки идентификатора рекламного блока Менеджера рекламы. Эти параметры можно найти, нажав «Медиация Chartboost» в пользовательском интерфейсе Chartboost.

Перейдите на вкладку «Ресурсы» > «Проводник API» и запишите свой идентификатор пользователя и подпись пользователя, расположенные в разделе «Аутентификация» .

Включите тестовый режим

Вы можете включить тестовый режим в своем приложении, перейдя на вкладку «Управление приложениями» в пользовательском интерфейсе Chartboost, выбрав свое приложение из списка и нажав «Изменить настройки приложения» .

Андроид

iOS

В настройках вашего приложения вы можете переключить тестовый режим в своем приложении.

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

После того как вы сможете получать тестовые объявления Chartboost, ваше приложение будет размещено на обзоре приложения издателя Chartboost. Чтобы монетизация на Chartboost работала, проверка приложения издателем должна быть одобрена Chartboost.

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

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

Андроид

Инструкции см. в шаге 2 руководства для Android .

iOS

Инструкции см. в шаге 2 руководства для iOS .

Добавьте Chartboost в список рекламных партнеров GDPR и государственных нормативов США.

Следуйте инструкциям в настройках GDPR и настройках законодательства штата США , чтобы добавить Chartboost в список рекламных партнеров GDPR и законодательства штата США в пользовательском интерфейсе Менеджера рекламы.

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

OpenUPM-CLI

Важно: если вы переходите с использования пакета .unitypackage на использование OpenUPM-CLI, вам необходимо вручную удалить ресурсы из старого местоположения, удалив все файлы из папки Assets/GoogleMobileAds/Mediation/Chartboost .

Если у вас установлен OpenUPM-CLI , вы можете установить плагин Google Mobile Ads Chartboost Mediation для Unity в свой проект, выполнив следующую команду из корневого каталога вашего проекта:

openupm add com.google.ads.mobile.mediation.chartboost

ОпенУПМ

Важно! Если вы переходите с использования пакета .unitypackage на использование OpenUPM, вам необходимо вручную удалить ресурсы из старого местоположения, удалив все файлы из папки Assets/GoogleMobileAds/Mediation/Chartboost .

В редакторе проекта Unity выберите «Правка» > «Настройки проекта» > «Диспетчер пакетов» , чтобы открыть настройки диспетчера пакетов Unity .

На вкладке «Регистрации с ограниченной областью» добавьте OpenUPM в качестве реестра с ограниченной областью действия со следующими сведениями:

• Имя: OpenUPM
• URL-адрес: https://package.openupm.com .
• Область применения: com.google

Затем перейдите в «Окно» > «Диспетчер пакетов» , чтобы открыть диспетчер пакетов Unity , и выберите «Мои реестры» в раскрывающемся меню.

Выберите пакет Google Mobile Ads Chartboost Mediation и нажмите «Установить» .

Пакет Единства

Загрузите последнюю версию подключаемого модуля медиации Google Mobile Ads для Chartboost по ссылке для скачивания в журнале изменений и извлеките пакет GoogleMobileAdsChartboostMediation.unitypackage из zip-файла.

В редакторе проекта Unity выберите «Активы» > «Импортировать пакет» > «Пользовательский пакет» и найдите загруженный вами файл GoogleMobileAdsChartboostMediation.unitypackage . Убедитесь, что все файлы выбраны, и нажмите «Импортировать» .

Затем выберите «Активы» > «Диспетчер внешних зависимостей» > «Android Resolver» > «Принудительное разрешение» . Библиотека диспетчера внешних зависимостей выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android вашего приложения Unity.

Шаг 4. Реализуйте настройки конфиденциальности в Chartboost SDK

Согласие ЕС и GDPR

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

Плагин посредничества Google Mobile Ads для Chartboost версии 3.1.0 включает метод Chartboost.AddDataUseConsent() . В следующем примере кода задается согласие на использование данных NonBehavioral . Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы с помощью Google Mobile Ads SDK.

using GoogleMobileAds.Api.Mediation.Chartboost;
// ...

Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);

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

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

Плагин посредничества Google Mobile Ads для Chartboost версии 3.1.0 включает метод Chartboost.AddDataUseConsent() . В следующем примере кода задается согласие на использование данных для OptInSale . Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы с помощью Google Mobile Ads SDK.

using GoogleMobileAds.Api.Mediation.Chartboost;
// ...

Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);

Шаг 5. Добавьте необходимый код.

Андроид

Для интеграции Chartboost не требуется никакого дополнительного кода.

iOS

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

Следуйте документации Chartboost , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.

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

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

Убедитесь, что вы зарегистрировали свое тестовое устройство в Менеджере рекламы и включили тестовый режим в пользовательском интерфейсе Chartboost.

Важно! Отключите тестовый режим для Менеджера рекламы и Chartboost перед выпуском приложения.

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

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

Дополнительные шаги

Андроид

Разрешения

Для оптимальной производительности Chartboost рекомендует добавить следующие дополнительные разрешения в файл AndroidManifest.xml вашего приложения:

<uses-permission android:name="android.permission.READ_PHONE_STATE" />

iOS

Для интеграции iOS не требуется никаких дополнительных действий.

Коды ошибок

Если адаптеру не удается получить объявление от Chartboost, издатели могут проверить основную ошибку из ответа на объявление, используя ResponseInfo в следующих классах:

Андроид

com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter

iOS

GADMAdapterChartboost
GADMediationAdapterChartboost

Вот коды и сопутствующие сообщения, выдаваемые адаптером Chartboost, когда объявление не загружается:

Андроид

Код ошибки	Причина
0-99	Chartboost SDK возвратил ошибку.
101	Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому Chartboost.
102	Chartboost может одновременно загружать только 1 объявление для каждого местоположения.
103	Параметры сервера Chartboost, настроенные в пользовательском интерфейсе Менеджера рекламы, отсутствуют/недействительны.
104	Межстраничное объявление или объявление с вознаграждением Chartboost не готово к показу.

iOS

Код ошибки	Причина
101	Параметры сервера Chartboost, настроенные в пользовательском интерфейсе Менеджера рекламы, отсутствуют/недействительны.
102	Chartboost SDK возвратил ошибку инициализации.
103	Объявление Chartboost не кэшируется во время показа.
104	Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому Chartboost.
105	Версия ОС устройства ниже минимальной поддерживаемой версии ОС Chartboost SDK.
200-299	Ошибки кэша Chartboost SDK. См. код для более подробной информации.
300-399	Chartboost SDK показывает ошибки. См. код для более подробной информации.
400-499	Ошибки щелчков Chartboost SDK. См. код для более подробной информации.

Журнал изменений плагина Chartboost Unity Mediation

Версия 4.7.0

• Поддерживает адаптер Chartboost Android версии 9.8.0.0 .
• Поддерживает адаптер Chartboost iOS версии 9.8.0.0 .
• Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.3.0.

Версия 4.6.1

• DummyClient переименован в PlaceholderClient .
• Поддерживает адаптер Chartboost Android версии 9.7.0.0 .
• Поддерживает адаптер Chartboost iOS версии 9.7.0.1 .
• Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.3.0.

Версия 4.6.0

• Поддерживает адаптер Chartboost Android версии 9.7.0.0 .
• Поддерживает адаптер Chartboost iOS версии 9.7.0.0 .
• Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.0.0.

Версия 4.5.0

• Поддерживает адаптер Chartboost Android версии 9.6.0.0 .
• Поддерживает адаптер Chartboost iOS версии 9.6.0.0 .
• Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.6.0.

Версия 4.4.0

• Поддерживает адаптер Chartboost Android версии 9.5.0.0 .
• Поддерживает адаптер Chartboost iOS версии 9.5.1.0 .
• Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.5.3.

Версия 4.3.0

• Поддерживает адаптер Chartboost Android версии 9.4.0.0 .
• Поддерживает адаптер Chartboost iOS версии 9.4.0.0 .
• Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.5.0.

Версия 4.2.0

• Поддерживает адаптер Chartboost Android версии 9.3.0.0 .
• Поддерживает адаптер Chartboost iOS версии 9.3.0.0 .
• Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.2.0.

Версия 4.1.1

• Содержимое адаптера перенесено в GoogleMobileAds/Mediation/Chartboost/ .
• Пространство имен адаптера изменено для использования GoogleMobileAds.Mediation.Chartboost .
• Поддерживает адаптер Chartboost Android версии 9.2.1.1 .
• Поддерживает адаптер Chartboost iOS версии 9.2.0.0 .
• Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.1.0.

Версия 4.1.0

• Поддерживает адаптер Chartboost Android версии 9.2.0.0 .
• Поддерживает адаптер Chartboost iOS версии 9.2.0.0 .
• Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.4.1.

Версия 4.0.0

• Поддерживает адаптер Chartboost Android версии 9.1.1.0 .
• Поддерживает адаптер Chartboost iOS версии 9.1.0.0 .
• Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.3.0.

Версия 3.5.1

• Поддерживает адаптер Chartboost Android версии 8.4.3.1 .
• Поддерживает адаптер Chartboost iOS версии 8.5.0.2 .
• Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.2.

Версия 3.5.0

• Поддерживает адаптер Chartboost Android версии 8.4.2.0 .
• Поддерживает адаптер Chartboost iOS версии 8.5.0.2 .
• Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.0.

Версия 3.4.1

• Поддерживает адаптер Chartboost Android версии 8.3.1.0 .
• Поддерживает адаптер Chartboost iOS версии 8.5.0.2 .
• Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.0.

Версия 3.4.0

• Поддерживает адаптер Chartboost Android версии 8.3.0.0 .
• Поддерживает адаптер Chartboost iOS версии 8.5.0.1.0 .

Версия 3.3.1

• Поддерживает адаптер Chartboost Android версии 8.2.1.0 .
• Поддерживает адаптер Chartboost iOS версии 8.4.1.1 .

Версия 3.3.0

• Поддерживает адаптер Chartboost Android версии 8.2.0.0 .
• Поддерживает адаптер Chartboost iOS версии 8.4.0.0 .

Версия 3.2.0

• Поддерживает адаптер Chartboost Android версии 8.1.0.0 .
• Поддерживает адаптер Chartboost iOS версии 8.3.1.0 .

Версия 3.1.0

• Удален метод RestrictDataCollection() из класса Chartboost .
• Добавлены вспомогательные методы AddDataUseConsent() для передачи информации GDPR и CCPA в Chartboost.
• Поддерживает адаптер Chartboost Android версии 8.1.0.0 .
• Поддерживает адаптер Chartboost iOS версии 8.2.0.0 .

Версия 3.0.1

• Поддерживает адаптер Chartboost Android версии 8.0.3.1 .
• Поддерживает адаптер Chartboost iOS версии 8.1.0.1 .

Версия 3.0.0

• Поддерживает адаптер Chartboost Android версии 8.0.2.0 .
• Поддерживает адаптер Chartboost iOS версии 8.1.0.0 .

Версия 2.0.1

• Поддерживает адаптер Chartboost Android версии 7.5.0.1 .
• Поддерживает адаптер Chartboost iOS версии 8.0.4.0 .

Версия 2.0.0

• Поддерживает адаптер Chartboost Android версии 7.5.0.0.
• Поддерживает адаптер Chartboost iOS версии 8.0.1.1.

Версия 1.3.0

• Обновлен плагин для поддержки нового Rewarded API.
• Поддерживает адаптер Chartboost Android версии 7.3.1.1.
• Поддерживает адаптер Chartboost iOS версии 7.5.0.0.

Версия 1.2.0

• Поддерживает адаптер Chartboost Android версии 7.3.0.0.
• Поддерживает адаптер Chartboost iOS версии 7.3.0.0.

Версия 1.1.1

• Поддерживает адаптер Chartboost Android версии 7.2.0.1.
• Поддерживает адаптер Chartboost iOS версии 7.2.0.1.

Версия 1.1.0

• Поддерживает Chartboost Android SDK версии 7.2.0.
• Поддерживает Chartboost iOS SDK версии 7.2.0.
• Добавлен метод Chartboost.RestrictDataCollection() позволяющий включить ограничения на сбор данных GDPR для Chartboost SDK.

Версия 1.0.0

• Первый выпуск!
• Поддерживает Chartboost Android SDK версии 7.0.1.
• Поддерживает Chartboost iOS SDK версии 7.1.2.