下载并集成 Chartboost SDK 到 Android ▶

上次更新:

 

 

添加您的移动游戏到 Chartboost 网络只需 10 行代码!

 


 

包括哪些内容?SDK 文件包内含各项特色功能。

高质量视频广告专为游戏打造,奖励您的玩家!

可自定义插页式广告为您的玩家提供无缝游戏体验!

强大数据分析套件为您定位最佳受众!

查看完整 SDK 发布说明 ▶

 


 

准备好集成 Chartboost SDK?那我们开始吧!

 

 


 

在您开始前:

  • 您是否已注册 Chartboost 帐户?
  • 您是否已添加应用到您的后台?
  • 您是否已下载最新 SDK
  • 您是否已有处于活动状态的发布活动
  • 亚马逊集成使用与 Android 相同 SDK。此集成指南适用于 Google Play 或亚马逊应用商店的游戏。
  • 如果您的游戏使用 Unity 生成,我们强烈建议使用我们的 Unity Android 插件。 如果您希望使用 Android SDK 配您自己的 Unity 适配器,请使用此方法以确保应用在您的游戏中妥善显示。
  • Chartboost SDK 要求 API 等级 9 (Android OS 2.3) 或更高。
  • Required permission: 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 通过 HTTP 请求检查 Wi-Fi 详情。此信息与 Android ID 和/或 GAID 一同用作用户标识符。检查设备识别码以获取详情。
  • 可选 (建议) 权限: android.permission.READ_PHONE_STATE 允许 SDK 处理视频播放期间插入的通话。

 


 

添加 chartboost.jar 文件到您的 libs 文件夹

  • 如果您没有 libs 文件夹,请创建并添加 .jar 文件
  • 可选: 添加 chartboost.jar.propertiesdoc 文件夹到 libs 以便从 IDE 获取 Javadocs。

 


 

添加 Google Play Services Library 作为项目的相关内容。

  • Google Play 库有自己的集成指南,包括添加到 Android Manifest 和 ProGuard 的配置。
  • 按照

Google 的设置指南。

您只需导入 com.google.android.gms:play-services-ads:8.4.0 到您的生成。

 


 

添加以下内容到您的 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" />
对于不包括 CBImpressionActivity 的复杂集成,所有显示 Chartboost 广告的活动的 Android 清单文件上必须具备 android:hardwareAccelerated="true" 值,否则视频无法正常显示。

 


 

如果您在任何支持不同方向的活动中显示 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()
专家提示: 注意例外: 初始化错误信息。该提示表示 SDK 未能妥善初始化。
专家提示: 如果您使用 Android SDK 配您自己的 Unity 调试器,您必须在 startWithAppId 后使用 Chartboost.setFramework(CBFramework.CBFrameworkUnity, unityVersion); 方法立即报告 Unity 为框架。使用此 Unity 函数的返回值来替换 unityVersion
startWithAppId 必须在启动或后台唤醒时调用,无论应用同时在执行其他任何操作。

 


 

添加应用 ID 和应用签名。

 


 

覆盖活动生命周期方法。

  • 添加以下代码以扩展您的活动 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 视频广告详情 ▶
请勿在同一位置 cacheInterstitial 后直接调用 showInterstitial,否则 SDK 会静默失败。
强烈推荐您在显示广告前先缓存。了解缓存详情 ▶

 

如需显示激励式视频广告:

Chartboost.cacheRewardedVideo(CBLocation.LOCATION_GAMEOVER);
Chartboost.showRewardedVideo(CBLocation.LOCATION_GAMEOVER);
请勿在同一位置 cacheInterstitial 后直接调用 showInterstitial,否则 SDK 会静默失败。
强烈推荐您在显示广告前先缓存。了解缓存详情 ▶

 

如果您使用 ProGuard,请添加如下内容到您的 proguard-rules.pro:

-keep class com.chartboost.** { *; }
专家提示: 按照 Google Play Services 指南以妥善设置 ProGuard。

 


 

测试您的集成。

  • 在 Android 设备上运行项目。
  • 如果您有处于活动状态的发布活动并且已集成“显示插页式广告”或“显示激励式视频”,您应该能够看到在线广告。
  • 如果您没有任何发布活动,但已集成调用,您可以使用测试模式来检查广告是否显示。
  • 为何我无法在游戏中看到广告?

 


 

在后台测试 SDK 图标。

  • 前往后台找到您的应用的应用设置 > 基本设置
  • 当服务器从 SDK 使用您的应用 ID 成功接收到启动调用后,应用图标下方的 SDK 图标会从灰色专为绿色。

 


 

大功告成! 您已将 Chartboost SDK 集成到您的应用!

您现在可以开始广告活动 ▶

 


 

了解更多 Chartboost SDK 特性

  • 缓存: 通过保存到本地加速广告和“更多应用”页面加载时间。
  • Chartboost 视频: 添加优质视频广告为玩家提供最佳游戏内体验。
  • 命名位置: 从后台优化广告活动的对象定位和广告频率。
  • 委托方法: 更好地控制游戏和广告间互动。
  • 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 v3.4.0 或更低版本: cb.setImpressionsUseActivities(true);
  • 对于 Chartboost SDK v4.x: CBPreferences.getInstance().setImpressionsUseActivities(true);
  • Chartboost SDK v5.x: Chartboost.setImpressionsUseActivities(boolean impressionsUseActivities) 在使用 startWithAppId 初始化 SDK 而调用 Chartboost.onCreate() ,在您的活动的 onCreate() 方法中调用此方法

 


 

您可能还希望…

 

▲ 返回顶部