下载并集成 Chartboost SDK 到 Unity ▶

上次更新:

 

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

使用 Unity 3.x 或更早版本?下载本插件 升级您的 SDK 视图更新日志

 


 

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

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

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

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

查看完整 SDK 发布说明 ▶

 


 

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

 


 

在您开始前:

轻松快捷添加 SDK 到您的游戏 — 仅需几个元素:

  • 一个 Chartboost 帐户
  • 一个后台上的应用
  • 最新的 SDK
  • 活跃的发布活动
  • 注: Chartboost 支持 Android 2.3+ 和 iOS 6.0,请确保您在 Unity 项目中正确设置相应 OS 最低版本要求。
  • 另外,为确保兼容 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: Chartboost Objective-C 代码帮助实现 Unity 内集成
  • /Assets/Plugins/Android: Chartboost Android 库文件

想立刻开始?看一眼 ChartboostExample 文件夹中的文件。探索演示场景时,记得留意日志文件,因为某些按钮并无明显效果。

Android: 对于将 Android 清单文件包括在插件中的复杂集成,所有显示 Chartboost 广告的活动的 Android 清单文件上必须具备 android:hardwareAccelerated="true" 值,否则视频无法正常显示。

 

如果您在 Google Play 商店中发布游戏,请关联 Google Play Services 库到您的 Unity 项目。

  • 前往 Chartboost > 编辑设置然后点击设置 Android SDK
  • 本操作会链接 Google Play Services 库到您的 Unity 项目,这是集成 Android 游戏专用 Chartboost SDK 所必须的。
  • 同样要求 Google Play Services 库通过 Android SDK Manager 完成安装。详情请见 Google 开发者网站

 

添加应用 ID 和应用签名。

从未使用的商城字段删除类似 CB_AMAZON_APP_IDCB_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!

 

场景视图拖拽并释放在 /Assets/Chartboost/Chartboost 的 Chartboost 预制到您的 Unity 场景。

  • 此预制自动处理基础 SDK 行为 (如实例化),使用您的应用 ID 和应用签名。
  • 提示: 拖动预制到只运行一次的场景 (例如开始场景) 以优化表现。

 

如需显示插页式广告:

  • 包括 using ChartboostSDK; 引用到会使用 Chartboost 方法的每个 Unity .cs 脚本的顶部。
  • 调用 /Assets/Chartboost/Scripts/Chartboost.cs 文件中 Chartboost 类的全部公用函数。请参考示例项目中的 ChartboostExample.cs
  • 如需显示广告,您现在可以调用:
    // 在位置 HomeScreen 展示插页式广告。 
// 查看 Chartboost.cs 了解可用的位置选项。
 Chartboost.showInterstitial(CBLocation.HomeScreen);
强烈推荐您在显示广告前先缓存。了解缓存详情 ▶

 

如果您要针对 iOS 设备生成:

  • 在您首次生成项目的时候,您应该执行生成 (而非生成并运行) 以便正确完成设置。
  • 生成完毕后,打开已创建的 Xcode 项目,并确保以下框架链接到生成阶段设置下您的对象的相应选项卡: StoreKit, SecurityCoreData 框架。
注意不要在 Unity 创建您的 Xcode 项目后错手关闭 StoreKit.framework 的连接 (例如禁用应用内购买)。Chartboost SDK 需要此框架方可正常运作。

 

如果您要针对 Android 设备生成:

  • 您可以直接生成项目为 APK 文件;如果您希望通过 Java 做进一步修改,您可以导出到 Android 项目。
  • 如果您的应用支持多方向,请在您的 <activity> 标签中调整 configChanges 设置来包括以下内容:
<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 也是最新版本。

 


 

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

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

 


 

更多 SDK 特色

  • Chartboost 视频: 使用激励式视频或插页式视频广告赢利或吸纳用户。
  • 缓存: 加快插页式广告、视频和“更多应用”页面的加载时间
  • 命名位置: 根据地点优化广告活动定位和插页式广告频率。(注意,命名位置在 SDK 5.0 中为必选内容。)
  • 委托方法: 在您的应用中进一步定制 Chartboost 的行为
  • SDK 配置方法: 访问 Chartboost SDK 功能和设置。
  • “更多应用”页面: 在您的应用中新建和自定义“查看更多游戏”页面从而为您或其他开发者的游戏投放广告。
  • 安装后数据分析: 用于具有应用内购买的游戏。解锁有关玩家购买行为的数据以优化广告活动或二次营销。

 


 

您可能还希望…