东西不灵。我们一起来修。

按平台浏览错误:

iOS SDK 错误

Android SDK 错误

Unity SDK 错误

iOS SDK 错误

CBLoadErrorFirstSessionInterstitialsDisabled

当 Chartboost SDK 设置不在首次会话显示广告时触发。您可能设置了 [Chartboost setShouldRequestInterstitialsInFirstSession:NO]。您可以在 iOS 集成指南的最佳实践页面阅读详情

CBLoadErrorInternal

多种可能原因。发送日志 (包括发生错误时的断点) 到客服以获取支持

CBLoadErrorInternetUnavailable

在测试设备无互联网连接时触发。排除可能发生的设备网络连接问题。

CBLoadErrorNetworkFailure

设备网络不可用或设备无法连接到互联网时触发。请检查网络设置并确保您的设备已连接到互联网。如果问题仍然存在，请将 Charles 网页代理日志发送到客服。

CBLoadErrorNoAdFound

广告服务器无法找到妥当的插页式广告发送到设备时触发。可能由于位置、广告活动筛选条件或其他因素导致。 疑难解答

CBLoadErrorNoLocationFound

当您在命名位置字符串输入 NULL 时触发。了解命名位置详情

CBLoadErrorSessionNotStarted

无法检测到有效 Chartboost 会话。请检查您的应用 ID 和应用签名，以及确保您采用如下方法妥当初始化 Chartboost: [Chartboost startWithAppId:@"YOUR_CHARTBOOST_APP_ID" appSignature:@"YOUR_CHARTBOOST_APP_SIGNATURE" delegate:self];

CBLoadErrorTooManyConnections

在同一命名位置同时发送或接收过多请求时触发使用新的命名位置或减少该位置的请求。

CBLoadErrorWrongOrientation

在 Chartboost 发送方向有误的插页式广告到设备时触发。请到 Chartboost 后台验证此应用 ID 已选择正确方向。如可能，请发送 Charles 网页代理日志到客服。

▲ 返回顶部

Android SDK 错误

ASSETS_DOWNLOAD_FAILURE

从 Chartboost 服务器下载素材出错。排查您的互联网连接问题 (检查网关等) 然后重试。如可能，请发送 Charles 网页代理日志到客服。

ERROR_CREATING_VIEW

展示 Chartboost 广告时出错。请检查您的集成并确保 Chartboost 的 Android 生命周期方法已妥善初始化。如可能，请发送 Charles 网页代理日志到客服。

ERROR_DISPLAYING_VIEW

展示视图时出错。请检查您的集成并确保 Chartboost 的 Android 生命周期方法已妥善初始化。如可能，请发送 Charles 网页代理日志到客服。

ERROR_PLAYING_VIDEO

Chartboost SDK 开始视频内容时遇到问题。如可能，请发送 Charles 网页代理日志到客服。

FIRST_SESSION_INTERSTITIALS_DISABLED

当 Chartboost SDK 设置不在首次会话显示广告时触发。您可能设置了 setShouldRequestInterstitialsInFirstSession(boolean shouldRequest) 为 FALSE。了解 Android SDK 配置方法

NO_HOST_ACTIVITY

在无 Chartboost 集成妥当的当前活动时触发。请检查您的集成并确保 Chartboost 的 Android 生命周期方法已妥善初始化。

IMPRESSION_ALREADY_VISIBLE

已有展示可见或处于加载过程中。请检查您的集成代码是否有额外 showInterstitial 调用。如可能，请发送代码片段 (初始化 Chartbosst 并使用 Chartboost SDK 方法部分) 然后联系客服。

INTERNAL

多种可能原因。发送日志 (包括发生错误时的断点) 到客服以获取支持。

INTERNET_UNAVAILABLE

在测试设备无互联网连接时触发。排除可能发生的设备网络连接问题。

INVALID_LOCATION

当您在命名位置字符串输入 NULL 时触发。了解命名位置详情

INVALID_RESPONSE

Chartboost 服务器返回无效响应。如可能，请发送 Charles 网页代理日志到客服。

NETWORK_FAILURE

设备网络不可用或设备无法连接到互联网时触发。请检查网络设置并确保您的设备已连接到互联网。如果问题仍然存在，请将 Charles 网页代理日志发送到客服。

NO_AD_FOUND

广告服务器无法找到妥当的插页式广告发送到设备时触发。可能由于位置、广告活动筛选条件或其他因素导致。 疑难解答

SESSION_NOT_STARTED

无法检测到有效 Chartboost 会话。请检查您的应用 ID 和应用签名，以及确保您采用如下方法妥当初始化 Chartboost: Chartboost.startWithAppId(this, appId, appSignature);

TOO_MANY_CONNECTIONS

在同一命名位置同时发送或接收过多请求时触发。使用新的命名位置或减少该位置的请求。 了解命名位置详情

VIDEO_ID_MISSING

视频链接丢失。如可能，请发送 Charles 网页代理日志到客服。

VIDEO_UNAVAILABLE

视频未缓存。如可能，请发送 Charles 网页代理日志到客服。

WRONG_ORIENTATION

在 Chartboost 发送方向有误的插页式广告到设备时触发。请到 Chartboost 后台验证此应用 ID 已选择正确方向。如可能，请发送 Charles 网页代理日志到客服。

▲ 返回顶部

Unity SDK 错误

无法转化类到 dex 格式

可能存在类不一致 (例如，com.BustersBoost 和 com.bustersboost)。更改为 PlayerSettings.bundleIdentifier 以解决冲突问题。通常，由于 Unity 限制，您无法使用 com.Example 为您的捆绑 ID，如果项目内任何包含的类名为 Example。通过文件 > 生成设置 > 玩家设置 > Android 设置 > 其他设置 > 识别进行修改，然后重建。

UnityEngine.EventSystems

在您的 Unity 版本过期时触发。升级到 Unity 4.0 或以上版本，或联系客服以请求旧版 SDK。

Chartboost SDK 对 Android 输入无响应。

请确保您的项目的主要 <activity> 元素 (包含 <intent-filter> 及 android.intent.action.MAIN 操作) 包含如下代码:

<meta-data android:name="unityplayer.ForwardNativeEventsToDalvik" android:value="true" />

Unity 近期版本将其值默认为 “FALSE”，但必须将其设为 “TRUE” 方可使 Chartboost 接收点击事件。Unity 通常会自动复制设置，但有时已更改设置并不会反映到最终产品上。

在 Android 项目上使用多个插件；Chartboost 或其他插件停止工作

Unity 通常会自动合并多个 Unity 插件所使用的不同的 Android 清单更改。不过该过程并不总能成功。您可能需要手动合并 Android 清单文件。

找到您的 Unity 项目的已有 AndroidManifest.xml 文件然后进行更改，确保具备以下权限:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>

在您的 AndroidManifest.xml 文件中添加如下条目，以显示平滑过渡和视频回放:

<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" />

您必须确保主要 <activity> 元素 (包含 <intent-filter> 及 android.intent.action.MAIN 操作) 包含如下代码:

<meta-data android:name="unityplayer.ForwardNativeEventsToDalvik" android:value="true" />

如需查看可行的 Android 清单文件并附所有设置，您可以在 /Assets/ChartboostExample 中查看 Chartboost 示例场景并检查 Unity 中和导出为 Google Android 项目的 Android 清单文件。

▲ 返回顶部

AIR 到原生 Android 错误

Load Error 0 又名 INTERNAL

多种可能原因。发送日志 (包括发生错误时的断点) 到客服以获取支持。

Load Error 1 又名 INTERNET_UNAVAILABLE

在测试设备无互联网连接时触发。排除可能发生的设备网络连接问题。

Load Error 2 又名 TOO_MANY_CONNECTIONS

在同一命名位置同时发送或接收过多请求时触发。使用新的命名位置或减少该位置的请求。了解命名位置详情

Load Error 3 又名 WRONG_ORIENTATION

在 Chartboost 发送方向有误的插页式广告到设备时触发。请到 Chartboost 后台验证此应用 ID 已选择正确方向。如可能，请发送 Charles 网页代理日志到客服。

Load Error 4 又名 FIRST_SESSION_INTERSTITIALS_DISABLED

当 Chartboost SDK 设置不在首次会话显示广告时触发。您可能设置了 setShouldRequestInterstitialsInFirstSession(shouldRequest:Boolean) 为 FALSE。阅读 Adobe AIR 集成指南

Load Error 5 又名 NETWORK_FAILURE

设备网络不可用或设备无法连接到互联网时触发。请检查网络设置并确保您的设备已连接到互联网。如果问题仍然存在，请将 Charles 网页代理日志发送到客服。

Load Error 6 又名 NO_AD_FOUND

广告服务器无法找到妥当的插页式广告发送到设备时触发。可能由于位置、广告活动筛选条件或其他因素导致。 疑难解答

Load Error 7 又名 SESSION_NOT_STARTED

无法检测到有效 Chartboost 会话。请检查您的应用 ID 和应用签名，以及确保您采用如下方法妥当初始化: chartboost.startWith("ANDROID_APP_ID", "ANDROID_APP_SIGNATURE"); 阅读 Adobe AIR 集成指南

Load Error 8 又名 IMPRESSION_ALREADY_VISIBLE

已有展示可见或处于加载过程中。请检查您的集成代码是否有额外 showInterstitial 调用。如可能，请发送代码片段 (初始化 Chartbosst 并使用 Chartboost SDK 方法部分) 然后联系客服。

Load Error 9 又名 NO_HOST_ACTIVITY

在无 Chartboost 集成妥当的当前活动时触发。请检查您的集成并确保 Chartboost 的 Android 生命周期方法已妥善初始化。

Load Error 11 又名 INVALID_LOCATION

当您在命名位置字符串输入 NULL 时触发。了解命名位置详情

Load Error 12 又名 VIDEO_UNAVAILABLE

视频未缓存。如可能，请发送 Charles 网页代理日志到客服。

Load Error 13 又名 VIDEO_ID_MISSING

视频链接丢失。如可能，请发送 Charles 网页代理日志到客服。

Load Error 14 又名 ERROR_PLAYING_VIDEO

Chartboost SDK 开始视频内容时遇到问题。如可能，请发送 Charles 网页代理日志到客服。

Load Error 15 又名 INVALID_RESPONSE

Chartboost 服务器返回无效响应。如可能，请发送 Charles 网页代理日志到客服。

Load Error 16 又名 ASSETS_DOWNLOAD_FAILURE

从 Chartboost 服务器下载素材出错。排查您的互联网连接问题 (检查网关等) 然后重试。如可能，请发送 Charles 网页代理日志到客服。

Load Error 17 又名 ERROR_CREATING_VIEW

展示 Chartboost 广告时出错。请检查您的集成并确保 Chartboost 的 Android 生命周期方法已妥善初始化。如可能，请发送 Charles 网页代理日志到客服。

Load Error 17 又名 ERROR_CREATING_VIEW

展示视图时出错。请检查您的集成并确保 Chartboost 的 Android 生命周期方法已妥善初始化。如可能，请发送 Charles 网页代理日志到客服。

▲ 返回顶部

应用列表是 Chartboost 应用 ID 的集合，您可以用来排除 (但不可定位) 表现不佳或不希望在您的广告活动中出现的游戏。(如需重温如何识别表现不佳的游戏，请访问应用筛选页面)。(注: 应用列表为可选内容。)

如需创建，请前往应用列表生成器，然后:

1. 输入列表名称然后从平台下拉菜单选择 iOS、Android 或 亚马逊。您需要为每个平台创建单独应用列表。
2. 点击选择文件字段点击选择文件以上传您的列表。应用列表必须具有 CSV 扩展名，不得超过 800 个应用 ID 且只应包含一个应用 ID 列表，由换行符分隔。(推荐使用 Excel 或其他工作表编辑器以到处您的单一 ID 栏到 .csv 格式。)
3. 点击保存即大功告成 — 您会看到新列表出现在页面下方

如需覆盖²，编辑名称或从帐户删除应用列表，只需点击列表操作一栏的 3 个图标之一:

使用应用列表

生成应用列表后，您通过编辑广告活动页面的应用筛选栏将其应用到您的广告活动:

点击应用列表名称后，您可以在同一位置看到生成内容，之后您可以按需要添加或删除应用。

注:

1. Excel 有 100 万行数限制，不过如果您需要添加更多设备到列表，您可以创建基于文本的 CSV (或使用 API)

2. 上传新文件到已有列表以替换原列表

3. 下载于 7 天后失效

4. 您无法删除处于活动状态的广告活动的列表

如需开始在您的游戏内部交叉推广 (例如向您的劲爆人气游戏玩家推荐您的酷炫新游戏)，请遵循以下步骤:

1. 点击后台左下角的添加应用以添加酷炫新游戏和劲爆人气游戏到后台 (详情见此)。如果您希望，您可以从应用设置菜单的边框页面为您的酷炫新游戏添加自定义边框 (示例见此)。
2. 集成 Chartboost SDK 到劲爆人气游戏。如果您希望跟踪安装数或日后在酷炫新游戏内发布，不妨同时为其添加 SDK。测试集成，提交您的更新到 App Store、Google Play Store 或亚马逊应用商店。
3. 创建交叉推广活动: 点击后台左下角的添加广告活动，然后点击交叉推广
4. 从应用推广的下拉菜单中选择酷炫新游戏
5. 在选择应用一栏，选中劲爆人气游戏旁边的复选框以运行广告活动。注意: 不能与应用推广设置相同，因为您无法在游戏中为游戏本身做广告。
6. 点击广告活动定位栏目添加广告图片集按钮以上传广告集以展示您的酷炫新游戏。广告单元必须满足一定要求。
7. 使用您所需要的广告活动逻辑，然后保存广告活动

注意: 如果您先前安装过您试图推广的游戏，插页式广告不会在您的设备上显示。系统不会向已安装的用户推荐应用。

iOS 支持的广告类型: 插屏广告（静态插屏、视频插屏）和激励视频广告。

Android 支持的广告类型: 插屏广告（静态插屏、视频插屏）和激励视频广告。

最佳实践

• 在Chartboost下为广告单位创建多个“广告位置（Ad Location）”，可以更好处理和设置瀑布流里的每一条。这个过程可以在下面的“如何在MAX为Chartboost设置多个广告位”中进行查看。

如何在MAX为Chartboost设置多个广告位

➊为你的应用设置Chartboost应用 ID 和应用签名

在MAX后台启用Chartboost网络，并输入相应的Chartboost应用ID和应用签名

你可以在Chartboost后台找到相应的应用ID和应用签名

➋输入广告位置信息以及 eCPM

在MAX后台的广告位置输入你想要发给Chartboost的广告位置名称（字符值）。如果你已经和你在Chartboost的客户经理讨论好了广告位置的名称，确保使用这些名称即可。注意保持一致性，包括大小写、空格等。

当手机端请求广告时，该广告位置名称（字符值）会直接发给Chartboost SDK。

在 Max 后台，请为每个广告位置设置明确的 eCPM 值，以便该广告位在瀑布流的合适位置出现。

➌添加更多的广告位置和 eCPM 设置

如果需要添加更多的广告位置，重复上述步骤进行广告位的添加以及设置 eCPM。如果你已经和Chartboost的客户经理讨论好了广告位置的名称，依然需要在MAX后台保持一致，包括大小写和空格等。

‍

‍下载 AdMob SDK iOS 版

‍iOS 集成

‍下载 AdMob SDK Android 版

‍Android 集成

‍支持广告类型: 视频插屏广告、静态插屏广告、激励视频广告。

AdMob 适配器当前将所有命名位置设为默认，如果您没在 AdMob 控制台上进行设置。

如何在 AdMob 中提高 Chartboost 排位

• 登录您的 AdMob 后台。
• 选择变现选项卡。
• 从侧边栏选择应用。
• 从中介栏选择添加资源。
• 选择 Chartboost 并取消选择网络广告优化选项。
• 手动输入较高的 eCPM 从而将 Chartboost 排在最前。

‍

The Ad Unit in the Mediation Group(s) will now be able to request ads with multiple Instances from Chartboost (Top-ranked first).

‍iOS 静态和视频插页式广告集成

‍iOS 激励式视频集成

‍Android 静态和视频插页式广告集成

‍Android 激励式视频集成

‍支持广告类型: 视频插屏广告、静态插屏广告、激励式视频。

如何在 Fyber 中提高 Chartboost 排位

• 登录到您的 Fyber 后台。
• 从您的列表选择适当应用。
• 选择应用网络选项卡。
• 点击操作栏的铅笔图标以编辑。
• 手动输入较高的 eCPM 从而强制将 Chartboost 排在最前。
• 将自动 eCPM设为关闭。
• 选择广告控制选项卡。
• 将 Chartboost 拖放到排位顶端。
• 为您的所有广告单元重复该步骤。

‍

如果您正在使用自有聚合或第三方聚合平台，添加 Chartboost 到您的瀑布流以提高您的广告填充率和 eCPM。

如果您还没有开启状态的广告活动，请开始发布变现活动

Chartboost 提供以下几种广告类型。激励视频（包括可玩式广告）让玩家在观看视频后赢得游戏内道具或虚拟货币；视频插屏让您在玩家播放视频完毕后赢利；静态插屏广告让您在每次广告点击或安装游戏后赢利。

当您在 Chartboost 后台设置好广告变现活动后，请与下方的聚合合作伙伴确认，验证其是否支持您希望发布的广告类型。

每种广告类型要求至少有一个同类型的变现活动。

Android: 所有显示 Chartboost 广告的活动的 Android Manifest文件上必须具备 android:hardwareAccelerated="true" 值，否则视频无法正常显示。

选择您的中介伙伴。

‍

• 请保持更新到广告聚合平台所支持的最新版本的 Chartboost SDK。我们会持续升级 SDKs 的功能特性来帮您达到效益的最大化。 下载最新版本 SDK

• 请确保在广告聚合平台的后台输入了正确的 Chartboost app IDs 和 app 签名。 我的 Chartboost app ID 在哪?
• 请确保您已经在 Chartboost 后台创建了广告变现活动 ( Publishing Campaigns) 。点这里了解更多广告变现活动

• 请确认 Chartboost 在聚合平台排在头部位置。这样能确保 Chartboost 有最好的变现效果，同时能最快确认集成是否成功。 点击这里 查看如何在聚合平台中将 Chartboost 广告网络放在头部位置。
• 如果您在展示 Chartboost 广告方面遇到困难, 请参考 Chartboost SDK 里自带的范例项目，换上您自己的 app ID 和 app 签名来初始化, 然后确认广告是否在范例项目里正常展示。如果一切工作正常，证明您在 Chartboost 这边的接入工作已经成功完成!

注意: 当您不满足于调用聚合平台提供的通用方法，需要调用其他 Chartboost SDK 的方法时，不同的聚合平台对此有不同的要求。您需要确保 Chartboost SDK 尽早被初始化，理想状态就是当 app 启动时马上初始化 Chartboost，以便  SDK 有足够的时间将广告准备好。具体实现方式视不同的聚合平台而定。

下载 & 和集成Unity版本的Chartboost SDK

版本8.1.0 (2020年7月10日) (当前版本)

此版本的Unity SDK包含以下原生SDK:

• iOS: 版本8.2.0
• Android: 版本8.1.0
• Chartboost支持iOS 9和Android 5.0
• Chartboost支持Unity 2017及以上
• 性能 & 提升:
• 处理GDPR和CCPA的新API: Chartboost.addDataUseConsent().

版本7.3.0 (2018年10月25日)

此版本的Unity SDK包含以下原生SDK:

• iOS: 版本7.3.0
• Android: 版本7.3.0

Chartboost SDK需要API level 16 (Android OS 4.1)或以上版本.

性能 & 提升:

• 处理GDPR的新API – void setPIDataUseConsent(CBPIDataUseConsent consent);
• 废弃API restrictDataCollection
• 导入安卓Google Play Services Library的过程已经更改。请参照Unity SDK集成说明的第2步， 通过单独的 “Play Services Resolver“插件进行导入

版本7.2.0 (2018年5月3日)

此版本的Unity SDK包含以下原生SDK:

• iOS: 版本7.2.0
• Android: 版本7.2.0

Chartboost SDK需要API level 16 (Android OS 4.1)或以上版本

性能 & 提升:

• 添加支持GDPR的许可
• 添加支持iOS广告静音

版本7.1.0 (2018年4月2日)

此版本的Unity SDK包含以下原生SDK:

• iOS: 版本7.1.2
• Android: 版本7.1.0

Chartboost SDK需要API level 16 (Android OS 4.1)或以上版本

性能 & 提升:

• 启用Moat可见技术，允许投放品牌广告

Unity修复:

• 更新支持信息
• 废弃UnityPlayerNativeActivity升级到UnityPlayerActivity
• 将安卓minSDKVersion从9升级到16

Version 7.0.2 (Mar. 7, 2018)

This version of the Unity SDK includes the following native SDKs:

• iOS: Version 7.1.2
• Android: Version 7.0.1

Unity Fixes:

• didDismissInterstitial delegate no longer fires early.

Version 7.0.1 (Dec. 15, 2017)

This version of the Unity SDK includes the following native SDKs:

• iOS: Version 7.0.4
• Android: Version 7.0.1

Unity Fixes:

• Project can now be built with the “Gradle (New)” setting.

Version 7.0.0 (Sep. 15, 2017)

This version of the Unity SDK includes the following native SDKs:

• iOS: Version 7.0.1
• Android: Version 7.0.0

Unity Fixes:

• Updated conditional compilations to include Unity 2017.
• Fixed issue with age gate not being shown in iOS.

Version 6.6.4 (August 8, 2017)

This version of the Unity SDK includes the following native SDKs:

• iOS: Version 6.6.3
• Android: Version 6.6.3

Unity Fixes:

• Fixed compile issue with Unity 2017.1

Version 6.6.3 (May 8, 2017)

This version of the Unity SDK includes the following native SDKs:

• iOS: Version 6.6.3
• Android: Version 6.6.3

Unity Fixes:

• Removed duplicate .jar file.

Version 6.6.2 (Apr. 4, 2017)

This version of the Unity SDK includes the following native SDKs:

• iOS: Version 6.6.2
• Android: Version 6.6.3

Features & Improvements:

• Removed references to MoreApps.

Version 6.6.1 (Jan. 12, 2017)

This version of the Unity SDK includes the following native SDKs:

• iOS: Version 6.6.1
• Android: Version 6.6.1

Features & Improvements:

• Added AerServ to mediation enumeration.

iOS Features & Improvements:

• Updated the underlying headers and shared lib for the Unity iOS plugin.

Version 6.6.0 (Nov. 30, 2016)

This version of the Unity SDK includes the following native SDKs:

• iOS: Version 6.6.0
• Android: Version 6.6.1

Important: iOS 6 is no longer supported. iOS 7.0 is the minimum supported iOS version. iOS Features:

• Added support for AerServ mediation.

iOS Fixes:

• Black background image no longer appears during video playback.
• App no longer freezes when backgrounding right after video playback.
• MoreApps respects the status bar app settings.

iOS Improvements:

• Improved rendering performance when rotating an ad.

Android Features:

• Added support for AerServ mediation.
• Added support for Heyzap mediation.

Android Improvements:

• Added reasoning for certain app permissions in the manifest.
• Reduced DEX method count by 606 in com.chartboost and 629 overall.

Android Fixes:

• MoreApps page no longer fail to show when the loading bar is enabled.
• didShow delegate is no longer called when an ad is not shown.
• Device identifiers updated on every request.
• Fixed an issue with close button placement.
• Optimized template parameter replacement.
• Cached ads are no longer shared between activities.
• Fixed a NullPointerException when backgrounding the app.
• Fixed issues with ironSource mediation.
• Fixed issues with Fyber mediation.
• Fixed issues with Corona mediation rewarded video.

closeImpression() functionality has been deprecated.

Version 6.5.1 (Sept. 29, 2016)

This version of the Unity SDK includes the following native SDKs:

• iOS: Version 6.5.2
• Android: Version 6.5.1

Android Fixes:

• Tilting the screen during an ad no longer changes app orientation incorrectly.

iOS Fixes:

• Fixed a bug that could display defects on ads when the app loses and regains focus.

Version 6.5.0 (Sept. 22, 2016)

iOS 6 is no longer supported. The minimum supported version is iOS 7.0.

This version of the Unity SDK includes the following native SDKs:

• Android: Version 6.5.1
• iOS: Version 6.5.1

Unity Features & Fixes

• Deprecated Android methods have been removed; please see Android notes below.
• Added HyprMX as a CBMediation value.

Android Features

• Chartboost SDK now uses network compression for improved performance.

Android Improvements

• void setFrameworkVersion() has been deprecated. Please use void setChartboostWrapperVersion() to set wrapper version.
• Added new mediation enum value HyprMX.
• Error codes are more accurate and descriptive.
• Previously deprecated methods and classes now removed:
• ChartboostActivity class
• boolean getIgnoreErrors()
• void setIgnoreErrors(boolean ignoreErrors)
• void didPassAgeGate(boolean pass)
• void setShouldPauseClickForConfirmation(boolean shouldPause)
• void clearCache()
• void setFramework (final CBFramework framework)
• boolean getImpressionsUseActivities()
• void setImpressionsUseActivities(final boolean impressionsUseActivities)
• void didPauseClickForConfirmation()
• void didPauseClickForConfirmation(Activity activity)

Android Fixes

• Invalid server responses no longer accepted as valid
• Fixed an issue with the back button not calling the dismiss/close delegates.
• Cached ads will no longer fail to show.
• SDK will no longer keep 0 byte files in cache when a download fails.
• Video ads no longer stay paused after maximizing a minimized app.

iOS Features

• Networking stack has been upgraded to AFNetworking 3.0.
• Added features to help support iOS changes to limit of ad tracking.
• iOS 10 compatibility.

iOS Fixes

• Fixed IFV reporting bug.
• Fixed bug that could retain a bad ad unit in the cache.
• Fixed bug that could send an inaccurate list of local videos to the server.
• Changed timeout for bad ad units to 3 seconds to avoid excessive loading bar wait time.

Version 6.4.5 (June 30, 2016)

This version of the Unity SDK includes the following native SDKs:

• Android: Version 6.4.2
• iOS: Version 6.4.6

Android Features

• The Chartboost Android SDK no longer supports the age gate feature. API methods related to age gate are being deprecated and will be removed in a future release.
• Publishers only: All Chartboost ads are now shown using CBImpressionActivity. You must add CBImpressionActivity to your AndroidManifest.xml file, like this:<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" />Note: Make sure hardware acceleration is added and enabled when declaring the CBImpressionActivity in the manifest.

Android Fixes

• Media loading is now more efficient.
• Memory usage on devices has been optimized.
• Video download is now more efficient.
• Fixed ConcurrentModificationException occurring in some devices.
• Fixed issue with video playback when backgrounding.
• Fixed IMPRESSION_ALREADY_VISIBLE error.

iOS Fixes

• Fixed Native Ads crash when clicking.
• Fixed intermitent issue when plugging or unplugging headphones.
• Fixed several threading issues leading to a EXC_BAD_ACCESS KERN_INVALID_ADDRESS error.

Version 6.4.4 (May 5, 2016)

Fixes:

• Various bug fixes.

Version 6.4.2 (April 7, 2016)

Fixes:

• Various bug fixes.

Version 6.4.1 (Mar. 29, 2016)

Fixes:

• Various bug fixes.

Version 6.4.0 (Mar. 14, 2016)

• With this SDK we will begin rolling out a brand new Chartboost Video experience, specially tailored for games. Upgrade now!
• We’ve also improved key features like video caching, memory management, and data usage for optimal SDK performance.

Features & Improvements

• Added a retry mechanism for downloading failed assets.
• iOS: Calls to ‘cacheInterstitial’ and ‘cacheRewarded’ have been optimized to require less memory.
• iOS: Interstitials will now fail gracefully instead of showing with missing assets.
• iOS: Closing the “loading” view has moved to the main thread.
• Android: Cached impressions on soft bootups are invalidated if any shared assets are deleted.
• Android: Fixed issues causing “Could Not Delete Cache Entry for key” log message on startup.

Version 6.3.0 (Feb. 16, 2016)

Upgrade now to get ready for the new Chartboost Video V2 experience, rolling out in Q1. Features & Improvements:

• Android: Older devices in the networking library no longer crash on occasion.
• Android: MoreApps rotation issue has been resolved.
• Android: Removed “Could Not Delete Cache Entry for key” notification from logs.
• Android: Fixed “Internal_Create can only be called from the main thread” warning.
• iOS: Certain network request failures no longer cause a crash.

Version 6.2.0 (Jan. 25, 2016)

Features & Improvements:

• Added didInitialize() delegate callback to notify when the SDK is initialized and ready to use.
• Android: Screen no longer turns black on occasion when playing videos.
• Android: Chartboost impressions no longer have a translucent view behind them.
• Android: Improved handling of views when the app is minimized after clicking an ad.
• Android: More efficient handling of cached assets now reduces network usage.
• Android: InPlay now triggers the failure delegate on failure.
• iOS: Blank ads no longer appear when the device is rotated into an unsupported orientation.
• iOS: App no longer crashes on startup when CoreData does not initialize (frequently occurred if device was out of memory).
• iOS: Fixed a rare crash that occurred when reopening the app after an ad is displayed.

Version 6.0.2 (Oct. 29, 2015)

Features & Improvements:

• Video experience rebuilt from the ground up.
• Android: Android 6.0 Marshmallow Features support.
• Ensure your Android project targets API Level 23 (However, “minimum” SDK can still target API Level 9).
• iOS: Supports Bitcode submissions for iOS 9.
• iOS: Removed deprecated Chartboost Newsfeed product.
• setMediation now uses enumerated constants for partners.
• Android: Required to ensure compatibility with Android 6.0 devices: Ensure your Android project builds and compiles against API Level 23
• Android: Updated AndroidManifest.xml to include com.chartboost.sdk.CBImpressionActivity
• Android: New recommended permission android.permission.READ_PHONE_STATE allows the SDK to handle calls interrupting video playback during videos.
• Android: No longer attempting to destroy already-destroyed Chartboost instances.
• iOS: cacheRewardedVideo no longer stops audio of the playing video.
• iOS: Removing headphones during the rewarded video confirmation screen no longer starts the video.
• iOS: Accepting or declining a phone call during the rewarded video confirmation screen no longer starts the video.

Version 5.5.3 (Aug. 5, 2015)

Features & Improvements:

• Android: Fixed a crash in the retry event system.

Version 5.5.1 (Jul. 16, 2015)

Features & Improvements:

• We temporarily pulled v5.5.1 to address a crash bug when retrying events in airplane mode.
• iOS: Fixed bug that prevented InPlay button response in example app included in SDK download package.
• iOS: Fixed an issue that crashed or hung the SDK while detecting jailbroken device status during initialization.

Version 5.5.0 (Jun. 29, 2015)

Compatible only with iOS 6.0+. If you need compatibility with older iOS versions, contact us!Features & Improvements:

