Загрузка и интеграция Chartboost SDK для Unity

Последнее обновление:

 

Внесите свою мобильную игру в сеть Chartboost, добавив всего 10 строчек кода!

Используете Unity 3.х или более раннюю версию? Загрузить подключаемый модуль Обновить SDK Журнал изменений

 


 

Что в пакете? В наш пакет SDK входит полный набор функций.

Высококачественная видеореклама, предназначенная специально для игр и ваших игроков!

Настраиваемые рекламные вставки, органично встроенные в игру и ее восприятие игроками!

Полезнейший набор аналитики, помогающий точно таргетировать нужную аудиторию!

Полная информация о версиях SDK ▶

 


 

Готовы к интеграции Chartboost SDK? Проведите ее!

 


 

Перед началом:

Добавить SDK в свои игры довольно легко, нужно лишь несколько составляющих:

  • Учетная запись Chartboost
  • Приложение на панели пользователя
  • Новейший SDK
  • Активная кампания публикатора
  • Обратите внимание на то, что Chartboost поддерживает Android 2.3+ и iOS 6.0+, поэтому не забудьте задать в своем проекте Unity соответствующие минимальные версии ОС.
  • Кроме того, для совместимости с устройствами и функциями Android 6.0 Marshmallow следует проводить сборку, компиляцию и таргетинг с использованием новейших версий Google Android SDK (API не ниже уровня 23). Тем не менее, «минимальный» SDK все еще позволяет таргетировать API вплоть до уровня 9.

 

Импортируйте пакет Chartboost Unity в свой проект.

Если вы проводите сборку для iOS, то можете пропустить подкаталог Plugins/Android, а если для Android, то подкаталог Plugins/iOS.

Файлы упорядочены по каталогам:

  • /Assets/Chartboost/Editor: код Chartboost C# для интеграции Unity Editor и Postprocessbuildscript
  • /Assets/Chartboost/Resources: эта папка содержит файл ChartboostSettings, где можно найти AppId и AppSignature для ваших приложений под iOS и Android
  • /Assets/Chartboost/Scripts: код C# для работы с Chartboost. В этой папке есть все наши функции общего доступа, представленные в Chartboost.cs.
  • /Assets/ChartboostExample: пример сцены, демонстрирующий использование Chartboost SDK
  • /Assets/Plugins/iOS: код Objective-C, помогающий интегрировать Chartboost в Unity
  • /Assets/Plugins/Android: файлы библиотеки Chartboost для Android

Хотите разобраться, как все устроено? Изучите файлы в папке ChartboostExample. При тестировании демонстрационных сцен не забывайте следить за журналом, поскольку действие некоторых кнопок не имеет видимого эффекта.

Android: При сложных интеграциях, которые меняют Android Manifest, входящий в наш подключаемый модуль, любая активность, показывающая рекламу Chartboost, должна иметь значение android:hardwareAccelerated="true" в записи активности в манифесте Android; в противном случае видео может выводиться неправильно.

 

Если вы публикуете свою игру в Google Play Store, скомпонуйте библиотеку Google Play Services со своим проектом Unity.

  • Выберите Chartboost > Edit Settings и нажмите "Set Up Android SDK".
  • Это скомпонует библиотеку Google Play Services с вашим проектом Unity, что необходимо для интеграции Chartboost SDK с играми под Android.
  • Требуется также, чтобы библиотека Google Play Services устанавливалась через Android SDK Manager. Подробнее см. сайт разработчиков под Google.

 

Добавьте идентификатор и подпись приложения.

Уберите такие фильтры, как CB_AMAZON_APP_ID и CB_AMAZON_APP_SIGNATURE из неиспользуемых полей магазинов, иначе Unity выдаст следующую ошибку:
W/Unity: CHARTBOOST: You are using the Chartboost Android example App ID! Go to the Chartboost dashboard
and replace these with an App ID & App Signature from your account!

 

Перетащите сборку Chartboost из /Assets/Chartboost/Chartboost в свою сцену Unity на экране Scene.

  • Эта сборка автоматически управляет базовым поведением SDK (например, инициализацией) через ид. и подпись приложения.
  • Совет: для оптимальной производительности перетащите сборку в сцену, которая запускается только один раз (например, при первом запуске игры).

 

Чтобы показать рекламную вставку:

  • Включите ссылку using ChartboostSDK; в начало каждого сценария .cs Unity, который будет вызывать методы Chartboost.
  • Вызывайте открытые функции, которые есть в файле /Assets/Chartboost/Scripts/Chartboost.cs (входят в класс Chartboost). Изучите ChartboostExample.cs в образце проекта.
  • Чтобы показать рекламу, можно сделать вызов:
    // Показать рекламную вставку в местоположении HomeScreen. 
// Доступные местоположения см. в Chartboost.cs.
 Chartboost.showInterstitial(CBLocation.HomeScreen);
Настоятельно рекомендуем кэшировать рекламные вставки перед их показом. Подробнее о кэшировании ▶

 

При сборке для устройств iOS:

  • При первой сборке проекта нужно нажать Build (а не Build & Run), чтобы все надлежащим образом настроилось.
  • По завершении сборки откройте созданный проект Xcode и убедитесь в том, что прикладные оболочки StoreKit, Security и CoreData скомпонованы на вкладке настроек Build Phases.
Следите за тем, чтобы случайно не отключить StoreKit.framework (например, при отключении покупок внутри приложений) после того, как Unity создаст ваш проект Xcode. Эта прикладная оболочка необходима для нормальной работы SDK.

 

При сборке для устройств Android:

  • Проект можно собирать сразу в файл APK или экспортировать в Android Project, если вы намерены вносить дальнейшие изменения в Java.
  • Если ваше приложение поддерживает разные ориентации, задайте настройки configChanges в своем тэге <activity> и добавьте туда следующее:
<activity android:name="com.chartboost.sdk.sample.SampleActivity"
 android:label="@string/app_name"
 android:configChanges="keyboardHidden|orientation|screenSize">

 

В нашем последнем SDK решена проблема совместимости с Google Play Services Rev.30. Если вы уже перешли на Rev.31, не забудьте обновить и свое хранилище Google.

 


 

Ура! Вы только что интегрировали Chartboost SDK в свое приложение!

Теперь можно перейти к запуску кампании ▶

 


 

Другие функции SDK

  • Chartboost Video: монетизируйте прибыль либо привлекайте пользователей с помощью рекламных видеовставок или видео с вознаграждением за просмотр.
  • Кэширование: ускорение сроков загрузки рекламных вставок, видеоматериалов и страниц «Другие приложения».
  • Именованные локации: тонкая настройка таргетинга кампаний и частоты рекламных вставок для разных местоположений. Учтите, что начиная с SDK 5.0 именованные местоположения стали обязательными.
  • Делегированные методы: расширенная настройка поведения Chartboost в ваших приложениях
  • Методы конфигурации SDK: Доступ к функциональности и настройкам Chartboost SDK.
  • Страница «Другие приложения»: Создание и видоизменение страницы с перечнем других игр, которая появляется в вашем приложении для рекламы ваших собственных игр или для публикации рекламы других разработчиков.
  • Послеустановочная аналитика: Для игр с покупками внутри приложения. Пользуйтесь полезными данными о поведении игроков как покупателей для того, чтобы оптимизировать кампании и проводить ретаргетинг.

 


 

Вам может быть интересно...