- 开始之前
- 正在导入 Chartboost Unity 数据包
- 正在链接 Google Play Services 服务库
- 正在添加 App ID 和 App 签名
- 正在将 Chartboost 预制设置添加至您的 Unity 场景
- 正在显示插页式广告
- 正在构建至 iOS 设备
- 正在构建至 Android 设备
- 更多 SDK 功能
![]() |
开始之前 |
- Chartboost 帐户
- 后台控制面板中有应用程序
- 最新的 SDK
- 活跃的广告发布活动
- 请注意,Chartboost 支持 Android 5 以上版本和 iOS 9.0版,因此请确保相应地设置Unity项目的最低操作系统版本。
- 此外,为确保与Android 6.0 Marshmallow设备和功能的兼容性,您应确保自己正在构建、编译和定位最新的Google Android SDK(至少API等级23)。 (但是,“最低限度”的SDK的定位仍是API等级16)
必须在您的应用程序硬启动或软启动的头几秒内
调用 Chartboost 初始化,与您应用程序内的任何其他操作或用户互动无关。
开发者可以调用 Chartboost SDK 里的
Chartboost.addDataUseConsent
API 来设置用户的授权许可状态。作为服务条款的一部分,开发者需要向用户征求授权许可(同意、不同意、未知),然后用上述 API 传递给 Chartboost,此 API 的调用必须在执行 startWithAppId
之前。GDPR / CCPA 的相关内容,开发者可以 参考这里。
![]() |
将 Chartboost Unity 数据包导入到您的项目中。 |
- /Assets/Chartboost/Editor:用于 Unity Editor 集成的 Chartboost C# 代码和 Postprocessbuildscript
- /Assets/Chartboost/Resources:此文件夹含有 ChartboostSettings 文件,其中包含用于您 iOS 和 Android 应用程序的AppId和AppSignature
- /Assets/Chartboost/Scripts:Chartboost 使用的 C# 代码。我们所有面向公众的功能均收在Chartboost.cs,在这个文件夹中
- /Assets/ChartboostExample:演示如何使用 Chartboost SDK 的示例场景
- /Assets/Plugins/iOS:有助于将其集成到Unity中的 Chartboost Objective-C 代码
- /Assets/Plugins/Android:Chartboost Android 库文件
Android:对于替换插件中包含的Android Manifest的复杂集成,可显示Chartboost广告的任何活动
必须在 Android 清单的活动条目中有值
android:hardwareAccelerated="true"
,否则视频可能无法正确显示。![]() |
如果要在 Google Play Store 中发布您的游戏,请将您的 Unity 项目与 Google Play Services 库进行链接。 |
- 转至Chartboost > 编辑设置并点击设置 Android SDK.
- 这会将 Google Play Services 库与您的 Unity 项目链接,Android 游戏集成 Chartboost SDK 需要该操作。
- 这也需要通过 Android SDK Manager 安装 Google Play Services 库。请参见谷歌开发者网站了解更多信息。
- 下载最新的 “Play Services Resolver” 插件:下载地址。 例如, 您可以找到 “1.2.129.0” 这个版本,下载地址在 这里。
- 将 “Play Services Resolver” 插件导入您的 Unity 项目。
- 右键点击您项目里的 “Assets->Plugin->Android” 目录然后选择 “Player Services Resolver ->Android Resolver ->Resolve“
- 这个步骤需要您已经提前使用 Android SDK Manager 安装好了所需的 Google Play Services library 。 详情请参考 Google 开发者 网站。

![]() |
添加您的 App ID 和 App 签名。 |
- 转至Chartboost > 编辑设置.
- 添加您的 App ID 和 App 签名。如何找到我的 App ID和 App 签名?
从不使用的存储字段删除内部内容,例如
CB_AMAZON_APP_ID
和
CB_AMAZON_APP_SIGNATURE
字段,否则 Unity 会提示以下错误:
W/Unity: CHARTBOOST: 您正在使用 Chartboost Android 示例 App ID! 请前往 Chartboost 后台控制面板,并使用您帐户的 App ID 和 App 签名替换这些内容!
Chartboost 的 App ID 是我们系统中区分 App 的惟一辨识符, 所以每个 App 都需要使用 单独的 Chartboost App ID。.
![]() |
在场景视图中将/Assets/Chartboost/Chartboost找到的 Chartboost Prefab 预设拖放到您的Unity 场景。 |
- 这个 Chartboost Prefab 预设可自动处理基本的 SDK 行为,例如使用 App ID 和 App 签名进行初始化。
- 提示:请将 Chartboost Prefab 预设拖放到仅运行一次的场景(例如启动场景)以获得最优效果。
![]() |
为展示插页式广告: |
- 使用 ChartboostSDK
在每个调用 Chartboost 方法的 Unity.cs 的顶部
包括一个参考。 - 调用Chartboost 类公共职能出现在/Assets/Chartboost/Scripts/Chartboost.cs文件中。请查看示例项目中的ChartboostExample.cs。
- 为展示广告,您现在即可调用:
我们
强烈建议您在显示广告之前,对插页式广告进行缓存。
了解更多关于缓存的信息▶
即使您正在使用聚合功能,预取的视频(总计)也只占用 30-50MB。
GDPR 相关:针对欧洲的用户,开发者可以调用 Chartboost SDK 里的
Chartboost.addDataUseConsent
API 来设置用户的授权许可状态。作为服务条款的一部分,开发者需要向用户征求授权许可(同意、不同意、未知),然后用上述 API 传递给 Chartboost,此 API 的调用必须在执行 startWithAppId
之前。![]() |
如果您要构建到 iOS 设备: |
- 首次构建您的项目时,应该构建(而非构建并运行)以便一切都设置正确。
- 一旦构建完成,打开创建的 Xcode 项目,并确保
StoreKit
,Security
且CoreData
框架已经加入到你的 Build Phases 编译选项里。 - 对于 iOS 14 及以上,需要添加下列必要的 SKAdNetwork ID 到项目的 Info.plist 里,详情请参考 iOS 14 接入指南.
请注意防止链接意外断开
StoreKit.framework(例如通过禁用应用程序内购买),这发生在 Unity 创建Xcode 项目之后。
Chartboost SDK 需要此框架以正常运行。
![]() |
如果您打算编译到 Android 设备: |
- 若要构建您的项目,直接对 APK 文件进行操作;或者如您希望在 Java 中进一步修改,则导出为 Android 项目。
- 如果您的应用程序支持多方向运行,调整
configChanges
设置,在您的<activity>
标签中包括这些内容:
我们最新的 SDK 已经修复了与 Google Play Services Rev.30 的兼容问题。如果您已升级至 Rev.31,请确保您的 Google Repository 亦为最新版。
w00t!您刚把 Chartboost SDK 集成到应用程序中!
现在您可以开始广告活动 ▶
更多 SDK 功能
- Chartboost 视频:通过奖励式广告或插页式视频广告变现或获取用户,
- 缓存:加快插页式广告、视频和 MoreApps 页面的加载时间
- 命名位置:根据位置微调广告活动的定位和插页式广告的频率。 (请注意,从SDK 5.0开始,命名的位置为必需项。)
- 委托方法:在您的应用程序
- SDK 配置方法中进一步配置 Chartboost 行为:访问 Chartboost SDK 的功能和设置。
您可能还喜欢…
- 常见错误及解决方案为 Unity 集成 SDK 时
Last Updated on 6月 29, 2021