• iOS: AFNetworking library updated to version 2.5.4.
• iOS: Rewarded videos no longer need to wait until the video prefetch is complete before showing an existing video.
• Added a Chartboost.Create() method that will create a Chartboost gameObject if one does not already exist. It is no longer necessary to drag one into the first scene as long – as you call this method at least once.
• The Chartboost gameObject no longer creates a second instance if one already exists.
• Fixed InPlay UI bug in sample app in Unity plugin download package.
• Android: Age gate now properly blocks video ads between the didPauseClickForConfirmation call and the successful didPassAgeGate response.
• Android: Optimized the Chartboost.cs onGUI() call to reduce memory allocations per frame.
• Android: Removed an unnecessary video prefetch call.
• Android: Fixed bug that caused Chartboost activity leaking in some cases.
• Android: Prevented MoreApps page loading screen from displaying before static interstitial and rewarded video ads.
• Android: Corrected time zone format in reporting from devices running Android OS version 4.1 and older.
• iOS: Fixed bug that prevented video ads from resuming/being dismissed after incoming phone calls.
• iOS: Corrected video prefetch behavior to prevent unwanted deletions of video ads prior to /show calls.
• iOS: Fixed bug that prevented proper caching of new MoreApps page data after /more/show call.
• iOS: Suppressed erroneous CoreData Unable to load class named 'CBHTTPRequestEntity' warning message.

Version 5.4.1 (Jun. 4, 2015)

Features & Improvements:

• Android: Fixed bug that caused Chartboost media files to appear in the Gallery app.

Version 5.4.0 (Jun. 1, 2015)

Features & Improvements:

• Added a ChartboostExample UI that shows delegate logs and cache states and lets you set various other – including age gate – options.
• Added CBCLickError enums for the didFailToRecordClick delegate.
• Android: Added IAP button to sample project included with SDK download.
• Android: Added error logging for all network calls.
• Android: Fixed bug causing ads to disappear on rotation while using activities.
• Android: Rewarded video pre-roll screen now properly displays after home key input.
• Android: Fixed null pointer exception that occurred when initializing Chartboost and making calls on different threads.
• Android: Fixed rare bug that prevented video prefetching under certain circumstances.

Version 5.3.0 (May 7, 2015)

Features & Improvements:

• Native Chartboost SDKs now send the version of the Unity wrapper SDK along with every request.
• Added Weeby to available frameworks.
• iOS: Added "rooted_device":true or "rooted_device":false to /api/install call REQUEST body to detect jailbroken devices.
• iOS: Fixed issue that stalled video playback after declined phone calls.

Version 5.2.1 (Apr. 13, 2015)

Features & Improvements:

• Fixed issue that caused CoreData crash on first bootup.
• Corrected symbol collision with third-party SDKs on audioRouteChangeListenerCallback
• Corrected symbol collision with third-party SDKs on MakeStringCopy
• Fixed bug preventing MoreApps page resize on device orientation change.
• Resolved Unity 5 Xcode build problem.

Version 5.2.0 (Apr. 6, 2015)

Features & Improvements:

• iOS: Added a developer-facing function, closeImpression, to force-close any visible impression or loading view.
• iOS: Added a new method to CBAnalytics, trackInAppPurchaseEventWithString, that acts like the trackInAppPurchaseEvent but takes a string instead of raw receipt data to allow frameworks to pass in base64-encoded receipts.
• iOS: Added new Core Data-backed persistence layer for the Chartboost request manager.
• Updated Amazon IAP library to v2.0.
• PIA Level Tracking available in CBAnalytics (contact your account manager or Support for information about Level Tracking).
• Improved SDK batch requests for an endpoint to cut down on outgoing network requests. Only enabled for Level Tracking.
• iOS: The receipt parameter to Chartboost.trackInAppAppleStorePurchaseEvent() is now assumed to be a base64-encoded string. Added a method to the example app to demonstrate this.
• iOS: Rewarded and interstitial video ads will now pause and disappear so players can complete age gate selections and reappear and resume after user input.
• iOS: Fixed issue that paused rewarded video and video interstitial playback when headphones were unplugged.
• iOS: didFailToLoadRewardedVideo delegate method now fires if rewarded video is requested before prefetching finishes.
• iOS: Fixed bug preventing loading view from displaying in a timely manner when setShouldDisplayLoadingViewForMoreApps was set to YES
• Android: Fixed bug preventing SDK from showing additional ads when setImpressionsUseActivities was enabled and previous ads were dismissed too quickly.
• Android: Resolved Chartboost Android SDK v5.1.3 bug that fired VIDEO_UNAVAILABLE error even when hasRewardedVideo returned true.
• Android: Fixed Chartboost Android SDK v5.1.3 bug that caused occasional crashes after interstitial views.
• Android: Fixed Chartboost Android SDK v5.1.1 bug that caused crashes when back button was pressed after interstitial views.
• Android: Removed all exceptions thrown from the SDK.
• Android: Fixed issue preventing /api/install calls on every bootup.
• Android: Fullscreen videos now properly extend to screen edges.

Version 5.1.4 (Mar. 17, 2015)

Features & Improvements:

• Fully compatible with Unity 5.0.
• Unity-built Android games: SDK now blocks UI clicks behind Chartboost ads.
• Fixed bug firing duplicate showInterstitial and showRewardedVideo calls in Unity-built Android games.
• Fixed bug affecting iOS Rewarded Video close buttons when videos shown on bootup.

Version 5.1.3 (Mar. 11, 2015)

Features & Improvements:

• Added a new setStatusBarBehavior method to control how fullscreen video ads interact with iOS’s status bar.
• Added the location parameter, when available, to click, show, completed-view, and other relevant network requests.
• Fixed bug causing force quitting on back press when no ad was shown.
• Fixed Android bug preventing didDismissInterstitial and didDismissRewardedVideo from firing
• Corrected debug message in CBManifestEditor.cs.
• Fixed iOS issue causing duplicate SDK calls to creative URLs.
• iOS: Max ads/hour setting is now respected when campaigns are configured to show one ad per hour and auto-caching is enabled.
• Fixed iOS bug that fired didDismissInterstitial or didDismissRewardedVideo during click events.
• Fixed iOS bug that prevented didClickInterstitial from firing on interstitial video clicks.
• Corrected iOS fullscreen video close button placement; close buttons no longer appear behind the iOS status bar.
• Resolved issue preventing didCacheInterstitial from firing when an ad was already cached at the same location.

Version 5.1.2 (Feb. 23, 2015)

Features & Improvements:

• Android: Added support for full-screen videos.
• Android: Fixed DevKit engine issue preventing rewarded video playback after device returns from sleep.
• Android: Fixed bug causing video crashes on crash exception.
• Android: Resolved issue preventing clicks from dismissing rewarded/interstitial video ads.
• Android: Corrected video download button alignment.

Version 5.1.1 (Jan. 19, 2015)

Features & Improvements:

• iOS: Added global flag to disable request retries by default (configurable in CBConfig).
• iOS: Fixed multithreaded crashes.
• iOS: Fixed silent failure when requesting assets with wrong orientation (now trackable via a CBLoadError)
• iOS: InPlay data can now be cached at multiple Named Locations.
• iOS: Added orientation information to api/click and video/complete calls to facilitate better analytics.
• iOS: Removed hardcoded affiliate token from SDK; now pulled from server.
• iOS: Added example use of isAnyViewVisible delegate method to sample project (included in SDK download package).
• iOS: Added InPlay button to Chartboost example app (included in SDK download package).

Version 5.1.0 (Dec. 10, 2014)

Features & Improvements:

• Fixed race condition between video actions on replay.
• Improved interaction between video ads and App Sheet.
• Fixed bug causing interstitial video close buttons to appear at incorrect time on portrait orientation devices.
• Fixed rare rewarded video bug causing play failures/autoplays when previous video was dismissed instead of watched.
• Resolved issues preventing api/config and api/install calls from firing on soft bootups.
• Fixed bug causing video close buttons to clip video ads in corner.
• Fixed various memory pressure, concurrency crashes.
• Fixed bug executing api/track on older devices.
• Corrected iPhone 6/6+ rotation problem causing video to display off screen.
• Corrected/updated error code enums.
• Fixed bug preventing MoreApps loading view from appearing on devices with slow connections.
• Fixed CBAnalytics crash in event of invalid NSDecimalNumber receipt.
• Fixed issue pushing age gate behind MoreApps view.
• Fixed bug allowing Unity App Sheets to rotate in single-orientation apps.
• Added armv7s architecture support.
• Fixed CBAppCall crash occurring after apps opened via deep link without resource path.
• Fixed race condition causing SKStoreProductViewController crash.
• Fixed video interstitial NullPointerException crash in Android SDK 5.0.3.
• Fixed Unity v5.0 and v5.0.2 bug preventing MoreApps pages from loading.
• Fixed bug preventing passing of custom_id callbacks parameter.
• Fixed Android video bug displaying black screen after receipt of invalid reward/get, interstitial/get responses.
• Fixed rare rewarded video bug that froze app if pre-roll popup was dismissed after player watched one video.
• Added new framework tracking values for Cordova and CocoonJS.
• Added new API to check for Chartboost UI visibility.
• Delegate callbacks for click and close now sent after impression closed or clicked.
• Delayed autocache call execution for better performance.

Version 5.0.3 (Oct. 1, 2014)

Features & Improvements:

• Bug fixes and stability improvements.

Version 5.0.2 (Sep. 12, 2014)

Features & Improvements:

• Higher eCPM for Android.
• Bug fixes and stability improvements.

Version 5.0.1 (Sep. 9, 2014)

Features & Improvements:

• Improved compatibility with various third party packages.
• Critical bug fixes and stability improvements.
• Post processing will remove legacy Chartboost files.

Version 5.0.0 (Sep. 4, 2014)

Features & Improvements:

• Chartboost Video released.
• Initialization now handled by the SDK to simplify the integration and decrease possible issues post launch.
• Easier setup and control of AppID/AppSignature pairs.
• namespace Chartboost renamed to namespace ChartboostSDK
• null or () no longer accepted as a location; you can pass in CBLocation.Default instead.
• All locations are now passed in via the CBLocation class.
• MoreApps calls now use locations public static void showMoreApps(CBLocation location)
• In app analytics, MoreApps page impressions now count toward total number of impressions.
• Chartboost SDK event names and method signatures have been significantly updated and improved.

Version 4.0.1 (Apr. 23, 2014)

Features & Improvements:

• Fixed crash due to Google Play Services security permission check.

Version 4.0.0 (Apr. 17, 2014)

Features & Improvements:

• Updated Android SDK to 4.0.0 (requires minimum Android OS version 2.3).
• Updated iOS SDK to 4.1 (requires minimum iOS version 5.1).
• Added CBImpressionError parameters to DidFailToLoad EventListener methods.
• Simplified Android plugin does not override main activity — this should eliminate conflicts with other plugins.
• Android plugin can now be initialized almost entirely in code — use the Setup dialog from the File menu and call CBBinding.init(appID, appSignature)
• Android: No longer need to use activities for Chartboost impressions.
• iOS: Removed unused iOS methods.

Version 3.4.0 (Feb. 25, 2014)

Features & Improvements:

• Updated Android SDK to v3.4.0.

Version 3.3.0 (Sep. 30, 2013)

Features & Improvements:

• Merged iOS and Android plugins: now just one almost identical API that intelligently works on both platforms.
• Repackaged all Chartboost C# classes into the namespace Chartboost
• Android: Renamed ChartBoostAndroid to CBBinding and ChartBoostAndroidManager to CBManager
• Android: Fixed issues preventing users from interacting properly with Chartboost interstitials.
• Android: Added ability to customize pause behavior while Chartboost impressions are visible.
• iOS: Renamed ChartBoostBinding to CBBinding and ChartBoostManager to CBManager
• iOS: Updated plugin to avoid possible Xcode build error with Unity 4.2.

‍

‍

下载和集成 Android / Amazon 版本 Chartboost SDK

注意: Chartboost Android SDK 同时支持 GooglePlay 和亚马逊平台。

版本8.2.0 (2020年11月27日) (当前版本)

提升:

• 添加adID到横幅广告委托方法，以及加载失败的信息到其它广告类型
• SDK支持安卓api level 29

修复:

• 修复下载时出现的相关bug
• 修复安卓4.4.4横幅广告的相关bug
• 修复点击横幅广告时候可能出现的bug

版本 8.1.0 ( 2020 年 6 月 30 日)

提升:

• 增加针对 CCPA 的 API 端支持。
• 增加了对 Android 10 (API Level 29) 的支持。
• 使横幅广告错误代码可从外部公开访问。
• 提升对激励视频错误时的处理方法。didCompleteRewardedVideo 回调函数如今在激励视频因异常错误关闭时会被调用。
• 更改关于横幅广告的自动缓存设置 Chartboost.setAutoCacheAds() 不再影响到横幅广告的缓存。横幅广告的自动缓存和自动刷新将变成针对单个对象进行设置： public void setAutomaticallyRefreshesContent(boolean autoRefreshEnabled).
• SDK 初始化回调函数确保会调用，无论 SDK 之前是否已经初始化过，didInitialize 一定会被调用。
• Android 权限修改。Chartboost 不再需要额外的权限。我们仅仅建议添加 READ_PHONE_STATE 权限（可选）以确保更好的广告体验。尤其是用户播放激励视频广告时被来电打断的情形。
• 精简了SDK启动后的API请求。
• 改进了后端和前端处理方式来提高性能和减少电量消耗
• 提升点击回调方法以更好地追踪广告点击事件。

修复:

• 修复当 SDK 受限于设备的广告追踪限制时的操作。
• 解决了network问题, 从无网络状态恢复后 SDK 能迅速唤醒并展示广告。
• 修复了缓存失败后的错误回调函数错误。

提示:

• 移除 restrictDataCollection: 方法。
• 废弃 setPIDataUseConsent ，替换为 addDataUseConsent。
• 废弃 getPIDataUseConsent ，替换为 getDataUseConsent。
• CBPIDataUseConsent 数据类型已停用，它依然可以作为废弃的候选方法使用，但我们建议您使用上述的新 API 来确定终端设备用户的数据许可，以符合 GDPR 和 CCPA 的要求。

版本 8.0.3 ( 2020 年 5 月 27日)

提升:

• 提升广告加载超时的等待响应时间，尤其是第一次加载广告时。以避免由于 App 启动时线程卡顿导致的广告加载错误。

修复:

• 修复在 Android 4.x 环境下的回调错误。尤其是避免第三方聚合平台由于缺少回调导致的超时现象。
• 修复 SDK 在网络链接时断时续时产生的中断休止错误。

版本 8.0.2 ( 2020 年 3 月 26 日 ) ( 当前版本 )

修复:

• 修复 Banner 自动刷新及加载的 Bug。

版本 8.0.1 ( 2020 年 2 月26 日 )

提升:

• 支持新的  Banner 横幅广告类型。
• 移除  Moat 的支持。
• 使用 JCenter  远程安装集成方式，取代原有的  .aar 集成方案。
• Chartboost  SDK 如今可以在应用程序上下文 context 内运行, 取代以往的 activity 引用的方式。
• Chartboost 不再需要强制绑定 Activity 生命周期的回调函数 ( callbacks ) 。

修复:

• 修复 SDK 在读取配置，确认归因和预缓存时，向远程服务器请求相关的 bug。
• 修复展示广告时引发的 ANR 相关 Bug。

注意:

• 此版本 Chartboost Android SDK 8.0.1 完全支持 Android X。
• 此版本 Chartboost Android SDK 需要 API level 21 (Android OS 5.0) 或更高版本的支持。
• 此版本 Chartboost 范例项目在 这里下载.

版本 7.5.0 ( 2019 年 8 月 7 日 )

提升:

• 添加基于 openRTB 的应用内竞价支持。详情请参考: https://www.chartboost.com/helium/
• 添加新的代理函数,didCompleteInterstitial(String location)。
• 移除对 ACCESS_WIFI_STATE 权限的要求。

修复:

• 修复在 Android 5.1 设备上的一些崩溃的 Bug。
• 修复由于 SSL 错误导致不被 GooglePlay 审核通过的 Bug。
• 断网重连时 SDK 会自动恢复工作。

This release and onwards are certified to work with 64-bit architectures.

版本 7.3.1 ( 2018 年 12 月 3 日 )

提升:

• 增加对 API Level 15 的支持。

修复:

• 修复广告使用复用型 bitmap 时导致的崩溃。

Version 7.3.0 (Sep. 28, 2018)

Improvements:

• Improved GDPR handling.

Fixes:

• Sound and video no longer continue to play after pressing on ‘power’ button to lock the phone.

Notes:

• New API for handling GDPR – void setPIDataUseConsent(Context context, CBPIDataUseConsent consent);
• API restrictDataCollection has been deprecated.

Version 7.2.1 (July 6, 2018)

Fixes:

• Native will replace Android Webview on Kindle 4.x and below.
• ANDROID_ID will no longer be collected unless there is no GAID available.

Notes:

• To enable GDPR data collection restrictions, call the restrictDataCollection method with the appropriate value for users who are EU Data Subjects. This method should be called before startWithAppId

Version 7.2.0 (May 1, 2018)

Fixes:

• Black screens no longer occur when showing ads on Android 8.0.

Improvements:

• Added restrictDataCollection method to support GDPR requirements.

Notes:

• To enable GDPR data collection restrictions, call the restrictDataCollection method with the appropriate value for users who are EU Data Subjects. This method should be called before startWithAppId

Version 7.1.0 (March 30, 2018) (current version)

Fixes:

• Enabled Moat viewability technology to allow serving of brand-based ads.
• Updated Supersonic to ironSource.

Improvements:

• Impression Trackers now use GET rather than POST.
• illegalStateException no longer occurs in LG Nexus 5.
• Fixed issue with older Kindle devices.

Version 7.0.1 (October 24, 2017)

Fixes & Improvements:

• INTERNET_UNAVAILABLE_AT_SHOW is reported when ad show is requested for a cached ad and internet is unavailable.
• Behavior of click/dismiss on end card matches previous SDK versions.
• SDK will not show incomplete ads.
• User can now exit ad by pressing the back button.

Version 7.0.0 (August 4, 2017)

• SDK 7.0.0 is a major release that focuses on quality and stability while adding some new features.

API Changes:

• Changed behavior of Chartboost.setShouldRequestInterstitialsInFirstSession to match the iOS SDK:
• This setting now only applies to interstitial ads. It no longer applies to rewarded video ads.
• This setting will now be checked whether or not there is a delegate set. SDK 6 and below only checked the value if a delegate had been set.
• Removed MoreApps support and deprecated API methods:
• Chartboost.hasMoreApps() will always return false.
• Chartboost.cacheMoreApps() and showMoreApps() will both call didFailToLoadMoreApps(location, END_POINT_DISABLED).
• Deprecated Chartboost.isWebviewEnabled()
• Removed the unused EMPTY_LOCAL_AD_LIST error code.
• Added VIDEO_UNAVAILABLE_FOR_CURRENT_ORIENTATION error code, which can occur when playing a native ad.
• InPlay changes:
• CBInPlay.getAppIcon will now throw an exception if there is a failure to load the icon file or to decode it as a bitmap.
• Added public final fields to CBInPlay (appName, location, largeAppIconUrl, largeAppIconFile).
• The sample app was erroneously checking CBInPlay.hasInPlay() after calling CBInPlay.getInPlay(). It now uses the getInPlay() result without checking hasInPlay()

Fixes:

• Fixed typos in sample app and permission entry in AndroidManifest.xml.
• The same ads are no longer returned for the first few requests after startup.

Improvements:

• Implemented better support for Exchange ads.
• Implemented better support for interactive ads.
• MRAID 2.0 is now supported.
• Improved Prefetch.
• Reduced DEX method count.
• AdUnit assets are handled in arbitrary subdirectories.
• If a bitmap or video is found to be corrupt when attempting to show an ad, we now delete the underlying file and call didFailToLoad on the delegate.
• Removed MoreApps from ChartboostExampleApp.
• willDisplayVideo delegate is called before starting CBImpressionActivity. This is primarily so that on Unity, the willDisplayVideo callback will be executed before the ad shows, rather than after.
• Added a delay with exponential back-off between ad cache or show failures.

Version 6.6.3 (March 30, 2017)

Fixes:

• Fixed NullPointerException issue when showing rewarded video.

Version 6.6.2 (March 20, 2017)  

Fixes:

• Fixed NullPointerException issue when downloading assets.
• Reconnecting to internet when caching or showing ads no longer produces INTERNET_UNAVAILABLE error.
• Fixed crashes when Google Play Services is not integrated on non-Kindle devices.
• Resolved value changes in getDisplayMetrics().heightPixels.
• Clarified ad server error messaging when no publisher campaigns are available.

Version 6.6.1 (November 3, 2016)  

Fixes:

• Fixed crashes with ironSource mediation.
• Fixed a bug where cached ads were not shared between activities.
• Fixed crashes with Fyber mediation.
• Fixed an issue where the close button was being misplaced.
• Fixed crashes with Corona mediation rewarded video.

closeImpression() functionality has been deprecated.

Version 6.6.0 (October 13, 2016)  

Features:

• Added support for additional mediation partners.
• InPlay works again in the Example App.

Improvements:

• Added reasoning for certain app permissions in the manifest.
• Reduced DEX method count by 606 in com.chartboost and 629 overall.

Fixes:

• MoreApps page will no longer fail to show with loading bar enabled.
• didShow delegate could be called when an ad was actually not shown.
• Update device identifiers on every request.
• Fixed an issue where the close button was being misplaced.
• Optimized template parameter replacement.
• Fixed a NullPointerException when backgrounding the app.

Version 6.5.1 (Sept. 1, 2016)

Fixes:

• Invalid server responses no longer accepted as valid.

Version 6.5.0 (August 11, 2016)

Features & Improvements:

• The example app CBSample has been renamed ChartboostExampleApp.
• ChartboostExampleApp has been updated to better showcase Chartboost SDK features.
• Chartboost SDK now uses network compression, improving performance.
• Previously deprecated methods and classes now removed:
• ChartboostActivity class
• boolean getIgnoreErrors()
• void setIgnoreErrors(boolean ignoreErrors)
• void didPassAgeGate(boolean pass)
• void setShouldPauseClickForConfirmation(boolean shouldPause)
• void clearCache()
• void setFramework (final CBFramework framework)
• boolean getImpressionsUseActivities()
• void setImpressionsUseActivities(final boolean impressionsUseActivities)
• void didPauseClickForConfirmation()
• void didPauseClickForConfirmation(Activity activity)

Fixes:

• Fixed an issue in which pressing the back button did not call the dismiss/close delegates.
• A cached ad will no longer fail to show.
• SDK will no longer keep 0 byte files in cache when a download fails.
• Video ads no longer stay paused after maximizing a minimized app.

Version 6.4.2 (June 30, 2016)

Features & Improvements:

• The Chartboost Android SDK no longer supports the age gate feature. API methods related to age gate are being deprecated and will be removed in a future release.
• Publishers only: All Chartboost ads are now shown using CBImpressionActivity. You must add CBImpressionActivity to your AndroidManifest.xml file, like this:<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" />Note: Make sure hardware acceleration is added and enabled when declaring the CBImpressionActivity in the manifest.

Fixes:

• Media loading is now more efficient.
• Memory usage on devices has been optimized.
• Video download is now more efficient.
• Fixed ConcurrentModificationException occurring in some devices.
• Fixed issue with video playback when backgrounding.
• Fixed IMPRESSION_ALREADY_VISIBLE error.

Version 6.4.1 (Mar. 25, 2016) (current version)

Fixes:

• Various bug fixes.

Version 6.4.0 (Mar. 14, 2016)

• With this SDK we will begin rolling out a brand new Chartboost Video experience, specially tailored for games. Upgrade now!
• We’ve also improved key features like video caching, memory management, and data usage for optimal SDK performance.

Features & improvements:

• New method setActivityCallbacks(boolean enabled) used to enable the activity lifecycle callbacks. Only available for Android 4.X and higher. This behavior is disabled by default.
• Added a retry mechanism for downloading failed assets.
• Cached impressions on soft bootups are invalidated if any shared assets are deleted.

Fixes:

• Fixed issues causing “Could Not Delete Cache Entry for key” log message on startup.

Version 6.3.0 (Feb. 8, 2016)

Features & Improvements:

• Upgrade now to get ready for the new Chartboost Video V2 experience, rolling out in Q1.
• Older devices in the networking library no longer crash on occasion.
• MoreApps rotation issue has been resolved.
• Removed “Could Not Delete Cache Entry for key” notification from logs.

Version 6.2.0 (Jan. 13, 2016)

Features & Improvements:

• New method getSDKVersion() returns the current version of the Chartboost SDK.
• New method setShouldHideSystemUI(Boolean hide) hides or displays the Navigation and Notification bars for Chartboost ads.
• setShouldRequestInterstitialsInFirstSession is no longer deprecated.

Fixes:

• Improved handling of views when the app is minimized after clicking an ad.
• Reduced network usage with more efficient handling of cached assets.

Version 6.1.0 (Nov. 19, 2015)

Features & Improvements:

• Added didInitialize() delegate callback to notify that the SDK is initialized and ready to use

Fixes:

• In Play Ads now properly trigger the failure delegate on failure in all cases
• Restored support for Minimum Android API Level 9
• Fixed a bug that caused null pointer exception crashes
• Various bug fixes and stability improvements

Version 6.0.2 (Oct. 26, 2015)

Features & Improvements:

• Video experience rebuilt from the ground up.
• Android 6.0 Marshmallow support. Set the project’s Target SDK Version to API Level 23 in your AndroidManfiest.xml: android:targetSdkVersion="23"

Required to ensure compatibility with Android 6.0 devices:

• Set the project’s Build SDK Version to API Level 23 in your build.gradle file: buildToolsVersion = '23.0.0'
• Set the project’s Compile SDK Version to API Level 23 in your build.gradle file: compileSdkVersion = 23

Integration now requires the following entry in the AndroidManifest.xml file to display ads:<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" />

• android.permission.WRITE_EXTERNAL_STORAGE is now an optional (but recommended) permission instead of required.
• New recommended permission android.permission.READ_PHONE_STATE allows the SDK to handle calls interrupting video playback during videos.
• New method, public void didPauseClickForConfirmation(Activity activity), to handle Age Gate functionality. Previous method didPauseClickForConfirmation() is now deprecated.
• Extending ChartboostActivity as a method of integration is deprecated. If you rely on this functionality please contact us.

Fixes:

• Bug fixes and improvements.

Version 5.5.3 (Aug. 5, 2015)

Fixes:

• Fixed a crash in the retry event system.

Version 5.5.0 (Jun. 29, 2015)

Features & Improvements:

• Added a new method, public void setMediation(String libraryName, String version), to track mediation partner library versions.

Fixes:

• We temporarily pulled v5.5.0 to address a crash bug when retrying events in airplane mode.
• Age gate now properly blocks video ads between the didPauseClickForConfirmation call and the successful didPassAgeGate response.
• Removed an unnecessary video prefetch call.
• Fixed bug that caused Chartboost activity leaking in some cases.
• Prevented MoreApps page loading screen from displaying before static interstitial and rewarded video ads.
• Fixed bug in sample app included in SDK download package that prevented GAID from being sent to our servers.
• Corrected time zone format in reporting from devices running Android OS version 4.1 and older.

Version 5.4.1 (Jun. 4, 2015)

Fixes:

• Fixed bug that caused Chartboost media files to appear in the Gallery app.
• android.permission.WRITE_EXTERNAL_STORAGE is now required.

Version 5.4.0 (Jun. 1, 2015)

Features & Improvements:

• Added error logging for all network calls.
• Chartboost can now determine which network type the device is using.

Fixes:

• Fixed bug causing ads to disappear on rotation while using activities.
• Rewarded video pre-roll screen now properly displays after home key input.
• Fixed null pointer exception that occurred when initializing Chartboost and making calls on different threads.
• Fixed rare bug that prevented video prefetching under certain circumstances.

Version 5.3.0 (May 7, 2015)

Features & Improvements:

• Added a new method, public void setFrameworkVersion(String version), to track custom framework versions.
• Added Weeby to available frameworks.

Version 5.2.0 (Apr. 6, 2015)

Features & Improvements:

• Updated Amazon IAP library to v2.0.

Fixes:

• Fixed bug preventing Android SDK from showing additional ads when setImpressionsUseActivities was enabled and previous ads were dismissed too quickly.
• Resolved Chartboost Android SDK v5.1.3 bug that fired VIDEO_UNAVAILABLE error even when hasRewardedVideo returned true.
• Fixed Chartboost Android SDK v5.1.3 bug that caused occasional crashes after interstitial views.
• Fixed Chartboost Android SDK v5.1.1 bug that caused crashes when back button was pressed after interstitial views.
• Resolved bug in Chartboost Android SDK v5.1.1 that caused occasional crashes on showInterstitial calls.
• Removed all exceptions thrown from the SDK.
• Fixed issue preventing /api/install calls on every bootup.
• Fullscreen videos now properly extend to screen edges.

Version 5.1.3 (Mar. 17, 2015)

Fixes:

• Fixed bug firing duplicate showInterstitial and showRewardedVideo calls in Unity-built Android games.

Version 5.1.2 (Mar. 11, 2015)

Features & Improvements:

• Lorem ipsum

Fixes:

• Fixed bug preventing didDismissInterstitial and didDismissRewardedVideo from firing.
• Resolved issue preventing didCacheInterstitial from being called when ads were already cached at the location.

Version 5.1.1 (Feb. 23, 2015)

Features & Improvements:

• Added support for full-screen videos.
• Fixed DevKit engine issue preventing rewarded video playback after device returns from sleep.
• Fixed bug causing video crashes on crash exception.
• Resolved issue preventing clicks from dismissing rewarded/interstitial video ads.
• Corrected video download button alignment.

Version 5.1.0 (Dec. 10, 2014)

Features & Improvements:

• Fixed video interstitial NullPointerException crash in Android SDK 5.0.3.
• Corrected/updated error code enums.
• Fixed Unity v5.0 and v5.0.2 bug preventing MoreApps pages from loading.
• Fixed bug preventing passing of custom_id callbacks parameter.
• Fixed rare Rewarded Video bug that froze app if pre-roll popup was dismissed after player watched one video.

Version 5.0.4 (Nov. 7, 2014)

Features & Improvements:

• Fixed bug preventing proper autocaching of ads.
• Added new isAnyViewVisible() API that can be used to check if any Chartboost ads are visible.
• Bug fixes and stability improvements for Video, static interstitials and InPlay.

Version 5.0.3 (Oct. 1, 2014)

Features & Improvements:

• Fix video playback codec support for low end android devices.
• willDisplayVideo delegate callback added when the video is about to be displayed both for rewarded and interstitial video.
• Minor bug fixes and improvements.

Version 5.0.2 (Sep. 12, 2014)

Features & Improvements:

• Fix for video where certain OEM devices video-completed calls were not sent out properly.
• Minor bug fixes and patches.

Version 5.0.1 (Sep. 9, 2014)

Features & Improvements:

• Fix for flickering issue for video on Android 2.3 devices on Native SDK.
• Fix for Unity plugin error calling the onBackPressed Event from a non-UI Thread.
• Fix for crash when using setImpressionsUseActivities().
• Various bug fixes and stability improvements.

Version 5.0.0 (Sep. 4, 2014)

