下载并集成 Chartboost iOS Swift SDK ▶

上次更新:

 

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

 


 

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

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

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

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

查看完整 SDK 发布说明 ▶

 


 

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

 


 

在您开始前:

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

  • 一个 Chartboost 帐户
  • 一个后台上的应用
  • 最新的 SDK
  • 活跃的发布活动
  • 应用必须使用基于 iOS SDK v6.0 或以上的版本编译。
  • 截至2016年6月1日,Apple 要求所有提交应用支持 IPv6。
  • 需要 iOS 版本 6.0 或更高。
  • 需要 iPhone 3GS 或更高版本,或 iPod 第三代及以上,或任何 iPad 型号。
  • Chartboost startWithAppId 调用不可依赖任何用户操作或其他先前网络请求。
  • iOS 10 中的比特代码版本不对 Xcode v7.3.1 向下兼容。升级到 Xcode v8.0+ 以避免比特代码兼容性问题,或在 Xcode v7.3.1 项目中禁用比特代码。

 

解压 SDK 数据包,将 Chartboost 框架放进您的 Xcode 项目中。

确保您同时链接了以下框架:

  • StoreKit
  • Foundation
  • CoreGraphics
  • UIKit
专业提示: 勾选复制所需文件选项。本操作会为您的项目所使用框架创建本地副本,让您的项目井然有序。

 

添加桥接头文件 .h 到您的 Swift 项目。

    • 在您的项目的生成设置中设置 .h 文件。请查阅 iOS 开发者网站上“将 Objective-C 导入 Swift”一栏。
    • 在 .h 文件中,添加如下内容:
#import <UIKit/UIKit.h>
#import <Chartboost/Chartboost.h>
#import <CommonCrypto/CommonDigest.h>
#import <AdSupport/AdSupport.h>

     

    在您的 didFinishLaunchingWithOptions 方法中初始化 Chartboost。

    func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
    // 初始化 Chartboost 库
     Chartboost.startWithAppId("YOUR_CHARTBOOST_APP_ID", appSignature: "YOUR_CHARTBOOST_APP_SIGNATURE", delegate: nil)
    
    ⚠ 您必须初始化 Chartboost 系统方可为您记录游戏启动数。如果您不初始化 Chartboost,您将无法运行广告活动。

       

      如需展示静态或插页式广告视频:

      // 在位置 HomeScreen 展示插页式广告。查看 Chartboost.h 了解可用的位置选项。
      Chartboost.showInterstitial(CBLocationHomeScreen)
      
      强烈推荐您在显示广告前先缓存。了解缓存详情 ▶

         

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

        // 在“MainMenu”位置显示激励式视频前置信息和视频。查看 Chartboost.h 了解可用的位置选项。
        Chartboost.showRewardedVideo(CBLocationMainMenu)
        
            • Chartboost 调用应总是由主线程而非后台发起: 否则调用会超时!
            • 如需自定义控制广告出现的时间和位置,Chartboost SDK 还提供更多特性,如缓存、委托方法和命名位置。
        强烈推荐您在显示广告前先缓存。了解缓存详情 ▶

           

          添加应用 ID 和应用签名。

          使用您的应用 ID 和应用签名来替换 YOUR_CHARTBOOST_APP_IDYOUR_CHARTBOOST_APP_SIGNATURE。即将完成!

           

          如何找到我的应用 ID 和应用签名?

           


             

            测试您的集成。

            如需测试安装,请开始发布活动,添加已集成 SDK 的应用到您的活动中,然后从 Xcode 启动模拟器。 

            如果您在代码调用之处可以看到 Chartboost 的测试插页式广告,那就表示大功告成!请务必禁用测试模式 (从应用设置页面) 以便查看实际网络广告:

             


             

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

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

             


             

               

              最佳实践

              首次运行体验

              这一实践行之有效 (在 iOS 人机互动指南中有所提及),仅在用户第一次玩过您的游戏之后显示插页式广告。

              您可以使用以下 Chartboost SDK 委托方法来阻止插页式广告在第二次初始化调用前出现:

              // 用于 Chartboost SDK v5.0+:
              Chartboost.setShouldRequestInterstitialsInFirstSession(false)
              

              了解更多 Chartboost SDK 特性

              • 缓存: 通过保存到本地加速广告和“更多应用”页面加载时间。
              • Chartboost 视频: 添加优质视频广告为玩家提供最佳游戏内体验。
              • 命名位置: 从后台优化广告活动的对象定位和广告频率。
              • 委托方法: 更好地控制游戏和广告间互动。
              • SDK 配置方法: 访问 Chartboost SDK 功能和设置。
              • “更多应用”: 在您的应用中新建和自定义“查看更多游戏”页面从而为您或其他开发者的游戏投放广告。
              • 安装后数据分析: 用于具有应用内购买的游戏。解锁有关玩家购买行为的数据以优化广告活动或二次营销。
              • 中介: 在一系列顶级网络中展示您的广告。

               

              您可能还希望…