iOS SDK

This article shows you how to integrate our Offer Wall, Router Link into your iOS App.

1. Get your API Key

Sign up for a new developer account and create a new App. Copy your App Token to initiate the SDK.

2. Install the SDK

Add a Podfile with BitLabs framework as a pod reference:

platform :ios, '12.0'
pod 'BitLabs', '~> 0.1.1'

3. Use the SDK

Initiate the SDK before you use it:

var bitlabs: BitLabs?

bitlabs = BitLabs.Init(token: "YOUR_TOKEN", uid: "YOUR_USER_ID")

Call the .show() function to open the Offer Wall/Router Link

bitlabs?.show(parent: self)

Use .checkForSurveys() to check if a survey is available for the user

bitlabs?.hasSurveys() { result in
           switch result {
           case true:
               debugPrint("Surveys available!")
           case false:
               debugPrint("No surveys available!")
           }
       }

Use .onReward() to check receive callbacks to reward the user. We highly recommend using server-to-server callbacks instead!

bitlabs?.onReward(completionHandler: { payout in
           debugPrint("You earned: \(payout)")
       })

Use .setTags() to pass additional parameters to the SDK you would like to receive in your callback

bitlabs?.setTags(t: ["userType": "New", "isPremium": false])

4. Set up your callbacks

Setting up callbacks can be done on the dashboard. Follow the instructions and examples in our Server to Server Callback Article to properly set up callbacks.