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

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

 

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

Примечание: Для интеграции Amazon используется тот же SDK, что и для Android.
Обновить SDK Журнал изменений

 


 

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

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

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

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

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

 


 

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

 

 


 

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

  • Уже зарегистрировали учетную запись Chartboost?
  • Добавили приложение на панель пользователя?
  • Загрузили новейший SDK?
  • Создали активную кампанию публикатора?
  • Для интеграции Amazon используется тот же SDK, что и для Android. Эти указания к интеграции относятся к играм для Google Play и Amazon App Store.
  • Если сборка игры проводится в Unity, настоятельно рекомендуем использовать наш подключаемый модуль Unity для Android. Если вы предпочитаете пользоваться Android SDK с собственным адаптером Unity, то этот метод поможет показывать рекламу в вашей игре.
  • Этому Chartboost SDK требуется API уровня 9 (Android OS 2.3) или выше.
  • Обязательное разрешение: android.permission.INTERNET
  • Обязательное разрешение: android.permission.ACCESS_NETWORK_STATE
  • Настоятельно рекомендуется: для совместимости с устройствами Android 6.0 задайте в своем файле build.gradle версии SDK для сборки и компиляции проекта как API уровня 23:
    buildToolsVersion = '23.0.0'
    compileSdkVersion = 23
  • Настоятельно рекомендуется: для работы функций Android 6.0 Marshmallow в своем файле AndroidManfiest.xml задайте версию целевого SDK как API уровня 23:
    android:targetSdkVersion="23"
  • Необязательное (но рекомендуемое) разрешение: android.permission.WRITE_EXTERNAL_STORAGE. Оно позволяет SDK кэшировать все рекламные активы (креативы, пользовательские рамки и т. п.) во внешней памяти. Это обеспечивает максимальную производительность, так как подает рекламу сразу и сокращает сетевой трафик, потребляемый SDK.
  • Необязательное (но рекомендуемое) разрешение: android.permission.ACCESS_WIFI_STATE. Оно позволяет SDK проверять сведения о Wi-Fi в HTTP-запросе. Наряду с Android ID и (или) GAID, он будет использоваться как идентификатор пользователя. Подробнее см. «Идентификаторы устройств».
  • Необязательное (но рекомендуемое) разрешение: android.permission.READ_PHONE_STATE. Оно позволяет SDK обрабатывать вызовы, прерывающие воспроизведение видео.

 


 

Добавьте файл chartboost.jar в свой каталог libs.

  • Если у вас нет папки libs, создайте ее и добавьте туда файл .jar.
  • Необязательно: Добавьте chartboost.jar.properties и каталог doc в libs, чтобы в вашей IDE был Javadocs.

 


 

В своем проекте добавьте библиотеку Google Play Services как зависимость.

  • У библиотеки Google Play Services есть свой набор указаний к интеграции, включая добавления в Android Manifest и в конфигурацию ProGuard.
  • Следуйте этим указаниям Google по настройке.

 


 

Добавьте в свой файл AndroidManifest.xml следующую строку:

<activity android:name="com.chartboost.sdk.CBImpressionActivity"
               android:excludeFromRecents="true"
               android:hardwareAccelerated="true"
               android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen"
               android:configChanges="keyboardHidden|orientation|screenSize" />
  • Это сделает переходы рекламы и видеовоспроизведение более плавными.

 


 

Если вы показываете рекламу Chartboost в активности, которая поддерживает разные ориентации, то добавьте к этим активностям в AndroidManifest.xml следующий атрибут:

android:configChanges="keyboardHidden|orientation|screenSize"
  • Это поможет сделать видеовоспроизведение более плавным при смене ориентации.

 


 

Импортируйте Chartboost SDK в активность, которая задействует Chartboost.

import com.chartboost.sdk.Chartboost;
import com.chartboost.sdk.CBLocation;
import com.chartboost.sdk.ChartboostDelegate;
import com.chartboost.sdk.Libraries.CBLogging.Level;
import com.chartboost.sdk.Model.CBError.CBClickError;
import com.chartboost.sdk.Model.CBError.CBImpressionError;
import com.chartboost.sdk.Tracking.CBAnalytics;
import com.chartboost.sdk.CBImpressionActivity;

 


 

Инициализируйте Chartboost SDK в своем классе активности запуска.

  • Расширить метод жизненного цикла onCreate своей основной активности можно так:
public class <your Class name> extends Activity {
            
@Override
public void onCreate() {
    super.onCreate();
    Chartboost.startWithAppId(this, appId, appSignature);
    Chartboost.onCreate(this);
    }   
}
  • С другой стороны, можно доверить ее обработку самому SDK и просто расширить ChartboostActivity. Это избавляет от необходимости переопределять такие методы жизненного цикла активности, как onCreate, то есть вы можете просто вызывать Chartboost.OnCreate().
