Kwizzad SDK for iOS

• 展示
• 先决条件
• 迁移
• 安装
• 使用

展示

先决条件

• 您已经有了自己的 KWIZZAD API 密钥和定位 ID。如果没有，请按 电子邮件 联系 TVSMILES，我们将注册您的 APP。
• 集成 KWIZZAD SDK 的 APP 至少需要 iOS 8.0。
• 完整的示例（Objective-C 和 Swift）可以在以下位置找到：示例

迁移指南

从版本 < 2.x.x 迁移指南

• 迁移指南

安装

如何集成 KwizzadSDK Kwizzad 支持 Swift 和 ObjectiveC，并为 CocoaPods 和 Carthage 提供包。

Carthage

Carthage 是 Cocoa 的依赖管理器。要安装 Carthage，请查阅 文档。

在 Carthage 上加载 Kwizzad SDK

• 在你的项目中放入一个 Cartfile。内容

  github "kwizzad/kwizzad-ios" "master"
  

  你可以用你想要坚持的特定版本号替换 master，例如 2.0.0。

• 运行 carthage checkout

  CocoaPods

CocoaPods 同样是 Cocoa 项目的依赖管理器。你可以使用以下命令来安装它

$ gem install cocoapods

在 CocoaPods 上加载 Kwizzad SDK

• 使用 CocoaPods 将 KwizzadSDK 集成到你的 Xcode 项目中，在你的 Podfile 中指定以下内容

  source 'https://github.com/CocoaPods/Specs.git'
  use_frameworks!
  
  target '<Your Target Name>' do
      pod 'KwizzadSDK'
      # Alternatively, if you want to stick to a specific Kwizzad SDK version:
      # pod 'KwizzadSDK', '<version number goes here>'
  end

• 在你的项目的根目录中，在终端中运行以下命令

  $ pod install

用法

步骤 1：初始化 SDK

• 使用 Swift

   KwizzadSDK.setup(apiKey: "YOUR_API_TOKEN_HERE"")```
  

• 使用 Objective-C

  [KwizzadSDK setupWithApiKey:@"YOUR_API_TOKEN_HERE"];

步骤 2：指派 Kwizzad 委托协议

• 使用 Swift

  import KwizzadSDK
  class ViewController: UIViewController, KwizzadSDKDelegate {
     override func viewDidLoad() {
        KwizzadSDK.instance.delegate = self
      }
  }

• 使用 Objective-C

  @interface ViewController () <KwizzadSDKDelegate>
  @end
  
  @implementation ViewController
  - (void)viewDidLoad {
   KwizzadSDK.instance.delegate = self;
  }

步骤 3：请求广告

• 使用 Swift

  KwizzadSDK.instance.requestAd(placementId: YOUR_PLACEMENT)

• 使用 Objective-C

  [KwizzadSDK.instance requestAdWithPlacementId:YOUR_PLACEMENT onAdAvailable:nil];

步骤 4：实现委托函数

请查看 KwizzadExample 应用项目。该项目有两个构建方案，一个用于 Swift，一个用于 Objective-C，以实现委托函数。

• 使用 Swift DebugViewController.swift 包含在一个视图控制器中广告位示例性集成的示例。

• 使用 Objective-C DebugViewController.m 包含在一个视图控制器中广告位示例性集成的示例。

 using the delegate pattern

    Mandatory callbacks :

    - kwizzadDidRequestAd:placementId
    - kwizzadOnAdAvailable:placementId:potentialRewards:adResponse
    - kwizzadOnAdReady:placementId
    - kwizzadDidShowAd:placementId
    - kwizzadGotOpenTransactions:openTransactions
    - kwizzadDidDismissAd:placementId
    - kwizzadOnNoFill:placementId

    Optionals Callbacks :

    - kwizzadOnErrorOccured:placementId:reason
    - kwizzadWillPresentAd:placementId
    - kwizzadOnGoalReached:placementId
    - kwizzadCallToActionClicked:placementId

为了更好地定位，请设置您的用户数据

let userData = kwizzad.userDataModel;
userData.userId = "12345" 
userData.gender = Gender.Female
userData.userName = "Francesca Rossi" 
userData.facebookUserId = "1234abc"