Features & Improvements:

• Chartboost Video released.
• All public methods are now static, so rather than using instance calls (e.g. this.cb) you can use the class name to call methods’ names (e.g. Chartboost.onCreate()).
• SDK initialization API name and its parameters are changed.
• ChartboostDelegate is not an interface anymore, but an abstract class. This means you don’t need to know ahead of time (or implement) the delegate callbacks that will be needed.
• New activity callbacks, onPause() and onResume(), added.
• Java API docs are provided along with SDK and a sample app (CBSample).

Version 4.1.2 (Aug. 20, 2014)

Features & Improvements:

• Fixed crash related to null path checking.
• Fixed an error related to linking Amazon in-app purchasing library.

Version 4.1.1 (Jun. 23, 2014)

Features & Improvements:

• Fixed edge case crash when calling cacheInterstitial() early; this method should always be called after onStart().
• Fixed crash while retrying request during network change.
• Fixed crash when filesystem data unavailable.
• Fixed tracking event overload on network failure.

Version 4.1.0 (Jun. 9, 2014)

Features & Improvements:

• New product: Post-Install Analytics exposes in-app purchasing API for developers to track Google Play and Amazon Appstore in-app purchases. More information
• New product: Tracking. This product is mainly used to log session events, user events, system events and debug events that are recorded by the SDK and sent to our servers.
• Carrier information like carrier name, MCC, MNC, ISO and phone type is sent in every API request.
• Permission android.permission.ACCESS_NETWORK_STATE is now required.
• jb flag is sent on every request to determine if the device a jailbroken or rooted device.
• New CBLocation constants (a default set of location constants which can be used during impression calls) provided to developers.
• Ultra-fast networking library for asynchronous networking (Volley + OkHttp Square).
• In app analytics, MoreApps page impressions now count toward total number of impressions.
• All impression classes are now more structurally organized.
• All impressions are grouped into their own packages.
• File caching and network reachability is centralized across SDK use.
• RequestManager module integrated with the new custom networking library for more reliable Chartboost API calls.
• Some clickable elements in impressions now have a pressed effect to improve user experience
• Deprecated methods (will be removed in the future releases):
• startSession(): SDK will be internally handling and tracking the session calls.
• clearImageCache(): Use clearCache() method, which performs the clearImageCache() operation internally.
• setFramework(): Removed in the previous release, but restored as a deprecated method for the time being.

Version 4.0.1 (Apr. 22, 2014)

Features & Improvements:

• Fixed crash due to Google Play Services security permission check.

Version 4.0.0 (Mar. 17, 2014) (requires Android OS v2.3+)

Features & Improvements:

• Improved interstitial and MoreApps page animations; we recommend you target Android OS 4.0+ for best results.
• Improved close button handling after device orientation changes.
• Added age gate for ad links, accessible via a new shouldPauseClickForConfirmation() delegate method. Learn more
• Fixed rare bug that served incorrect ad sizes.
• Improved SDK organization: All Chartboost properties and settings are accessible/editable via a new CBPreferences class.
• Added error constants that can be used to print delegate method failure reasons in log.
• Renamed didFailToLoadUrl delegate method to didFailToRecordClick in order to more granularly describe event failures.
• Added ability to configure logging for reports to Chartboost Support, accessible separate from the Chartboost instance via CBPreferences.setLoggingLevel(). Options are:
• NONE: Nothing is logged.
• INTEGRATION: The default setting — suspected integration errors will be logged (debug builds only).
• ALL: Suspected integration errors, plus diagnostic errors and messages, will be logged (in debug and release builds).
• Added client-side support for Google Play Services Advertising ID tracking.
• CBAnalytics is no longer available.

Version 3.4.0 (Nov. 20, 2013)

Features & Improvements:

• Now handles high-res interstitial assets!

Version 3.3.0 (Sep. 25, 2013)

Features & Improvements:

• ChartboostActivity and ChartboostNativeActivity are simple alternatives to implementing Chartboost in your app. Simply extend your activities from either class (depending on whether you use native activities or not), provide the app ID and signature, and you’re done!
• Changed documentation to suggest calling Chartboost.startSession() and cb.showInterstitial(); in your activity’s onStart() method, instead of in onCreate().
• ChartboostDefaultDelegate is a new abstract class that serves as a ChartboostDelegate. Extending from this instead will allow you to skip overriding the methods you are not interested in, at the expense of not being able to inherit from your own base class. The default implementation returns true for any method that returns a boolean in the delegate.
• didFailToLoadUrl() is called when the result of a click in an impression fails to load.
• Added exceptions to warn you if you have forgotten to properly exclude Chartboost from your proguard using the line -keep class com.chartboost.sdk.** { *; }
• Simultaneous identical interstitial or MoreApps request attempts will fail immediately. However, simultaneous interstitial requests with different locations are fine.
• Fix allowing Chartboost servers to differentiate buggy Android 2.x devices that all share the same ANDROID_ID
• Fixed an infrequent HTTP connection error during image downloads.
• Fixed bug where if the network is lost while viewing the MoreApps page, a click would cause a progress bar to hang forever.
• Fixed edge case crashes related to caching images.
• Method Chartboost.orientation() is now called getOrientation()
• Added ability to disable animations and fixed animation type none
• Fixed memory leak that could sometimes occur with the activity impressions setting.
• Removed dependence of sensor listener unless orientation is overridden.
• Removed all dependencies on AsyncTask, ensuring full compatibility with multithreaded apps.
• Fixed bug where screen stayed dark after closing interstitials on certain problem devices (including 4.1.2 Nexus S and Nexus 10).
• Fixed interference with game-rate sensor listeners on certain problem devices (including 2.3.x Galaxy S1 and Galaxy S2).
• Fixed crash when cacheInterstitial() was called off the UI thread.
• Change: Show impression calls will immediately fail (and call delegate method) if an impression is already visible.
• Stopped delegate method shouldDisplayLoadingViewForMoreApps() from being fired when showing interstitials.
• Fixed delegate method shouldRequestMoreApps() was not being called as specified.
• Fixed harmless Lint error about invalid package reference (also no longer necessary to include -dontwarn java.lang.management.** in your proguard configuration).
• Fixed memory leak involved in using Chartboost in multiple subsequent activities.
• Fail gracefully in low memory situations.
• Added ability to suppress off-thread method calling exceptions for certain unusual use cases.

Version 3.1.5 (Feb. 13, 2013)

Features & Improvements:

• Library javadoc now included!
• Add chartboost.jar.properties and doc directory to libs
• Adds support for campaign targeting by language.
• Significant memory management improvements.
• SDK no longer retains an activity reference, be sure to implement cb.onDestroy() in your activity’s onDestroy() method.
• Improved stability when WiFi connected without internet connectivity
• Interstitials now work in the Android emulator.
• Removed deprecated methods, see documentation or the example project.
• Added descriptive exceptions to occur in certain wrong implementation scenarios.
• Now compatible with NativeActivity and other edge case scenarios.
• Safer and more efficient image loading.
• Fixed showMoreApps() when delegate is null.
• Variety of stability and compatibility improvements.
• Improved reliability when using proguard. Be sure to add the following to your proguard.cfg: -keep class com.chartboost.** { *; } -dontwarn java.lang.management.**

Version 3.1.3 (Dec. 14, 2012)

Features & Improvements:

• Fixes language bug to improve stability for Asian languages.
• Fixes rare http request: null error on certain devices.

Version 3.1.0 (Nov. 20, 2012)

Features & Improvements:

• SDK is now an Interface instead of a Class.
• New native interstitials: faster, less memory.
• New native More-Apps page: faster, less memory, less network activity.
• Asset caching: individual assets are cached & only downloaded if they don’t exist in cache.
• Cache expiration: cached interstitials automatically expire after 24 hours.
• Multi orientation support: if your app works in both orientations, simply select both (landscape and portrait) in the dashboard.
• No longer uses an activity to display the view (better performance).
• Handles tracking of cached interstitials properly.
• Countless performance & stability upgrades.
• New API method: cb.onCreate initializes Chartboost with cb.onCreate(Context, appID, appSignature, chartboostDelegate or null)
• New API method: cb.startSession(), removed cb.install()
• New delegate method: didCacheInterstitial called when an interstitial is successfully cached from the server, interstitial location identifier passed in.
• New delegate method: didCacheMoreApps called when the MoreApps page is successfully cached from the server.
• New delegate method: shouldRequestInterstitialsInFirstSession default is YES, you may override to NO if you don’t want interstitials displayed until after the 2nd startSession (for compliance with Human Interface Guidelines).

‍

‍

下载和集成 Chartboost SDK iOS 版和 iOS Swift 版

版本8.4.2 （2021年6月16日） （当前版本）

功能改进：

• 添加对SKAdNetwork 2.2的支持
• 内部性能提升

Version 8.4.1 (2021年2月25日)  

功能改进：

• 内部性能提升

Version 8.4.0 (2020年11月20日)

功能改进:

• 添加 adID 作为参数传递到各个代理函数里，作为广告的唯一标识符。

修复:

• 修复了由于调用系统 API 导致的崩溃。
• 增加对低版本 OS 的兼容，低 iOS 版本不支持的函数将会被自动跳过。

Version 8.3.1 (2020年9月14日)

功能改进:

• 增加 iOS 14 和 SKAdNetwork 的支持。
• Apps 的 Info.plist 必须包含使用过的广告网络 SKAdNetwork ID.
• 更多内容请 查看这里.

修复:

• 解决了在初始化 SDK 之前调用设置 logging level 的方法导致的崩溃问题。

提示:

• 最小支持的 iOS 版本为 10.0。

Version 8.2.1 (2020年8月11日)

我们发现 Chartboost iOS SDK 8.2.0 有一处小错误会导致 app 崩溃。这个 bug 已经在 8.3.0 彻底修复, 或者您可以使用更直接的方案，即避免在初始化 Chartboost SDK 之前调用 Chartboost setLoggingLevel:CBLoggingLevelVerbose;，就能防止此问题。

如果您正在使用第三方广告聚合，譬如 AdMob 或 MoPub, 且不确定 Chartboost 各个方法的执行顺序, 为了确保进程安全，您可以在 app 初始化以后，在其他 SDK 执行任何操作之前调用 Chartboost 的方法。(譬如: Chartboost getCustomId 可以被调用并且忽略其返回值)。

提示:

• 内部性能提升。

版本 8.2.0 (2020年7月30日)

功能改进:

• 增加了支持CCPA的用户数据许可的API。
• didShowAd:error: 代理函数如今仅供 CHBInterstitial 和 CHBRewarded 广告对象调用。当广告展示后发生异常，SDK 会通过调用 didDismissAd: 代理函数进行通知。
• didEarnReward: 代理函数会在激励视频展示后，因为发生异常关闭前调用。注意，如果激励视频在展示前就发生异常，它不会被执行。(展示前发生错误，则 didShowAd:error: 代理函数会被调用).
• setMuted: 方法如今在 SDK 初始化之前和之后均可被调用。

修复:

• 解决了当展示 AppStore 标签页，点击关闭广告时的异常错误。如今 AppStore 标签页可以再次展现。
• API中发送请求中关于设备的用户代理字段总是保持更新的状态。
• 解决了由于网络访问异常导致的错误和线程锁定问题。
• 解决了横幅广告有时导致的崩溃错误。
• 精简了SDK启动后的API请求。

提示:

• 移除 restrictDataCollection: 方法。
• 废弃 getPIDataUseConsent 和 setPIDataUseConsent:。

版本 8.1.0 (2020年2月28日)  

功能改进:

• 插屏广告和激励视频广告使用更简洁的 API：CHBInterstitial 和 CHBRewarded。
• 模块化 API 使得 Chartboost SDK 在同一应用程序中被多个聚合平台调用。
• 每个广告有自己独立的代理函数, 当基于 View Controller 的状态栏被启用后，手机状态栏会自动隐藏。
• 新版 SDK 初始化函数 startWithAppId:appSignature:completion:。
• 新版 SDK 极大提升了初始化速度。
• 缓存广告的新 API 采用 Chartboost OpenRTB 来缓存返回的结果。

修复:

• 当广告被点击后自动关闭时，didClick 代理事件会在 didDismiss 之前被调用。

提示:

• 废弃一下方法： ChartboostDelegate, startWithAppId:appSignature:delegate:, isAnyViewVisible, hasInterstitial:, hasRewardedVideo:, cacheInterstitial:, showInterstitial:, cacheRewardedVideo:, showRewardedVideo:, setDelegate:, didPassAgeGate:, handleOpenURL:sourceApplication:, handleOpenURL:sourceApplication:annotation:, setShouldRequestInterstitialsInFirstSession:, setShouldPauseClickForConfirmation:, setAutoCacheAds:, getAutoCacheAds .

版本 8.0.4 (2019年11月27日)

修复:

• 修复当 Banner 从视图中被移除时产生的 Bug。

版本 8.0.3 (2019年10月29日)

功能改进:

• 增加对 iOS 13 的支持。
• 删除关于 UIWebView 的使用。
• 移除 Moat 的支持。
• 为 MAX 和 Fairbid 第三方广告中介增加 CBMediation 参数。

提示:

• 从此版本起不再支持 iOS 8 及更早的 iOS 系统。

版本 8.0.1 (2019年7月15日)

功能改进:

• 新增 Banner 横幅广告类型。
• 更新 Log 模块。新的 Log 模块可以支持不同层级的日志记录。

注意:

• 移除 cacheInPlay, hasInPlay 和getInPlay 函数。

Version 7.5 (Apr. 4, 2019)  

Improvements:

• Updated setMediation:withVersion: method to include a third parameter adapterVersion.
• Improvements in the dismissal of the ad.

Fixes:

• App sheet will be now gracefully handled.

Notes:

• Deprecated setStatusBarBehavior.

Version 7.3.1 (Feb. 28, 2019)

Fixes:

• Resolved potential crash when changing the mute setting.
• setMuted: now works as expected.

Version 7.3.0 (Sept. 28, 2018)

Improvements:

• Improved GDPR handling.

Fixes:

• startWithAppId can now recover from failed initialization.
• didFailToLoad delegate will now be called in the event of CBLoadErrorInternetUnavailable error.

Notes:

• New API for handling GDPR + (void)setPIDataUseConsent:(CBPIDataUseConsent)consent;
• API restrictDataCollection has been deprecated.

Version 7.2.0 (May 1, 2018)

Improvements:

• Improved appsheet behavior for smoother UX.
• Added restrictDataCollection method to support GDPR requirements.
• Added setMuted method to sync Chartboost ad mute status with in-game mute capability.

Notes:

• To enable GDPR data collection restrictions, call the restrictDataCollection method with the appropriate value for users who are EU Data Subjects. This method should be called before startWithAppId.
• AVFoundation is now a required framework.
• Xcode 8.x has been deprecated. Sorry, we cannot support Xcode versions below 9.0.

Version 7.1.2 (Mar. 7, 2018)

Improvements:

• SDK no longer collects IDFV.

Fixes:

• Resolved potential crash with Unity 2017.

Notes:

• Xcode 8.x is being deprecated. Sorry, we cannot support Xcode versions below 9.0 in future SDK releases.

Version 7.1.1 (Feb. 23, 2018)

Improvements:

• Better handling of iPhone X unsafe areas. Ads will now be letterboxed in black.

Fixes:

• All first ads shown by Chartboost now respect the mute switch.
• didDismissInterstital/Rewarded is no longer called when shouldDisplayIntertitial/Rewarded delegate returns NO.

Notes:

• Xcode 8.x is being deprecated. Sorry, we cannot support Xcode versions below 9.0 in future SDK releases.

Version 7.1.0 (Feb. 9, 2018)

Improvements:

• Enabled Moat viewability technology to allow serving of brand-based ads.
• Added more examples of delegate callbacks in the Example App.

Fixes:

• Fixed rare crash involving Reachability.
• Fixed rare crash involving DisplayManger.
• App Sheet now displays properly.

Notes:

• Added CHAMoatMobileAppKit.framework to project along with Chartboost.framework to enable brand ad support.

Version 7.0.4 (Nov. 28, 2017)

Fixes:

• Completed view events now fire properly for rewarded video.
• Fixed missing iTunes ID issue.
• Fixed rare configuration issue.

Version 7.0.3 (Oct. 27, 2017)

Fixes:

• didCloseInterstitial delegate now fires when ad is closed.
• didCloseRewardedVideo delegate now fires when ad is closed.
• didDismissInterstitial delegate now fires when ad is removed from UI.
• didDismissRewardedVideo delegate now fires when ad is removed from UI.
• Fixed issue that prevented clicks while age gate is enabled.

Version 7.0.2 (Oct. 20, 2017)

Improvements:

• Completed ads are now dismissed when the user clicks through.
• Added comment for custom age gate.
• Users can now download assets into arbitrary sub-directories.
• Added CBLoadErrorInternetUnavailableAtShow.

Fixes:

• Impression trackers now fire for Exchange ads.
• SDK now sends mediation values.
• Devices running below iOS 10 now use UIWebView.
• Stale assets are now deleted.
• Fixed deadlock issue with click delivery.
• Fixed multitasking mode on the iPad in iOS 11.

Notes:

• Dropped support for iOS 7.
• WebKit is now a required framework.

Version 7.0.1 (Sep. 14, 2017)

Improvements:

• iOS 9+ ads now use WKWebView instead of UIWebView for better performance and memory usage.
• Any UIView-based object can be used as a custom age gate screen.
• SDK has been tested with iOS 11.
• SDK is compiled with Xcode 9 GM.

Fixes:

• Ad unit will pause for age gate.
• Improved cache size reduction.
• Added UIKit import to Chartboost.h
• Fixed compatibility issue between some exchange ads and WKWebView.
• Fixed thread watchdog issue.

Notes:

• Dropped support for iOS 7.
• WebKit is now a required framework.

Version 7.0.0 (Aug. 30, 2017)

SDK 7.0.0 is a major release that focuses on quality and stability while adding several new features. Compatible with iOS 8.0+. If compatibility for iOS 7.0 is required, consider using Chartboost iOS SDK version 6.6.3.API Changes:

• Removed MoreApps support and deprecated API methods.
• hasMoreApps will now return false.
• cacheMoreApps is no-op.
• showMoreApps is no-op.
• Added willDisplayInterstitial delegate.

Fixes:

• iOS Runtime Exception: NSUserDefaults
• Added clearer ad server messaging.
• Removed all instances of method swizzling.

Improvements:

• Rewrote Ad Unit State Manager and Download Manager.
• Implemented better support for Exchange ads.
• Implemented better support for interactive ads.
• Improved prefetch.
• Decreased size of Chartboost Library.

Version 6.6.3 (May 1, 2017)

Fixes & Improvements:

• didCache and has delegates are no longer called when the ad is not ready to be displayed.
• Fixed timing issue where prefetch calls at bootup might negatively affect get calls.

Version 6.6.2 (Mar. 13, 2017)

Fixes & Improvements:

• No longer freezes after backgrounding when post-roll is shown.
• Removed MoreApps from Sample/Example project.
• Clarified ad server error messaging when no publisher campaigns are available.
• Modified NSUserDefaults category to resolve name-collisions with other SDKs.

Version 6.6.1 (Jan. 4, 2017)  

Features:

• App Transport Security (ATS) added to Chartboost Example Project. ATS improves user security and privacy by requiring apps to use secure network connections over HTTPS.

Fixes & Improvements:

• Video no longer freezes when app is backgrounded.
• Reachability reports are more accurate.

Version 6.6.0 (Nov. 16, 2016)  

This library is built using Xcode 8 with bitcode enabled. In order to use it with prior versions of Xcode (including 7.3.1), bitcode must be disabled.

iOS 6 is no longer supported. iOS 7.0 is the minimum supported iOS Version.

closeImpression() functionality has been deprecated.

Features:

• Added support for AerServ.

Fixes:

• Black background now remains when a video ad is playing.
• Fixed bug that could cause visual defects on ads when the app loses and regains focus.
• App no longer freezes when backgrounding after a video plays.
• MoreApps now respect the status bar app settings.

Improvements:

• Improved the rendering performance when rotating an ad.

Version 6.5.2 (Sept. 28, 2016)

iOS 6 is no longer supported. iOS 7.0 is the minimum supported iOS Version.

Fixes:

• Fixed bug that could cause visual defects on ads when the app loses and regains focus.

Version 6.5.1 (Sept. 16, 2016)  

iOS 6 is no longer supported. iOS 7.0 is the minimum supported iOS Version.

Fixes:

• Fixed bug that prevented MoreApps from showing.

Version 6.5.0 (Sept. 12, 2016)  

iOS 6 is no longer supported. iOS 7.0 is the minimum supported iOS Version.

Features & Improvements:

• Networking stack has been upgraded to AFNetworking 3.0.
• Added features to help support iOS changes to limit of ad tracking.
• iOS 10 compatibility.

Fixes:

• Fixed IFV reporting bug.
• Fixed bug that could retain a bad ad unit in the cache.
• Fixed bug that could send inaccurate list of local videos to the server.

Version 6.4.7 (July 25, 2016)  

Fixes:

• Cache folders combined and various timing changes implemented to avoid possible issues with delivering impressions.
• Video file sizes are now checked during download and maintenance to prevent corruption.
• Framework file in the Example project has been replaced with a reference to the file in order to reduce download size.

Version 6.4.7 (legacy Xcode 6 compatible)* (July 25, 2016)

*This version is a variation of the SDK for developers who need to build on older versions of Xcode. This SDK version does not have bitcode support. Download legacy Xcode compatible SDK for iOS

Version 6.4.6 (June 22, 2016)

Fixes:

• Various bug fixes.

Version 6.4.6 (legacy Xcode 6 compatible)* (June 22, 2016)

*This version is a variation of the SDK for developers who need to build on older versions of Xcode. This SDK version does not have bitcode support.

Version 6.4.4 (May 5, 2016)

Fixes:

• Various bug fixes.

Version 6.4.5 (May 5, 2016) (no bitcode support)*

*This version is a variation of the SDK for developers who need to build on older versions of Xcode. This SDK version does not have bitcode support.

Version 6.4.2 (April 5, 2016)

Fixes:

• Various bug fixes.

Version 6.4.3 (April 6, 2016) (no bitcode support)*

*This version is a variation of the SDK for developers who need to build on older versions of Xcode. This SDK version does not have bitcode support.

Version 6.4.0 (Mar. 14, 2016)

• With this SDK we will begin rolling out a brand new Chartboost Video experience, specially tailored for games. Upgrade now!
• We’ve also improved key features like video caching, memory management, and data usage for optimal SDK performance.

Features & Improvements:

• Calls to cacheInterstitial and cacheRewarded have been optimized to require less memory.
• Interstitials will now fail gracefully instead of showing with missing assets.
• Added a retry mechanism for downloading failed assets.
• Closing the “loading” view has moved to the main thread.

Fixes:

• Updated documentation to use hasInterstitial instead of hasCachedInterstitial

Version 6.4.1 (Mar. 14, 2016) (no bitcode support)*

*This version is a variation of the SDK for developers who need to build on older versions of Xcode. This SDK version does not have bitcode support.

Version 6.3.0 (Feb. 8, 2016)

Features & Improvements:

• Upgrade now to get ready for the new Chartboost Video V2 experience, rolling out in Q1.
• Certain network request failures no longer cause a crash.

Version 6.3.1 (Feb. 8, 2016) (no bitcode support)*

*This version is a variation of the SDK for developers who need to build on older versions of Xcode. This SDK version does not have bitcode support.

Version 6.2.0 (Jan. 13, 2016)

Features & Improvements:

• New method getSDKVersion returns the current version of the Chartboost SDK.
• New method setDelegate changes the Chartboost delegate object.
• New method setAutoIAPTracking replaces the need to call trackInAppPurchaseEvent. If enabled, Chartboost will listen for purchase events.
• Added imports to Foundation and UIKit in Chartboost.h.

Fixes:

• Improved SDK stability when running with Address Sanitizer.
• Blank ads no longer appear if the device is rotated into an unsupported orientation.
• Fixed rare issue where MoreApps or a blank screen would sometimes be displayed when attempting to show an interstitial ad.

Version 6.2.1 (Jan. 13, 2016) (no bitcode support)*

*This version is a variation of the SDK for developers who need to build on older versions of Xcode. This SDK version does not have bitcode support.

Version 6.1.0 (Nov. 12, 2015)

Features & Improvements:

• Added support for iOS9 split screen mode
• Added didInitialize delegate that is called when Chartboost has been initialized and which replaces didPrefetchVideo

Fixes:

• Fixed a rare crash when reopening the application when an ad was just displayed
• Fixed a bug causing the delegate didPrefetchVideo to fire twice where it should only fire once

Version 6.1.1 (Nov. 12, 2015) (no bitcode support)*

*This version is a variation of the SDK for developers who need to build on older versions of Xcode. This SDK version does not have bitcode support.

Version 6.0.0 (Oct. 5, 2015)

Features & Improvements:

• Video experience rebuilt from the ground up.
• setMediation now uses enumerated constants for partners.
• Removed deprecated Chartboost Newsfeed product.

Fixes:

• cacheRewardedVideo no longer stops audio of the playing video
• Removing headphones during the rewarded video confirmation screen no longer starts the video.
• Accepting or declining a phone call during the rewarded video confirmation screen no longer starts the video.
• Xcode 7 compiler warnings fixed.

Version 6.0.1 (Oct. 26, 2015) (no bitcode support)*

*This version is a variation of the SDK for developers who need to build on older versions of Xcode. This SDK version does not have bitcode support. Fixes:

• Addressed Xcode 7.0.1 compile error preventing archiving with Bitcode enabled.
• Calls to cacheInterstitial and cacheRewardedVideo retry again when there are no available videos cached to the device
• Fixed build warnings with Bitcode enabled

Version 5.5.4

Features & Improvements:

• SDK now supports Bitcode submissions for iOS 9.

Version 5.5.3 (Aug. 5, 2015)

Features & Improvements:

• SDK now builds with armv7s architecture.

Version 5.5.1 (Jul. 16, 2015)

Fixes:

• Fixed bug that prevented InPlay button response in example app included in SDK download package.
• Fixed an issue that crashed or hung the SDK while detecting jailbroken device status during initialization.

Version 5.5.0 (Jun. 29, 2015)

Compatible only with iOS 6.0+. If you need compatibility with older iOS versions, contact us!. Features & Improvements:

• Rewarded videos no longer need to wait until the video prefetch is complete before showing an existing video.
• Mediation partners can now call setMediation:withVersion to set the library name and version.
• AFNetworking library updated to version 2.5.4.
• Sample app included in SDK download package now supports portrait orientation.

Fixes:

• Fixed bug that prevented video ads from resuming/being dismissed after incoming phone calls.
• Corrected video prefetch behavior to prevent unwanted deletions of video ads prior to /show calls.
• Fixed bug that prevented proper caching of new MoreApps page data after /more/show call.
• Suppressed erroneous CoreData Unable to load class named 'CBHTTPRequestEntity' warning message.

Version 5.4.0 (Jun. 1, 2015)

Features & Improvements:

• Added additional argument to setFramework to allow framework developers to include a version strings (Unity 4.6.0f1, for example).

Fixes:

• didPrefetchVideo now returns when video prefetching is complete. Once this call returns, you can show rewarded videos.

Version 5.3.0 (May 7, 2015)

Features & Improvements:

• Added Weeby to available frameworks.
• Native iOS SDK now sends the version of the Unity wrapper SDK along with every request.
• Added "rooted_device":true or "rooted_device":false to /api/install call REQUEST body to detect jailbroken devices.

Fixes:

• Fixed issue that stalled video playback after declined phone calls.

Version 5.2.1 (Apr. 13, 2015)

Fixes:

• Fixed issue that caused CoreData crash on first bootup.
• Corrected symbol collision with third-party SDKs on audioRouteChangeListenerCallback.
• Fixed bug preventing MoreApps page resize on device orientation change.

Version 5.2.0 (Apr. 6, 2015)

Features & Improvements:

• Added new Core Data-backed persistence layer for the Chartboost request manager.
• Added a developer-facing function, closeImpression, to force-close any visible impression or loading view.
• Added a new method to CBAnalytics, trackInAppPurchaseEventWithString, that acts like the trackInAppPurchaseEvent but takes a string instead of raw receipt data to allow frameworks to pass in base64-encoded receipts.
• PIA Level Tracking available in CBAnalytics (contact your account manager or Support for information about Level Tracking).
• Improved SDK batch requests for an endpoint to cut down on outgoing network requests. Only enabled for Level Tracking.

Fixes:

• Fixed issue that paused rewarded video and video interstitial playback when headphones were unplugged.
• didFailToLoadRewardedVideo delegate method now fires if rewarded video is requested before prefetching finishes.
• Fixed bug preventing loading view from displaying in a timely manner when setShouldDisplayLoadingViewForMoreApps was set to YES.
• Rewarded and interstitial video ads will now pause and disappear so players can complete age gate selections and reappear and resume after user input.

Version 5.1.5 (Mar. 17, 2015)

Fixes:

• Fixed bug affecting iOS Rewarded Video close buttons when videos shown on bootup.

Version 5.1.4 (Mar. 11, 2015)

Features & Improvements:

• Added a new setStatusBarBehavior method to control how fullscreen video ads interact with iOS’s status bar.
• Added the location parameter, when available, to click, show, completed-view, and other relevant network requests.

Fixes:

• Fixed issue causing duplicate SDK calls to creative URLs.
• Max ads/hour setting is now respected when campaigns are configured to show one ad per hour and auto-caching is enabled.
• Fixed bug that fired didDismissInterstitial or didDismissRewardedVideo during click events.
• Fixed bug that prevented didClickInterstitial from firing on interstitial video clicks.
• Corrected fullscreen video close button placement; close buttons no longer appear behind the iOS status bar.

Version 5.1.3 (Jan. 19, 2015)

Features & Improvements:

• InPlay data can now be cached at multiple Named Locations.
• Added orientation information to api/click and video/complete calls to facilitate better analytics.
• Removed hardcoded affiliate token from SDK; now pulled from server.
• Added example use of isAnyViewVisible delegate method to sample project (included in SDK download package).
• Added InPlay button to Chartboost example app (included in SDK download package).

Fixes:

• Added global flag to disable request retries by default (configurable in CBConfig).
• Fixed multithreaded crashes.
• Fixed silent failure when requesting assets with wrong orientation (now trackable via a CBLoadError).

Version 5.1.2 (Dec. 10, 2014)

Fixes:

• Fixed CBAppCall crash that occurred when resource path was not sent with URL.
• Fixed race condition causing SKStoreProductViewController crash.
• Fixed SKStoreProductViewController rotation issue with Unity.
• Resolved concurrency issue in CBConfig.

Version 5.1.0 (Nov. 25, 2014)

Features & Improvements:

• Added new framework tracking values for Cordova and CocoonJS.
• Added new API to check visibility of Chartboost UI.
• Changed delegate callbacks for click and close to be sent after closing or clicking the impression.
• Changed auto-cache calls to delay execution for better performance.

Fixes:

• Fixed race condition between video actions on replay.
• Fixed loading screen that was causing issues with video and App Sheet.
• Fixed issue causing interstitial video close button to appear at incorrect time in portrait orientation.
• Fixed rewarded video auto-plays when previous display of video was dismissed instead of watched.
• Fixed bug preventing api/config from executing on soft bootups.
• Fixed problem with close button clipping the video player in corner.
• Fix for various crashes due to memory pressure and concurrency.
• Fix for api/track executing on hidden files for older devices.
• Fix for issue causing video to display off screen after rotating iPhone 6/6+.
• Fix for incorrect error code enumerations being used.
• Fixed loading view not appearing for MoreApps page on devices with slow connections.
• Fixed crash in CBAnalytics if sent an invalid NSDecimalNumber.

Version 5.0.3 (Oct. 1, 2014)

Fixes:

• Bug fixes and stability improvements.

Version 5.0.2 (Sep. 12, 2014)

Features & Improvements:

• Added functionality to close loading view if taking too long.

Fixes:

• Bug fixes and stability improvements.

Version 5.0.1 (Sep. 9, 2014)

Fixes:

• Critical bug fixes and stability improvements.

Version 5.0.0 (Sep. 4, 2014)

Features & Improvements:

• Chartboost Video released.
• Updated SDK interface to use static methods.
• Removed deprecated Chartboost Store.
• New ChartboostExample project included in SDK package.
• Many delegate methods now “setter and getter” functions.
• Introduced new Chartboost display methods that accept a UIViewController.
• Full SKProductsViewController support added.
• CBPostInstallAnalyticsTracker renamed to CBAnalytics.
• Reduced overall size of SDK.
• Symbols and frameworks now dynamically loaded.
• Removed external dependencies.
• Enabled logging in DEBUG builds via environment variable.
• Bug fixes and stability improvements.

Version 4.5.1 (Jun. 30, 2014)

Fixes:

• Minor bug fixes for session analytics.

Version 4.5.0 (Jun. 9, 2014)

Features & Improvements:

• Newsfeed publicly available.
• Post-Install Analytics publicly available.

Version 4.4.1 (May 19, 2014)

Features & Improvements:

• Now supports 64-bit Simulator.
• Fixed support for iOS 5.1.1.

Version 4.4.0 (May 16, 2014)

Features & Improvements:

• New MoreApps: Brand new look and feel, custom headers and close buttons, support for Named locations.
• In app analytics, MoreApps page impressions now count toward total number of impressions.
• New Chartboost initialization method: startWithAppId:appSignature:delegate:
• Automatic caching now enabled after show calls.
• New delegate method: didFailToRecordClick:withError: called when a click is registered, but the user is not forwarded to the App Store.
• Orientation improvements: Ads will now be displayed in any orientation the game supports (according to the Chartboost dashboard), regardless of device orientation.
• Numerous bug fixes.
• Deprecated default location API calls.

Version 4.2.0 (Mar. 25, 2014)

Features & Improvements:

• Non-default Apple frameworks (Quartzcore, System Configuration, Store Kit and Ad Support) no longer need to be linked manually.
• Named Locations for caching/showing interstitials and MoreApps pages are now predefined. (A list of the enum values can be found in the Chartboost.h file.)
• Added MoreApps page support for beta App Sheet program (contact us for more information)
• Carrier information now included in default request parameters

Version 4.1.0 (Feb. 17, 2014)

Features & Improvements:

• Interstitials and MoreApps pages now change orientation with device (if app supports multiple orientations).
• MoreApps header background now built from tileable image, providing better support for various screen resolutions.
• Backgrounds when interstitials are displayed now blurred (if device and OS support it) to match iOS 7 UI.
• Server responses now validated and will fail if any field is incorrect, increasing SDK reliability.
• Age Gates can now be added after interstitials are clicked. Use delegate method shouldPauseClickForConfirmation to activate.
• Fixed memory leak and improved SDK architecture via a comprehensive refactor.
• Various other bug fixes.

Version 4.0.0 (Jan. 10, 2014)

Features & Improvements:

• Bundle file scanning is now an option in the header, controlled by a boolean property set to false by default.
• Files in the cache folder will be now deleted if they have not been used for 7 days.
• Rate limiting of requests: only 3 interstitial requests per 90s per named location are allowed.
• Error delegate methods now take an enum describing the error.
• When an interstitial is not loaded because of first session interstitials being disabled (shouldRequestInterstitialsInFirstSession), didFailToLoadInterstitial is now triggered.
• When an interstitial is the wrong orientation, it now also triggers an error.
• User-agent updated to allow wrappers to suffix User-agent.
• New delegate method, to be called when the App Store sheet is dismissed.
• Completely removing deprecated library, CBAnalytics.
• New example project is now part of the sdk download package.
• When attempting to load an interstitial without having started a session, an error is triggered.

Version 3.3.1 (Oct. 30, 2013)

Features & Improvements:

• Fixed bug causing MoreApps page crashes on iOS 7.
• Fix crashes on iOS 5 devices related to the new 64-bit support.
• New Feature: Xcode 5 now automatically displays integration tips (defined in chartboost.h), contextually presenting them while you code.

Version 3.3.0 (Oct. 17, 2013)

Features & Improvements:

• Fully compatible with iOS 7 64-bit-only projects. Maintains support for 32-bit projects and iOS 5.1+ devices.

Version 3.2.2 (Oct. 10, 2013)

Features & Improvements:

• Added a new public method (dismissChartboostView) to dismiss an interstitial or MoreApps view programmatically.
• Fixed a bug causing indefinite loading after MoreApps page clicks while in Airplane Mode.
• Fixed a crash bug that would occur if the SDK received corrupt image data.
• Fixed bug affecting display of MoreApps button labels on iOS 7 devices.
• Fixed bug causing crashes when user clicked interstitial with no iTunes URL set via the dashboard.

Version 3.2.1 (May 23, 2013)

Features & Improvements:

• Improved long term memory management.
• Better handles clicks on interstitials with malformed URLs.
• Increased stability on repeated calls to hasCachedInterstitial.
• Fixed issue where dismiss button could be pressed multiple times on a single interstitial.
• Replaced third party JSON lib with Apple internal JSON serializer.
• Compatible only with iOS 5.0+. If you need iOS 4.3+ compatibility, use SDK version 3.2 below.

Version 3.2.0 (April 19, 2013)

Features & Improvements:

• UDID method removed. Use this SDK in any apps submitted to the App Store after May 1st, 2013.
• MoreApps page better handles long app names.
• Handles showing an interstitial at the same time as the Game Center login prompt.
• Better time-outs on intermittent internet.
• No longer shows blank interstitials when app orientation is misconfigured server-side.
• Added support for targeting interstitials by language.
• The window property has been changed to root view.
• CBAnalytics beta features removed.

Note: “Unique” column of App Analytics temporarily shows 0 for apps using SDK v3.2. Please use “Installs” or “Bootups” for reference.

Version 3.1.1 (Nov. 27, 2012)

Features & Improvements:

• Stability improvements for apps with over 300mb of bundled assets.
• Fixed rare visual glitch where interstitial positions itself incorrectly relative to status bar after app rotation.

Version 3.1.0 (Oct. 12, 2012)

Features & Improvements:

• Added support for the iOS 6 App Sheet so your users can download apps without ever leaving your app! You must include StoreKit.framework for access to the App Sheet.
• MoreApps status bar fixed, now auto-adjusts position when status bar is visible.
• Fixed rare crasher in CBCrypto.
• Note: This version and all versions in the future are compatible with iOS version 4.3 and higher ONLY (armv7 and armv7s).

Version 3.0.7

Features & Improvements:

• REQUIRED: You must include AdSupport.framework for access to the identifierForAdvertising.
• Added compatibility with Xcode 4.5 and armv7s. This SDK includes armv6, armv7, and armv7s.
• Fixed shouldRequestInterstitialsInFirstSession delegate method; now requests interstitials only after 2nd startSession call.
• Internal API upgrades.

Version 3.0.6 (Sep. 13, 2012)

Features & Improvements:

• Automatic interstitial caching now uses a version fallback if your app does not include CFBundleShortVersionString in the info.plist. For best interstitial caching, add CFBundleShortVersionString key and value to your info.plist.

Version 3.0.5 (Aug. 28, 2012)

Features & Improvements:

• Fixed rare crash in web image caching library.

Version 3.0.4 (Aug. 16, 2012)

Features & Improvements:

• Added SDK support for targeting wi-fi devices.

Version 3.0.3 (Jul. 31, 2012)

Features & Improvements:

• Removed automatic removal of interstitials and MoreApps view when backgrounding app.

Version 3.0.2 (Jul. 20, 2012)

Features & Improvements:

• Improves click tracking in race conditions.
• Fixes issue where cached ads appear during backgrounding.
• Fixed JSON crasher in CB Analytics.

Version 3.0.1 (Jul. 6, 2012)

Features & Improvements:

• Improved compatibility with iOS versions 4.0 to 4.2.

Version 3.0 (Jul. 2, 2012)

Features & Improvements:

• Delegate methods now return location strings (no longer pass in a view) — i.e. didFailToLoadInterstitial will pass in the specific location identifier that failed.
• Removed methods: loadInterstitial, install — now use showInterstitial, startSession.
• Requirement: rename ChartBoost class to Chartboost (lowercase b, no camelCase) Feeling hardcore? Run this bash command in your project directory to update camelcase ChartBoost in all your files: bash for ext in '*.m' '*.h' '*.c' '*.mm'; do find . -name "$ext" -exec sed -i '' 's/ChartBoost/Chartboost/g' '{}' ; ; done.
• New native interstitials: faster, less memory.
• New native MoreApps page: faster, less memory, less network activity.
• Asset caching: individual assets are cached and only downloaded if they don’t exist in cache — all assets stored in caches folder so the OS handles memory appropriately.
• Cache expiration: cached interstitials automatically expire after 24 hours.
• Multi orientation support: if your app works in both orientations, simply select both (landscape and portrait) in the dashboard.
• Orientation override: SDK detects orientation using the statusbar location, you may override this detection
• UDID replacement: iOS 6 compatible.
• didCacheInterstitial: called when an interstitial is successfully cached from the server, interstitial location identifier passed in.
• didCacheMoreApps: called when the MoreApps page is successfully cached from the server.
• shouldRequestInterstitialsInFirstSession: default is YES, you may override to NO if you don’t want interstitials displayed until after the 2nd startSession (for compliance with Human Interface Guidelines).
• Version notifications: if a new version of the SDK is released, you’ll get a version notification in the Xcode console if current device is iPhone Simulator.
• Bundle assets: you may include frame and cross promotion assets into your binary.
• Displaying interstitial no longer fails when there is no appDelegate window property.
• Fixed memory leaks.
• SDK supported – coming soon to the dashboard: Interstitial animations: four, configurable from the dashboard.
• SDK supported – coming soon to the dashboard: Retina support for interstitials and MoreApps
• SDK supported – coming soon to the dashboard: New cell types.

‍

‍

效果监测

‍

数据概览

1. 跳转到页面 Analytics > Performance - All, 您可以看到头部竞价和瀑布流模式所有的统计数据。
2. 跳转到页面 Analytics > Performance - Bidding, 您可以看到头部竞价的统计数据。
3. 跳转到页面 Analytics > Performance - Waterfall, 您可以看到瀑布流，也就是非头部竞价的统计数据。

‍

头部竞价分布

1. 跳转到页面 Analytics > Bidding
2. 如果您选择 “Price Distribution by Winning Bids”, 页面会显示每个价格区间竞价成功的数据统计。
3. 如果您选择 “Price Distribution by Shown Impressions”, 页面会显示每个价格区间的广告展示量。

‍

A/B 测试

跳转到页面 Analytics > A/B Tests, 您可以看到每个 Mediation App 和广告位的 A/B 测试结果。

‍

A/B 测试

1. 在 Helium 上进行 A/B 测试有一些应用场景。
   i. 当您开始使用 Helium 时，可以利用 A/B 测试来检验混合盈利模式（头部竞价加瀑布流）与纯瀑布流盈利模式相比较的效果。
   ii. 即使使用 Helium 一段时间后，如果您想在聚合平台里测试一个新的广告网络，或者测试不同的 line item 设置，您仍然可以使用 A/B 测试。‍
   ‍
2. A/B 测试可以在每个 Helium Placement 层级上进行。您需要确保已经为这些 Helium Placement 广告位设置了基本的头部竞价和瀑布流模式。‍
   ‍
3. 对于测试混合模式（头部竞价与瀑布流）与单独瀑布流模式的初始应用场景，以下是在 Helium 后台设置 A/B 测试的流程：
   i. 在 Helium Placement 设置上，您已完成所有头部竞价网络（包括 Chartboost、Meta Audience Network、AdColony、Tapjoy）的设置。同时，您也已完成瀑布流模式的设置（包括广告组和 Line items）。
   ii. 在 Placement 设置页面的高级设置标签栏，开启  A/B 测试.
   iii. Helium 后台会自动创建 A/B 测试的设置界面。
   iV. 广告组 A 默认设定为当前的头部竞价与瀑布流混合模式，应用在当前 Helium placement 广告位上。
   V. 广告组 B 是将现有设定复制一份，然后您可以关闭所有的头部竞价网络，然后添加额外的  line items (包括 Meta Audience Network, AdColony, Tapjoy 等) 到广告组 B 里。‍
   ‍
4. Helium 自动分配 50% 广告请求给广告组 A，另外 50% 给广告组 B。i. 每个终端用户会被随机分配到广告组 A 或者 B，然后该用户后续的广告请求会被固定到这个广告组里，以此确保 A/B 测试的效果。‍
   ‍
5. 您可以在 Helium 后台的 Analytics > A/B tests. 查看 A/B 测试的结果。
   ‍‍‍
6. 如果在查看 A/B 测试分析后，您发现其中一个广告组的表现更好，您可以通过在 Helium Placement 中禁用表现较差的广告组来停止 A/B 测试。i. 一旦某个广告组被禁用，该广告组所有广告请求将自动开始转向另一个开启状态的广告组。ii. 您不能同时禁用两个广告组，至少有一个必须是开启状态。‍
   ‍
7. 如果您希望再次启用 A/B 测试，您可以直接编辑头部竞价或者瀑布流设定，将已禁用的广告组重新开启。

‍

Chartboost非常重视我们的开发者和他们的最终用户的隐私。我们知道用户数据对我们的开发者价值和运营至关重要。因此，我们正在采取措施，支持我们的合作伙伴遵守欧盟数据保护要求，包括《通用数据保护条例》（GDPR），自2018年5月25日起生效。

‍

欲了解更多信息，我们鼓励我们的客户阅读下面提供的资源。

‍

什么是GDPR？

《通用数据保护条例》（GDPR）是一项新的欧洲隐私法，旨在取代现行的欧盟数据保护指令（指令95/46/EC）。 GDPR旨在加强欧盟个人数据的安全和保护。

‍

GDPR适用于谁？

GDPR适用于在欧盟境内运营并处理欧盟居民个人可识别数据的所有组织。个人数据是任何与已识别或可识别自然人相关的信息。

‍

Chartboost是控制者还是处理者？

对于我们处理的欧洲数据主体的个人数据，Chartboost是“控制者”。 Chartboost依赖于其发布商具有适当的法律依据或同意，以便Chartboost处理此类数据。

‍

我们有一个专门的团队致力于GDPR合规性，以在2018年5月25日之前实施适当的措施。

‍

Chartboost通过其广告服务收集哪些数据？

Chartboost收集数据（包括设备ID和IP地址），以优化我们的应用内广告网络并提高性能和定向。此外，Chartboost可能会收集与其客户用户相关的安装后事件。

‍

Chartboost针对转移至欧盟以外的数据的数据转移做法是什么？

Chartboost已获得EU-US和Switzerland-US Privacy Shield框架的认证。

‍

Chartboost计划如何处理合作伙伴GDPR下的欧盟用户（数据主体）的请求？

我们重视我们的合作伙伴，并打算在他们履行GDPR下对其用户的义务方面帮助他们。此外，我们的隐私政策描述了用户管理其数据和选择退出的选项。

‍

Chartboost是否有处理活动记录，并且这个处理活动记录是否经常记录和更新？

是的。 Chartboost保持一个内部处理活动记录，由一个专门的跨职能团队定期更新。

‍

Chartboost采取了什么技术和组织措施来保护用户数据？

Chartboost已制定安全措施和协议。可以在特定情况下通过保密协议（NDA）获得Chartboost安全政策和措施的概览。

‍

Chartboost发布商如何为GDPR执行做准备？

Chartboost鼓励发布商通过审查其隐私和数据安全流程和政策，以确保在2018年5月25日前符合规定，为GDPR执行做好准备。

Chartboost SDK如何注册用户同意使用个人数据？

发布商应从Chartboost SDK调用“setPIDataUseConsent” API，并传递是否存在同意、不存在同意或未知的适当值。作为服务条款的一部分，发布商必须在Chartboost处理任何个人数据并通过上述方法将其传递给Chartboost SDK之前，获得其用户的同意。

您的条款和隐私政策在哪里可以查看？

‍

条款和条件

隐私政策

欲了解更多信息，请访问欧盟GDPR网站

重要提示：开发人员有责任评估他们的应用程序，以确定它们是否面向13岁以下的儿童（每个“面向儿童的应用”）。在Google的Designed for Families计划、Google Play的家庭版或Apple App Store的Kids类别中包含的应用程序，除非开发人员已为这些应用程序实施了年龄门槛，否则应被视为面向儿童的应用。对于任何面向儿童的应用程序，开发人员应进行适当的设置，以仅启用上下文广告。

‍

面向儿童的应用需要在应用创建过程中指定其为COPPA，以便退出行为定位。

‍

如何退出行为定位？

• 在Chartboost dashboard上创建应用程序时，必须选择您的应用程序是否面向13岁以下的儿童。如果您选择是，您的应用程序将退出行为定位，仅提供上下文广告。

‍

如果我将我的应用程序指定为COPPA应用程序，会发生什么？

• 您的用户仅会看到上下文定向的广告活动。
• 在外部API中（例如导出安装）将设备标识符匿名化。

‍

我可以更改设置吗？

是的，您可以在未来自由更改设置。

‍

作为网络广告客户端，我可以退出行为定位吗？

不，退出选项仅适用于网络发布商。

‍

为什么我的广告报告中有“NON-TRACKABLE”标记的设备？

该点击或安装的发布应用是COPPA应用。

‍

我如果在交叉推广活动中有一个COPPA应用会发生什么？

从2018年3月26日开始，COPPA定位不能启动交叉推广活动。

• 您的应用只能交叉推广其他COPPA应用。
• 您的应用只能被其他COPPA应用推广。
• 设备标识符在外部API（例如导出安装）中被匿名化。

交叉推广活动仅限于推广具有等效退出选择设置的应用程序。例如：COPPA应用只能交叉推广其他COPPA应用。同样，未选择退出行为定向的应用只能推广未选择退出的应用。

如何让我的广告素材创意更好？

点击这里了解如何制作出色的广告素材。

我可以发布或使用纵向视频广告进行广告宣传吗？

视频创意必须以横向方向上传。用户可以将设备保持纵向方向，并且可以显示应用商店评级，如下所示。了解更多有关广告素材的信息。

您可以在启动发布活动时选择应用程序的目标。

从2022年4月开始，所有开发人员都必须声明他们如何收集和处理他们在Google Play上发布的应用程序中的用户数据，并提供有关他们如何通过加密等安全实践来保护这些数据的详细信息。这包括通过任何第三方库或SDK在其应用程序中收集和处理的数据，例如Chartboost。为了促进此过程，我们已披露Chartboost数据收集如下。

‍

您可以在此处找到有关Google数据收集披露目的的更多信息。

‍

以下披露仅包括我们的SDK收集的数据。您有责任为您的应用程序提供任何其他披露，包括在您的应用程序中使用的其他第三方SDK。本文件仅供您参考； Chartboost不对此类信息，包括但不限于其准确性或完整性，作出任何陈述。

‍

Chartboost SDK加密了所有在传输中收集的数据。Chartboost还为客户提供了删除特定用户数据的功能。由于Chartboost广告服务的性质，Chartboost收集的数据不会被短暂处理。

‍

‍

从2020年12月8日开始，iOS应用程序的发布者将需要定义其应用程序收集的数据，包括集成的第三方SDK（例如Chartboost）收集的数据。为了促进这个过程，我们披露了Chartboost数据收集如下。

您可以在此处找到有关苹果数据收集披露目的的更多信息。

以下披露仅包括我们的SDK收集的数据。您负责为您的应用程序提供任何其他披露，包括您的应用程序中使用的其他第三方SDK。本文档仅供您参考；Chartboost不对此类信息（包括但不限于其准确性或完整性）作任何陈述。

‍

‍

‍

‍

‍

更改大约需要一小时左右才能生效。

您是否设置了过高的eCPM底价？高的eCPM底价会导致较低的竞价率，最终会导致较低的填充率。

• 为了确保不同的广告主（需求方）同时对您的广告库进行竞标，您需要在 App 里集成 SDK 以及在 Helium Dashboard 进行正确的配置。
• 您需要确保在 SDK 集成时使用了正确的 Helium AppID 和签名，以及使用了与 Dashboard 设置相同的广告位。在后台 Dashboard 中检查，确保您的 App 和广告位均处于打开状态。

• iOS：Mediation iOS SDK 将使您的最终 App 包体下载大小增加约 1MB。
• Android：Mediation Android SDK 将使您的最终 App 包体下载大小增加约 393KB。
• 有关 Demand 端合作方 SDK 大小，您可以在此处找到 Chartboost SDK 信息和 Tapjoy SDK 信息。

• 可以。您可以在广告位置设置中设置 eCPM 底价。您可以设置全局 eCPM 底价，也可以为各个国家设置不同的底价。eCPM 底价设置决定了 Mediation 提供广告所需的最低 eCPM。
• 需要注意的是，设置较高的 eCPM 底价极有可能会降低填充率。

管理广告组

1. 点击 "New Ad Group +" 添加新的广告组。
2. 填写广告组的名称，使其在所有广告组中更易识别。
3. 选择您希望包含在此广告组中的国家。
4. 点击“+ Add a line item”，可以创建新的 line item 条目，或选择与此广告组的 Placement 广告类型匹配的现有 line item 条目。
   
   i. 为了创建一个新的 Line item，您需要先选择广告网络，填写 Helium Line item 名称和与第三方平台保持一致的 Placement 名称，并填写 CPM 底价。
   ii. 第三方广告网络的 Placement
   a. AdColony: Zone ID
   b. AdMob: Ad Unit ID
   c. AppLovin: Zone ID
   d. Chartboost: Named Locations
   e. Meta Audience Network: Placement ID
   f. Tapjoy: Placement Name
   g. Vungle: Placement Reference ID
   h. ironSource: Instance ID
   i. Unity Ads: Placement ID
   ‍
5. 将 Helium Placement 与此广告组关联。
6. 如果您是从某个 Helium Placement 页面直接进入创建广告组的话， 那么该 Placement 会自动与广告组关联。
7. 如果您是在广告组页面直接创建新的广告组，那么您需要从现有的 Placement 选择一个，使其跟广告组关联起来。

‍

广告位的基础设定

1. 点击“New Placement +”创建新的Helium广告位。
2. 选择广告位类型（插屏或激励视频）
3. 填写广告位名称。您可以从下拉菜单中选择预定义的广告位名称，也可以填写自定义广告位名称。自定义广告位名称中不应超过50个字符。只允许数字、字母、连字符，不允许使用空格或其他特殊符号。
4. 您在此处填写的广告位名称将用于Helium SDK集成，请仔细选择或者填写。

‍

广告位的高级设定

广告素材类型

• 默认情况下允许所有广告素材类型。对于插屏广告位，允许展示静态、视频和试玩广告。对于激励视频广告位，允许展示视频和试玩广告。
• 允许所有广告素材类型将有助于最大化您的收益。
• 但是，如果您有强烈的偏好屏蔽掉某些广告素材类型，您可以禁用“Allowed All Creative Types（允许所有创意类型）”，并选择要允许的广告素材类型。

‍

A/B 测试

• 可以针对 Helium 广告位启用 A/B 测试。
• 在设置完 Helium 广告位的头部竞价网络和聚合瀑布流后，再启用 A/B 测试，效果会更佳。​​
  
  ‍

头部竞价设置

eCPM 底价

• 如果您在 Helium 广告位中仅使用头部竞价，则可以通过设置全局 eCPM 底价或在特定国家启用 eCPM 底价。
• 针对特定国家级别的 eCPM 底价优先于全局 eCPM 底价。对于没有国家级别 eCPM 底价的国家，Helium 将使用全局 eCPM 底价。
• 如果您在此 Helium 广告位中同时使用头部竞价和聚合瀑布流，则不应启用 eCPM 底价，这样的话，参与头部竞价的网络会与聚合瀑布流中所有广告请求返回的价格进行竞争，最终才能以最佳价格展示广告。

⚠️ 注意

设置更高的 eCPM 底价将会大概率降低填充率。

‍

头部竞价网络

• Chartboost：Chartboost App ID和App Signature已经自动填写。
• Meta Audience Network：您需要填写Meta Audience Network Placement ID。
• AdColony：您需要填写AdColony Zone ID。
• Tapjoy：您需要填写Tapjoy Placement Name。
  ‍

📘提示:

请确保在 Helium Dashboard 填写的凭据与各自广告网络后台 Dashboard 的信息一致。

请确保所有头部竞价的广告网络是开启的状态。

‍

瀑布流

• 您可以在聚合瀑布流中添加现有的广告组或者添加新的广告组。
• 每个广告组里显示的分层信息，都是源自各个聚合广告网络。

添加头部竞价网络

‍

Chartboost

• 当您选择添加Chartboost时, Chartboost App ID and App Signature 会自动填充。

‍

Meta Audience Network

• 您需要填写 Meta Audience Network App ID 和 System User Access Token.
• 要获得 Meta Audience Network App ID, 请前往 Meta 后台该 App 的属性页面。​​
• 点击应用程序旁边的信息图标 ( Info Icon )。
• 为了生成系统用户访问令牌 ( System User Access Token), 您可以遵循 Meta Audience Network Instructions.请确保为您的应用程序选择read_audience_network_insights作为可用范围，并点击“生成令牌” ( Generate Token )。

‍

AdColony

1. 您需要填写 AdColony App ID 和 API Key.
2. 可以在 AdColony 后台的Monetization > Apps 找到 App ID。
3. API 密钥可以在账户设置页面找到。

‍

Tapjoy

1. 您需要填写 Tapjoy SDK Key, mediation reporting API Key 和 Publisher OAuth Key.
2. Tapjoy SDK Key 可以在 Tapjoy 后台相应的 App 的 Settings > App Settings 里找到。 请注意，每个应用程序/平台组合都有自己的 SDK Key (Instructions).
3. Mediation reporting API Key 可以在 Tapjoy 后台 SDK Key 相同的页面出找到。然后回到 Helium 后台，只需跳转到 “Mediation Keys” 选项卡填写即可。
4. Publisher OAuth Key 可以在 Tapjoy 后台 SDK Key 相同的页面出找到。然后将它填写到 Helium 后台的 “API Keys” 选项卡的 OAuth Key 栏目下。

‍

添加聚合广告网络

‍

Admob

为了更快地获取 AdMob 的单独凭据, 您可以登录到下面链接的 Google API credentials portal。你依然需要输入 AdMob App ID, 以及输入该 App ID 相关联的 Google 账户进行验证，以此添加 AdMob 应用程序到 Helium. 除此以外您不需要填写其它字段。

1. 您需要输入 AdMob App ID, API Key, Client ID, Client Secret, Refresh Token
2. AdMob App ID 可以在您 AdMob 账户后台该 App Settings 下找到。
3. 要生成 API Key, 您可以遵循一下规范 AdMob instructions。
4. 您需要在这里 Google API Console page first 创建一个新的项目。
   跳转到 “Get Started” 栏目并选择 “Enable APIs and get credentials like keys”.
5. 然后跳转到左侧的 “Credentials” 并选择 Create Credentials > API Key.
6. 您可以在 Google API Console页面找到 Client ID 和 Client Secret。
7. 在选定的项目里，跳转到 Credentials > OAuth consent 标签栏，在 “Product name shown to users” 填写产品名称然后点击保存按钮。
8. 跳转到 AdMob 后台 Dashboard > ENABLE APIS AND SERVICES, 并打开 AdSense Management API.
9. 然后选择 Credentials > Create Credentials ，同时选择  “OAuth client ID”。
10. 选择 Web application 然后在 “Name” 填入名称. 您需要进入 https://developers.google.com/oauthplayground 去验证至少一个重定向的 URI.
11. 点击保存按钮以后您就可以获得 “Client ID” 和 “Client Secret” 了。
12. 您可以在 OAuth 2.0 Playground page 获取 Refresh Token。
13. 在右上角的设置区，选择 “Use your own OAuth credentials” 然后添加您的 Client ID 和 Client Secret。
14. 回到 “Step 1 Select & authorize APIs”, 点击 “AdSense Management API v1.4”, 选择 "https://www.googleapis.com/auth/adsense.readonly", 参考"https://www.googleapis.com/auth/admob.report" ，输入您使用 API 的目的, 然后点击 “Authorize APIs”.
15. 当你收到第一步中生成的 Authorization code 以后, 您可以点击 “Exchange authorization code for tokens” 然后获取一个第二步产生的 Refresh token。

AppLovin

1. 您需要填写 AppLovin SDK Key, Package Name 和 Report Key.
2. 您可以在 Account > Keys 页面获取 SDK Key 和 Report Key。

Vungle

1. 您需要填写 Vungle App ID 和 Reporting API Key。
2. Reporting API Key 的位置在 Vungle 后台 Dashboard 的右上角。

ironSource

1. 您需要填写 ironSource Application Key, Secret Key 和 Refresh Token。
2. 您可以在 ironSource 后台 Dashboard 的 ‘My Account’ 栏目下的 ‘API Details’ 找到相关的信息。

Unity Ads

1. 您需要填写 Unity Game ID, Monetization API Key 和 Organization Core ID.
2. 您可以在你的 Unity Ads 账户后台的 ‘Monetization Settings’ 栏目下找到相关信息。

⚠️开始之前

确保你的应用程序已经在 Chartboost 后台 Dashboard 上已经通过审核并处于开启状态。如果没有，请先在 Chartboost 后台 Dashboard 上设置您的应用程序（请参考以下说明）

• 在 Helium 后台应用程序页面上点击  Add Helium App 
• 您可以通过名称或 Chartboost AppID 在搜索框中搜索应用程序，或者直接在下拉菜单中进行选择。选择正确的应用程序后，点击导入按钮以确认把 Chartboost 应用程序导入 Helium 后台。

📘 注意

目前仅支持在 Helium 后台上导入 iOS 和 Google Play 应用程序，不支持 Amazon 应用程序。

• 在单个应用程序概述页面上，请确保应用程序处于开启状态。该应用程序的基本信息会自动导入到 Helium。

我可以在 CPM 方式的广告推广活动里使用 Flexbid 吗?

不能。您不能在 CPM（按千次展示结算）方式的推广活动里使用 Flexbid，它只能以 CPI （按安装激活结算）方式运行。

我可以在同一个广告推广活动中使用多个 Target 吗？