ПРОФЕССИОНАЛЬНЫЙ СОВЕТ: Сообщение "Exception: Initialization error" означает, что SDK не был корректно инициализирован.
ПРОФЕССИОНАЛЬНЫЙ СОВЕТ: если вы используете Android SDK со своим собственным адаптером Unity, то Unity следует заявить как прикладную оболочку сразу после startWithAppId с помощью метода Chartboost.setFramework(CBFramework.CBFrameworkUnity, unityVersion);. Замените unityVersion значением, которое возвращает эта функция Unity.
startWithAppId(android.app.Activity activity, java.lang.String appId, java.lang.String appSignature) обязательно должен вызываться при жестких и мягких запусках – независимо от того, какие еще действия выполняет ваше приложение.

 


 

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

 


 

Переопределите методы жизненного цикла активности.

  • Для расширения методов onStart(), onPause(), onResume(), onStop(), onDestroy() и onBackPressed() своей активности добавьте следующий код:
@Override
public void onStart() {
 super.onStart();
 Chartboost.onStart(this);
}

@Override
public void onResume() {
 super.onResume();
 Chartboost.onResume(this);
}

@Override
public void onPause() {
 super.onPause();
 Chartboost.onPause(this);
}
 
@Override
public void onStop() {
 super.onStop();
 Chartboost.onStop(this);
}

@Override
public void onDestroy() {
 super.onDestroy();
 Chartboost.onDestroy(this);
}

@Override
public void onBackPressed() {
// Если вставка на экране, закрыть ее.
 if (Chartboost.onBackPressed())
 return;
 else
 super.onBackPressed();
}

 


 

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

Chartboost.cacheInterstitial(CBLocation.LOCATION_DEFAULT);
Chartboost.showInterstitial(CBLocation.LOCATION_DEFAULT);
  • Интерфейсный класс CBLocation можно использовать для получения списка констант местоположения по умолчанию и для того, чтобы задавать собственные константы.  Если местоположение использовано хотя бы однажды, оно будет добавлено на вашу панель пользователя, где можно будет задать его настройки.
  • Для дополнительного управления поведением рекламы в вашей игре Chartboost SDK предлагает и другие функции: именованные местоположения, кэширование и делегированные методы.
  • Подробнее см. раздел о видеорекламе Chartboost.
Настоятельно рекомендуем кэшировать рекламные вставки перед их показом. Подробнее о кэшировании ▶

 

Чтобы показать видеорекламу с вознаграждением за просмотр:

Chartboost.cacheRewardedVideo(CBLocation.LOCATION_GAMEOVER);
Chartboost.showRewardedVideo(CBLocation.LOCATION_GAMEOVER);
Настоятельно рекомендуем кэшировать рекламные вставки перед их показом. Подробнее о кэшировании ▶

 

Если вы пользуетесь ProGuard, добавьте в свой proguard-rules.pro следующее:

-keep class com.chartboost.** { *; }
ПРОФЕССИОНАЛЬНЫЙ СОВЕТ: Для правильной настройки ProGuard следуйте указаниям Google Play Services.

 


 

Проверьте свою интеграцию.

  • Запустите свой проект на устройстве Android.
  • Если у вас есть активная кампания публикатора и вы интегрировали вызовы показа рекламной вставки или показа видео с вознаграждением, но должны увидеть на устройстве работающую рекламу.
  • Если у вас нет кампаний публикатора, но вы интегрировали эти вызовы, то можете воспользоваться тестовым режимом, чтобы проверить, выводится ли реклама.
  • Почему я не вижу в своей игре рекламы?

 


 

Проверьте значок SDK на панели пользователя.

  • Перейдите в «Настройки приложения» > «Основные настройки» на панели пользователя.
  • Когда наши серверы получат от нашего SDK успешный вызов запуска с идентификатором вашего приложения, значок SDK под значком приложения поменяет цвет с серого на зеленый.

 


 

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

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

 


 

Ознакомьтесь с другими функциями Chartboost

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

 


 

Использование Open GL и более давних версий Chartboost SDK

  • Добавьте в свой файл AndroidManifest.xml следующую строку: Подробнее см. этот шаг.
<activity android:name="com.chartboost.sdk.CBImpressionActivity"
               android:excludeFromRecents="true"
               android:hardwareAccelerated="true"
               android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen"
               android:configChanges="keyboardHidden|orientation|screenSize" />
  • Chartboost SDK 3.4.0 и ниже: cb.setImpressionsUseActivities(true);
  • Chartboost SDK 4.x: CBPreferences.getInstance().setImpressionsUseActivities(true);
  • Chartboost SDK версий 5.x: Chartboost.setImpressionsUseActivities(boolean impressionsUseActivities). Вызывайте этот метод в методе onCreate() своей активности после того, как инициализировали SDK с помощью startWithAppId, однако до вызова Chartboost.onCreate()

 


 

Вам может быть интересно...
  • Коды ошибок: Решение распространенных проблем при интеграции SDK для Android.

 

▲ К началу