Flurry App Analytics for iOS

Gain deep insight into your customer’s behavior very quickly and with little effort using Flurry Analytics for iOS. The integration process is designed to be as easy as possible with basic setup that you can complete in a short period of time.

1. Get your API Keys

Start by creating an app. Once you create the app, you’ll receive a Flurry API Key, which you’ll need when using the SDK.

Sign up  or  Create an App for iPhone

2. Integrate the SDK With Your App

Note

Minimum supported version is iOS6

Important

If you are using Xcode 7, you can use the latest version of the Flurry SDK (7.1.1). Otherwise, please use the SDK 7.1.0. You can acquire Flurry SDK 7.1.0 from the Cocoapods following the instructions provided below. For direct integration the library files are available from https://github.com/flurry/Flurry-iOS-SDK/tree/7.1.0

Note

Framework and library providers need to include bitcode for Xcode 7 development, and Xcode 7 generates bitcode by default. To build a library without bitcode, either use Xcode 7 with the build setting Enable Bitcode disabled (ENABLE_BITCODE=NO) or use Xcode 6.

There are two distinct ways to acquire the Flurry SDK and to add it into your app. To get the Flurry SDK into your app, use Option 1 or Option 2 :

Option 1: Download the SDK Files and manually add them to your Xcode project

Download the SDK for your iOS project. The downloaded SDK includes the required library containing Flurry’s collection and reporting code.

  • In the Finder, drag the Flurry SDK into your project’s file folder. (Note: If you are upgrading the Flurry iOS SDK, be sure to remove any existing Flurry library folders from your project’s file folder before proceeding.)
  • Now add it to your project: File > Add Files to “YOUR PROJECT”
  • Add SystemConfiguration.framework to your app. This is required for Reachability to manage network operations efficiently.
  • For iOS SDK 4.2.3+, add Security.framework to your app.

Option 2: Acquire the Flurry SDK using CocoaPods

Flurry distributes the iOS SDKs via CocoaPods. CocoaPods is used to install and manage dependencies in existing Xcode projects.

You can install the CocoaPods tool on OS X by running the following command from the terminal:

$ sudo gem install cocoapods

Detailed information is available in the CocoaPods Getting Started guide

To add a Flurry SDK to your iOS app:

  • Create an Xcode project, and save it to your local machine.

  • Create a file named Podfile in your project directory. This file defines your project’s dependencies, and is commonly referred to as a Podspec.

  • Open Podfile, and add your dependencies. A simple Podspec shown here provides the latest SDK:

    target 'yourTargetName' do
    # uncomment next line if you're using Swift
    # use_frameworks!
    pod 'Flurry-iOS-SDK/FlurrySDK'
    # uncomment next line if you also want to use ad publishing
    # pod 'Flurry-iOS-SDK/FlurryAds'
    end
    
  • To acquire an earlier version of the Flurry SDK provide the version desired, for instance:

    target 'yourTargetName' do
    # uncomment next line if you're using Swift
    # use_frameworks!
    pod 'Flurry-iOS-SDK/FlurrySDK', '~> 7.1.0'
    # uncomment next line if you also want to use ad publishing
    # pod 'Flurry-iOS-SDK/FlurryAds', '~> 7.1.0'
    end
    
  • Save the file.

  • Open a terminal and cd to the directory containing the Podfile:

    $ cd <path-to-project>/project/
    
  • Run the pod install command. This will install the SDKs specified in the Podspec, along with any dependencies they may have.:

    $ pod install
    
  • Open your app’s .xcworkspace file to launch Xcode. Use this file for all development on your app.

3. Integrate Flurry Analytics

Note

If you are using Swift, check out our Flurry Swift Integration guide

In your Application delegate, import Flurry and inside applicationDidFinishLaunching: add:

Flurry recommends calling Flurry Analytics from the main thread. Flurry Analytics is not supported when called from other threads.

The Flurry SDK automatically transfers the data captured during the session once the SDK determines the session completed. In case the device is not connected, the data is saved on the device and transferred once the device is connected again. The SDK manages the entire process. Currently, there is no way for the app to schedule the data transfer.

Important

A unique API Key must be used for each distinct app. Using the same API Key across distinct apps is not supported and will result in erroneous data being displayed in Flurry Analytics.

Note

The validity of the Crash Analytics data will be negatively affected by the use of an uncaught exception handler. Please remove all such handlers when using Flurry Crash Analytics.

Following these steps provides you with access to the wide range of features listed below. In the Lexicon section of the documentation, you’ll find detailed descriptions of these features and terms.

  • Sessions
  • Active Users
  • New Users
  • Session Length
  • Frequency of Use
  • Page Views
  • Custom User Segments
  • User Paths
  • Lifecycle Metrics
  • User Retention
  • Version Adoption
  • Cross-App Usage
  • iOS Category Interests
  • Demographic Estimates
  • Time of Day Reporting
  • Geographic Usage
  • Language Metrics
  • Devices
  • Carriers
  • Firmware Versions

Now that you’ve completed the basic setup, you are ready to move on to custom events, which enable you to better understand user behavior through Tracking Custom Events.

Need Help?

Check out our robust collection of FAQs and a detailed Lexicon of key terminology. Didn’t find what you were looking for? Our team is answering questions on Flurry Forums.

Have Feedback?

We’d love to hear your suggestions for us. Please visit our feedback board to submit your ideas.