可以。您可以照常保留 Campaign 的设定。如果您每个 Campaign 只有一个 Target 目标，Flexbid 会在当前可用的 Target 上生效。当 Campaign 中存在多个 Target 时，Flexbid 只会应用于您在 Flexbid 配置文件中指定的 Target 上。如果您希望 Flexbid 应用于所有 Target，您需要在 Flexbid 配置文件中针对每个 Target 进行设置。

Flexbid 可用的竞价维度是什么？我应该使用哪个？

取决于您的 LTV 模型，您可以在更多的维度进行弹性竞价。请确保您的竞价策略与您的 LTV 模型相匹配。通过分析您的用户数据，决定您希望使用 Flexbid 竞价的维度，从而达到价值最大化。您可以在一个 Flexbid 里选择使用下列四种维度中的一种或多种。在一个 Flexbid 推广活动中，我们对单个维度下使用的 Key-Value （分类标记以及具体的弹性系数）的数量没有任何限制。

Flexbid 使用的竞价维度都有哪些？

• 基于开发者 App
• 您可以直接面向特定开发者的 App 进行竞价。
• 基于国家
• 您可以直接针对不同的国家进行竞价，对于高价国家使用高倍率的系数，对于底价国家使用低倍率的系数。
• 基于设备的操作系统
• 传统的竞价方式是对所有的移动设备一视同仁，而通过 Flexbid，您可以针对操作系统进行区分，针对高版本操作系统的设备采用高倍率竞价，对低版本则使用低倍率竞价。由于低版本设备的价格竞争并不是很激烈，所以您可以用较低的成本赢得展示的机会。
• 基于设备的硬件模块
• 您可以针对设备的硬件模块的版本（iOS 和 Android）来设置不同的竞价价格。

针对每个竞价维度下的价格弹性系数，我该如何设置?

弹性系数的取值在 0.01 到 25 之间。每个广告主会根据自己的推广目标和预算，设置不同的弹性系数。使用 Flexbid 竞价需要您时刻关注您的用户数据，每周定期进行优化，才能产生最佳效果。 下面的范例将展示 Flexbid 的工作方式以及您最终需要支付的价格： 您的弹性系数设置: Bid by publisher app: （基于开发者的 App 维度）

• Publisher A – 2.0
• Publisher B – 1.5
• Publisher C – 1.2

Bid by devices: （基于设备维度）

• iPhone X – 2.0
• iPhone 8 – 1.5
• iPhone 7 – 1.0
• iPhone 6 – 0.75
• iPhone 5 – 0.25

当广告主的在开发者 A 的 iPhone 5 设备上展示一次，同时带去一个安装，那么广告主需要为这次安装支付的价格为：Campaign Bid (CPI) 默认安装价格$1.00Bid dimension – Key values 竞价维度Multiplier ValuePublisher app – A2.00Device – iPhone 50.25Flexbid CPI Bid （最终价格）$0.50为了简单说明，我们在上述范例里仅使用两个弹性系数，实际应用中您可以使用任意多个，我们没有特殊限制。你设定的每个弹性系数都将与你在推广活动中的 CPI 基础竞价进行相乘，在上述案例里，最终的竞价价格为 1 x 2 x 0.25 = $0.50. 通过这个范例，您可以看到 Flexbid 可以将您的 CPI 推广活动变成弹性的竞价，或高于，或低于您设定的基准价格。从而帮助您实现效益最大化。

如何在一个已有的推广活动里添加  Flexbid?

在 Chartboost 后台菜单的的  Campaigns > Advertising 下可进行设置。 注意: Flexbid 只能应用于 CPI 模式的推广活动。

如何对修改现有的  Flexbid 推广活动？

修改现有的 Flexbid 推广活动跟新建 Flexbid 类似，所有新设定的数值直接覆盖原有部分，您的推广活动将重新按新数值运行。需要注意的是，您在 Flexbid Excel 模板文件里设定的数值，必须与您选定的维度相匹配，否则这些数值不会在 Flexbid 里生效。

我找不到我想要的设备类型，怎么办？

您下载的 Flexbid 模板文件里包含 Flexbid 支持的各个平台的设备列表。如果里面没有您想要精准投放的设备，请 联系我们 ，我们会考虑您的需求提供技术支持。

我需要多久更新一次我的 Flexbid 推广活动？

您需要收集尽可能多的数据来进行分析，才能使投放越来越精准，我们建议您至少每隔一周修改一次 Flexbid 推广活动里的数值设定，以达到持续优化投放效果的目的。

如何查看 Flexbid 推广活动的效果？

您需要等待几周的时间来观测 Flexbid 推广活动的效果。您可以在推广活动的统计界面或者第三方归因的报表里进行查看。

什么是Chartboost交流？

‍‍哪些定位选项可用来对Chartboost交易所的DSP？

‍‍哪些广告格式（创新型）都可以通过Chartboost交流？

‍‍其DSP合作伙伴并Chartboost一起工作？

‍‍我期待与Chartboost集成DSP。我从哪说起呢？‍我是广告客户，我想通过程序生成阿德·坎帕恩斯与Chartboost。我从哪说起呢？

什么是Chartboost交流？

该Chartboost Exchange允许广告客户通过实时竞价平台达到我们的全球观众。 DSP和他们的广告客户有机会获得应用内广告在全球拥有超过30万款移动游戏。 开始使用Chartboost交易所

▲返回页首

哪些定位选项可用来对Chartboost交易所的DSP？

在Chartboost交易所，DSP合作伙伴可以针对移动游戏类别，国家平台（iTunes或谷歌播放）和操作系统（IOS，Android的）阿德·坎帕恩斯。▲返回页首

哪些广告格式（创新型）都可以通过Chartboost交流？

该Chartboost Exchange支持最新颖的广告格式全能见度：

• 静态的插页式广告
• 影片插页
• 可播放的广告
• 奖励的展示位置（视频和playables）

查看我们的合作伙伴门户

所有广告的格式规范

▲返回页首

其DSP合作伙伴并Chartboost一起工作？

Chartboost与多家合作伙伴的需求。如果您想看到我们目前的合作伙伴，请访问： chartboost.com/ad-exchange.▲返回页首

我期待与Chartboost集成DSP。我从哪说起呢？

Chartboost今天积极整合新的合作伙伴。交换是建立在2.3的OpenRTB标准。如果您有兴趣开始使用Chartboost交流，请发送电子邮件至 adexchange@chartboost.com或访问 chartboost.com/ad-exchange.▲返回页首

我是广告客户，我想通过程序生成阿德·坎帕恩斯与Chartboost。我从哪说起呢？

Chartboost目前与多个合作伙伴的需求。如果您是广告客户，并希望您的DSP合作伙伴或代理商与我们的网络中工作，请访问：chartboost.com/ad-exchange.

▲返回页首

什么是Chartboost Exchange？

该Chartboost Exchange允许广告客户通过实时竞价平台达到我们的全球观众。 DSP和他们的广告客户有机会获得应用内广告在全球拥有超过30万款移动游戏。 开始使用Chartboost交易所

▲返回页首

如何在Chartboost Exchange 进行流量变现？

对于变现方来时，Chartboost Exchange意味着接入更多的广告主需求，增加有效每千次，和更高的填充率造成提升收入。集成最新的Chartboost SDK，您会立刻受益。 下载最新的SDK

了解更多关于Chartboost交易所

▲返回页首

Chartboost 视频常见问题

什么是 Chartboost 视频？

Chartboost SDK 让您可以强化玩家的游戏体验，提供引人入胜的优质视频广告，支持富媒体。作为开发者，您对视频广告全权控制，一切透明，通过 Chartboost 后台实现。集成 Chartboost 视频

是什么让 Chartboost 视频广告如此优秀？

• 对优质视频、GIF 动画及其他富媒体的支持。
• 无缝、快速以及自定义广告体验。
• 对展示次数、点击数、安装数及其他的详尽报告。
• 高级广告活动定位、筛选和优化以实现更高 eCPM。
• 免费实施。

何为激励式视频？

激励式视频是一种广告类型，玩家观看视频广告后得到奖励 (例如游戏内货币)。激励式视频可以为媒体提供额外收入来源，为广告主带来优质而且专注的用户。

需要什么视频编码和尺寸规格？

视频必须使用 H.264 编码且最低分辨率为 1280 x 720，适宜绝大多数设备的最佳编码为 H.264, 30-60 FPS, M4V, 1280 x 720。了解广告图片素材详情

视频广告质量如何？

系统使用专利技术以实现最佳质量，极高反应速度，无论网络连接如何均能提供可靠的高清回放。

视频广告应该多长？

平均视频通常介于 15 到 30 秒 (建议保持在 15 秒以下)。Chartboost 视频广告可以持续 30 秒。用户有选项在播放 5 秒后跳过视频。

如何在激励式视频广告中关闭播放前和播放后信息？

• 选择应用然后前往应用设置 > 激励式视频。
• 前往高级设置。
• 取消选择显示播放前确认和显示播放后确认。

Chartboost 视频广告需要多大花费？

SDK 集成 Chartboost 视频是免费的！视频计费基于每观看完毕成本 (CPCV) 或每安装成本 (CPI)。了解 Chartboost 价格。

是否能用 CPI 视频广告来推广我的付费游戏？

否，付费游戏仅可使用 CPCV。

您可能还希望…

• Chartboost 视频
• 播放归属
• 如何开始广告活动？
• Chartboost 需要多大花费？

▲ 返回顶部

Callback 回调常见问题

Chartboost 为什么类型的事件提供数据传输?

点击、转化安装和完成查看。可能包括点击您的发布应用的插页式广告或点击网络广告为您游戏所做的广告。

那“更多应用”页面的点击和转化安装呢？

Chartboost 只为您加到“更多应用”页面的广告活动发送数据传输，不针对应用单独进行。

Callback 回调会在何时发送？

数据传输几乎在事件发生之后立刻传送。所有数据发送前均经过 URL 编码。

什么数据不在 Callback 回调中发送？

• 原始 MAC 地址
• 分布数据

如何找到用户 ID 和用户签名？

您可以在后台 API 浏览器页面顶部找到您的用户 ID 和用户签名。

随时点击即可重置您的用户签名并吊销第三方服务的 API 访问权限。

点击

以复制您的用户签名到剪切板。

如何下载我的数据分析？

在监控帐户方面，您有若干不同选项。广告概述和发布概述页面均提供一览图以便轻松了解趋势。更多信息

如果您需要查看更详尽的报告，请前往应用 > 数据分析或广告活动 > 数据分析，并下载 CSV 格式数据以供 Excel 或其他程序使用。更多信息

数据分析和 API 结果采用何种格式？

• 数据分析报告采用时区为太平洋标准时 (PST)。
• 从我们的 API 返回的数据分析报告大多为 JSON 格式。
• （从2022年5月22日起 生效日期已推迟，将另行通知）来自广告活动端点以国家或广告活动分组的请求、一切针对导出安装端点的搜索，均以 CSV (逗号分隔值) 返回。注意：当单元格数据为空或者单元格数据值包含逗号时，单元格数据将包裹在引号内，其余情况下单元格数据将不使用引号包裹。(示例: data_value1, “”, “iPhone13,4”).
• 所有报告均已 UTF-8 编码以妥善显示非拉丁字符。
• 如果您对从 Chartboost 获取的数据分析进行程序性更改，您可能需要更新您的系统以顾全 逗号分隔。
• 数据分析报告在 Excel 或其他数据表软件中依然可以正常打开。

为何我的游戏看不到任何启动数或安装数？

别紧张 — 启动数/安装数及其他数据可能需要 2-3 小时方可显示在后台 (尽管通常更快)，请在延迟后重新查看您的应用数据分析或广告活动数据分析。

您还可以检查此状态页面以了解分析数据上次在后台更新是什么时候。

如果您仍然无法看到启动数/安装数，请检查您的代码是否正确进行以下调用:

• iOS 游戏: [Chartboost startWithAppId:@"YOURAPPID" appSignature:@"YOURAPPSIGNATURE" delegate:self];
• Android 游戏: Chartboost.startWithAppId(this, "YOURAPPID", "YOURAPPSIGNATURE");
• 使用 Unity 生成的 iOS 游戏: CBBinding.init(“YOURAPPID”, “YOURAPPSIGNATURE”);
• 使用 Unity 生成的 Android 游戏: CBBinding.init();

系统需要在每次激活您的游戏时接收到这些调用方可准确跟踪启动数/安装数。

什么是数据传输？如何添加？

数据传输是服务器到服务器的事件通知，报告您的广告活动所带来的点击或转化安装的详情。如果您长期无法使用后台报告工具，建议您设置数据传输以接收大量数据。更多信息

是否会一次下载过多数据？

大型数据分析报告会在系统处理数据后自动以 TSV 格式返回，但如果您长期无法下载文件，推荐您使用数据传输或 API 以汇报数据到第三方服务器或系统。

是否可以按国家查看我的广告活动表现？

• 前往您的 Chartboost 后台的广告活动数据分析。
• 从分组条件下拉菜单中选择国家。
• 按角色和广告活动类型筛选您的结果。
• 点击

• 以到处您的数据到电子表格。
• 您还可以获取定时电子邮件报告按照国家分组，或点击进入 Chartboost API 以获取自定义数据分析。
• 了解数据分析报告详情

为什么我的 Chartboost 安装数跟 iTunes Connect 不符？

有若干个因素可能导致 iTunes Connect 安装计数和 Chartboost 计数存在差异:

以下为常见原因:

• iTunes Connect 基于 Apple ID 报告安装数，而 Chartboost 则使用唯一设备标识符。也就是说如果某设备安装多次，均会在 iTunes Connect 中显示，而在 Chartboost 中则只显示一次。
• iTunes 在游戏安装完毕后立即 (甚至还未启动) 记录安装数。而 Chartboost 则要求游戏至少启动一次，具备可靠互联网连接和恰当 SDK 集成。
• Chartboost 报告依照 PST/PDT (UTC-8 小时/UTC-7 小时) ¹，而 iTunes 报告则取决于开发者位置。iTunes Connect 使用时区如下:
• 为美国、加拿大和拉美的开发者使用 PST/PDT
• 为欧洲、中东、非洲和亚太地区使用 CET
• 为日本使用 JST
• 为澳大利亚和新西兰使用 WST

如需了解 iTunes Connect 报告详情，请点击此处。

所有安装数、启动数、唯一用户 (设备) 数、传递安装数和接收安装数有何区别？

• 所有安装数: 该数据指系统接收到您的游戏初始化调用次数，通常包括并非由 Chartboost 接收的安装数。
• 启动数: 来自 Chartboost SDK 的调用，每次用户在设备启动您的应用后即会注册。
• 唯一: 启动您的应用的唯一设备的数目。此数目为每应用每天的唯一设备数。唯一数不可以跨应用或用天数叠加，因为这样会产生设备重复，导致数据膨大。唯一数的准确性取决于开发者是否将应用启动数 100% 发送给 Chartboost。
• 传递安装数: 或 installDelivered发布活动期间用户在初次启动应用前奠基广告的次数。
• 接收安装数: 用户点击您的广告、交叉推广或直接交易广告后首次启动您的游戏的次数。

我是否会收到媒体收入的每月发票？

否 – 系统只向广告主发送发票。媒体会接收自动支付和电子邮件确认。

需要预留多少用作纳税？

Chartboost 并不扣留金额用作纳税。不过您需要符合当地税则。

我所接收到的媒体收益与后台不符。

通常，差异是由于您所选择的支付方式造成的:

• 对于 USD 电汇，有 $25 电汇费。(还请与您的银行沟通，了解银行收取的费用。)
• 对于非 USD 电汇，我们收取 $25 电汇费和 3% 换汇费用。(还请与您的银行沟通，了解银行收取的费用。)
• 对于 PayPal 支付，系统收取 4.0% 最多不超过 $25 的手续费。
• 对于纸质支票和 eCheck/当地银行转帐/全球 ACH，有 $10 手续费。

如何在公司所在地以外国家接收款项？

请发送请求到 payments@chartboost.com 我们会为您设置帐户！

为什么我的广告活动已经暂停了，但我仍然被收取安装费？

• Chartboost 广告缓存 时长是24 小时。广告暂停之后，缓存的广告仍会在后续 24 小时内提供给用户。
• Chartboost 使用21 天归因窗口。用户点击您的广告后，有 21 天的窗口期下载并安装您的 App。在此期间实现的安装都将收取您的费用。
• 加上 24 小时的缓存和 21 天的归因窗口期，暂停广告活动后，您可能会看到 22 天的安装费用。

▲返回页首

我可以在 Chartboost 网络中使用聚合 SDK 做广告吗？

是的！可以使用服务器到服务器（S2S）追踪进行安装归因。

▲返回页首

批准广告活动需要多长时间？

它需要24 至 48 小时是否批准广告活动，取决于广告活动本身。

▲返回页首

Chartboost 提供什么竞价类型？

在 Chartboost，您可以通过多种方式竞价：

• CPI（每次安装费用）竞价是让您指定您愿意为通过点击推广您的游戏的广告而发生的安装进行付费的最大金额（现在可用于插播视频！）
• CPC（每次点击费用）竞价代表您愿意为通过点击推广您的游戏的广告而支付的最大金额
• CPCV（每完成查看费用）竞价是让您为奖励或观看插播视频而支付规定的最大金额。
• CPM（每千次展示费用）竞价让您基于您广告显示的次数付费。

CPM 广告活动不再提供 InPlay 广告.

竞价类型教程视频

▲返回页首

我应该如何针对点击或安装竞价？我应该在广告活动上花费多少钱？

• 开始积极竞价，然后再根据您所获得的流量，来调整您的出价。
• 逐渐调低竞价会比调高竞价更符合成本效益，因为低报价负面影响您的 eCPM。
• 使用Chartboost Insights查看全球 CPI 报告，并做出更明智的出价决策。
• 优化广告活动瞄准正确的用户，获得更多收益。
• 了解如何避免超出预算

• 详细了解出价类型

• 有很多的广告活动？那就同时调整竞价！可以在后台控制面板中使用批量编辑，选择要编辑的广告活动，并输入新的竞价价格。

▲返回页首

我可以使用 Chartboost 向中国的 Android 用户营销吗？

可以！有一些事情您应该知道：

• 如果您的 App 中没有 Google Play 网址，将创意上传到广告活动时您必须使用广告素材网址。这些广告素材网址适用于所有竞价类型。
• 广告商必须在广告活动中输入营销网址。可以随意使用营销网址获得耀眼的提升。有史以来最伟大的游戏。无论您使用哪个营销网址，广告素材网址都将覆盖它。
• 如果您的 App 已在多个中国本土的 App 商店，你需要创建单独的定向广告活动，针对每个 App 商店使用设备定向。您还需要上传带有单独广告素材网址的单独广告素材集合。

▲返回页首

请求 S2S 安装跟踪的按钮在哪里？

如果您看不到请求S2S 安装跟踪的后台控制面板按钮，请尝试以下操作：

• 在您的 App 上添加并附加回调或者添加至所有广告活动。
• 刷新浏览器。

还没看到？请告诉我们！

您可能还喜欢…

• S2S（服务器到服务器）追踪

▲返回页首

为什么 Chartboost 拒绝了我 S2S 安装跟踪请求？

• S2S 跟踪是一个仅供免费游戏使用的广告活动类型。如果您希望宣传付费 App，请使用 CPC 广告活动。
• 您必须添加点击回调将 Chartboost 的点击访问报告给您的第三方归因平台。
• Chartboost 要求回传成功转化的安装。请确保您发送所有会话和已转化安装的第三方归因平台是否符合要求。

您可能还喜欢…

• S2S（服务器到服务器）追踪

▲返回页首

CPC 和 CPI 广告活动之间有什么不同？

CPI或每次安装费用活动侧重于使用初始点击保留用户并鼓励他们定期体验您的游戏。CPI 广告活动依靠于基于 ROI 的营销、用户质量、玩家百分比和其他 KPI。

CPC或每次点击费用广告活动通常侧重于品牌曝光，可能不会深入了解用户经过初始点击之后的动作。当您尝试让用户“口碑相传”您的游戏时，CPC 广告活动很有用。

您可能还喜欢…

• 广告活动：将您的游戏向潜在的玩家炫耀一下

▲返回页首

我怎样才能获得更多的用户？

• 优化您的广告活动！
• A/B 测试您的广告素材以便获得表现最好的展示！
• 过滤掉那些与您的广告互动不好的游戏玩家。
• 首先积极竞价使用目标定向以不同的方法到达不同的市场和设备。

▲返回页首

我怎样才能避免超出预算？

• 优化广告活动更好的定向于用户，最大限度地提高您的潜在覆盖。这样可以让你获得最大的产出。
• 设置电子邮件通知在您即将到达预算限制时通知您。
• 每日预算 $500 以下经常会很快用尽并且超预算.
• 花费超过您帐户中的资金将导致负余额。您将无法发放广告，直到您向您帐户添加更多资金。

Chartboost 有 21 天安装归因窗口期。如果某位用户在 21 天内首次点击了促销您 App 的广告，费用将从您的广告帐户中扣除，即使您的 CPI 广告活动已经停止展示。

Chartboost 有 7 天点击归因窗口期。如果用户点击了您的广告，您 CPC 广告活动停止展示之后最多 7 天的费用将从您的广告帐户中扣除。

探索更多…

• 我应该如何竞价点击或安装？我应该在广告活动上投入多少？
• Chartboost 提供什么竞价类型？

▲返回页首

什么是 eCPM？为什么它对广告主很重要？

eCPM 是我们的系统用来决定哪个广告活动投放到特定的广告活动发布的重要指标。由于 Chartboost 广告主对每次点击或安装（而不是每次展示）出价，Chartboost 的 eCPM 是广告活动的安装率（IR），点击率（CTR）和竞价的组合，反映了广告活动的整体竞争力。所以广告表现越好，您就能获得更高品质的流量。更多优化信息

▲返回页首

可以估算出某个竞价能够产出多少次的点击或安装我的游戏吗？

因为我们的网络是动态的 – 每天都有新的开发者加入我们 – 因此很难预测。请记住，您获得的流量也取决于您的 eCPM（IR、CTR 和竞价的组合），所以很难通过简单的竞价估算出点击和安装数量。 我们可以和您一起优化您的广告活动，您也可以使用您帐户的报告工具识别和了解一段时间内的趋势。

▲返回页首

我的广告活动如何获得更多点击、安装或完整的查看？

在我们的系统检索符合发布广告的设定标准的广告活动时，它将把表现最好的广告活动展示在发布游戏中。 我们使用eCPM指标评估表现，通常定义为每千次有效展示服务费用（eCPM =费用或收益/展示次数 * 1000）。但由于 Chartboost 广告主竞价每次点击或安装（而不是每次展示），Chartboost的 eCPM 是安装率（IR）、点进率（CTR）和竞价的组合，反应了该广告活动的整体竞争力。 收益表：广告效果越好，您越能获得更多高品质流量。 有关用来提升您的绩效并最大化 ROI 的提示信息，请访问我们广告文档的优化部分这里。

▲返回页首

什么是展示归因（VTA）？

展示归因允许您追踪用户观看视频广告后，即使未点击广告但在较短时间段内安装您 App 的安装记录。

• 捕捉您 UA 广告活动与传统最后点击方式的对比的真实状况。
• 更多的安装量意味着更高的 eCPM，它可以帮助您的广告活动在 Chartboost 网络中更具有竞争力。
• 当用户观看进度 90％以上 的视频广告时，就计算为一次完整观看。

您可能还喜欢…

• 服务器到服务器（S2S）追踪
• 回调
• Chartboost 视频广告

▲返回页首

如果我在“广告活动编辑”页面上的“要推广的 App”中没有找到我的游戏怎么办？

在“要推广的 App”下拉列表中选择您的游戏之前，您需要执行一些操作：

• 检查iTunes 网址、市场网址或亚马逊网址，这些字段在“App 设置”页面（如下图所示）设置完整并指向您的游戏商店列表：

• 要确保您已经上传了推广您游戏的广告素材。更多信息

另外请注意，如果您要保存网络广告活动，您的帐户余额必须大于或等于广告活动的每日预算。要增加资金或从您展示收益中转钱，请点击这里。 仅交叉推广活动：如果您要设置一个交叉推广，并尝试在有可选退出的 App 内宣传一个没有可选退出行为跟踪的 App，要推广的 App下拉列表中不会显示要发布的 App（拥有可选退出），反之亦然。只有有可选退出的 App 可以在其他有可选退出的 App 中推广。

▲返回页首

什么是安装归因窗口？

若要将某个安装归属到您的广告活动，用户必须在点击您的广告后 21 天内启动您的游戏。每次我们系统收到您游戏的初始化调用时，我们将记录启动，所以请确保您 App 中每次调用时代码都可用。

▲返回页首

Chartboost 是否支持激励安装？

对不起，我们不支持激励安装。

▲返回页首

iOS 限制广告跟踪会如何影响我的广告活动？

• 广告会不显示在 iOS 10 以上版本的设备上，如果发布者正在运行低于 Chartboost iOS SDK 6.5 版本。请立即下载最新的 Chartboost iOS SDK！
• 此外，广告活动中促销中的 App 必须使用兼容的第三方归因服务。如果广告 App 没有使用兼容的第三方归因服务，将无法向具有限制广告跟踪的 iOS 10 设备发放广告，即使宿主发布 App 正式使用 Chartboost iOS SDK 6.5 或更高版本也不行。这同样适用于交叉推广活动.

▲返回页首

我如何知道能从我的广告活动中筛选出哪些 App？

我们 强烈推荐让 Chartboost 决定您的广告活动中显示哪些 App。只有当您出于商业原因（如竞争或类似的 App）时才需要筛选 App，请按照以下说明操作。

以下是如何使用 Microsoft Excel 筛选 App：

• 前往您后台控制面板上的广告活动数据分析面板。
• 从“按广告活动或 App 筛选”下拉列表中选择广告活动▼：筛选按广告活动或应用程序。
• 使用文本字段搜索和选择要分析的广告活动。
• 从“时间范围”下拉框中选择时间段。我们推荐最近 7 天。
• 在“群组方式”下拉列表中将广告活动▼更改为App▼
• 点击刷新按钮即可生成报告。
• 点击下载按钮将您的数据导出为一个 TSV 文件。了解更多关于报告格式的信息

• 在 Microsoft Excel 中打开 TSV 文件。
• 选择工作表中所有的数据，然后点击顶部菜单中的数据 > 透视表。
• 添加至 App 名称至行标签。添加展示总数，点击总数,已安装总数和收入总数至值.

• 计算eCPM使用公式=E5/B5 * 1000在 F 列的 F5 单元格中。然后将公式扩充到该列的其他行。您也可以将整列格式化为货币以便更利于阅读。
• eCPM 最重要，但是您也可能要考虑点击率（点击/展示）和安装率（安装/点击）。并非所有的 App 都追踪安装，所以如果有些显示 0 次安装不要紧张。
• 整体平均 eCPM 将显示在您新表的右下角。将此数据透视表复制到另一个工作表，按照 eCPM 排序可以轻松查看哪些 App 具有最低的相对 eCPM，继而从广告活动中筛选掉。
• 如果您想要筛选某个 App，请看一下它为您的 App 带来多少的展示份额或者在您的 App 中收到的展示份额。例如，某个 App 可能稍微低于您的平均 eCPM，但是贡献了较大比例的展示份额。您可能不希望将这个 App 从您的广告活动中筛选掉。如果您筛选过多的展示，您可能会无法填满您的广告资源。另一方面，很可能不值得筛选掉一大批只有很少展示的 App。
• 一旦您确定了要筛选哪些 App，点击下面的两个链接了解如何从您的广告活动中筛选它们。

我们建议您在单个广告活动中不要筛选超过 1500 个 App。

对后台控制面板的任何更改可能会花费最多 30 分钟生效。

如果您筛选掉某个 App 并且某个用户已经在他们的设备上缓存了那个广告，广告仍然会显示最多 24 小时。

▲返回页首

如果我找不到要筛选的 App 该怎么办？

请告诉我们！请包括您要删除的 App 的名称和 ID。

▲返回页首

我应该将已经应用的筛选保留多久？

因为网络中的情况经常发生变化，我们建议每过几周清理筛选，重新评估贡献低 eCPM 的游戏，然后排除新列表。您可能会非常惊讶两个组的差异。

▲返回页首

为什么我在游戏中看不到广告？

发布广告变现活动时观看广告的问题：

• 广告活动可能需要长达 30 分钟才能在 Chartboost 网络上显示。再次查看之前，请稍等片刻。
• 请确保自己正确将游戏添加至您的 Chartboost 后台控制面板，并开始发布广告变现活动。请参阅我们的入门指南，了解更多关于设置 Chartboost 的信息。
• 仔细检查您的SDK 集成。您的代码是否使用了正确的App ID和 App 签名？您也可以打开测试模式，验证您的代码是否能够正确调用展示广告。
• 请仔细检查您设备上的时间设置。错误的时间和日期可能会影响安全的网络通信。
• 如果您仍然无法看到广告，试着打开您的广告发布并删除所有可能会缩小广告触达目标，如设备筛选器或国家筛选器。请确保自己并未添加频率上限，限定每个用户、每小时、每个命名位置等的广告显示频率。移除所有非默认选项，保存该广告活动，等待 30 分钟再进行测试。
• 您可能采用低填充率测试某个国家。尝试在您的设备上使用 VPN 通过美国服务器连接至互联网。

在交叉推广活动中观看广告时出现的问题：

• 广告活动可能需要长达 30 分钟才能在 Chartboost 网络上显示。再次查看之前，请稍等片刻。
• 请确保自己正确将游戏添加至Chartboost 后台控制面板并开始交叉推广活动。请参阅我们的入门指南了解更多关于设置 Chartboost 的信息。
• 仔细检查您的SDK 集成。您的代码是否使用了正确的App ID和 App 签名？您也可以打开测试模式验证您的代码是否能够正确调用展示广告。
• 请仔细检查您设备上的时间设置。错误的时间和日期可能会影响安全的网络通信。
• 您的交叉推广广告可能遇到了方向问题。如果您的游戏 Buster’s Boost 使用横屏和竖屏运行，同时您正在交叉推广其他游戏 Buster’s Return，您必须为 Buster’s Return 上传横屏和竖屏的两种创意广告素材，以便在 Buster’s Boost 的广告中显示。请于素材上传30 分钟后再进行重新测试。
• 如果您仍然无法看到广告，试着打开您的交叉推广广告活动并删除所有可能会缩小广告触及面的定位，如设备筛选器或国家筛选器。请确保自己并未添加频率上限，限定每个用户、每小时、每个命名位置等的广告显示频率。移除所有非默认选项，保存该广告活动，等待 30 分钟再进行测试。

▲返回页首

我会在何时得到报酬？为什么我没有得到报酬？

我们尽量在当月最后一天支付您上月的收入，请参阅 付款条款和日期以了解更多信息。▲返回页首

我能在 Chartboost 上开展哪些类型的广告活动？如何开始广告活动？

发布广告活动：通过在您的游戏中发布其他开发者的 App 获得收益。开始赚钱

广告活动：通过在 Chartboost 网络上宣传您的应用程序来获得用户获得更多用户

