Unity


 

Предварительные действия

Добавить SDK к игре несложно, достаточно всего нескольких ингредиентов:

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

 

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

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

Файлы распределяются по нескольким разным каталогам:

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

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

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

 

Если игра публикуется в Google Play Store, подключите к своему проекту Unity библиотеку Google Play Services.

  • Перейдите по путиChartboost > Изменить параметрыи кликнитеSet Up Android SDK.
  • В результате библиотека Google Play Services будет подключена к проекту Unity, что необходимо для интеграции SDK Chartboost в игры на 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 dashboardand replace these with an App ID & App Signature from your account! (С Unity: CHARTBOOST: вы используете идентификатор-пример приложения Chartboost для Android! Откройте панель наблюдения Chartboost и замените эти значения идентификатором и подписью приложения из вашей учетной записи!)

 

Перетащите префаб Chartboost из/Assets/Chartboost/Chartboostв сцену Unityв режиме отображения Сцена.

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

 

Отображение рекламных вставок:

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

 

Если сборка выполняется для устройств на iOS:

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

 

Если сборка выполняется для устройств на Android:

  • Выполните сборку проекта непосредственно в файл APK или экспортируйте его в проект Android, если требуется вносить дополнительные изменения на 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 Repository.

 


 

Ура!SDK Chartboost успешно интегрирован в приложение!

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

 


 

Дополнительные функции SDK

  • Видео Chartboost:монетизируйте или приобретайте пользователей с помощью видеорекламы с вознаграждением за просмотр и рекламных видеовставок.
  • Кэширование:снижайте время загрузки для рекламных вставок, видео и страниц MoreApps.
  • Именованные пункты:проводите тонкую настройку таргетинга акции и частоты показа рекламных вставок в зависимости от пункта. (Обратите внимание, что, начиная с SDK 5.0, именованные пункты стали обязательными.)
  • Делегированные методы:дополнительно настраивайте поведение Chartboost в своем приложении.
  • Методы конфигурации SDK:обращайтесь к функциям и параметрам SDK Chartboost.

 


 

Возможно, вас также заинтересует…