CleverTap iOS SDK
The CleverTap iOS SDK for Mobile Customer Engagement and Analytics solutions
CleverTap brings together real-time user insights, an advanced segmentation engine, and easy-to-use marketing tools in one mobile marketing platform — giving your team the power to create amazing experiences that deepen customer relationships. Our intelligent mobile marketing platform provides the insights you need to keep users engaged and drive long-term retention and growth.
To get started, sign up here
Following are required for using CleverTap iOS SDK -
- iOS 9.0 or later
- tvOS 9.0 or later
- Xcode 10.0 or later
For your iOS, App Extension target(s) and tvOS app, add the following to your Podfile:
target 'YOUR_TARGET_NAME' do pod 'CleverTap-iOS-SDK' end
If your main app is also a watchOS Host, and you wish to capture custom events from your watchOS app, add this:
target 'YOUR_WATCH_EXTENSION_TARGET_NAME' do pod 'CleverTapWatchOS' end
Also, you will need to enable the preprocessor macro via your Podfile by adding this post install hook:
post_install do |installer_representation| installer_representation.pods_project.targets.each do |target| target.build_configurations.each do |config| config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= ['$(inherited)', 'CLEVERTAP_HOST_WATCHOS=1'] end end end
CleverTap also supports
Carthage to package your dependencies as a framework.
To integrate CleverTap into your Xcode project using Carthage, specify it in your
carthage update to build the framework and drag the built
CleverTapSDK.framework into your Xcode project.
Also, follow steps to link SDWebImage into your project
- In your Project, go to Carthage folder
- Select clevertap-ios-sdk under Checkouts
- Drag the built
SDWebImage.frameworkfrom Vendors into your Frameworks and Libraries
Download the latest framework release. Unzip the download.
Add the CleverTapSDK.xcodeproj to your Xcode Project, by dragging the CleverTapSDK.xcodeproj under the main project file.
Embed the framework. Select your app.xcodeproj file. Under "General", add the CleverTapSDK framework as an embedded binary
Add your CleverTap account credentials
Update your .plist file:
- Create a key called CleverTapAccountID with a string value
- Create a key called CleverTapToken with a string value
- Insert the values from your CleverTap Dashboard -> Settings -> Integration Details.
For more details, refer to our installation guide for instructions on installing and using our iOS SDK in your project.
📲 Rich Push Notifications
Apart from Title and Message, you have the below-mentioned options to add to your iOS push notification. Please note that each of these is optional.
For more details, refer to our Advanced iOS Push Notifications guide.
CleverTap Geofence SDK provides Geofencing capabilities to CleverTap iOS SDK. To find the installation & integration steps for CleverTap Geofence SDK, click here.
𝌡 Example Usage
- A demo application showing the integration of our SDK in Objective-C language.
- A demo application showing the integration of our SDK in Swift language.
🆕 Change Log
Refer to the CleverTap iOS SDK Change Log.
CleverTap iOS SDK is released under the MIT license. See LICENSE for details.