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

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

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

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

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

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

Требования

  • Новейший Google Mobile Ads Unity Plugin
  • Unity 4 или выше
  • Для развертывания на Android
    • Android API уровня 23 или выше
  • Для развертывания на iOS
    • Целевая версия iOS для развертывания — 13.0 или выше.
  • Рабочий проект Unity, настроенный с использованием Google Mobile Ads Unity Plugin . Подробности см. в разделе «Настройка Google Mobile Ads Unity Plugin .
  • Set up AdMob Mediation

Step 1: Set up configurations in Chartboost UI

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

Chartboost apps dashboard

Click the Add new app button to create your app.

Apps Management

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

New app form

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

Android

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

iOS

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

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

Chartboost mediation dashboard

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

Chartboost api explorer

Обновите файл app-ads.txt.

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

Для интеграции файла app-ads.txt с Chartboost см. файл app-ads.txt .

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

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

Android

Edit app settings

iOS

Edit app settings

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

Chartboost test mode

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

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

Step 2: Set up Chartboost demand in AdMob UI

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

Android

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

iOS

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

Добавьте Chartboost в список рекламных партнеров, соответствующих требованиям GDPR и законодательства штатов США.

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

Step 3: Import the Chartboost SDK and adapter

OpenUPM-CLI

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

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

OpenUPM

В редакторе проекта Unity выберите Edit > Project Settings > Package Manager , чтобы открыть настройки менеджера пакетов Unity .

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

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

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

Затем перейдите в меню Window > Package Manager , чтобы открыть диспетчер пакетов Unity , и выберите My Registries из выпадающего меню.

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

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

Установка через OpenUPM

Пакет Unity

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

В редакторе проекта 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: Внедрите настройки конфиденциальности в SDK Chartboost.

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

The Google Mobile Ads mediation plugin for Chartboost version 3.1.0 includes the Chartboost.AddDataUseConsent() method. The following sample code sets data use consent to NonBehavioral . If you choose to call this method, it is recommended that you do so prior to requesting ads using Google Mobile Ads Unity Plugin .

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

Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);

Законы штатов США о защите частной жизни

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

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

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

Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);

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

Android

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

iOS

Интеграция SKAdNetwork

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

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

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

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

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

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

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

Android

Разрешения

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

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

iOS

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

коды ошибок

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

Android 

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

iOS 

GADMAdapterChartboost
GADMediationAdapterChartboost

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

Android

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

iOS

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

Chartboost Unity Mediation Plugin Changelog

Версия 4.11.2

Version 4.11.1

Version 4.11.0

Version 4.10.3

Version 4.10.2

Version 4.10.1

Version 4.10.0

Version 4.9.3

Version 4.9.2

Version 4.9.1

Version 4.9.0

Version 4.8.0

Version 4.7.3

Версия 4.7.2

Version 4.7.1

Версия 4.7.0

Версия 4.6.1

Version 4.6.0

Версия 4.5.0

Версия 4.4.0

Версия 4.3.0

Версия 4.2.0

Version 4.1.1

Версия 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.
  • Supports Chartboost iOS adapter version 8.0.1.1.

Версия 1.3.0

  • Плагин обновлен для поддержки нового API вознаграждений.
  • Поддерживает адаптер Chartboost для Android версии 7.3.1.1.
  • Supports Chartboost iOS adapter version 7.5.0.0.

Версия 1.2.0

  • Поддерживает адаптер Chartboost для Android версии 7.3.0.0.
  • Supports Chartboost iOS adapter version 7.3.0.0.

Версия 1.1.1

  • Поддерживает адаптер Chartboost для Android версии 7.2.0.1.
  • Supports Chartboost iOS adapter version 7.2.0.1.

Версия 1.1.0

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

Версия 1.0.0

  • Первый релиз!
  • Поддерживает Chartboost Android SDK версии 7.0.1.
  • Supports Chartboost iOS SDK version 7.1.2.