交叉推广：在您的现有 App 中宣传新 App，完全零成本。开始交叉推广

▲返回页首

我没有集成贵公司的SDK， 可以为自己的应用程序做广告吗？

可以，但是…

• 您将只能运行CPC（每次点击付费）和CPCV（每次看完付费）的广告活动。
• 您将不能运行开展 CPI（每次安装收费）的广告活动。
• 您不能在用户点击展示后，对设备的安装情况进行追踪。
• 我们强烈建议集成我们的 SDK 或使用我们第三方合作伙伴设置S2S（服务器到服务器）追踪这些方法有助于您了解自己的目标受众，并使用硬数据实现利润最大化。

▲返回页首

如何测试我的 SDK 集成？

如果您已经通过 Chartboost 后台控制面板在游戏中设置广告发布，您应该能够通过模拟器从 IDE 或设备运行您的游戏，查看您的代码调用时显示的 Chartboost 广告。如果您有任何疑问…  

• 请确保您已遵循入门指南
• 启用测试模式，尝试查看我们的占位静态广告/激励式视频广告之一。如果您能看到这些广告中的一个，可能您已正确集成，但在活动层面有问题。
• 使用类似Charles 的网页调试代理，检查您的游戏是否正在对Chartboost进行正确的网络呼叫。
• 请使用 VPN。因为问题可能在于您正在从低填充率的国家测试广告活动，您可将设备添加至 VPN，模拟较高填充率国家的玩家体验。

▲返回页首

我的 App ID 和 App 签名在哪里？

• 请在 Chartboost 后台控制面板的左上角选择您的应用程序.
• 转至应用设置 > 基本设置.
• 您的 App ID 和 App 签名出现在您 App 图标的下方。

请为您的 App 签名保密！我们用它来确认您是应用程序 的所有者。

▲返回页首

Chartboost 的费用是多少？

交叉推广

在您自己的游戏中进行推广，完全免费！ 了解更多关于交叉推广的信息

网络广告投放和广告发布

广告投放：费用基于 CPI、CPC、CPM 和 CPCV 广告活动. 发布广告：您的收入基于动态的广告客户购买情况，具体取决于出价类型、广告格式和其他因素。 Chartboost团队利用机器算法和数据科学不断优化我们的网络，帮助发布商获得尽可能高的eCPMs（有效每千次展示费用）和总体收入。 了解更多关于投放广告的信息

了解更多关于广告发布的信息

▲返回页首

为什么我的 eCPM 很低？如何提高我的 eCPM？

• 您的流量可能较低。创建较低优先级的新广告活动，以测试您是否错过了任何高绩效广告商。尝试不同的广告定位，触及更合适的受众群体并提升流量。
• 您可能需要调整玩家在游戏中观看广告的方式。使用命名位置和自己的创意素材自定义显示广告的位置和方式。在您的游戏中让广告更加无缝流畅，可能会吸引玩家成功点击。
• 让数据分析帮助您确定如何操作。可访问您后台的发布概览页面，发现业绩趋势和玩家行为。您也可以下载广告数据分析，生成电子表格。
• 您的游戏中出现错误的广告类型？将它们筛选掉！

▲返回页首

Chartboost 要做什么，不做什么？

Chartboost 的目标是确保您拥有相应工具，通过货币化和获取用户来构建最成功的业务。保持网络平衡和健康意味着游戏发行商获得高eCPM，广告客户则获享高ROI（投资回报率）。 以下是一些最佳实践，可帮助您跻身高品质媒体，维护好自己的游戏。 在游戏中明智地使用广告：想一想您的玩家何时何地看到广告，参与的玩家能给您带来收入并有助于维持 Chartboost 平台的总体健康。尝试最新的广告格式，如激励式视频广告和动画GIF，为您的玩家提供尽可能好的体验。 务必保护您的帐户：确保您的密码安全，并对访问您帐户的用户数量进行限制。 确保所有提交广告均内容恰当，并且有您的知识产权（IP）：始终确保提交的广告素材远离淫秽内容（洁身自好！），合法使用自己的品牌、商标或知识产权（IP）。 确保您应用程序 的第三方服务也合法：您对任何授权访问您 Chartboost 帐户的第三方的行为负责。始终确保您与符合我们条件和条款的合法合作伙伴进行合作，并帮助您保持游戏健康。 上线之前应务必使用测试模式：这样，您便可查看可能出现在游戏中的任何广告，而无需跟踪使用中的任何不规范行为。 阅读更多请点击这里. 务必监控您广告投放和安装后的关键指标：可疑的高点击率和安装率可能是非人类流量的信号。此外，忽略 D7 留存和购买活动通常是欺诈信号。 务必在后台检查广告发布情况：Chartboost 使开发和运行变得非常简单。 虽然发布广告可能觉得无需监控，但最好检查一下游戏性能以及游戏为生态系统带来的广告资源质量。 请遵守所有应用商店和广告网络指南：请务必根据指南检查您的游戏、广告或用户，以确保您不会因为不适当的活动而被标记。这些指南可在任何网络服务条款中找到。请点击此处阅读 Chartboost 的条款和条件。 请联络 Chartboost 支持团队：如果您有任何问题，我们随时在您身边！从 Chartboost 如何运作到设置视频广告的最佳方式，我们的团队都会一路相伴。 不要激励用户点击或安装：短期来看，激励用户或许会增加收入，但实际上会带来低素质用户，这对于互动另一端的广告商而言很不公平。 不要使用机器人：Chartboost 不允许软件生成的流量。始终了解您流量的来源，并确保您正在使用值得信任的渠道来增长您的受众。 Chartboost 认真对待欺诈防范，请阅读更多内容，了解我们如何看待广告网络生态系统中的欺诈行为。 加入 Chartboost 网络时，您即同意我们的条款和条件。请在此阅读全文.▲返回页首

您的收入共享模型是什么？

您的收入基于动态的广告客户购买，具体取决于出价类型、广告格式和其他因素。 Chartboost团队不断利用机器算法和数据科学优化我们的网络，帮助发布商获得尽可能高的eCPMs（有效每千次展示费用）和总体收入。▲返回页首

我是代理，是否可以从 Chartboost 购买流量？

感谢您对 Chartboost 的兴趣！您应该先了解一些事项……

• 如果您想代表已在使用Chartboost的公司和应用程序开展广告活动，则需要开发者的书面同意。
• 如果您希望开展 CPI 广告活动，您必须直接将 Chartboost SDK集成到每个 App 中。如果您正在使用第三方安装归因，则无需集成该 SDK。
• 我们不是交易者，因此我们无法成为中间人或直接出售流量。

 如果您有上面未能回答的任何问题，请联系我们。

▲返回页首

Chartboost 支持什么类型的素材？

静态广告已是昨日黄花！信息量大、吸引人的动画 GIF比视频广告更紧凑，可显著提升您的 eCPM。试一试

高品质的视频广告以类似个性化建议的终端卡吸引玩家。 玩家观看视频后，用游戏中的好东西或虚拟货币对其进行奖励。入门指南

全屏静态广告仍然是吸引玩家注意力的最简单、干扰最少的方式

不要光看 – 试一试吧！好玩的广告是吸引游戏玩家、提高 eCPM 的最佳途径。了解更多

下载并整合 SDK

▲返回首页

Chartboost SDK 有多大？

Android：Chartboost SDK 比您最终下载的版本大约多出 700KB。

iOS 9.x +：Chartboost SDK 比您最终下载的版本大约多出不到 1.5MB。

iOS 8.x 及以下版本：Chartboost SDK 比您最终下载的通用版本大约多出不到 4MB。

实际的 SDK数据包下载文件可能大得多因为它包括示例代码和完整的 Chartboost 框架。这些文件大多可在编译后删除。

▲返回页首

我的应用程序不是游戏，还能使用 Chartboost 吗？

可以！您可以使用 Chartboost 做这些事情：

• 开始投放广告。以获得更多用户。
• 免费在您的其他应用程序中交叉推广您的 App。

▲返回页首

广告活动的优先级和逻辑是什么？它们如何运行？

• 如果您正在发布多个广告，Chartboost 会按照优先级顺序为广告服务，从最高优先级到低优先级，一应俱全。.
• 您可在广告活动的高级设置中选择优先级。

• 我们将尽可能多为最高优先级的广告活动提供广告。 当没有更多广告来投放该系列时，我们会转向下一个最高优先级。
• 如果两个广告活动拥有相同的优先级，则赋予其同等的显示广告的机会。
• 如果您的游戏使用命名位置，则选择自定义优先级。您可为游戏中独特节点出现的广告设置不同的优先级。

▲返回页首

Chartboost 是否支持 HTML5 广告？

对不起，Chartboost 目前不支持 HTML5 广告。

我们渴望收到您的反馈，如果您使用 HTML5 广告但希望得到我们的支持，请告诉我们！ 请查看支持的广告类型

▲返回页首

如何加快广告加载时间？

使用 缓存加快加载时间。▲返回页首

Chartboost 是否有已弃用或删除的功能或产品？

• 旧 iOS SDK 版本：Chartboost 已弃用 3.0.7 版本下的 iOS SDK。请查看您游戏Chartboost.h头文件中的版本号，以验证您的游戏可继续使用 Chartboost。获得最新版 SDK
• 旧 iOS SDK 版本：Chartboost 已弃用 3.1 版本下的所有 Android SDK。获得最新版 SDK
• MoreApps：MoreApps 已从后台控制面板中删除。

▲返回页首

如何从后台控制面板中删除某个应用程序？

• 在您的 Chartboost 后台控制面板中选择要删除的应用程序.
• 点击应用设置 > 基本设置.
• 点击右上角的大红色删除按钮。
• 点击继续确认删除。

删除应用程序为永久性操作！

删除的 App 将从所有广告活动或计划报告中删除。

如果已删除应用程序是广告活动中的唯一应用程序，

则广告活动将自动归档。

已删除 App 的数据分析在您的后台仍然可用.

▲返回页首

‍

Flexbid 工具是什么?

Flexbid 允许广告主针对不同的细分目标用户创建最匹配的广告推广活动。传统的 Chartboost 广告网络只允许单一的竞价策略，而 Flexbid 则允许针对不同的细分用户群采用不同的竞价策略。

Flexbid 的主要特性

通过 Flexbid, 广告主可以在更细的颗粒度上进行竞价，细分维度包括 开发者, 国家, 操作系统, 以及设备型号。从而锁定高质量的流量展示，提升广告效果。

Flexbid 带来的好处

1. 聚焦主要的竞价维度，从而提升广告效果
2. 全方位掌控竞价策略
3. 最大化每次广告展示的价值
4. 可通过 Dashboard 或者 API 轻松设置

如何使用 Flexbid 工具

➊在新的广告推广活动上添加 Flexbid

• 在 Chartboost 后台像往常一样创建一个广告推广活动，菜单 ‘Advertising > Advertising Campaigns> Add a campaign > Network Advertising’。
• 在 ‘Campaign Targeting’ 和 ‘Audience’ 栏目下，保持默认的设置，即选中 ‘Target all countries’, ‘Target all OS versions’ 和 ‘Target all device types’。
• 如果您对默认的设置进行过修改，使用 ‘Target selected countries’, ‘Target selected OS versions’, 或 ‘Target selected device types’, 则您在后续填写 Flexbid 模板设置时必须确保选中了相同的范围，详情请参考本文第六步。否则的话，Flexbid 会与您预期的效果不一致。
• 选择 CPI 作为竞价方式, 填写竞价价格及您的预算。
• 点击 “+ Add Flexbid”

➋设置 Flexbid 推广活动

• 在弹出的 Flexbid 窗口, 选择 download Flexbid template，下载 Flexbid 模板文件。
• 在 Excel 里打开下载后的 .xlsx 模板文件
• 在模板文件里您可以找到下列可编辑的竞价维度:
• Country （国家）
• Device model iOS （iOS 设备，仅在您选择 iOS 作为广告活动目标设备时生效）
• Device model Android （Android 设备，仅在您选择 Android 作为广告活动目标设备时生效）
• OS version iOS （iOS 操作系统具体的版本）
• OS version Android （Android 操作系统具体的版本）
• Publisher ID （流量方的 AppID。在 Chartboost 后台  > Analytics > Campaign 菜单栏目下， ‘Group by’ 下拉菜单中选择 ‘App’, 您可以在 “From App ID” 这一栏找到 Publisher ID ）
• Maximum bid （竞价最大值。如果没填写，默认为 $20）
• Minimum bid （竞价最小值。如果没填写，默认为可设置的最低价 $0.10）
• 填写您要设置的乘数系数值。取值范围是 0.01 到 25 之间。请注意“.” 表示小数点， “,” 代表千位分隔符。
• 绿色背景的单元格属于可编辑的栏目，它们分别属于以下竞价维度：国家, iOS设备型号, Android设备型号,  iOS 操作系统版本，Android 操作系统版本等等。
• 代表 Publisher App ID 的可编辑栏目有两列。Publisher ID 列填写Publishing AppID (不能有空格或者特殊字符)。Multiplier 列填写你希望设置的乘数系数。
• 保持 .xlsx Excel 文件。
• 在 Chartboost 后台点击 Upload Flexbid 按钮, 选择您设置好的 Excel 文件并上传。

➌调试 Flexbid 广告活动

• 当您上传设置好的 Flexbid 模板文件后, 我们的系统会自动检测您在编辑过程中可能发生的错误 (譬如格式不匹配，错误的数值设置等等) 。系统会给您提示并让您修改然后再次上传。
• 一些 Flexbid 设置错误可能会导致广告推广活动无法启用:
• 最大竞价值在 Flexbid 模板（ .xlsx Excel 文件）里未设置。
• 一些设置错误可能会导致 Flexbid 无法按预期运行：
• 当您在 Flexbid 模板 （.xlsx Excel文件里）设置了某个国家, 操作系统版本或者设备类型，但在它所属的广告推广活动 ‘Campaign Targeting > Audience > Target selected Countries/ OS versions/ Device Types.’ 里并没有对应的国家、操作系统、设备类型设置。
• 如果您If you’ve edited any key values under each bid dimension in the Flexbid Template .xlsx that doesn’t match with our database, then the specific multiplier will not be applied.

➍保存 Flexbid 推广活动

• 如果一切操作顺利，您可以保存 Flexbid 的设置。等广告活动被审核通过以后，Flexbid 将被正式启用。

您可能还喜欢…

• Flexbid 工具问答
  

设备列表为设备标识符的简单列表，让您组织玩家到不同组别 — 您可以将列表应用到广告活动中。(注: 设备列表为可选内容。)

设备列表类型

• 包括列表（白名单）让您可以专门定位一组设备。未在包括列表中的设备不会收到插页式广告或视频。
• 排除列表（黑名单）让您可以排除一组设备。排除列表中的设备不会收到插页式广告或视频。

创建设备列表

您有两种方法可以创建设备列表:

• 利用设备列表生成器轻松上传管理您的列表。查看以下章节以进一步了解。
• 使用编辑设备列表 API 随时更新列表；访问 API 浏览器获取详情

您需要用来生成列表的标识符为:

• IFA 用于 iOS 设备

• 未插入破折号
• 32 个字符长度
• 设备列表 IFA 示例: aaaaaaaabbbbcccc1111222222220000

• GAID 用于 Google Play 设备

• 包括 4 个短横线
• 32 个字符长度 (不包括短横线)
• 小写字母
• 设备列表 GAID 示例: aaaaaaaa-bbbb-cccc-1111-222222220000

• Android ID 用于 Google Play 设备

• 16 个字符长度
• 设备列表 Android ID 示例: aaabbbbccc111222

使用设备列表生成器

如果您使用 TestFlight 来测试您的 Chartboost 集成，请务必阅读集成详情然后再生成设备列表。

首先，请前往帐户的设备列表一栏，您会看到已有列表和控制面板用来添加新列表:

‍

添加列表方法:

1. 输入列表名称然后从平台下拉菜单选择 iOS、Android 或 亚马逊。您需要为不同平台单独创建设备列表，因为每份列表只能容纳一类设备标识符。 (不过，您可以上传既包含 GAID 又包含 Android ID 的 Android 列表)。
2. 点击选择文件字段点击选择文件以上传您的列表。设备列表必须具有 CSV 扩展名，不超过 50 MB ¹且只应包含一个应用 ID 列表，由换行符分隔。(推荐使用 Excel 或其他工作表编辑器以到处您的单一 ID 栏到 .csv 格式。)
3. 点击保存即大功告成 — 您会看到新列表出现在页面下方

(注意: 取决于文件大小，系统可能需要数小时来处理您的列表，处理完成方可显示有效和无效设备 (无效会以红色高亮)，然后方可用于广告活动。)

如需覆盖²、从帐户下载³或删除⁴，请点击列表操作栏的 3 个图标之一:

‍

使用设备列表

生成设备列表后，您通过编辑广告活动页面的广告活动逻辑栏将其应用到您的设备:

‍

注:

1. Excel 有 100 万行数限制，不过如果您需要添加更多设备到列表，您可以创建基于文本的 CSV (或使用 API)

2. 上传新文件到已有列表以替换原列表

3. 下载于 7 天后失效

4. 您无法删除处于活动状态的广告活动的列表

无法看到交叉推广活动？这通常是由于您的设备上已经安装了您要进行交叉推广的应用。Chartboost 不会显示此类应用。

如需修复问题，请重置您的设备广告标识符。方法如下:

‍

‍

iOS

‍

• 前往您的设备的设置。
• 选择隐私。
• 选择广告。
• 选择重置广告标识符。

‍

‍

‍

‍

Android

• 前往您的设备的 Google 设置。
• 选择广告。
• 选择重置广告 ID。
• 选择确定。

‍

‍

‍

‍

‍

依然无效？告诉我们！

广告标识符

IFA 又称 IDFA。两者所指相同。

发送字段:

• ifa

格式:

• 来自设备的 IFA 数据十六位标记
• 未插入破折号
• 32 个字符长度

平台:

• iOS

支持提供:

• Chartboost iOS SDK v3.0.7 及以上
• 数据传输
• 服务器对服务器集成

如何获取我的 IFA？(iOS 版本 6.0+)

1. 链接 AdSupport.framework (生成阶段 -> 链接二进制文件到库)
2. 添加代码到应用，在 iOS 设备上运行 — 您会在日志中看到 IFA:

// 导入内容#import <CommonCrypto/CommonDigest.h>#import <AdSupport/AdSupport.h>// 打印 IFA (广告标识符) 到输入端。添加到 applicationDidBecomeActive，仅 iOS 6+ 设备。 NSString* ifa = [[[NSClassFromString(@"ASIdentifierManager") sharedManager] advertisingIdentifier] UUIDString];ifa = [[ifa stringByReplacingOccurrencesOfString:@"-" withString:@""] lowercaseString];NSLog(@"IFA: %@",ifa);

或者您可以使用第三方应用 The Identifiers 来找到您的设备的 IFA。

使用 Chartboost SDK 是否符合 Apple 的 IDFA 政策？

Chartboost SDK 遵循限制广告跟踪设置和 Apple 在使用 IDFA 方面的限制:

1. 在应用内显示广告
2. 将应用安装归属为前一次展示的广告
3. 将应用内操作归属为前一次展示的广告

请放心使用 Chartboost SDK，如有任何问题或顾虑，请联系我们。

Google 广告 ID (GAID)

发送字段:

• gaid

格式:

• 32 个字符外加 4 条短横线 (例如 e4fe9bde-caa0-47b6-908d-ffba3fa184f2)
• 小写字母

平台:

• Android

支持提供:

• 所有 Chartboost Android SDK
• S2S 服务器对服务器集成
• Callback 回调数据传输

如何获取 GAID？

• 在您的 Android 设备上打开 “Google 设置” 应用。
• 选择广告。
• 您的广告 ID 会在底部显示。

‍

UDID

发送字段:

• uuid

格式:

• 不应使用哈希算法或其他处理
• 36 个字符长度

平台:

• 仅 iOS

支持提供:

• Chartboost SDK v3.1.1 及以下 (UDID 在 v3.2 中删除)
• 服务器对服务器集成
• 数据传输‍
  

获取帐户信息

端点会针对帐户返回特定金额信息。除用户 ID 和用户签名验证外无需任何参数。  HTTP 方法GET端点https://api.chartboost.com/account示例请求https://api.chartboost.com/account?user_id={{Chartboost customer’s user ID}}&user_signature={{CB customer’s user signature}} 回复字段参数描述公司帐户名称余额当前余额收益当前总收益

您可能还希望…

• Chartboost API
• Chartboost 术语
• 为什么我的 Chartboost 安装数跟 iTunes Connect 不符？
  

某些端点需要广告活动 ID。我的广告活动 ID 在哪里？

获取广告活动信息

端点为指定广告活动提供信息，否则会返回所有广告活动，无论状态。在此提供的 bid_id 可以用于下方端点。 HTTP 方法GET端点https://api.chartboost.com/campaigns示例请求https://api.chartboost.com/campaigns/?user_id={{Chartboost customer’s user ID}}&user_signature={{CB customer’s user signature}}

参数

参数请求类型是否必填?描述默认campaign_id字符串可选唯一广告活动 ID全部

回复字段

参数描述返回用作…app_id广告应用 ID广告主投标广告投标 ID; bid_id 用于下方端点所有人campaign_typemarketplace, directdeal, crosspromotion所有人date_created广告活动创建日期 (UNIX 时间戳)所有人date_max广告活动结束日期 (UNIX 时间戳)所有人date_min广告活动开始日期 (UNIX 时间戳)所有人date_modified广告活动上次更改日期 (UNIX 时间戳)所有人id广告活动 ID所有人名称广告活动名称所有人platformios, google_play, amazon所有人优先级当前广告活动显示优先级所有人promote_in发布应用 ID媒体状态当前广告活动状态: 活跃, 暂停, 已存档所有人  ▲ 返回顶部

获取应用信息

应用端点为您的应用提供详情，体现指定应用基本设置页面的相应信息。您每次请求仅可获取一个或全部应用的信息。  HTTP 方法GET端点用于全部应用: https://api.chartboost.com/apps 用于一次一个指定应用: https://api.chartboost.com/apps/app_ID示例请求用于全部应用: https://api.chartboost.com/apps/?&user_id={{Chartboost customer’s user ID}}&user_signature={{CB customer’s user signature}} 用于一次一个指定应用: https://api.chartboost.com/apps/{{App ID}}?app_id={{App ID}}&user_id={{Chartboost customer’s user ID}}&user_signature={{CB customer’s user signature}} 针对单个应用查询时，应用 ID 必须指定为 API 端点和查询字符串的限定内容，同时写入 app_id 参数。

参数

参数请求类型是否必填?描述默认app_id字符串可选一个应用 ID无

回复字段

参数描述id应用 ID名称应用名称昵称应用昵称date_created应用添加到 Chartboost 后台的日期 (UNIX 时间戳)store_id应用商店特定 IDstore_url应用商店 URLbundle_id应用平台和商店特定 ID (亚马逊 ASIN)platform以下任何: iOS, Google Play, 亚马逊  ▲ 返回顶部

您可能还希望…

• Chartboost API
• Chartboost 术语
• 为什么我的 Chartboost 安装数跟 iTunes Connect 不符？‍
  

目录 ▼

广告活动分析

广告活动数据分析 API 提供详细报告，可以按应用或素材分组。注意，指定 groupBy 字段后，数据查询队列系统会返回 jobID，在“开始之前” 栏目有详细描述。  HTTP 方法GET端点https://analytics.chartboost.com/v3/metrics/campaign示例请求https://analytics.chartboost.com/v3/metrics/campaign?dateMin={{Minimum date}}&dateMax={{Maximum date}}&userId={{Chartboost customer’s user ID}}&userSignature={{CB customer’s user signature}} 参数参数请求类型是否必填?描述默认合计字符串可选按时间累计结果 (每日、每周、每月)每日campaignId字符串可选广告活动 ID (既可以是 To Campaign ID 又可以是 From Campaign ID 基于 groupBy 和角色)不适用campaignType字符串可选network, cross_promonetworkdateMin字符串必填最小日期 (YYYY-MM-DD)不适用dateMax字符串必填最大日期 (YYYY-MM-DD)不适用groupBy字符串可选以下其中一项: 'country' 'app' 'app,creative' 'target_creative' 'date' 'campaign' 'campaign_target' 'campaign_type'无platform字符串可选按指定平台筛选结果 (iOS、Google Play、Amazon)全部角色字符串可选广告主或流量主全选

回复字段

参数描述返回用作…adTypeId1 = interstitial 2 = more_apps 3 = in_play 4 = rewarded_video 5 = video_interstitial 10 = banner所有人应用应用名称所有人广告活动广告活动名称所有人campaignId广告活动 ID (既可以是 To Campaign ID 又可以是 From Campaign ID 基于 groupBy 和角色)所有人campaignTarget广告定位名称 (仅在按 campaign_target 分组时返回)广告主campaignSubTypeuser_acquisition所有人clicksDelivered传递点击数流量主clicksReceived接收点击数广告主cpcvEarned完成视频收益与查看数比率流量主cpcvSpent完成视频成本与查看数比率广告主广告图片广告素材名称 (仅在按 creative 分组时返回)广告主ctrDelivered已传递展示次数的点击率流量主ctrReceived已接收展示次数的点击率广告主dt日期 (YYYY-MM-DD)所有人ecpmEarned每 1,000 次展示收益流量主ecpmSpent每 1,000 次展示成本广告主impressionsDelivered流量主传递展示次数流量主impressionsReceived广告主接收展示次数广告主installDelivered传递安装数流量主installRateDelivered安装率流量主installRateReceived安装率广告主installReceived安装广告主moneyEarned收益金额流量主moneySpent花费金额广告主videoCompletedDelivered传递的视频查看完毕次数流量主videoCompletedReceived接收的视频查看完毕次数广告主  ▲ 返回顶部

应用数据分析

应用数据分析端点提供详细报告，可以按应用、广告类型或广告位置。  HTTP 方法GETAPIhttps://analytics.chartboost.com/v3/metrics/app示例请求https://analytics.chartboost.com/v3/metrics/app?dateMin={{Minimum date}}&dateMax={{Maximum date}}&userId={{Chartboost customer’s user ID}}&userSignature={{CB customer’s user signature}} 参数参数请求类型是否必填?描述默认合计字符串可选按时间累计结果 (每日、每周、每月)每日appId字符串可选一个或多个 (逗号分隔) 应用 ID全部dateMax字符串必填最大日期 (YYYY-MM-DD)不适用dateMin字符串必填最小日期 (YYYY-MM-DD)不适用groupBy字符串可选以下其中一项: app, ad_type,app, date, ad_location (仅限流量主), platform, campaign_type无platform字符串可选以下任何: iOS, Google Play, 亚马逊全部角色字符串可选广告主或流量主全选

回复字段

参数描述返回用作…ad_type广告素材类型 了解广告类型详情

所有人，仅当 groupBy=ad_type,appallInstalls不计来源累计安装总数 (Chartboost 或其他)所有人应用应用名称所有人appBundleId不再发送；用户会在报告中看到弃用所有人appIdChartboost 应用 ID所有人启动数用户在设备上启动您的应用的次数所有人campaignTypenetwork, cross_promo所有人, 仅当 groupBy=campaignTypeclicksDelivered传递点击数流量主clicksReceived接收点击数广告主cpcvEarned完成视频收益与查看数比率流量主cpcvSpent完成视频成本与查看数比率广告主ctrDelivered已传递展示次数的点击率流量主ctrReceived已接收展示次数的点击率广告主dt日期 (YYYY-MM-DD)所有人ecpmEarned每 1,000 次展示收益流量主ecpmSpent每 1,000 次展示成本广告主eventLocationChartboost 命名位置。广告主会在相应字段看到Default。所有人impressionsDelivered流量主传递展示次数流量主impressionsReceived广告主接收展示次数广告主installDelivered传递安装数流量主installRateDelivered安装率流量主installRateReceived安装率广告主installReceived安装广告主moneyEarned收益金额流量主moneySpent花费金额广告主platformiOS, Google Play 或 Amazon所有人唯一数启动过此应用的唯一设备数所有人videoCompletedDelivered传递的视频查看完毕次数流量主videoCompletedReceived接收的视频查看完毕次数广告主  ▲ 返回顶部

导出安装数

导出安装数端点提供所有接收或提供安装数的完整列表。断点会一直从列队数据分析系统返回工作 ID，在“开始之前”栏中有详细说明。  HTTP 方法GETAPIhttps://analytics.chartboost.com/v3/metrics/install示例请求https://analytics.chartboost.com/v3/metrics/install?dateMin={{Minimum date}}&dateMax={{Maximum date}}&userId={{Chartboost customer’s user ID}}&userSignature={{CB customer’s user signature}} 参数参数请求类型是否必填?描述默认campaignIds字符串可选一个或多个 (逗号分隔) 广告活动 ID所有广告活动campaignType字符串可选network, cross_promo全部dateMax字符串必填最大日期 (YYYY-MM-DD)不适用dateMin字符串必填最小日期 (YYYY-MM-DD)不适用platform字符串可选以下任何: iOS, Google Play, Amazon全部角色字符串可选广告主或流量主全选

回复字段

参数描述返回用作…广告类型广告素材类型 了解广告类型详情

所有人点击时间戳日期和时间 (DD-MM-YYYY HH:MM:SS)所有人费用类型广告竞价类型 了解竞价类型详情

所有人费用值广告投标数量所有人国家设备双字符国家代码所有人日期日期和时间 (DD-MM-YYYY HH:MM:SS)所有人来自应用文件包发布应用文件包 ID所有人从应用 ID发布应用 ID所有人从应用名称发布应用名称所有人来自广告活动 ID发布活动 ID流量主来自广告活动名称发布活动名称流量主来自广告活动类型network, cross_promo流量主GAIDGoogle 广告 ID所有人 (如果行为定位禁用则仅限流量主)IFAiOS 广告主标识符 (如果 iOS 10 限制广告跟踪已禁用)所有人 (如果行为定位禁用则仅限流量主)MACMAC 地址 (弃用)不适用类型设备型号所有人OS设备操作系统所有人到应用文件包广告应用文件包 ID所有人到应用 ID广告应用 ID所有人到应用名称广告应用名称所有人到广告活动 ID广告活动 ID广告主到广告活动名称广告活动名称广告主到广告活动定位广告活动定位 ID所有人到广告活动类型network, cross_promo广告主UUID设备通用唯一标识符 (如可用)所有人 (如果行为定位禁用则仅限流量主)  ▲ 返回顶部

应用数据分析按国家分组

除了您在后台的 API 浏览器页面发现的端点外，我们专门设计了用于在应用、日期和国家层面输出数据分析的端点。此端点还可由需要国家层面数据的第三方归属和中介服务代表 Chartboost 客户使用。应用数据分析按国家分组 API 仅提供过去 40 天的数据查询。

中介网络说明: 强烈建议您忽略广告活动类型字段，因为 API 会自动为 network 返回结果。

“更多应用”数据未包括在此 API 中。注意，应用和广告活动端点和您的后台数据分析可能有出入。使用广告活动端点并按照国家分组以获取应用, 国家, 和 ad_type 数据。

