Kiip iOS Integration Guide
This guide will walk you through adding Kiip Rewards to your iOS application. Once you’re done, navigate over to the SDK Docs for extra, optional information.
Note: Due to GDPR regulations, Kiip is now blocking all ad requests from the affected EEA regions.
First, make sure you’re registered for a developer account at app.kiip.me. Adding an app to your developer account will issue an app key and secret necessary to integrate the Kiip SDK.
Download the Kiip SDK
The latest Kiip SDK is always downloadable from the downloads page.
Add Yourself as a Test Device
There are two ways to set Test Mode using the Kiip SDK.
1. Setting Test Mode at the build level
This Test Mode method requires Kiip SDK 2.3.0 or higher. To set Test Mode at the build level requires including the following flag:
The default value for this flag is NO.
2. Setting Test Mode at the device level
If using this method, we recommend adding a test device to your app before getting started with integrating Kiip. However, you can add a test device in the Kiip dashboard at any time.
To add a test device to an iOS app, click the
Test Devices button at the bottom of the desired application page on the Kiip Dashboard. Define a unique name for the device and the device’s Advertising ID. You can retrieve your Advertising ID by downloading The Identifiers app.
For pre-iOS 7 devices, substitute the device’s MAC address for Advertising ID.
Note: The iOS Simulator will always be recognized as a test device.
Common Testing Questions
What if I’m not in the US? How do I see a Kiip reward?
When testing from outside the US it is recommended to use a US-based VPN connection when requesting rewards.
Test rewards fill 100% of the time, whereas with live/production rewards it is expected that not every request will be filled with a reward.
It is important that you add the correct device identifier inside the
Test Devices section of the Kiip dashboard.
A null poptart? No test reward? Some devices work but others don’t!
If you’re getting a null poptart, don’t worry. This means you have correctly saved a moment through the SDK, but we didn’t recognize your device as a test device. Try the following steps:
- Ensure limited ad tracking is disabled in
- Ensure you copied and pasted the advertising identifier correctly (with dashes).
If you’re using Cocoapods, you can integrate the Kiip SDK using a Podfile. If you’re not using Cocoapods, skip this section.
If creating your first Podfile, uncomment these two lines of code (or add them).
In your Podfile, add the following pod command.
Navigate to your project folder in a terminal window, and run the following command:
Open up “YOUR_PROJECT_NAME”.xcworkspace and click on your project and go to the “Build Setting.” Under Build Option, there is a field called “Always Embed Swift Standard Libraries.” Mark this as “Yes.”
For more information about using CocoaPods with your app, see the CocoaPods Getting Started Guide. Make sure you have the CocoaPods gem installed on your machine before attempting to install any KiipSDK pods.
Add the Necessary Frameworks
If you’re not using Cocoapods, use the following methods to integrate Kiip. Before Kiip can load within your app, you’ll need to verify you can link the following frameworks below.
KIIPMoatMobileAppKit.framework(SDK version 2.3.2 and above),
XIDLibrary.framework(SDK version 3.0.0 and above) and
KiipSDKResources.bundleinto your XCode project.
Build Phases, verify that
XIDLibrary.frameworkare in the
Link Binary with Librariesand the
Copy Bundle Resourcessection.
Open your projects
Build Phasessection and add in the following frameworks:
WebKit.frameworkSDK version 2.3.2 and above
MediaPlayer.frameworkSDK version 2.0.8 and above
Note: Kiip iOS SDK 2.3.2 and above are enabled with MOAT to measure impressions. If you want a non MOAT Kiip SDK, download Kiip iOS SDK 2.3.1
Note: Kiip iOS SDK 2.3.0 and above requires XCode 7 becuase of bitcode support. They are not compatible with XCode 6 or below. If you are using XCode 6 or below, download Kiip iOS SDK 2.1.1
Linking dependent libraries (SDK version between 3.0.0 and 3.0.2)
Those using Kiip iOS SDK 3.0.0, 3.0.1, or 3.0.2 will need to link the
XIDLibrary.framework. Failure to do so will result in a crash.
- Go to app settings and click the Build Settings tab.
- Navigate to Build Options and change ‘Always Embed Swift Standard Libraries’ to Yes.
- Go to app settings and click the General tab.
- Navigate to Embedded Binaries and add the
- Navigate to Embedded Binaries and add the
Upload a new build to iTunes Connect (Only applicable if KiipSDK includes XIDLibrary)
Navigate to your working project TARGET -> Build phases.
Click on “+” icon and click on “New Run Script Phase”
Copy script below and paste it into “New Run Script Phase”. This script will remove architectures incompatible with iTunes Connect.
Changes for iOS 9
Apple has changed its policies regarding TLS versions and only accepts TLSv1.2 SSL connections (iOS 9 and OSX 10.11). Developers will need to override this restriction by adding the following lines to the app’s Info.plist file
Once you verify you’ve successfully linked the Kiip framework in your project, navigate to your
AppDelegate.h. You will need the following import:
Note: You will need to import the library whenever you want to use a Kiip SDK function.
Then, add an interface for the KiipDelegate in your
Now, you can initialize Kiip in the
didFinishLaunchingWithOptions method, located in
It should look something like this:
Make sure you replace your
app_secret with your actual application key and secret, available on the Kiip dashboard.
Call a Kiip Moment
Kiip moments are points in your Application where you want to reward your user. The end user is allowed to earn rewards multiple times for the same moment. If there is a reward available, the SDK will display the reward to the user.
Locate the file you want to call your Kiip moment, and make sure you import Kiip:
Then, when you want to give a reward to a user, call a moment:
With one call, you’ve let the SDK know that you’d like to show a reward. Through the completion handler, you can also handle other logic, such as lowering the app’s volume.
Something to consider is how you name each moment. When you pass a string to the saveMoment call, such as “finishing level one”, it will be displayed to the end user when your app goes live – unless you change your moment names on your dashboard. The string the reward unit provides is: “Congratulations! Here’s a reward for [your moment name]”.
You can always edit your moment titles later on in the dashboard.
Reward Virtual Currency
If your app provides virtual currency, then you can reward your users with that, as well.
First, you’ll need to enable virtual currency rewards in the dashboard, and assign values to each dollar amount.
Then, place the following listener in your
AppDelegate.m in order to listen for currency rewards.
Make sure virtual currency is enabled for your app. This setting can be found on the app’s profile page in the Kiip dashboard.
This listener will be called by the Kiip SDK after a user redeems a reward that carries a virtual currency value. We will pass a quantity of currency into the method under the
quantity parameter and the name of the currency, if there are multiple, under the
content parameter. You can then handle depositing the value via your in-game currency management.
If a user chooses not to redeem currency, then the value passed down will be zero.
If a virtual currency postback endpoint is provided to kiip, you can confirm issuance of virtual currency and gain access to additional virtual currency reward opportunities.
Access more inventory, increase engagement and drive more revenue with Rewarded Video. To utilize Rewarded Video, designate and individual moments placement in the Kiip dashboard.
We’ve provided a couple of sample applications for you to browse. Check out our public Github repo in case you’d like to try custom notifications, or just need to see some code-samples.
Trouble with test rewards?
If your test device is not located in the US and you’re having trouble retrieving a test reward, please use a VPN with set to a US location.
We’re happy to answer any questions about integrating Kiip. Please email us.