Countly Mobile Analytics - iOS SDK
Switch branches/tags
Nothing to show
Pull request Compare This branch is 540 commits behind Countly:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

##What's Countly? Countly is an innovative, real-time, open source mobile analytics application. It collects data from mobile phones, and visualizes this information to analyze mobile application usage and end-user behavior. There are two parts of Countly: the server that collects and analyzes data, and mobile SDK that sends this data (for iOS & Android).

Countly Server;

Other Countly SDK repositories;


Countly iOS SDK includes necessary tools to track your application. In order to integrate SDK to your application, follow these steps.

  1. Download Countly iOS SDK.
  2. Add these files to your project under Xcode: Countly.h Countly.m Countly_OpenUDID.h Countly_OpenUDID.m
  3. In the project navigator, select your project
  4. Select your project
  5. Select the Build Phases tab
  6. Open Link Binaries With Libraries expander
  7. Click the + button
  8. Select CoreTelephony.framework, select Optional (instead of Required)
  9. (optional) Drag and drop the added framework to the Frameworks group
  10. In your application delegate, import Countly.h and inside application:didFinishLaunchingWithOptions: add the line; [[Countly sharedInstance] start:@"YOUR_APP_KEY" withHost:@""]; at the beginning of the function.

Note that if you use Countly Cloud, you must set withHost parameter to for step 10.

It should finally look like this:

#import "Countly.h"  // newly added line
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
[[Countly sharedInstance] start:@"TYPE_HERE_YOUR_APP_KEY_GENERATED_IN_COUNTLY_ADMIN_DASHBOARD" withHost:@"http://TYPE_HERE_URL_WHERE_API_IS_HOSTED"]; // newly added line
// your code

Note: If your project uses automatic reference counting (ARC), you should disable it for the sources Countly_OpenUDID.m and Countly.m:

  1. Select your project
  2. Select the Build Phases tab
  3. Open Compile Sources tab
  4. Double click Countly.m and Countly_OpenUDID.m and add -fno-objc-arc flag

Note: Before upgrading to a new SDK, do not forget to remove the existing, older SDK from your project.

##How can I help you with your efforts? Glad you asked. We need ideas, feedbacks and constructive comments. All your suggestions will be taken care with upmost importance.

We are on Twitter and Facebook if you would like to keep up with our fast progress!


##Community & support