API 返回的数据一般会有几个小时的延迟。默认以 UTC 时区为基准。

所有 adLocation 为空 "" 的记录会被聚合到 Default 这个命名空间下.

HTTP 方法GETAPIhttps://analytics.chartboost.com/v3/metrics/appcountry示例请求https://analytics.chartboost.com/v3/metrics/appcountry?dateMin={{Minimum date}}&dateMax={{Maximum date}}&userId={{Chartboost customer’s user ID}}&userSignature={{CB customer’s user signature}}

参数

参数请求类型是否必填?描述默认appIds字符串可选一个或多个 (逗号分隔) 应用 ID全部应用dateMin字符串必填最小日期 (YYYY-MM-DD)不适用dateMax字符串必填最大日期 (YYYY-MM-DD)不适用campaignType字符串可选network, cross_promo 或者全部networkadTypeIds字符串可选一个或多个 (逗号分隔) 广告类型 ID: 1 = interstitial, 3 = in_play, 4 = rewarded_video, 5 = video_interstitial1,4,5角色字符串可选广告主或流量主流量主时区字符串可选utc 或 pstutcadLocation字符串可选一个或多个 (逗号分隔) adLocations

• 实例 #1: (adLocation=<value which is not 'all'>) 仅针对该 adLocation 并按照指定 adLocation 汇总显示结果。仅当 adLocation 为发布应用的前 3 项 adLocation 时才提供该信息。其他 adLocation 无返回信息。
• 实例 #2: (adLocation='all') 对于发布应用显示前 3 项 adLocation 的分项结果，其他结果汇总为 adLocation = 'other'。
• 实例 #3: (adLocation= 空置或未传入) 汇总所有 adLocation = 'overall' 下的数据。不提供按照 adLocation 细分的信息。

查看实例 #3

adLocation 命名空间的值必须是最近活跃的（譬如被多次请求并展示）。否则它们可能被聚合到 Default 命名空间下。

回复字段

参数描述返回用作…adLocationChartboost 命名位置。广告主会在相应字段看到Default。所有人adTypeinterstitial, rewarded_video, video_interstitial所有人应用应用名称所有人campaignType网络、交叉推广所有人clicksDelivered点击流量主clicksReceived点击广告主countryCode双字母国家代码或 “Unknown”所有人cpcvEarned完成视频收益与查看数比率流量主cpcvSpent完成视频成本与查看数比率广告主ctrDelivered点击率流量主ctrReceived点击率广告主dt日期 (YYYY-MM-DD)所有人ecpmEarned每 1000 次展示收益流量主ecpmSpent每 1000 次展示成本广告主impressionsDelivered展示次数流量主impressionsReceived展示次数广告主installRateDelivered安装率流量主installRateReceived安装率广告主installsDelivered安装流量主installsReceived安装广告主moneyEarned收益金额流量主moneySpent花费金额广告主platformiOS, Google Play 或 Amazon所有人videoCompletedDelivered已完成视频查看流量主videoCompletedReceived已完成视频查看广告主  ▲ 返回顶部

您可能还希望…

• Chartboost API‍
  

使用 Chartboost API，您可以访问广告活动和应用数据分析，获取帐户和收益信息、上传、更新广告活动投标及其他 。

在您开始前

• 验证: 您需要包括您的帐户的用户 ID 和用户签名以验证您的 API 请求。您可以在后台 API 浏览器页面顶部找到您的用户 ID 和用户签名。
• HTTP 方法: 必要的 HTTP 方法 — GET, POST, PUT 等 — 各端点均有不同。在您的后台的 API 浏览器页面查看每个请求的 HTTP 方法。所有请求均应通过 HTTPS 完成。下面以显示两项数据分析查询为例: 列队作业初始化请求和使用作业 ID 进行后续请求以取回结果。

// 用于初始化查询请求的伪代码示例
query_url = "http://analytics.chartboost.com/v3/metrics/campaign?" + query_params
query_params = "... groupBy=app,creative ..."

response = get(query_url);
if (response.status = 202) {
jobId = response.parse('jobId');
// 捕获 jobId 用于 retrieve() 函数
file.write(jobId);
}
else {
// 处理失败
};


// 用于通过 jobId 取回结果的伪代码示例
query_url = "http://analytics.chartboost.com/v3/metrics/jobs/" + jobId
query_params = ""

created = get(query_url + "?status=true");
if (created.status == 201) {
response = get(query_url);
if (response.status == 200) {
// 一头扎进数据里
}
else {
// 处理失败
}
};'

• 接收到使用 groupBy 参数的 GET /campaign 和 GET /install 查询后，Chartboost API 会返回作业ID(job ID)，确认请求已接受并加入处理队列。
• 您可以再次发出请求，使用该 ID 来检查作业状态，使用新端点: GET /v3/metrics/jobs/[job_id]?status=true
• 如果作业结果可供收集，则查询会返回 201 {状态: “已创建”}。当系统收到响应后，您可以使用如下方法抓取数据: GET /v3/metrics/jobs/[job_id]
• 如果您试图在作业完成前取回数据，您收到的响应可能空白或不完整。
• 查询结果会存储并可供下载长达 24 小时，过期自动删除。
• （从2022年5月22日起 生效日期已推迟，将另行通知），唯一支持的 content-type 为text/comma-separated-values;charset=UTF-8，结果会以 CSV 表格形式返回。
• API 方法: Chartboost API 提供 4 中不同方法类型 — 分析方法、应用方法、广告活动方法和帐户方法。每个方法类型均有独一无二的端点。使用后台 API 浏览器页面找到您的请求的正确端点。
• 参数: 添加参数到生成请求用作测试。必填参数会在后台以红色显示。
• 从我们的 API 返回的数据分析报告大多为 JSON 格式。特定查询会以 CSV (逗号分割值) 格式返回。了解格式详情

• 请符合下方的 Chartboost API 规则。

▲ 返回顶部

Chartboost API 规则

以下准则帮助我们确保所有用户请求均得到快速回复。如果您不遵守限制，您的 API 访问会受到限制。请妥善使用我们的 API，为了您也为了其他 Chartboost 客户。

请分开发送请求。如果您每天需要 5 份不同报告，请不要同时发送 5 个请求。请间隔几分钟来喘口气。如果您的查询频率超过每分钟一次，您的 API 访问将会受限。

将您的多个应用归到一个请求中。请勿为每个应用发送单独 API 请求，去掉 appId 参数，让 API 返回所有数据。

 ▲ 返回顶部

数据分析方法

Chartboost 会在对第三方MMP 设置 Callback 回调数据传输 先填好的模板。您无需手动复制参数。不过，如果您需要其他帮助，您可以查看下方第三方 MMP 文档。

以下内容适用于所有数据传输类型:

• 您的服务器: 您将需要一个支持实时事件的服务器
• 故障/超时: 系统会三次尝试将数据传输送达您的服务器。如果三次尝试均失败，您的端点将被列入黑名单达 15 分钟。黑名单期间，数据传输无法发送，直至时间到期恢复。
• 响应码: 如果您的服务器回复 200 - 302，服务即认为请求成功
• 重定向: Callback 回调可以是重定向 URL，但不能将任何商店 (App Store、Google Play 商店、亚马逊应用商店等) 作为最终目的地址。同时必须为有效 URL。(为了保证最佳可靠性，请避免使用重定向)
• SSL: 端口必须支持 SSL
• URL 编码: 所有数据发送前均经过 URL 编码
  

当您的 Callback 回调设置开始向您的服务器或第三方 MMP 汇报数据后，您会发现我们后台和您系统中的数据存在差异。

我们很乐意协助调查差异，但是在调查之前，请考虑一些普遍因素:

• Callback 回调数据传输数据问题: 验证您的数据传输包括您的服务器或跟踪服务必填参数和静态变量 , 并确保其附加在正确的层级上 (应用层级或广告活动层级)。如果您遗漏了必填参数，通过与 Chartboost 后台相关的服务反馈的数据会偏低。
• 时差问题: 我们的系统使用 PST/PDT (UTC – 8小时)，如果您的服务在其他时区发送报告，您会发现数据差异。(考虑添加时间戳参数到您的数据传输以了解事件的时间，不同于数据传输到达您的系统的时间)。
• 删除安装数/最近点击属性重复项: 因为跟踪服务有时候会在识别上次发送报告的服务后删除重复内容，Chartboost 的结算安装数 (接收安装数/传递安装数) 可能会比别处要高。如果用户点击广告并且在点击后 21 天以内启动推广游戏，系统会登记该结算安装数。
• 不同的归因时间窗口: 如上所述，如果玩家在点击广告后 21 天内启动游戏，我们会记录为转化安装。其他 MMP 服务可能有不同的归因时间窗口设置 (也可能会让您指定时间窗口)，在您进行故障排解时请谨记这点。
• Chartboost SDK 集成前: 如果您在请求转化到 S2S 跟踪前，您的应用已集成 SDK 并由 Chartboost 广告活动进行推广，您可能会收到 SDK 驱动安装数账单，最多长达转化完成后 21 天。那些安装数为 S2S 批准前由点击带来的数量。
• Chartboost 汇总延迟: 安装、点击等数据需要 2-3 个小时才能反映到 Chartboost 的后台，但是数据传输会立即发送 — 如果您通过服务看到较高的数据，很可能是因为分析系统数据还没跟上。
• 设备无法跟踪: 如果您为游戏设置了不跟踪目标用户行为 (opted-out of behavioral targeting) ，但设置了回调数据报告时间，系统会发送设备标识符为“无法跟踪 (NON-TRACKABLE)”。Mobile App Tracking 会将多次“无法跟踪”的数据传输算作单次事件；比如，如果系统发送了 100 次回调数据，而这其中 50 次包含“无法跟踪”的标识符, Mobile App Tracking 会报告 51 次事件，而非 100 次。
  

Callback 回调参数

‍

您可以指定自己的 Key 参数名，然后选择以下其中一个值作为该参数的值。

您还可以通过点击“+”按钮添加自己的静态和动态参数。

‍

‍

‍

‍

‍

接受 PHP 时间戳格式和范围

‍

时间戳
格式描述D工作日作为区域简略名称l工作日作为区域全称M月份作为区域简略名称F月份作为区域全称d月份日期用十进制数字表示 [01,31]H小时数用十进制数字表示 [00,23] (24 小时制)h小时数用十进制数字表示 [01,12] (12 小时制)z天数用十进制数字表示 [001,366]，其 PHP 范围为 [000,365] 但仍将 364 天算作一年m月份用十进制数字表示 [01,12]i分钟用十进制数字表示 [00,59]aAM 或 PM 的区域对应表述；在 PHP 中为小写，在 Python 中为大写AAM 或 PM 的区域对应表述s秒钟用十进制数字表示 [00,61]w工作日用十进制数字表示 [0,6]；0 = SundayW一年中的星期数，周一为周中第一天y年份用十进制数表示，不显示前两位数 [00,99]Y年份用十进制数表示 (例如 2016)OUTC 以 +HHMM 或 -HHMM 体现在形式上T时区名称，原生对象字符串为空e时区名称，原生对象字符串为空UUnix 时间

设置 Callbacks（回调）

关于点击、完成视频观看或转化安装的事件通知。

‍

