Chartboost for iOS

版本 7.0.2

Chartboost iOS SDK 是 Chartboost 网络的基石。它
提供了展示横幅广告、更多应用页面和
追踪应用内购买收入的功能。

使用方法

1. 开始之前

• 您已经注册了 Chartboost 账户吗？
• 您是否已在仪表板上添加了应用？
• 您是否下载了最新的 SDK？
• 您是否有活跃的发布活动？
• 应用必须使用 iOS 基础 SDK v7.0 或更高版本编译。自 Chartboost 版本 6.5.0 起不再支持 iOS 6.0。
• 截至 2016 年 6 月 1 日，Apple 要求所有提交的应用支持 IPv6。
• Chartboost SDK 只在 iOS 版本 7.0 或更高版本的设备上运行，iPhone 4 或更高版本，第五代或更高版本的 iPod Touch，第二代或更高版本的 iPad。
• startWithAppId:appSignature:delegate: 必须在硬件和软件启动期间始终被调用，无论您的应用正在执行哪些其他操作。

2. 将 Chartboost.framework 拖放到您的 Xcode 项目中。

提示：如果需要，请选中“如果需要则复制项目”选项。这会在您的项目中创建框架本地副本，从而保持项目的整洁。

3. 链接 StoreKit，Foundation，CoreGraphic，WebKit 和 UIKit 框架。

4. 将导入头文件 #import <Chartboost/Chartboost.h> 添加到您的 AppDelegate.m 文件中。

5. 在 didFinishLaunchingWithOptions 方法中初始化 Chartboost。

(BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    // Initialize the Chartboost library
    [Chartboost startWithAppId:@"YOUR_CHARTBOOST_APP_ID"
                  appSignature:@"YOUR_CHARTBOOST_APP_SIGNATURE"
                      delegate:self];
    return YES;
}

**Please note:**

- `startWithAppId:appSignature:delegate:` must always be called during hard and soft bootups, no matter what other actions your app is taking.
- You might receive a warning when passing an object as a delegate into the `startWithAppID:appSignature:delegate:` method. You can usually ignore this warning, but you can also resolve it by ensuring that the object you're passing conforms to the ChartboostDelegate protocol.

6. 添加您的应用 ID 和应用签名。

   • 将 YOUR_CHARTBOOST_APP_ID 和 YOUR_CHARTBOOST_APP_SIGNATURE 替换为您的应用 ID 和应用签名。
   • 我在哪里可以找到我的应用 ID 和应用签名？

7. 要展示静态或视频横幅广告

   • [Chartboost showInterstitial:CBLocationHomeScreen]; 在主屏幕位置展示横幅广告。有关可用的位置选项，请参阅 Chartboost.h。
   • 为了更细心地控制广告在游戏中的行为，Chartboost SDK 还提供了更多功能，例如缓存、代理方法和命名位置。
   • [了解更多关于 Chartboost 视频广告的详情。](https://answers.chartboost.com/hc/en-us/articles/201220275)
   • 重要：Chartboost 调用始终应从主线程而不是后台线程中发出，否则这些调用可能会超时！

8. 要展示奖励视频广告

   • [Chartboost showRewardedVideo:CBLocationMainMenu]; 在主菜单位置展示奖励视频的前置消息和视频广告。有关可用的位置选项，请参阅 Chartboost.h。
   • 为了更细心地控制广告在游戏中的行为，Chartboost SDK 还提供了更多功能，例如缓存、代理方法和命名位置。
   • 了解更多关于 Chartboost 视频广告。
   • 重要：Chartboost 调用始终应从主线程而不是后台线程中发出，否则这些调用可能会超时！

9. 测试您的集成。

   • 从 Xcode 在设备或模拟器上构建并运行您的项目。
   • 如果您的发布活动处于活跃状态并且集成了“展示插屏”或“展示激励视频”调用，您应该能看到活广告。[https://answers.chartboost.com/hc/en-us/articles/204930539]
   • 如果您没有发布活动，但仍然集成了这些调用，您可以使用测试模式来查看测试广告是否显示。
   • 为什么我在游戏里看不到广告？

10. 检查Chartboost仪表板中的SDK图标。

    • 转到您的应用的“应用设置”>“基本设置”，可以在您的仪表板中找到。
    • 当我们的服务器成功接收到使用您的应用ID的SDK启动调用时，您应用图标下的SDK图标将从灰色变为绿色。

深入了解

有关更多常见用例，请访问我们的在线文档。

查看我们的头文件Chartboost.h获取完整的API规范。

如果您遇到任何问题，请毫不犹豫地联系我们的快乐支持团队：[email protected]。