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

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

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

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

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

Требования

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

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

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

Панель инструментов приложений Chartboost

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

Управление приложениями

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

Новая форма заявки

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

андроид

Настройки приложения

iOS

Настройки приложения

AdMob требует Chartboost User ID и User Signature для настройки вашего рекламного блока AdMob ID. Вы можете найти эти параметры, нажав Chartboost mediation в Chartboost UI.

Панель управления посредничеством Chartboost

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

Chartboost API-обозреватель

Обновите свой app-ads.txt

Авторизованные продавцы приложений app-ads.txt — это инициатива IAB Tech Lab, которая помогает гарантировать, что ваш рекламный инвентарь приложения продается только через каналы, которые вы определили как авторизованные. Чтобы предотвратить значительную потерю дохода от рекламы, вам нужно будет внедрить файл app-ads.txt . Если вы еще этого не сделали, настройте файл app-ads.txt для своего приложения .

Чтобы реализовать app-ads.txt для Chartboost, см. app-ads.txt .

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

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

андроид

Изменить настройки приложения

iOS

Изменить настройки приложения

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

Тестовый режим Chartboost

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

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

Шаг 2: Настройте спрос Chartboost в пользовательском интерфейсе AdMob

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

андроид

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

iOS

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

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

Следуйте инструкциям в настройках европейских и государственных нормативных актов США, чтобы добавить Chartboost в список рекламных партнеров, соответствующих европейским и государственным нормативным актам США, в пользовательском интерфейсе AdMob.

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

OpenUPM-CLI

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

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

OpenUPM

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

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

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

Подробности OpenUPM

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

Реестры единства

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

Установить из OpenUPM

Пакет «Единство»

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

В редакторе проекта Unity выберите Assets > Import Package > Custom Package и найдите загруженный вами файл GoogleMobileAdsChartboostMediation.unitypackage . Убедитесь, что выбраны все файлы, и нажмите Import .

Импорт из Unity

Затем выберите Assets > External Dependency Manager > Android Resolver > Force Resolve . Библиотека External Dependency Manager выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android вашего приложения Unity.

Сила Решения

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

В соответствии с Политикой согласия пользователей ЕС 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: Проверьте свою реализацию

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

Обязательно зарегистрируйте свое тестовое устройство в AdMob и включите тестовый режим в пользовательском интерфейсе 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 может загружать только одно объявление для каждого местоположения одновременно.
103 Параметры сервера Chartboost, настроенные в пользовательском интерфейсе AdMob, отсутствуют или недействительны.
104 Рекламное объявление Chartboost или реклама с вознаграждением не готовы к показу.

iOS

Код ошибки Причина
101 Параметры сервера Chartboost, настроенные в пользовательском интерфейсе AdMob, отсутствуют или недействительны.
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.8.0

Версия 4.7.3

Версия 4.7.2

Версия 4.7.1

Версия 4.7.0

Версия 4.6.1

Версия 4.6.0

Версия 4.5.0

Версия 4.4.0

Версия 4.3.0

Версия 4.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

Версия 4.0.0

Версия 3.5.1

Версия 3.5.0

Версия 3.4.1

Версия 3.4.0

Версия 3.3.1

Версия 3.3.0

Версия 3.2.0

Версия 3.1.0

Версия 3.0.1

Версия 3.0.0

Версия 2.0.1

Версия 2.0.0

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

Версия 1.3.0

  • Обновлен плагин для поддержки нового API Rewarded.
  • Поддерживает адаптер 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.