➊ 添加新的 callback (回调）

• 在 Chartboost 后台转到 Callbacks 页面：

• 点击 Add New Callback （添加回调）.

• 为您的回调命名并添加描述。
• 为您的回调选择一个模板。
• 使用第三方 MMP 平台: Chartboost 为大多数第三方MMP 平台提供预配置的回调模板。点击一个模板，自动填充所有必需的参数。 您可能需要添加您 App 的 bundle ID 或者其他信息。 所有第三方 MMP 的回调默认为广告主角色。
• 使用自定义模板：如果您没有使用预定义的第三方 MMP 接口，您可以选择自定义模板，并使用以下设置设置回调：

• 角色：选择您的角色（广告主或流量变现端）。只有当您的应用程序中同时有流量变现和投放广告且希望对两者使用相同的回调时，才选择“BOTH”。
• Tracking URL: 我们将发送回调的您的服务器或第三方 MMP 跟踪服务的接口（例如，https://myserver.com/tracker）。我们的系统会根据规定将静态和动态参数附加到此 URL。
• Static Parameters: 在回调 URL 的查询字符串中包含静态键值对。要包含像 network=chartboost 这样的静态参数，您需要在 Key 字段中添加 network，并在 Value 中添加 chartboost。
• Dynamic Parameters: 决定关于事件需要发送哪些额外信息。在 Key 字段中输入您的端点支持的参数名称，然后从下拉菜单中选择一个宏值。您可以参考这些参数以获得帮助。
• Callback URL and Ping Test: 点击“Test Now”以验证您的接口状况是否正常。您的回调 URL 应该出现在该字段中。以下是我们在测试 Ping 中发送的信息示例：

Chartboost 的 POST 回调不包含请求正文中的数据。相反，它将数据作为附加到 URL 的查询字符串包含在内，类似于 GET 回调。

• 将回调从 OFF 切换到 ON，然后点击保存。

‍

➋将回调关联到您的应用或广告活动

• 将回调关联到您的应用：从列表中打开任意回调，向下滚动到“选择应用”。勾选将关联点击、安装或完成视图回调的应用。或者，从后台 Dashboard 左上角选择任意应用，转到其“基本设置”>“高级设置”，并从下拉菜单中附加回调（见下面的屏幕截图）。

• 请注意，使用我们预定义的第三方供应商模板创建的回调或使用第三方 MMP 跟踪 URL 只能关联到点击或查看事件。
• 安装回调仅支持自定义模板和自定义跟踪 URL。

• 将回调关联到您的广告活动：从列表中打开任意回调，向下滚动到“选择广告活动”。勾选将关联点击、安装或视频完播回调的广告活动。或者，打开任意推广或变现活动，转到活动的高级设置，并从那里的下拉菜单中附加回调（见下面的屏幕截图）。

• 请注意，使用我们预定义的第三方 MMP 模板创建的回调或使用第三方 MMP 跟踪 URL 只能关联到点击或查看事件。
• 安装回调仅支持自定义模板和自定义跟踪 URL。
• 具有广告主角色的回调在“选择活动”窗口中不会显示网络变现广告活动，同时也无法在网络变现广告活动页面中选择。
• 具有变现端角色的回调在“选择活动”窗口中不会显示网络推广广告活动，同时也无法在网络推广广告活动页面中选择。

如果与此广告活动关联的应用已将此回调关联到相同的事件，则无需将此回调关联到广告活动。

• 将回调关联到您的整个帐户：为简化 Chartboost 仪表板上的回调功能，我们自 2020 年 10 月 7 日起取消了将回调关联到帐户级别的功能。

如果您对此变更有任何疑问，请联系 我们的技术支持团队.

‍

➌申请服务端（S2S）跟踪

• 如果您希望使用服务器端（S2S）跟踪，则需要手动向您的账户经理请求激活。如果您不需要S2S跟踪，则可以跳过此步骤。
• 为了使Chartboost启用S2S跟踪，您必须在广告余额中存入至少 $5,000。充值到您的账户余额
• 了解更多关于服务器到服务器（S2S）跟踪的信息：

‍

➍如果您希望使用服务器端（S2S）跟踪，则需要手动向您的账户经理请求激活。如果您不需要S2S跟踪，则可以跳过此步骤。

• 要复制一个回调，请打开它，然后在页面顶部点击“复制”。

• 要从列表中删除回调，请点击“X”。
• 要编辑回调，请点击铅笔图标。
• 要暂停回调，请点击暂停图标。

‍

‍

以下是您需要了解的一些回调规范：

• 您需要一个准备好支持实时事件的服务器。
• 我们会尝试三次将回调发送到您的服务器。如果所有尝试都失败，则您的接口将被列入黑名单15分钟。在黑名单期间，回调将不会被发送或尝试，直到经过完整的时间为止。
• 如果您的服务器响应 2xx，则我们的服务将视为请求成功。
• 回调可以是重定向 URL，但不能将任何商店（App Store、Google Play Store、Amazon Appstore for Android 等）作为最终的地。它们还必须是有效的 URL。为了最大可靠性，请不要使用重定向。
• 端点必须通过 HTTPS 支持 SSL。
• 在发送之前，所有数据都将进行 URL 编码。

‍

您可能也会喜欢...

• Callbacks 回调的相关问答
• Callbacks 回调参数

Chartboost 的 S2S 跟踪可以让您充分利用来自第三方平台的安装归因，在 Chartboost 网络中创建 CPI 广告推广活动。

目录▼

➊将点击回调添加至您的 App

• 添加点击回调（Click Callback），方法是转至您后台控制面板的回调面板点击添加新回调。
• 从“模板”下拉列表中使用第三方模板创建点击回调。请确保选择适合您 App OS 平台（iOS 或 Android）的模板。

• 系统将提示您输入第三方要求的附加信息，例如 Bundle ID。
• 填写回调模板后，将回调附加到您希望通过第三方跟踪的 App 的点击事件。选择该 App，转至APP 设置 > 基本设置 > 高级设置，从下拉列表中选择点击回调。

• 点击保存。

➋添加已完成展示回调启用展示归因（VTA）

展示归因（VTA）允许您记录那些观看过视频广告后，即使未点击广告，但在较短时间段内安装您 App 的安装记录。了解更多

• 转至后台控制面板的回调面板并点击添加新回调。
• 命名您的回调并进行描述。
• 从模板下拉列表，选择适合您合作伙伴的完整观看模板（例如 “Tune iOS Completed View”）。
• 系统可能会提示您添加您的 Bundle ID 或其他信息。
• 在您回调详情下方列表中找到该回调的 App，选中展示列中的选框。
• 将回调从关切换为开然后单击保存。

➌➌ 配置您的第三方平台以发送归因和启动数据

选择您的第三方服务获取更多说明：

为了确保您的 App 的最佳定向和表现，您的 App 启动后的 几秒内必须始终调用启动/安装通知，这与您的App 内任何其他操作或用户互动无关。

➍在您的 Chartboost 后台控制面板上请求 S2S 安装跟踪

• 在左上角选择您的 App。
• 转至您 App 的基本设置。
• 向下滚动到高级设置。
• 点击请求S2S 安装跟踪旁边的请求按钮。我没有看到 S2S 请求按钮！
• 请允许Chartboost在 1 至 3 个工作日审核您的要求。一旦您的申请被批准或拒绝，您将会收到电子邮件通知。为什么我的请求被拒绝？

如果您的 App 之前集成了 SDK，在您请求 S2S 跟踪之前正在由 Chartboost 广告活动推广，转换完成之前您可能会被收取最多 21 天的 SDK 驱动的安装。转换后，安装归因窗口将在至少 7 天后与第三方一致。

您可能还喜欢…

• 展示归因（VTA）跟踪那些用户在观看过视频后但是并未点击广告且在很短时间内进行的安装。
  

如需激活 Adjust 安装归因属和启动回传，只需添加您的应用的 Chartboost  AppID 和 AppSignature 到 Adjust 后台，可以在合作伙伴设置 > Chartboost 下找到。

基本完成了！现在从 Chartboost 后台请求 S2S 跟踪。

您可能还希望…

• S2S (服务器对服务器) 跟踪: 利用第三方平台的安装归因，从而在 Chartboost 网络打造 CPI 广告推广活动。
• 查看完成归因: 如果用户播放视频后并未点击广告但随后完成了安装，功劳仍然归你。
  

如需设置 Tenjin 安装归属因启动数回传:

• 请登录到您的 Tenjin 后台。
• 创建新的 Chartboost 营销频道。

• 添加您的 Chartboost UserID 和 UserSignature。您可以在 Chartboost 后台的 API Explorer 面板顶部找到。

• 营销频道设置完毕后，导航至广告活动面板，为您的应用创建新的广告活动:

• 复制跟踪 URL 到您的剪切板。您需要该内容方可设置 Chartboost 点击跟踪地址。

• 如果 Chartboost 应用 ID 未能在营销频道传输中自动检测，请点击在此填入宏。

• 添加 Chartboost AppID 完毕后，您会收到确认说明跟踪 URL 处于活动状态。

• 基本完成了！现在从 Chartboost 后台请求 S2S 跟踪。

您可能还希望…

• S2S (服务器对服务器) 跟踪: 利用第三方平台的安装归因，从而在 Chartboost 网络打造 CPI 广告推广活动。
• 查看完成归因: 如果用户播放视频后并未点击广告但随后完成了安装，功劳仍然归你。

请联系您的 Singular 联系人来为您的应用设置回发，然后从 Chartboost 后台请求 S2S 跟踪。

您可能还希望…

• S2S (服务器对服务器) 跟踪: 利用第三方平台的安装归属从而在 Chartboost 网络打造 CPI 广告活动。
• 查看完成归属: 如果用户播放视频后并未点击广告但随后完成了安装，功劳仍然归你。

如需在 Kochava 后台设置安装归属和启动/会话回发:

• 添加应用到 Kochava 后台，然后导航至应用工具下拉菜单并选择数据回发配置。
• 点击添加配置。
• 在新配置页面，搜索 Chartboost 并从下拉菜单选择 Chartboost – Android 或 Chartboost – iOS。请勿使用 Chartboost – Legacy。

• 添加您的应用的 Chartboost 应用 ID 和应用签名到相应字段。

• 勾选发送归属到复选框然后在发送方法下拉菜单中选择全部。点击保存。

• 数据回发保存完毕后，您会在安装数据回发旁看到绿色图标以确保设置妥当。

• 基本完成了！现在从 Chartboost 后台请求 S2S 跟踪。

了解 Kochava-Certified 数据回发详情

您可能还希望…

• S2S (服务器对服务器) 跟踪: 利用第三方平台的安装归属从而在 Chartboost 网络打造 CPI 广告活动。
• 查看完成归属: 如果用户播放视频后并未点击广告但随后完成了安装，功劳仍然归你。

如需为 AppsFlyer 设置归因回传，请在 Charboost S2S 下 AppsFlyer 后台添加您的 Chartboost AppID 和 AppSignature，然后从 Chartboost 后台请求 S2S 跟踪。

您可以在 AppsFlyer 后台开启应用内购数据回传，用于安装后数据分析，目前仅支持IAP 内购事件。请见 AppsFlyer 文档

您可能还希望…

• S2S (服务器对服务器) 跟踪: 利用第三方平台的安装归因，从而在 Chartboost 网络打造 CPI 广告推广活动。
• 查看完成归因: 如果用户播放视频后并未点击广告但随后完成了安装，功劳仍然归你。

‍

补充资金以继续运行您的广告活动。

在您开始前

• 您是否开始了广告推广活动？
• 了解如何避免超支

• Chartboost 广告网络主要面向免费游戏。如果您希望在非游戏应用或付费游戏中投放广告，请在添加资金前联系 bizdev@chartboost.com。

➊登录到您的后台

前往后台的管理资金 > 添加资金或点击此处。

▲ 返回顶部

➋添加资金

有三种方式可以添加资金:

• PayPal: 从您的 Paypal 帐户添加资金。Paypal 手续费会从总额中扣除。Paypal 转账额度最低为 $150 USD。
• 电汇/ACH: 如果金额大于 $150，我们可以接受电汇或 ACH。电汇说明请见此 PDF 文件。请指明您希望转账的帐户名称和数额。
• 从变现收入中转账: 如果您通过变现广告活动有所收益，您可以将这些资金转到您的广告推广活动余额中。此转账选项不会将资金发到您的银行或 PayPal 帐户，只会转到您的广告余额。

▲ 返回顶部

关于手续费…

以某些方式添加资金可能会造成非 Chartboost 费用:

‍

Chartboost 不收取转入电汇费用。不过，您的银行可能会收取电汇费用，约为 $20-$35。建议您添加 Charge Our 说明到您的电汇说明里，这样电汇费用可以全款到达您的广告余额。

▲ 返回顶部

您可能还希望…

• 付款条款和要求
• 支付常见问答
• 开始广告推广活动
  

作为广告主，您的目标就是以合适的价位获取稳定数量的高质量玩家。

当系统依照发布活动条件获取相应广告活动后，系统会为发布游戏提供最优的广告。

我们衡量业绩的方法是 eCPM 指标，通常定义为每千次广告展示次数的有效成本。，Chartboost eCPM 由广告活动的安装率 (IR)、点击率 (CTR)和反映活动的整体竞争力的投标组成。因此，您的广告表现越佳，您就能获得更优质的流量。

以下是改善表现和最大化投资回报率 (ROI) 的五条建议：

1. 优化您的广告图片

我们建议您一次运行 3-4 个不同的广告图片，最多每周刷新一次 (至少每月刷新一次)。新的插页式广告为您的游戏提供新视角，可以提高您的 CTR；用户往往对不曾见过的广告图片反应较好。

查阅我们博客上的优秀广告图片一览，我们会展示 Chartboost 网络上表现最优的广告图片。其他有用内容: 我们的广告图片文档页面有更多提示/技巧，还有您在启动广告活动前需要了解的要求。

您可以通过广告活动配置页面查看广告的 CTR 和 IR，并手动或通过我们的广告优化功能自动分配流量。

2. 去除广告活动中表现不佳的游戏

您需要跟您的潜在玩家所关注的媒体并与之合作，但同时应该为点击或安装做适当支出。为实现目标，您可以从您的广告活动中筛选出eCPM 较低的游戏。筛选后，您可以让您表现较佳的应用 (能产生更多点击/安装的应用) 来显示您的插页式广告。

首先，请查阅我们的应用筛选功能。当您建立好您的透视表格并计算出 eCPM 后，搜索高展示次数且低 eCPM 的应用: 推荐您删选出排名前 10-15 且 eCPMs 低于 $1.00 的应用。

3. 让投标更有竞争力

以最低价投标看似是个削减成本的好主意，不过，低投标也意味着较低的 eCPM，即展示次数较少。我们建议您从网络平均价格 (或者以您认为合适的高价) 开始投标，然后根据流量调整投标。

您可以使用我们实用的洞见页面掌握信息，做出明智决策: 您会发现世界各地 Android 和 iOS 广告活动的平均 CPI 投标。

简而言之: 长期来看，将投标调低的成本效益更高，而非调高。

4. 按国家定位

各国玩家有不同的消费习惯：一名美国玩家或许比一名马来西亚玩家更愿意在您的游戏中花钱，所以您有必要按需调整投标，才能让广告大获成功。

关键是如何为同一广告活动创建不同的目标，您可以在广告活动定位栏中实现。为了帮助您迅速创建多个目标，我们在这一栏中将各国分成了几组，每一层级都是历史上 eCPM 相似的国家集合。

要在目标上添加层级，只需在按国家定位栏中点击它的名字。更多分层信息

您的广告优化工具库还包括了洞见页面，您可以查看每个国家的平均 Android 或 iOS CPI 投标。

5. 按设备定位

如果您想在多于一种的设备上推广游戏，请考虑为每个类型分别定位。如果每种设备类型都有自己的目标，它们也能同时设置自己的投标，这些投标可经调整以弥补目标的糟糕表现。(如需按目标监控广告活动表现，只需前往广告活动 > 数据分析，运行通过广告活动目标分组报告。)

请记住: 如果您的广告活动没有分开设置目标，如此调整要困难得多，因此请记得使用！

‍

优化您的广告活动以控制您的投标类型和数额、哪些用户或设备可以看到您再哪些国家的广告，及其他！

目录 ▼

高级设置

➊ 从您的后台选择广告活动。

‍

➋ 点击

以展开高级设置并作更改。了解您下方的选项。

‍

➌完成后点击保存。

计划开始和结束时间

• 为您的广告活动选择开始和结束时间。
• 广告活动默认立即开始并从不结束。
• 点击在选定时间运行以选择特殊时段运行您的广告活动。
• Chartboost 对广告活动使用太平洋标准时间。了解报告详情

▲ 返回顶部

屏蔽应用和公司

• 阻止其他公司或特定应用显示您的广告活动。
• 点击 ▼ 以展开下拉菜单并选择应用或公司。
• 您可以添加自定义应用列表来屏蔽。

▲ 返回顶部

屏蔽评级为成年或 17+ 受众的内容

选中屏蔽 17+ 复选框以阻止成人应用显示您的广告。

▲ 返回顶部

使用列表包括或排除设备

• 使用列表生成器来生成和选择完整设备列表用来在此广告活动中包括或排除。
• 选择包括或排除列表。
• 从下拉菜单中选择列表。

▲ 返回顶部

数据传输

• 数据传输提供点击和结算安装数的事件通知。
• 设置数据传输，然后从下拉菜单中选中以添加到此广告活动。

▲ 返回顶部

广告活动 URL

添加唯一 URL 将用户从广告活动转至特定网站或跟踪用户。

▲ 返回顶部

用户回访

• 选择这是用户回访广告活动从而定位已安装您的应用的玩家。
• 使用深度链接引导他们进入特定位置而非安装页面。
• 了解用户回访详情

▲ 返回顶部

广告活动定位

➊从您的后台选择广告活动。

‍

➋前往广告活动定位并做更改。了解您下方的选项。

‍

➌点击添加定位以添加更多定位。点击

以禁用定位。

‍

➍完成后点击保存。

按类型、游戏受众或性别进行定位

• 选择应用以选择显示广告的应用类型、您希望定位的游戏受众 — 硬核、中核或休闲 — 以及您希望定位的受众性别。
• 点击类别，选中您希望的选项，然后点击选择。

▲ 返回顶部

按国家定位

• 从您的广告活动中包括或排除特定国家。
• 点击定位选定国家。
• 选择包括或排除，然后从下拉菜单中选择国家。

▲ 返回顶部

按 OS 版本定位

• 从您的广告活动中包括或排除特定 OS 版本。
• 点击定位选定 OS 版本。
• 选择 OS 版本的最小值和/或最大值。

▲ 返回顶部

按设备类型定位

• 从您的广告活动中包括或排除特定设备系列或型号。
• 点击定位选定设备类型。
• 选择包括或排除。
• 选择系列或型号，然后选择特定系列或型号以定位。

▲ 返回顶部

Wi-Fi 连接

选择仅定位 Wi-Fi 网络设备以缩小定位范围到当前连接到 Wi-Fi 网络的设备。

▲ 返回顶部

投标类型、每日预算和建议投标

• 输入您的投标类型和每日预算。
• 使用建议投标来决定投标值。
• $500 以下的每日预算很容易达到并超标。了解如何避免超支

• 当您的广告活动接近每日上限时您会收到邮件提醒。您可以通过此类邮件编辑广告活动。
• CPC 广告活动每日预算不得低于 $250。
• CPI 和 CPCV 广告活动每日预算不得低于 $100。
• 使用 Chartboost 洞见来查看全局 CPI 报告并做出更明智的投标决定。
• 如何决定点击或安装的投标金额？
• 了解投标类型详情

▲ 返回顶部

上传广告图片

• 选择已有广告图片，或点击上传广告图片以添加新的广告素材。

• 将您的广告图片拖动到上传窗口。
• 预览您的广告图片并确保已针对各种设备进行优化。在此获取广告尺寸

• 添加广告图片 URL 或深度链接将用户从广告活动转至特定网站或跟踪用户。
• 手动优化您的广告图片流量以决定每套广告素材得到展示的百分比。

▲ 返回顶部

广告图片 URL 和广告图片深层链接

• 添加广告图片 URL 将用户从广告活动转至特定网站或跟踪用户。广告图片 URL 会覆盖广告活动 URL。
• 选择广告图片深度链接以引导二次营销用户到应用的指定位置。

▲ 返回顶部

优化流量分配

• 如果您有超过一套广告素材，Chartboost 会默认分配更多展示次数给表现更佳的广告素材。但您可以手动决定每套广告素材得到展示的百分比。
• 取消选择优化流量分配 (推荐) 然后选择您的每套广告图片的流量百分比。
• 了解优化流量分配详情

▲ 返回顶部

您可能还希望…

• 开始广告活动: 设置广告活动以开始吸纳新用户。
• 添加资金到您的广告活动: 注入资金以保持您的广告活动继续运作。
• 广告提示和最佳实践: 您信得过的策略，帮助您优化广告活动绩效。
• 用于广告的图片素材: 打造引人入胜的广告以吸引用户到您的应用。
• Chartboost 洞见: 查看全局投标报告并做出更明智的投标决定。

‍

为了帮助广告主应对iOS 14.5的发布以及ATT的实施, 我们现在推出了SKAdNetwork广告活动，以帮助广告主进行试验。 这样，您就可以使用MMP合作平台对主要归因及付费进行SKAdNetwork的测试。Chartboost后台的CPI付费也即将推出。

测试模式下的SKAdNetwork广告活动不会替换您现有的任何iOS广告活动和目标。 我们会尽快发布此功能，这样您就可以开始测试SKAdNetwork广告活动、查看初期表现，并将其与普通iOS广告活动进行比较。

请按照本指南创建目标为iOS 14+的SKAdNetwork广告活动

• 开始之前
• 创建一个新的广告活动
• 设置活动目标、价格、预算以及上传素材
• 提交活动进行审核
• 编辑一个SKAdNetwork活动
• 在MMP后台查看SKAdNetwork下载

开始之前:

• 只有已经通过审核的iOS应用可以创建SKAdNetwork (iOS 14+)广告活动。 联系您的客户经理或 support提交您的应用进行审核。
• 每个应用、每种广告素材类型（视频、静态、试玩）最多只能创建一个SKAdNetwork广告活动。
• 每个SKAdNetwork活动最多能创建9个目标。

‍

➊ 创建一个新的广告活动

• 在 后台的左下方点击 + CAMPAIGN
• 选择 SKAdNetwork (iOS 14+) Advertising

• 命名您的广告活动.
• 选择您的iOS应用.
• 只有已经通过审核的iOS应用会出现在下拉菜单。如果你还没有iOS应用通过SKAdNetwork活动，请联系您的客户经理或support提交应用进行审核
• 选择一个素材类型: 静态、视频或试玩
• 注意，每个应用每种素材类型只能有一个活动
• 只有已经通过审核的试玩素材会出现在下拉菜单。联系您的客户经理或support。了解更多试玩素材的审核流程.
• SKAdNetwork (iOS 14+)广告活动不支持动画GIF 了解更多广告素材类型

‍

➋ 设置活动目标、价格、预算以及上传素材

• 每个SKAdNetwork活动最多能创建9个目标。前往Campaign Targeting为您的目标命名
• 默认情况下，您的目标将包括所有国家/地区、所操作系统版本（此类广告活动的操作系统为14+ OS）以及所有设备型号
• 设置出价以及预算
• 您可以使用Flexbid工具, 但是SKAdNetwork仅支持‘国家/地区’选项
• 我们正在等待苹果提供更多有关SKAdNetwork下载里的开发者应用方面的信息
• 点击选择Existing或Upload Creatives并进行如下操作
• 拖、放您的广告素材到strong>Upload New Creative Set窗口
• 点击保存.
• 如果您想要添加更多目标，点击Add Target并重复上述步骤
• 您可以使用Advanced Settings安排您的活动、筛选特定应用或公司、选特定手机型号为目标或其它了解更多高级设置.

➌ 提交活动进行审核

• 点击保存当你准备好提交广告活动的时候
• 我们会审核您的广告活动，通常在24至48小时内完成审核

➍ 编辑一个SKAdNetwork活动

• 在广告活动概括中，您会看到SKAdNetwork iOS 14+活动被标上了‘iOS 14+’的图标
• 点击活动，输入‘campaign page’可以编辑已有的SKAdNetwork广告活动进行修改
• 您可以停止广告活动，您无法再创建一个使用同类广告素材的活动，但是可以在修改后重新发布
• 您可以归档活动但您不能取消归档活动。您可以重新创建一个广告活动
• 您无法复制SKAdNetwork广告活动

➎ 在MMP后台查看SKAdNetwork下载

• 我们会将SKAdNetwork下载分享给归因平台，您可以在MMP后台进行查看。目前我们支持Appsflyer, Adjust和Kochava.

‍

在 Chartboost 网络上推广您的 App 获取用户

目录▼

在您开始之前，请确保您已经阅读了相关的条款。

• 您是否下载并集成了Chartboost SDK？如果您计划针对 CPI（单次安装成本）只使用 S2S（服务器到服务器）追踪，则不需要集成 Chartboost SDK。

• 您是否在后台控制面板上添加资金了？了解如何避免超出预算

➊开始新的广告活动

• 点击您后台控制面板左下方的+ 广告活动。
• 选择网络广告（Network Advertising）。
• 命名您的广告活动，选择支持的广告素材类型 – 静态、视频、或试玩广告的素材，然后选择要在这个广告活动中推广的 App。了解更多关于广告素材的类型

➋使用广告目标定向和高级设置优化您的广告活动

• 让我们将一些广告目标添加到您的广告活动中，以便您可以精准推广到正确的用户并获得最大回报。
• 转至广告活动目标定向（Campaign Targeting）为您的第一个广告目标定向输入名称。
• 默认情况下，您的广告目标定向包括所有的国家，所有的设备类型，所有玩家等。可以根据特定玩家、国家和地区、App 以及更多条件自定义您的定位。了解更多关于广告活动目标定向的信息‍
• 您还可以使用高级设置安排您的广告活动，筛选掉特定的 App 或公司、目标定向在特定的设备列表等。了解更多关于高级设置的信息

• 使用后台控制面板分析以确定您广告活动的成效。
• 请看一下我们的广告提示和最佳实践使用更多的方法让您的广告活动出彩。

➌输入您的出价和预算

• 每日预算在 $500 以下经常会迅速耗尽或者甚至超出预算。了解如何避免超出预算

• 当您的广告活动接近每日最高限额时您将收到电子邮件通知。您可以使用这些电子邮件编辑广告活动。
• CPM 广告活动必须有最低 $250 的每日预算。
• CPI 活动必须有最低 $100 的每日预算。
• 使用 Chartboost Insights 查看全球 CPI 报告并做出更明智的出价决策。
• 我应该如何为点击和安装设定出价？
• 详细了解出价类型

➍上传您的广告素材

• 点击上传广告素材。
• 将您的广告素材拖放到上传新广告素材集窗口。
• 点击保存。
• 了解更多关于上传广告素材的信息

• 获取广告的尺寸，阅读指导并学习如何做出惊艳的广告

• 了解更多关于广告类型的信息

➎提交您的广告活动供审批

• 当您准备好开展广告活动时点击保存。
• 我们的团队将审核您的广告活动。广告活动审批需要 24 至 48 个小时。

➏分析数据保持增长

• 使用 Chartboost API 查看您的数据分析，更新广告活动出价，并且可以从后台控制面板执行更多操作。
• 开始重新定向广告活动以便留住现有的用户并最大限度地挖掘其价值。

‍

为了建立一个透明的、安全的以及反作弊的 App 内广告生态, Chartboost 现在已全面支持 app-ads.txt, 一个由 IAB 发起的 App 反作弊标准。当整个广告行业发展到程序化购买阶段, app-ads.txt 将成为每个开发者的技术栈标配，以此提升自身在程序化购买中的变现能力。

app-ads.txt 是什么?

App-ads.txt 是一个文本文件，此文件列出授权销售移动 App 开发者（变现端）广告资源的广告来源。移动 App 开发者将此文件放到自己的网站上，让流量的买方（广告主）平台通过爬虫自动抓取并分析开发者网站上的 app-ads.txt 文件，以此验证所有的竞价请求来自正规的流量卖方。

使用 app-ads.txt 的好处?

• 避免由于未使用 app-ads.txt 而被程序化购买的流量买方（广告主）忽略，因此错失了参与竞价的机会，从而造成潜在的利润损失。
• 作为官方认证的识别符，跟一些模仿自己的流量方区分开来。
• 有效帮助开发者建立己方流量在整个移动广告网络的权威和可信度。
• 进一步参与程序化竞价体系，提供技术栈支持。

如何创建 app-ads.txt 并将 Chartboost 包含其中?

1. 参照 IAB 技术实验室提供的标准 Authorized Sellers for Apps specification 创建您的 app-ads.txt 文件。
2. 要添加 Chartboost 广告网络的内容，首先必须登陆到您的  Chartboost 管理后台。
3. 从左侧的菜单中展开  ‘Tools’。
4. 在 ‘Tools’ 菜单下，您可以看到 app-ads.txt 栏目。
5. 复制 app-ads.txt 栏目里的内容并粘贴到您之前创建的 app-ads.txt 文件里。
6. 将您的 app-ads.txt 上传到您的网站根目录上。一切就完成了！

如何确保正确地添加 app-ads.txt?

• 检查 app-ads.txt file 里面的内容并确保没有拼写错误。
• 例举所有您在各大应用商店发布 App 时使用的开发者网址链接。
• 确保您的 app-ads.txt 存放在您网站的根目录。例如: https://example.com/app-ads.txt。
• 如果您已经在 app-ads.txt 添加过 Chartboost 广告网络的内容，请确保您的文件内容是 Chartboost 后台（进入 Tools -> app-ads.txt 页面）上面的最新列表。

‍

通过CSV上传取消设备ID追踪的操作流程如下：

• 从Chartboost dashboard 左上方选择App

• 前往应用设置（ App Settings ）> 隐私设置（Privacy Settings）

• 在这里您可以上传包含用户设备ID的CSV文档并且选择适用GDPR或CCPA中的其中一个隐私法案。
• GDPR: 通过添加设备ID列表到您的应用，Chartboost将禁止对指定应用上传的设备进行个人信息收集与个性化广告的投放，选择GDPR并上传的设备号将不会被用于行为定向（Behavioral Targeting）但是仍有可能被用于您允许的目的如发送上下文广告(Contextual Targeting) ，评估广告效果和控制广告投放频次。
• CCPA:通过添加设备ID列表到您的应用，Chartboost将禁止对指定应用上传的设备进行个人信息收集与个性化广告的投放。用户数据仍有可能被用于您允许的目的如发送上下文广告(Contextual Targeting) ，评估广告效果和控制广告投放频次。

开发者需要上传的内容格式包含单独一列的设备ID（不需要标题行），如示例所示。 其他格式将返回错误。

68753A44-4D6F-1226-9C60-0050E4C0006768753A44-4D6F-1226-9C60-0050E4C0006868753A44-4D6F-1226-9C60-0050E4C00069

设置您的付款详情以便我们可以支付您的收入。

➊登录到您的后台控制面板

转至您后台控制面板中的管理资金 > 付款详情或者点击这里。

▲返回页首

➋填写您的付款详情

• 填写您的地址信息，然后点击下一步。
• 选择付款方式。

• 电汇：选择您的账户名并输入您的银行信息。
  

• 支票：选择您的货币，并添加您的支票信息。支票取现最低付款金额：75.00 美元。手续费： 10.00 美元。可能会收取 3％ 的货币转换费。
  

• 直接存款/ACH：输入您的银行名称，汇款路径号码，账号和账户类型。
  

• PayPal:自 2017 年 12 月 1 日起， Chartboost 将不再接受 PayPal 作为付款方式。
• 暂停付款：选择此选项时，将不再处理付款。当您重新选择不同的、有效的付款方式时，您的付款将被支付。

• 点击下一步。

如果在地址部分中，您的国家不在付款方式选定国家或地区中，请发送邮件至 payments@chartboost.com 告诉我们。默认情况下，我们假设你的帐户与您的地址在同一个国家或地区。

• 上传 W-9 税务表格（美国服务提供者）或 W-8BEN 税表（国际服务提供者）。

请不要在电子邮件中将您的 W-9 或 W-8BEN 税表发送给我们！Chartboost 对您或发布者应支付给美国国税局或您的政府的税务不进行任何税务代扣。

• 点击下一步。如果您已成功完成了所有这些步骤，您会看到完成。

更改可能需要 最长一个小时时间显示在您的后台控制面板上。

▲返回页首

➌获得报酬

• 开始发布广告活动在您的游戏中显示广告，通过点击、观看等获得收入。
• 请看一下我们的付款条款了解您获得收入的频率。
• 没收到付款？这里有一些原因

▲返回页首

您可能还喜欢…

• 付款条款和要求
• 付款常见问题解答
• 我何时会收到款项？为什么我没有获得付款？

‍

作为媒体，您的目标就是最大化收入，方法是在高 eCPM 的广告活动中展示尽可能多的广告。 当系统依照您设置的发布活动条件获取相应广告活动后，系统会为发布游戏提供最优的广告。 我们衡量业绩的方法是 eCPM 指标，通常定义为每千次广告展示次数的有效成本。不过，因为 Chartboost 的广告主基于每点击次数或每安装次数 (而非每广告展示次数) 参加投标，Chartboost eCPM 由广告活动的安装率 (IR)、点击率 (CTR)和反映活动的整体竞争力的投标组成。 (从展示广告的角度而言，eCPM 代表了当您的游戏为某一广告活动的展示广告次数达到 1000 时您所预计取得的收入。此为关键表现指标，但是我们系统并不使用媒体的 eCPM 将广告活动和广告应用相匹配。) 以下是您可以用来最大化收入的三大策略：1. 使用命名地点来调整您展示广告的位置众所皆知，并非所有的广告位置都一样。我们非常支持应用启动时的广告 (干扰游戏体验最少)，但是也许您的游戏的另一位置最容易获取玩家的关注。关键就是要找到这些位置，命名位置让一切变得简单，不用将重复的代码更新推送至 iTunes 或 Google Play。 详细的 iOS 集成命名位置安装指南在此，但是最基本的想法就是在提交前尽可能多的在代码中添加位置。您可以通过后台按照命名位置管理广告活动，游戏上线后对其进行 A/B 测试也很容易。(如需进行，请前往应用 > 分析 然后运行按广告位置分组报告。)

优化您的活动以控制您游戏中的广告类型、出现频率、哪类用户或设备可见，及其他！

目录 ▼

高级设置

• 计划开始和结束时间
• 逻辑与广告活动优先级
• 按文件包版本号筛选
• 屏蔽特定应用和公司
• 屏蔽评级为成年或 17+ 受众的内容
• 屏蔽直接交易合作伙伴
• 使用列表包括或排除设备
• 数据传输

广告活动定位

• 每用户显示最大广告数
• 按类型、游戏受众或性别进行定位
• 按国家定位
• 按 OS 版本定位
• 按设备类型定位

高级设置

‍
1. 创建一个免费帐户

‍

2. 点击

以展开高级设置并作更改。了解您下方的选项。

‍

3. 完成后点击保存。

计划开始和结束时间

• 为您的广告活动选择开始和结束时间。
• 广告活动默认立即开始并从不结束。
• Chartboost 对广告活动使用太平洋标准时间。了解报告详情

▲ 返回顶部

逻辑与广告活动优先级

• 如果您同时运行多个发布活动，Chartboost 会按照优先级来投放。
• 选择广告活动优先级，从低到最高。了解逻辑和优先级

▲ 返回顶部

按文件包版本号筛选

• 阻止您的应用的特定版本显示广告
• 输入您的应用的最小和/或最大版本号码。

▲ 返回顶部

屏蔽特定应用和公司

• 阻止其他公司或特定游戏显示您的广告活动。
• 点击 ▼ 以展开下拉菜单并选择应用或公司。
• 您可以添加自定义应用列表来屏蔽。

▲ 返回顶部

屏蔽评级为成年或 17+ 受众的内容

选中屏蔽 17+ 复选框以阻止成人游戏显示您的广告。

▲ 返回顶部

使用列表包括或排除设备

• 使用列表生成器来生成和选择完整设备列表用来在此广告活动中包括或排除。
• 选择包括或排除列表。
• 从下拉菜单中选择列表。

▲ 返回顶部

数据传输

• 设置点击、视频浏览或结算安装数的事件通知。
• 设置数据传输，然后从下拉菜单中选中以添加到此广告活动。

▲ 返回顶部

广告活动定位

‍

➊ 从您的后台选择发布活动。

‍

➋ 前往广告活动定位并做更改。了解您下方的选项。

‍

➌ 点击添加定位以添加更多定位。点击

以禁用定位。

‍

➍ 完成后点击保存。

每用户显示最大广告数 (频率封顶)

设置用户在此广告活动中能看到广告的每周、每日或每小时最大次数

▲ 返回顶部

按类型、游戏受众或性别进行定位

• 选择显示广告的类型、您希望定位的游戏受众 — 硬核、中核或休闲 — 以及您希望定位的受众性别。
• 点击类别，选中您希望的选项，然后点击选择。

▲ 返回顶部

按国家定位

• 从您的发布活动中包括或排除特定国家。
• 点击定位选定国家。
• 选择包括或排除，然后从下拉菜单中选择国家。

▲ 返回顶部

按 OS 版本定位

• 从您的发布活动中包括或排除特定 OS 版本。
• 点击定位选定 OS 版本。
• 选择 OS 版本的最小值和最大值。

▲ 返回顶部

按设备类型定位

• 从您的发布活动中包括或排除特定设备系列或型号。
• 点击定位选定设备类型。
• 选择包括或排除。
• 选择系列或型号，然后选择特定系列或型号以定位。

▲ 返回顶部

您可能还希望…

• 开始发布活动: 设置广告活动通过投放广告而赢利。
• 媒体收款: 了解显示广告从而赢利的详情。
• 发布提示和最佳实践: 您信得过的策略，帮助您优化广告活动绩效。
• 发布素材: 添加自定义边框和按钮以打造无缝游戏体验。

‍

通过在您的游戏中发布来自其他开发者应用程序的广告来获得收益。

目录▼

在您开始之前

• 您是否在后台控制面板上填写了付款详情？执行该操作前，无法激活您的广告。
• 您是否下载并集成了Chartboost SDK？您的游戏需要用它来展示广告。

➊开始新的广告活动

• 点击+ CAMPAIGN位于您后台控制面板的左下方。
• 选择网络广告发布。
• 为您的广告发布活动命名，选择您的游戏中要显示的广告类型，选择一个平台，然后选择该活动中您的哪些游戏将显示广告。

➋使用定位和高级设置优化您的广告活动

• 将某些目标定位添加至您的广告活动。向合适的玩家展示恰当的广告，可帮助您获得最多的点击率和浏览量，从而为您创造最大的潜在收入来源。
• 转至广告活动定位并为您的首个定位输入名称。
• 默认情况下，您的定位将包括所有国家、所有设备类型、所有玩家等。可根据特定玩家、国家、游戏类型和更多条件对您的定位进行自定义。了解更多关于广告活动定位的信息

• 您还可以使用高级设置安排您的广告活动，排列其优先级并筛选特定应用程序、公司或设备。了解更多关于高级设置的信息

• 使用后台数据分析来确定广告活动的成效。
• 请查看我们的发布提示和最佳实践，了解更多令广告出彩的方式。

• 当您准备好开始广告活动时，请点击保存。

广告活动可能需要长达 20 分钟才能上线。

➌获得报酬

• 请确保您正确填写了所有的付款详情！
• 转至您的交易历史记录，查看您的收入和付款日期。
• 了解更多关于获得报酬的详情。我会在何时得到报酬？为什么我没有得到报酬？

您可能还喜欢…

• 作为发布者获得报酬：详细了解通过展示广告赚钱的信息。
• 高级设置和定位：优化您的广告发布活动，最大限度地提高收入。
• 发布提示和最佳实践：提升广告成效的可信赖策略。
• 发布素材：添加自定义框架、关闭按钮以提供更好的用户体验。

‍

Chartboost 一直致力于提供高质量的广告流量。

从 2019 年 10 月 23 日起，所有广告变现的 App应用，在启用广告变现活动之前需要经过 Chartboost 官方的审核。

目录 ▼

开始之前

Chartboost 建议开发者先在 App 里将 ChartboostSDK 集成完毕，并提交上线到应用商店以后，再申请应用审核。

如果您的 App 还未成功集成 ChartboostSDK 且上线，将无法通过 App 应用审核。在这种情况下，开发者可以遵循以下步骤：

1. 在 Chartboost 后台 添加一个新 App
2. 先不用填写 bundle ID 或者 App Store URL
3. 开启 测试模式
4. 保存 App 设置
5. 集成 ChartboostSDK
6. 使用 Chatboost 测试模式 检测集成是否成功
7. 将 App 放到设备上运行，请求并展示 Chartboost 通用测试广告
8. 等待 App 设置页面的 SDK 图标变成绿色
9. 这一步先不用着急申请应用审核，会因为还无法提供有效的应用商店地址而被拒绝
10. 当开发者将应用在商店上发布以后，可以参考这里使用 [Import] 将应用导入到 Chartboost 后台
11. 然后按 按以下步骤 申请应用审核

在测试模式下，请不要在 App Settings 页面填写 Bundle ID (GooglePlay) 或者 Market URL (AppStore)，否则关闭测试模式后这个输入框将变成不可修改。必要时请联系您的客户经理或者 Chartboost 技术团队获得支持。

App 应用审核步骤

➊在 Chartboost 后台添加一个新 App应用

如果您希望使用 Chartboost 做广告变现，您需要先在 Chartboost 后台添加一个新 App应用。

• 按这里的步骤 新建 App.
• 在 App’s Settings 页面，请确保您已经使用导入 (Import) 的方式准确地填写 App 在应用商店的地址。

注意 Chartboost 的 App ID 与您的 App应用 必须保持唯一的对应关系。根据我们的条款规定，不能在多个 App 应用里使用同一个 Chartboost AppID。

对于您以前添加过的 App应用，如果从来没有为它们创建过广告发布活动的话，需要重新提交审核申请。

➋下载、集成 Chartboost SDK 并在移动设备上运行

• 下载并集成 Chartboost SDK 到您的 App 里。
• 将您的 App 在手机上运行一次，确保 Chartboost SDK 在 App 里初始化成功。 您将看到在 Chartboost 后台该 App 的 App’s Settings 页面里，“SDK” 图标由灰色变成绿色。
• 如果您希望在申请审核前展示 Chartboost 测试广告，可以使用 测试模式 来实现。

请确保集成了最新版本的 Chartboost SDK，否则有可能因此被拒绝通过。

➌将应用设置成 “允许发布”

您需要将应用的状态设置成”允许发布“，步骤如下：

• 登录进 Chartboost 后台
• 在左上角点击应用图标，并选择你想要提交审核的 App应用
• 在左侧菜单处点击 ‘App Settings’ （应用设置）
• 点击 ‘Basic Settings’ （基本设置）
• 找到  ‘Publishing’ （发布）一栏
• 勾选 ‘Enable this app for Publishing’ (允许发布本应用) 选项。 如果此处是灰色已勾选的状态，说明此应用已经通过审核
• 点击 ”保存“。我们随后会在后台看到您提交的请求记录
• 如果您有多个应用需要提交审核，可重复上述步骤

我们的工作人员会尽快审核您的 App并邮件通知您，请及时查收邮件。审核流程大概需要工作日时间 48 小时。如果您的请求在一周内没有得到回复, 您可以通过 此页面 的 Publishing -> I didn’t get a response to my Publisher App Review Request 来与我们联系。

注意：在已提交 App 应用审核之前，您需要将已集成 Chartboost SDK 的 App 放到移动设备上运行一遍，确保该 App 的 “SDK” 图标已经变成绿色。

➍查看 App应用的审核状态

• 我们会在几个工作日内通过 Email 通知您 App 应用审核的结果。如果您的请求在一周内没有得到回复, 您可以通过 此页面 的 Publishing -> I didn’t get a response to my Publisher App Review Request 来与我们联系。
• 当您的 App 应用成功通过审核，Publishing 选项框会变成 ‘App approved for publishing’ 状态，您就可以马上 创建广告发布活动 啦！

• 当您的 App 应用被拒绝通过，您可以根据本文后面的建议去排查原因，然后再次提交审核。

注意， 在您的 App 应用通过审核之前，在广告发布活动的页面，该 App 应用会在选择窗口中呈灰色（不可选）状态。

为什么我的应用审核不通过?

有多种情况会导致应用审核不通过，常见的原因如下:

• 没有正确地集成 Chartboost SDK（譬如使用了过旧版本的 SDK 或者错误的 App ID）。集成 SDK 的步骤请 参考这里 。
• 无法在应用商店上访问到您的 App，或者 App 仅在某些特定的国家上架。我们的工作人员在审核过程中需要从商店下载您的 App 到测试设备上运行。对于 Google Play 和 Amazon 商店，请提供正确的商店 URL，确保 App 应用可以从美国区或荷兰区的商店上下载。 对于仅在其它国家上架或者还未上架的 App，可以直接将应用的 APK 包发给我们测试。
• 您的 App 应用无法正常运行或者广告弹出太频繁。
• 您的 App 应用不符合 Chartboost 的 条款和规定.

如果您的 App 应用因为以上原因被拒，您可以在 14 日内修复并 联系我们 再次审核。否则，请按照 此页面 的 Publishing -> My app has been rejected for publishing 条目下的步骤进行处理。

如果您使用了第三方的广告中介平台且在 Chartboost 审核被拒

原因可能是我们的审核人员检测到您的 App 在启动时并未成功加载 Chartboost SDK。具体有三种情况：

1. 第三方广告中介平台可能会在启动时按瀑布流的顺序加载各家广告平台的 SDK。如果 Chartboost 未能在第一时间加载，您可以临时将 Chartboost 放在瀑布流靠前的位置。您可以单独只针对荷兰（Netherlands）这个国家做这样的设置。如果您不了解详细的设置方法，可以通过 app.review@chartboost.com 联系我们，记得告诉我们您具体使用的第三方广告平台。
2. 使用第三方广告中介平台跟 Chartboost 集成过程中遇到问题。请查阅并参考下面的文档Chartboost 与第三方广告中介平台集成。如有疑问也请随时联系我们。
3. 已上线的 App 里并未成功集成或者开启 Chartboost。我们建议您线上的 App 务必集成 Chartboost 或者在第三方广告中介里开启 Chartboost，否则将无法通过审核。

我之前在 Chartboost 后台创建的 App，需要重新提交审核申请吗?

对于您之前创建的 App，如果没有创建相应的广告发布活动（Publishing Campaign），则需要重新提交审核申请。具体请参考 “将应用设置成 ‘允许发布’” 一节。

您可能还喜欢…

• 作为发布者获得报酬：  详细了解通过展示广告赚钱的信息。
• 高级设置和定位： 优化您的广告发布活动，最大限度地提高收入。
• 发布提示和最佳实践：  提升广告成效的可信赖策略。

▲ 返回顶部

‍

为 iOS 14 作准备

iOS 14 隐私新规改变了用户定向与安装归因的逻辑。Chartboost 已经为 iOS 新政做好了准备，开发者也需要立即对接我们最新的 SDK。

如果您没有进行以下操作，您的流量将不符合 SKAdNetwork 的规定，我们将无法为您的iOS 14.5+ 用户展示广告，这将严重影响您的变现收入。

‍

1. 下载并对接最新的 Chartboost iOS SDK

点此下载最新的 iOS SDK，对接流程详见此页面

您必须选择 iOS SDK 8.3 或以上版本来符合 SKAdNetwork 的规定。

2. 启用 SKAdNetwork

将我们完整的 SKAdNetwork ID添加到您应用的 info.plist 文件中。

将我们完整的 SKAdNetwork ID 添加到您应用的 info.plist 文件中很重要，因为每一个 SKAdNetwork ID 代表一家广告买量平台。如果没有添加某个平台的 SKAdNetwork ID，那么这家广告买量平台将无法对您的 iOS 14.5 流量竞价，也无法对其带来的下载做正确归因。

Chartboost 完整的 SKAdNetwork IDs 您可以在这里找到 XML 和 JSON 格式，您需要将此处所有的 SKAdNetwork IDs 添加到 info.plist 中。

举例：
将带有 Chartboost 的 SKAdNetwork ID 值 f38h382jlk.skadnetwork 和其他广告平台SKAdNetwork ID 值添加到 Info.plist 中的 SKAdNetworkItems 数组中。

<key>SKAdNetworkItems</key><array><dict><key>SKAdNetworkIdentifier</key><string>f38h382jlk.skadnetwork</string><dict/></array>

更多有关编辑 info.plist 的信息详见以下两个页面：如何添加 SKAdNetwork ID 和 编辑 property lists。

‍

在游戏不同位置显示不同广告活动以便您通过后台微调广告行为。自定义游戏逻辑以便您在正确时机将正确广告请求投放给正确玩家。

目录 ▼

➊在您的代码中调用命名位置

// 显示带位置标记指示关卡结束的插页式广告
[Chartboost showInterstitial:CBLocationLevelComplete];
// 检查是否已缓存您希望从商店显示的激励式视频
[Chartboost hasRewardedVideo:CBLocationIAPStore];iOS SDK 的预定义位置请见 Chartboost.framework > Headers > Chartboost.h

Chartboost.showInterstitial(CBLocation.LOCATION_LEVEL_COMPLETE);
Chartboost.hasRewardedVideo(CBLocation.LOCATION_IAP_STORE);Android SDK 的预定义位置请见 docs 文件夹的 CBLocation 界面类。

Chartboost.showInterstitial(CBLocation.LevelComplete);
Chartboost.hasRewardedVideo(CBLocation.IAPStore)Unity SDK 的预定义位置请见 Chartboost > Scripts > Chartboost.cs▲ 返回顶部

➋设置您的后台以显示命名位置

• 选择您的游戏并前往基础设置。
• 向下滚动到高级设置。

• 从本页面您可以决定每小时或每天在指定位置 (例如主页、暂停页面、第 1 级之后等等) 显示多少广告，所有广告活动通用。您可以删除任意未使用的位置。
• 或选择发布活动并向下滚动至广告活动逻辑栏。

• 选择按位置。

• 选择您在游戏命名位置显示显示广告的频率，针对每个命名位置设置优先级，从从不显示到最高。
• 点击“完成”。

▲ 返回顶部

➌使用命名位置以决定您的广告活动逻辑

• 使用您的后台报告工具以决定哪个广告活动在哪个位置表现更佳。
• 从您的 Chartboost 后台对广告活动进行调整。
• 命名位置并不一定是您游戏中的实际位置，可以由您的游戏逻辑来定义。例如，如果您的玩家将性别设置为“女性”，您可以使用命名位置针对女性受众发布广告。

▲ 返回顶部

➍添加自定义命名位置以进一步控制广告活动行为

使用用户指定字符串来生成您自己的命名位置。  

[Chartboost showInterstitial:@"CustomLocation"];

Chartboost.showInterstitial("CustomLocation");