Merge lp:~rockstar/ubuntuone-ios-music/flurry-analytics into lp:ubuntuone-ios-music

[Paul Hummer]

Add Flurry analytics

This branch adds Flurry analytics to the U1 Music app. I added the base analytics, and timed event logging for each of the view controllers.

[lp:~rockstar/ubuntuone-ios-music/flurry-analytics]

294. By Paul Hummer on 2013-02-11

Fix copy and paste errors

[Roberto Alsina (ralsina)]

review: Approve

=== added directory 'Dependencies/Flurry'
=== added file 'Dependencies/Flurry/Flurry.h'
--- Dependencies/Flurry/Flurry.h	1970-01-01 00:00:00 +0000
+++ Dependencies/Flurry/Flurry.h	2013-02-11 04:20:26 +0000
@@ -0,0 +1,611 @@
+//
+//  Flurry.h
+//  Flurry iOS Analytics Agent
+//
+//  Copyright 2009-2012 Flurry, Inc. All rights reserved.
+//	
+//	Methods in this header file are for use with Flurry Analytics
+
+#import <UIKit/UIKit.h>
+
+/*!
+ *  @brief Provides all available methods for defining and reporting Analytics from use
+ *  of your app.
+ * 
+ *  Set of methods that allow developers to capture detailed, aggregate information
+ *  regarding the use of their app by end users.
+ *  
+ *  @note This class provides methods necessary for correct function of FlurryAds.h.
+ *  For information on how to use Flurry's Ads SDK to
+ *  attract high-quality users and monetize your user base see <a href="http://support.flurry.com/index.php?title=Publishers">Support Center - Publishers</a>.
+ *  
+ *  @author 2009 - 2012 Flurry, Inc. All Rights Reserved.
+ *  @version 4.0.0
+ * 
+ */
+@interface Flurry : NSObject {
+}
+
+/** @name Pre-Session Calls
+ *  Optional sdk settings that should be called before start session. 
+ */
+//@{
+
+/*!
+ *  @brief Explicitly specifies the App Version that Flurry will use to group Analytics data.
+ *  @since 2.7
+ *
+ *  This is an optional method that overrides the App Version Flurry uses for reporting. Flurry will
+ *  use the CFBundleVersion in your info.plist file when this method is not invoked.
+ *
+ *  @note There is a maximum of 605 versions allowed for a single app. \n
+ *  This method must be called prior to invoking #startSession:.
+ *
+ *  @param version The custom version name.
+ */
+
++ (void)setAppVersion:(NSString *)version;
+
+/*!
+ *  @brief Retrieves the Flurry Agent Build Version.
+ *  @since 2.7
+ *
+ *  This is an optional method that retrieves the Flurry Agent Version the app is running under. 
+ *  It is most often used if reporting an unexpected behavior of the SDK to <a href="mailto:[e-mail]">
+ *  Flurry Support</a>
+ *
+ *  @note This method must be called prior to invoking #startSession:. \n
+ *  FAQ for the iPhone SDK is located at <a href="http://wiki.flurry.com/index.php?title=IPhone_FAQ">
+ *  Support Center - iPhone FAQ</a>.
+ *
+ *  @see #setDebugLogEnabled: for information on how to view debugging information on your console.
+ *
+ *  @return The agent version of the Flurry SDK.
+ *
+ */
++ (NSString *)getFlurryAgentVersion;
+
+/*!
+ *  @brief Displays an exception in the debug log if thrown during a Session.
+ *  @since 2.7
+ *
+ *  This is an optional method that augments the debug logs with exceptions that occur during the session.
+ *  You must both capture exceptions to Flurry and set debug logging to enabled for this method to
+ *  display information to the console. The default setting for this method is @c NO.
+ *
+ *  @note This method must be called prior to invoking #startSession:.
+ *
+ *  @see #setDebugLogEnabled: for information on how to view debugging information on your console. \n
+ *  #logError:message:exception: for details on logging exceptions. \n
+ *  #logError:message:error: for details on logging errors.
+ *
+ *  @param value @c YES to show errors in debug logs, @c NO to omit errors in debug logs.
+ */
++ (void)setShowErrorInLogEnabled:(BOOL)value;
+
+/*!
+ *  @brief Generates debug logs to console.
+ *  @since 2.7
+ *
+ *  This is an optional method that displays debug information related to the Flurry SDK.
+ *  display information to the console. The default setting for this method is @c NO.
+ *
+ *  @note This method must be called prior to invoking #startSession:.
+ *
+ *  @param value @c YES to show debug logs, @c NO to omit debug logs.
+ *
+ */
++ (void)setDebugLogEnabled:(BOOL)value;	
+
+/*!
+ *  @brief Set the timeout for expiring a Flurry session.
+ *  @since 2.7
+ * 
+ *  This is an optional method that sets the time the app may be in the background before 
+ *  starting a new session upon resume.  The default value for the session timeout is 10 
+ *  seconds in the background.
+ * 
+ *  @note This method must be called prior to invoking #startSession:.
+ * 
+ *  @param seconds The time in seconds to set the session timeout to.
+ */
++ (void)setSessionContinueSeconds:(int)seconds;
+
+/*!
+ *  @brief Send data over a secure transport.
+ *  @since 3.0
+ * 
+ *  This is an optional method that sends data over an SSL connection when enabled. The
+ *  default value is @c NO.
+ * 
+ *  @note This method must be called prior to invoking #startSession:.
+ * 
+ *  @param value @c YES to send data over secure connection.
+ */
++ (void)setSecureTransportEnabled:(BOOL)value;
+
+//@}
+
+/*!
+ *  @brief Start a Flurry session for the project denoted by @c apiKey.
+ *  @since 2.6
+ * 
+ *  This method serves as the entry point to Flurry Analytics collection.  It must be
+ *  called in the scope of @c applicationDidFinishLaunching.  The session will continue 
+ *  for the period the app is in the foreground until your app is backgrounded for the 
+ *  time specified in #setSessionContinueSeconds:. If the app is resumed in that period
+ *  the session will continue, otherwise a new session will begin.
+ * 
+ *  @note If testing on a simulator, please be sure to send App to background via home
+ *  button. Flurry depends on the iOS lifecycle to be complete for full reporting.
+ * 
+ * @see #setSessionContinueSeconds: for details on setting a custom session timeout.
+ *
+ * @code
+ *  - (void)applicationDidFinishLaunching:(UIApplication *)application 
+ {
+ // Optional Flurry startup methods
+ [Flurry startSession:@"YOUR_API_KEY"];
+ // ....
+ }
+ * @endcode
+ * 
+ * @param apiKey The API key for this project.
+ */
+
++ (void)startSession:(NSString *)apiKey;
+
+/** @name Event and Error Logging
+ *  Methods for reporting custom events and errors during the session. 
+ */
+//@{
+
+/*!
+ *  @brief Records a custom event specified by @c eventName.
+ *  @since 2.8.4
+ * 
+ *  This method allows you to specify custom events within your app.  As a general rule
+ *  you should capture events related to user navigation within your app, any action 
+ *  around monetization, and other events as they are applicable to tracking progress
+ *  towards your business goals. 
+ * 
+ *  @note You should not pass private or confidential information about your users in a
+ *  custom event. \n
+ *  Where applicable, you should make a concerted effort to use timed events with
+ *  parameters (#logEvent:withParameters:timed:) or events with parameters 
+ *  (#logEvent:withParameters:). This provides valuable information around the time the user
+ *  spends within an action (e.g. - time spent on a level or viewing a page) or characteristics
+ *  of an action (e.g. - Buy Event that has a Parameter of Widget with Value Golden Sword).
+ * 
+ *  @see #logEvent:withParameters: for details on storing events with parameters. \n
+ *  #logEvent:timed: for details on storing timed events. \n
+ *  #logEvent:withParameters:timed: for details on storing timed events with parameters. \n
+ *  #endTimedEvent:withParameters: for details on stopping a timed event and (optionally) updating 
+ *  parameters.
+ *
+ *  @code
+ *  - (void)interestingAppAction 
+ {
+ [Flurry logEvent:@"Interesting_Action"];
+ // Perform interesting action
+ }
+ *  @endcode
+ * 
+ *  @param eventName Name of the event. For maximum effectiveness, we recommend using a naming scheme
+ *  that can be easily understood by non-technical people in your business domain.
+ */
++ (void)logEvent:(NSString *)eventName;
+
+/*!
+ *  @brief Records a custom parameterized event specified by @c eventName with @c parameters.
+ *  @since 2.8.4
+ * 
+ *  This method overrides #logEvent to allow you to associate parameters with an event. Parameters
+ *  are extremely valuable as they allow you to store characteristics of an action. For example,
+ *  if a user purchased an item it may be helpful to know what level that user was on.
+ *  By setting this parameter you will be able to view a distribution of levels for the purcahsed
+ *  event on the <a href="http://dev.flurry.com">Flurrly Dev Portal</a>.
+ * 
+ *  @note You should not pass private or confidential information about your users in a
+ *  custom event. \n
+ *  A maximum of 10 parameter names may be associated with any event. Sending
+ *  over 10 parameter names with a single event will result in no parameters being logged
+ *  for that event. You may specify an infinite number of Parameter values. For example,
+ *  a Search Box would have 1 parameter name (e.g. - Search Box) and many values, which would
+ *  allow you to see what values users look for the most in your app. \n
+ *  Where applicable, you should make a concerted effort to use timed events with
+ *  parameters (#logEvent:withParameters:timed:). This provides valuable information 
+ *  around the time the user spends within an action (e.g. - time spent on a level or 
+ *  viewing a page).
+ * 
+ *  @see #logEvent:withParameters:timed: for details on storing timed events with parameters. \n
+ *  #endTimedEvent:withParameters: for details on stopping a timed event and (optionally) updating 
+ *  parameters.
+ *
+ *  @code
+ *  - (void)userPurchasedSomethingCool 
+ {
+ NSDictionary *params =
+ [NSDictionary dictionaryWithObjectsAndKeys:@"Cool Item", // Parameter Value
+ @"Item Purchased", // Parameter Name
+ nil];
+ [Flurry logEvent:@"Something Cool Purchased" withParameters:params];
+ // Give user cool item
+ }
+ *  @endcode
+ * 
+ *  @param eventName Name of the event. For maximum effectiveness, we recommend using a naming scheme
+ *  that can be easily understood by non-technical people in your business domain.
+ *  @param parameters A map containing Name-Value pairs of parameters.
+ */
++ (void)logEvent:(NSString *)eventName withParameters:(NSDictionary *)parameters;
+
+/*!
+ *  @brief Records an app exception. Commonly used to catch unhandled exceptions.
+ *  @since 2.7
+ * 
+ *  This method captures an exception for reporting to Flurry. We recommend adding an uncaught
+ *  exception listener to capture any exceptions that occur during usage that is not
+ *  anticipated by your app.
+ * 
+ *  @see #logError:message:error: for details on capturing errors.
+ *
+ *  @code
+ *  - (void) uncaughtExceptionHandler(NSException *exception) 
+ {
+ [Flurry logError:@"Uncaught" message:@"Crash!" exception:exception];
+ }
+ 
+ - (void)applicationDidFinishLaunching:(UIApplication *)application 
+ {
+ NSSetUncaughtExceptionHandler(&uncaughtExceptionHandler);
+ [Flurry startSession:@"YOUR_API_KEY"];
+ // ....
+ }
+ *  @endcode
+ * 
+ *  @param errorID Name of the error.
+ *  @param message The message to associate with the error.
+ *  @param exception The exception object to report.
+ */
++ (void)logError:(NSString *)errorID message:(NSString *)message exception:(NSException *)exception;
+
+/*!
+ *  @brief Records an app error.
+ *  @since 2.7
+ * 
+ *  This method captures an error for reporting to Flurry.
+ * 
+ *  @see #logError:message:exception: for details on capturing exceptions.
+ *
+ *  @code
+ *  - (void) webView:(UIWebView *)webView didFailLoadWithError:(NSError *)error 
+ {
+ [Flurry logError:@"WebView No Load" message:[error localizedDescription] error:error];
+ }
+ *  @endcode
+ * 
+ *  @param errorID Name of the error.
+ *  @param message The message to associate with the error.
+ *  @param error The error object to report.
+ */
++ (void)logError:(NSString *)errorID message:(NSString *)message error:(NSError *)error;
+
+/*!
+ *  @brief Records a timed event specified by @c eventName.
+ *  @since 2.8.4
+ * 
+ *  This method overrides #logEvent to allow you to capture the length of an event. This can
+ *  be extremely valuable to understand the level of engagement with a particular action. For
+ *  example, you can capture how long a user spends on a level or reading an article.
+ * 
+ *  @note You should not pass private or confidential information about your users in a
+ *  custom event. \n
+ *  Where applicable, you should make a concerted effort to use parameters with your timed 
+ *  events (#logEvent:withParameters:timed:). This provides valuable information 
+ *  around the characteristics of an action (e.g. - Buy Event that has a Parameter of Widget with 
+ *  Value Golden Sword).
+ * 
+ *  @see #logEvent:withParameters:timed: for details on storing timed events with parameters. \n
+ *  #endTimedEvent:withParameters: for details on stopping a timed event and (optionally) updating 
+ *  parameters.
+ *
+ *  @code
+ *  - (void)startLevel 
+ {
+ [Flurry logEvent:@"Level Played" timed:YES];
+ // Start user on level
+ }
+ 
+ - (void)endLevel 
+ {
+ [Flurry endTimedEvent:@"Level Played" withParameters:nil];
+ // User done with level
+ }
+ *  @endcode
+ * 
+ *  @param eventName Name of the event. For maximum effectiveness, we recommend using a naming scheme
+ *  that can be easily understood by non-technical people in your business domain.
+ *  @param timed Specifies the event will be timed.
+ */
++ (void)logEvent:(NSString *)eventName timed:(BOOL)timed;
+
+/*!
+ *  @brief Records a custom parameterized timed event specified by @c eventName with @c parameters.
+ *  @since 2.8.4
+ * 
+ *  This method overrides #logEvent to allow you to capture the length of an event with parameters. 
+ *  This can be extremely valuable to understand the level of engagement with a particular action 
+ *  and the characteristics associated with that action. For example, you can capture how long a user 
+ *  spends on a level or reading an article. Parameters can be used to capture, for example, the
+ *  author of an article or if something was purchased while on the level.
+ * 
+ *  @note You should not pass private or confidential information about your users in a
+ *  custom event.
+ *
+ *  @see #endTimedEvent:withParameters: for details on stopping a timed event and (optionally) updating 
+ *  parameters.
+ *
+ *  @code
+ *  - (void)startLevel 
+ {
+ NSDictionary *params =
+ [NSDictionary dictionaryWithObjectsAndKeys:@"100", // Parameter Value
+ @"Current Points", // Parameter Name
+ nil];
+ 
+ [Flurry logEvent:@"Level Played" withParameters:params timed:YES];
+ // Start user on level
+ }
+ 
+ - (void)endLevel 
+ {
+ // User gained additional 100 points in Level
+ NSDictionary *params =
+ [NSDictionary dictionaryWithObjectsAndKeys:@"200", // Parameter Value
+ @"Current Points", // Parameter Name
+ nil];
+ [Flurry endTimedEvent:@"Level Played" withParameters:params];
+ // User done with level
+ }
+ *  @endcode
+ * 
+ *  @param eventName Name of the event. For maximum effectiveness, we recommend using a naming scheme
+ *  that can be easily understood by non-technical people in your business domain.
+ *  @param parameters A map containing Name-Value pairs of parameters.
+ *  @param timed Specifies the event will be timed.
+ */
++ (void)logEvent:(NSString *)eventName withParameters:(NSDictionary *)parameters timed:(BOOL)timed;
+
+/*!
+ *  @brief Ends a timed event specified by @c eventName and optionally updates parameters with @c parameters.
+ *  @since 2.8.4
+ * 
+ *  This method ends an existing timed event.  If parameters are provided, this will overwrite existing
+ *  parameters with the same name or create new parameters if the name does not exist in the parameter
+ *  map set by #logEvent:withParameters:timed:.
+ * 
+ *  @note You should not pass private or confidential information about your users in a
+ *  custom event. \n
+ *  If the app is backgrounded prior to ending a timed event, the Flurry SDK will automatically
+ *  end the timer on the event. \n 
+ *  #endTimedEvent:withParameters: is ignored if called on a previously
+ *  terminated event.
+ *
+ *  @see #logEvent:withParameters:timed: for details on starting a timed event with parameters.
+ *
+ *  @code
+ *  - (void)startLevel 
+ {
+ NSDictionary *params =
+ [NSDictionary dictionaryWithObjectsAndKeys:@"100", // Parameter Value
+ @"Current Points", // Parameter Name
+ nil];
+ 
+ [Flurry logEvent:@"Level Played" withParameters:params timed:YES];
+ // Start user on level
+ }
+ 
+ - (void)endLevel 
+ {
+ // User gained additional 100 points in Level
+ NSDictionary *params =
+ [NSDictionary dictionaryWithObjectsAndKeys:@"200", // Parameter Value
+ @"Current Points", // Parameter Name
+ nil];
+ [Flurry endTimedEvent:@"Level Played" withParameters:params];
+ // User done with level
+ }
+ *  @endcode
+ * 
+ *  @param eventName Name of the event. For maximum effectiveness, we recommend using a naming scheme
+ *  that can be easily understood by non-technical people in your business domain.
+ *  @param parameters A map containing Name-Value pairs of parameters.
+ */
++ (void)endTimedEvent:(NSString *)eventName withParameters:(NSDictionary *)parameters;	// non-nil parameters will update the parameters
+
+//@}
+
+
+/** @name Page View Methods
+ *  Count page views. 
+ */
+//@{
+
+/*!
+ *  @brief Automatically track page views on a @c UINavigationController or @c UITabBarController.
+ *  @since 2.7
+ * 
+ *  This method increments the page view count for a session based on traversing a UINavigationController
+ *  or UITabBarController. The page view count is only a counter for the number of transitions in your
+ *  app. It does not associate a name with the page count. To associate a name with a count of occurences
+ *  see #logEvent:.
+ * 
+ *  @note Please make sure you assign the Tab and Navigation controllers to the view controllers before
+ *  passing them to this method.
+ *
+ *  @see #logPageView for details on explictly incrementing page view count.
+ *
+ *  @code
+ * -(void) trackViewsFromTabBar:(UITabBarController*) tabBar 
+ {
+ [Flurry logAllPageViews:tabBar];
+ }
+ *  @endcode
+ * 
+ *  @param target The navigation or tab bar controller.
+ */
++ (void)logAllPageViews:(id)target;		
+
+/*!
+ *  @brief Explicitly track a page view during a session.
+ *  @since 2.7
+ * 
+ *  This method increments the page view count for a session when invoked. It does not associate a name
+ *  with the page count. To associate a name with a count of occurences see #logEvent:.
+ *
+ *  @see #logAllPageViews for details on automatically incrementing page view count based on user
+ *  traversing navigation or tab bar controller.
+ *
+ *  @code
+ *  -(void) trackView 
+ {
+ [Flurry logPageView];
+ }
+ *  @endcode
+ *
+ */
++ (void)logPageView;
+
+//@}
+
+/** @name User Info
+ *  Methods to set user information. 
+ */
+//@{
+
+/*!
+ *  @brief Assign a unique id for a user in your app.
+ *  @since 2.7
+ * 
+ *  @note Please be sure not to use this method to pass any private or confidential information
+ *  about the user.
+ *
+ *  @param userID The app id for a user.
+ */
++ (void)setUserID:(NSString *)userID;	
+
+/*!
+ *  @brief Set your user's age in years.
+ *  @since 2.7
+ * 
+ *  Use this method to capture the age of your user. Only use this method if you collect this
+ *  information explictly from your user (i.e. - there is no need to set a default value).
+ *
+ *  @note The age is aggregated across all users of your app and not available on a per user
+ *  basis.
+ *
+ *  @param age Reported age of user.
+ *
+ */
++ (void)setAge:(int)age;
+
+/*!
+ *  @brief Set your user's gender.
+ *  @since 2.7
+ * 
+ *  Use this method to capture the gender of your user. Only use this method if you collect this
+ *  information explictly from your user (i.e. - there is no need to set a default value). Allowable
+ *  values are @c @"M" or @c @"F"
+ *
+ *  @note The gender is aggregated across all users of your app and not available on a per user
+ *  basis.
+ *
+ *  @param gender Reported gender of user.
+ *
+ */
++ (void)setGender:(NSString *)gender;	// user's gender m or f
+
+//@}
+
+/** @name Location Reporting
+ *  Methods for setting location information. 
+ */
+//@{
+/*!
+ *  @brief Set the location of the session.
+ *  @since 2.7
+ * 
+ *  Use information from the CLLocationManager to specify the location of the session. Flurry does not
+ *  automatically track this information or include the CLLocation framework.
+ *
+ *  @note Only the last location entered is captured per session. \n
+ *  Regardless of accuracy specified, the Flurry SDK will only report location at city level or higher. \n
+ *  Location is aggregated across all users of your app and not available on a per user basis. \n
+ *  This information should only be captured if it is germaine to the use of your app.
+ *
+ *  @code
+ CLLocationManager *locationManager = [[CLLocationManager alloc] init];
+ [locationManager startUpdatingLocation];
+ 
+ CLLocation *location = locationManager.location;
+ [Flurry setLatitude:location.coordinate.latitude
+ longitude:location.coordinate.longitude
+ horizontalAccuracy:location.horizontalAccuracy
+ verticalAccuracy:location.verticalAccuracy];
+ *  @endcode
+ *  @param latitude The latitude.
+ *  @param longitude The longitude.
+ *  @param horizontalAccuracy The radius of uncertainty for the location in meters.
+ *  @param verticalAccuracy The accuracy of the altitude value in meters.
+ *
+ */
++ (void)setLatitude:(double)latitude longitude:(double)longitude horizontalAccuracy:(float)horizontalAccuracy verticalAccuracy:(float)verticalAccuracy;
+
+//@}
+
+/** @name Session Reporting Calls
+ *  Optional methods that can be called at any point to control session reporting. 
+ */
+//@{
+
+/*!
+ *  @brief Set session to report when app closes.
+ *  @since 2.7
+ * 
+ *  Use this method report session data when the app is closed. The default value is @c YES.
+ *
+ *  @note This method is rarely invoked in iOS >= 3.2 due to the updated iOS lifecycle.
+ *
+ *  @see #setSessionReportsOnPauseEnabled:
+ *
+ *  @param sendSessionReportsOnClose YES to send on close, NO to omit reporting on close.
+ *
+ */
++ (void)setSessionReportsOnCloseEnabled:(BOOL)sendSessionReportsOnClose;	
+
+/*!
+ *  @brief Set session to report when app is sent to the background.
+ *  @since 2.7
+ * 
+ *  Use this method report session data when the app is paused. The default value is @c NO.
+ *
+ *  @param setSessionReportsOnPauseEnabled YES to send on pause, NO to omit reporting on pause.
+ *
+ */
++ (void)setSessionReportsOnPauseEnabled:(BOOL)setSessionReportsOnPauseEnabled;
+
+/*!
+ *  @brief Enable custom event logging.
+ *  @since 2.7
+ * 
+ *  Use this method to allow the capture of custom events. The default value is @c YES.
+ *
+ *  @param value YES to enable event logging, NO to stop custom logging.
+ *
+ */
++ (void)setEventLoggingEnabled:(BOOL)value;	
+
+//@}
+
+@end
 
=== added file 'Dependencies/Flurry/libFlurry.a'
 Binary files Dependencies/Flurry/libFlurry.a	1970-01-01 00:00:00 +0000 and Dependencies/Flurry/libFlurry.a	2013-02-11 04:20:26 +0000 differ
=== modified file 'Music/UOAppDelegate.m'
--- Music/UOAppDelegate.m	2013-02-08 17:05:40 +0000
+++ Music/UOAppDelegate.m	2013-02-11 04:20:26 +0000
@@ -56,6 +56,7 @@
 
 - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions: (NSDictionary *)launchOptions {
     [Crashlytics startWithAPIKey:@"0606692bafe724ed1413548f6211a8557140eade"];
+    [Flurry startSession:@"BTQGJ5ZF8C7SMQG3GC5F"];
     
     self.window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds ]];
 
 
=== modified file 'Music/View Controllers/AlbumViewController.m'
--- Music/View Controllers/AlbumViewController.m	2013-02-11 04:20:26 +0000
+++ Music/View Controllers/AlbumViewController.m	2013-02-11 04:20:26 +0000
@@ -34,10 +34,12 @@
 @synthesize artistId = _artistId;
 
 - (void)viewDidLoad {
+    [super viewDidLoad];
     [self.tableView setDataSource:self];
 }
 
 - (void)viewWillAppear:(BOOL)animated {
+    [super viewWillAppear:animated];
     [self fetchAlbum];
     
     if ([[UOPlayer player] currentSong]) {
@@ -69,6 +71,13 @@
     } else {
         [[UOWebServiceController controller] updateSongs:self];
     }
+    
+    [Flurry logEvent:EVENT_ALBUM_VIEW timed:YES];
+}
+
+- (void)viewDidDisappear:(BOOL)animated {
+    [super viewDidDisappear:animated];
+    [Flurry endTimedEvent:EVENT_ALBUM_VIEW withParameters:nil];
 }
 
 - (void)viewDidUnload {
 
=== modified file 'Music/View Controllers/AlbumsViewController.m'
--- Music/View Controllers/AlbumsViewController.m	2013-02-11 04:20:26 +0000
+++ Music/View Controllers/AlbumsViewController.m	2013-02-11 04:20:26 +0000
@@ -50,6 +50,18 @@
     [[UOWebServiceController controller] updateAlbums:self clearCache:YES];
 }
 
+#pragma mark - View controller lifecycle
+
+- (void)viewWillAppear:(BOOL)animated {
+    [super viewWillAppear:animated];
+    [Flurry logEvent:EVENT_ALBUMS_VIEW timed:YES];
+}
+
+- (void)viewDidDisappear:(BOOL)animated {
+    [super viewDidDisappear:animated];
+    [Flurry endTimedEvent:EVENT_ALBUMS_VIEW withParameters:nil];
+}
+
 #pragma mark - Storyboard methods
 
 - (void)prepareForSegue:(UIStoryboardSegue *)segue sender:(id)sender {
 
=== modified file 'Music/View Controllers/ArtistViewController.m'
--- Music/View Controllers/ArtistViewController.m	2013-02-11 04:20:26 +0000
+++ Music/View Controllers/ArtistViewController.m	2013-02-11 04:20:26 +0000
@@ -35,6 +35,7 @@
 @synthesize artistId = _artistId;
 
 - (void)viewDidLoad {
+    [super viewDidLoad];
     [self.tableView setDataSource:self];
 }
 
@@ -63,6 +64,14 @@
     NSSortDescriptor *sortDescriptor = [[NSSortDescriptor alloc] initWithKey:@"year" ascending:NO];
     tableData = [artist.albums sortedArrayUsingDescriptors:@[sortDescriptor]];
     [self.tableView reloadData];
+    
+    [super viewWillAppear:animated];
+    [Flurry logEvent:EVENT_ARTIST_VIEW timed:YES];
+}
+
+- (void)viewDidDisappear:(BOOL)animated {
+    [super viewDidDisappear:animated];
+    [Flurry endTimedEvent:EVENT_ARTIST_VIEW withParameters:nil];
 }
 
 - (void)viewDidUnload {
 
=== modified file 'Music/View Controllers/ArtistsViewController.m'
--- Music/View Controllers/ArtistsViewController.m	2013-02-11 04:20:26 +0000
+++ Music/View Controllers/ArtistsViewController.m	2013-02-11 04:20:26 +0000
@@ -53,6 +53,18 @@
     [[UOWebServiceController controller] updateArtists:self clearCache:YES];
 }
 
+#pragma mark - View controller lifecycle
+
+- (void)viewWillAppear:(BOOL)animated {
+    [super viewWillAppear:animated];
+    [Flurry logEvent:EVENT_ARTISTS_VIEW timed:YES];
+}
+
+- (void)viewDidDisappear:(BOOL)animated {
+    [super viewDidDisappear:animated];
+    [Flurry endTimedEvent:EVENT_ARTISTS_VIEW withParameters:nil];
+}
+
 #pragma mark - Storyboard methods
 
 - (void)prepareForSegue:(UIStoryboardSegue *)segue sender:(id)sender {
 
=== modified file 'Music/View Controllers/PlayerViewController.m'
--- Music/View Controllers/PlayerViewController.m	2013-02-11 04:20:26 +0000
+++ Music/View Controllers/PlayerViewController.m	2013-02-11 04:20:26 +0000
@@ -41,6 +41,7 @@
     [self updateCurrentSong];
     
     heartbeat = [NSTimer scheduledTimerWithTimeInterval:0.5f target:self selector:@selector(heartbeat:) userInfo:nil repeats:YES];
+    [Flurry logEvent:EVENT_PLAYER_VIEW timed:YES];
 }
 
 - (void)viewDidDisappear:(BOOL)animated {
@@ -51,6 +52,8 @@
     
     [heartbeat invalidate];
     heartbeat = nil;
+    
+    [Flurry endTimedEvent:EVENT_PLAYER_VIEW withParameters:nil];
 }
 
 - (void)viewDidUnload {
 
=== modified file 'Music/View Controllers/PlaylistsViewController.m'
--- Music/View Controllers/PlaylistsViewController.m	2013-02-11 04:20:26 +0000
+++ Music/View Controllers/PlaylistsViewController.m	2013-02-11 04:20:26 +0000
@@ -49,4 +49,16 @@
     [[UOWebServiceController controller] updatePlaylists:self clearCache:YES];
 }
 
+#pragma mark - View controller lifecycle
+
+- (void)viewWillAppear:(BOOL)animated {
+    [super viewWillAppear:animated];
+    [Flurry logEvent:EVENT_PLAYLISTS_VIEW timed:YES];
+}
+
+- (void)viewDidDisappear:(BOOL)animated {
+    [super viewDidDisappear:animated];
+    [Flurry endTimedEvent:EVENT_PLAYLISTS_VIEW withParameters:nil];
+}
+
 @end
 
=== modified file 'Music/View Controllers/SettingsAuthenticationViewController.m'
--- Music/View Controllers/SettingsAuthenticationViewController.m	2013-01-26 02:37:04 +0000
+++ Music/View Controllers/SettingsAuthenticationViewController.m	2013-02-11 04:20:26 +0000
@@ -92,6 +92,18 @@
     [self.spinner setHidden:YES];
 }
 
+#pragma mark - View controller lifecycle
+
+- (void)viewWillAppear:(BOOL)animated {
+    [super viewWillAppear:animated];
+    [Flurry logEvent:EVENT_AUTHENTICATION_VIEW timed:YES];
+}
+
+- (void)viewDidDisappear:(BOOL)animated {
+    [super viewDidDisappear:animated];
+    [Flurry endTimedEvent:EVENT_AUTHENTICATION_VIEW withParameters:nil];
+}
+
 #pragma mark - Private methods
 
 - (void)showAlert:(NSString *)message {
 
=== modified file 'Music/View Controllers/SettingsViewController.m'
--- Music/View Controllers/SettingsViewController.m	2013-01-28 17:21:44 +0000
+++ Music/View Controllers/SettingsViewController.m	2013-02-11 04:20:26 +0000
@@ -23,6 +23,18 @@
 
 @implementation SettingsViewController
 
+#pragma mark - View controller lifecycle
+
+- (void)viewWillAppear:(BOOL)animated {
+    [super viewWillAppear:animated];
+    [Flurry logEvent:EVENT_SETTINGS_VIEW timed:YES];
+}
+
+- (void)viewDidDisappear:(BOOL)animated {
+    [super viewDidDisappear:animated];
+    [Flurry endTimedEvent:EVENT_SETTINGS_VIEW withParameters:nil];
+}
+
 - (void)viewDidAppear:(BOOL)animated {
     [super viewDidAppear:animated];
     
 
=== modified file 'Music/View Controllers/SongsViewController.m'
--- Music/View Controllers/SongsViewController.m	2013-02-11 04:20:26 +0000
+++ Music/View Controllers/SongsViewController.m	2013-02-11 04:20:26 +0000
@@ -50,6 +50,18 @@
     [[UOWebServiceController controller] updateSongs:self clearCache:YES];
 }
 
+#pragma mark - View controller lifecycle
+
+- (void)viewWillAppear:(BOOL)animated {
+    [super viewWillAppear:animated];
+    [Flurry logEvent:EVENT_SONGS_VIEW timed:YES];
+}
+
+- (void)viewDidDisappear:(BOOL)animated {
+    [super viewDidDisappear:animated];
+    [Flurry endTimedEvent:EVENT_SONGS_VIEW withParameters:nil];
+}
+
 #pragma mark - UIStoryboard methods
 
 - (void)prepareForSegue:(UIStoryboardSegue *)segue sender:(id)sender {
 
=== modified file 'U1Music.xcodeproj/project.pbxproj'
--- U1Music.xcodeproj/project.pbxproj	2013-02-11 04:20:26 +0000
+++ U1Music.xcodeproj/project.pbxproj	2013-02-11 04:20:26 +0000
@@ -10,6 +10,7 @@
 		1D60589F0D05DD5A006BFB54 /* Foundation.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 1D30AB110D05D00D00671497 /* Foundation.framework */; };
 		1DF5F4E00D08C38300B7A737 /* UIKit.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 1DF5F4DF0D08C38300B7A737 /* UIKit.framework */; };
 		2892E4100DC94CBA00A64D0F /* CoreGraphics.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 2892E40F0DC94CBA00A64D0F /* CoreGraphics.framework */; };
+		5207A4C216C89B140006A4E6 /* libFlurry.a in Frameworks */ = {isa = PBXBuildFile; fileRef = 5207A4C116C89B140006A4E6 /* libFlurry.a */; };
 		520BBF2416B51F2A00307F32 /* UODownloader.m in Sources */ = {isa = PBXBuildFile; fileRef = 520BBF2316B51F2A00307F32 /* UODownloader.m */; };
 		52169C9815D95DD100ED366D /* cancel-grey.png in Resources */ = {isa = PBXBuildFile; fileRef = 52169C9415D95DD100ED366D /* cancel-grey.png */; };
 		52169C9915D95DD100ED366D /* [e-mail] in Resources */ = {isa = PBXBuildFile; fileRef = 52169C9515D95DD100ED366D /* [e-mail] */; };
@@ -32,9 +33,9 @@
 		5257415416C37E1A00530CCC /* SSPullToRefreshDefaultContentView.m in Sources */ = {isa = PBXBuildFile; fileRef = 5257414F16C37E1A00530CCC /* SSPullToRefreshDefaultContentView.m */; };
 		5257415516C37E1A00530CCC /* SSPullToRefreshSimpleContentView.m in Sources */ = {isa = PBXBuildFile; fileRef = 5257415116C37E1A00530CCC /* SSPullToRefreshSimpleContentView.m */; };
 		5257415616C37E1A00530CCC /* SSPullToRefreshView.m in Sources */ = {isa = PBXBuildFile; fileRef = 5257415316C37E1A00530CCC /* SSPullToRefreshView.m */; };
+		5257416D16C5653100530CCC /* Crashlytics.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 5257416C16C5653100530CCC /* Crashlytics.framework */; };
 		5257417716C5CC5D00530CCC /* NSString+UbuntuOne.m in Sources */ = {isa = PBXBuildFile; fileRef = 5257417616C5CC5D00530CCC /* NSString+UbuntuOne.m */; };
 		5257417A16C5CDA900530CCC /* UIImageView+UbuntuOne.m in Sources */ = {isa = PBXBuildFile; fileRef = 5257417916C5CDA900530CCC /* UIImageView+UbuntuOne.m */; };
-		5257416D16C5653100530CCC /* Crashlytics.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 5257416C16C5653100530CCC /* Crashlytics.framework */; };
 		5268509716AE5267001F65A6 /* libRestKit.a in Frameworks */ = {isa = PBXBuildFile; fileRef = 5268509016AE516C001F65A6 /* libRestKit.a */; };
 		526850A816AEE4E1001F65A6 /* Storyboard_iPhone.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 526850A516AEE4E1001F65A6 /* Storyboard_iPhone.storyboard */; };
 		526850A916AEE4E1001F65A6 /* UOAppDelegate.m in Sources */ = {isa = PBXBuildFile; fileRef = 526850A716AEE4E1001F65A6 /* UOAppDelegate.m */; };
@@ -256,6 +257,8 @@
 		1D6058910D05DD3D006BFB54 /* U1 Music.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = "U1 Music.app"; sourceTree = BUILT_PRODUCTS_DIR; };
 		1DF5F4DF0D08C38300B7A737 /* UIKit.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = UIKit.framework; path = System/Library/Frameworks/UIKit.framework; sourceTree = SDKROOT; };
 		2892E40F0DC94CBA00A64D0F /* CoreGraphics.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = CoreGraphics.framework; path = System/Library/Frameworks/CoreGraphics.framework; sourceTree = SDKROOT; };
+		5207A4C016C89B140006A4E6 /* Flurry.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = Flurry.h; sourceTree = "<group>"; };
+		5207A4C116C89B140006A4E6 /* libFlurry.a */ = {isa = PBXFileReference; lastKnownFileType = archive.ar; path = libFlurry.a; sourceTree = "<group>"; };
 		520BBF2216B51F2A00307F32 /* UODownloader.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = UODownloader.h; sourceTree = "<group>"; };
 		520BBF2316B51F2A00307F32 /* UODownloader.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = UODownloader.m; sourceTree = "<group>"; };
 		52169C9415D95DD100ED366D /* cancel-grey.png */ = {isa = PBXFileReference; lastKnownFileType = image.png; path = "cancel-grey.png"; sourceTree = "<group>"; };
@@ -287,11 +290,11 @@
 		5257415116C37E1A00530CCC /* SSPullToRefreshSimpleContentView.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = SSPullToRefreshSimpleContentView.m; sourceTree = "<group>"; };
 		5257415216C37E1A00530CCC /* SSPullToRefreshView.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = SSPullToRefreshView.h; sourceTree = "<group>"; };
 		5257415316C37E1A00530CCC /* SSPullToRefreshView.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = SSPullToRefreshView.m; sourceTree = "<group>"; };
+		5257416C16C5653100530CCC /* Crashlytics.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; path = Crashlytics.framework; sourceTree = "<group>"; };
 		5257417516C5CC5D00530CCC /* NSString+UbuntuOne.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = "NSString+UbuntuOne.h"; path = "Categories/NSString+UbuntuOne.h"; sourceTree = "<group>"; };
 		5257417616C5CC5D00530CCC /* NSString+UbuntuOne.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; name = "NSString+UbuntuOne.m"; path = "Categories/NSString+UbuntuOne.m"; sourceTree = "<group>"; };
 		5257417816C5CDA900530CCC /* UIImageView+UbuntuOne.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = "UIImageView+UbuntuOne.h"; path = "Categories/UIImageView+UbuntuOne.h"; sourceTree = "<group>"; };
 		5257417916C5CDA900530CCC /* UIImageView+UbuntuOne.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; name = "UIImageView+UbuntuOne.m"; path = "Categories/UIImageView+UbuntuOne.m"; sourceTree = "<group>"; };
-		5257416C16C5653100530CCC /* Crashlytics.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; path = Crashlytics.framework; sourceTree = "<group>"; };
 		5268508516AE516B001F65A6 /* RestKit.xcodeproj */ = {isa = PBXFileReference; lastKnownFileType = "wrapper.pb-project"; name = RestKit.xcodeproj; path = ../RestKit/RestKit.xcodeproj; sourceTree = "<group>"; };
 		526850A516AEE4E1001F65A6 /* Storyboard_iPhone.storyboard */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = file.storyboard; path = Storyboard_iPhone.storyboard; sourceTree = "<group>"; };
 		526850A616AEE4E1001F65A6 /* UOAppDelegate.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = UOAppDelegate.h; sourceTree = "<group>"; };
@@ -640,6 +643,7 @@
 				5268509716AE5267001F65A6 /* libRestKit.a in Frameworks */,
 				52E7F4A316AF1522003A46DA /* UbuntuOneAuthKit.a in Frameworks */,
 				5257416D16C5653100530CCC /* Crashlytics.framework in Frameworks */,
+				5207A4C216C89B140006A4E6 /* libFlurry.a in Frameworks */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 		};
@@ -672,7 +676,6 @@
 				29B97317FDCFA39411CA2CEA /* Resources */,
 				964FA39013CA5BE60018A65B /* Dependencies */,
 				29B97323FDCFA39411CA2CEA /* Frameworks */,
-				5279764815F00B2600F8435F /* libz.dylib */,
 				19C28FACFE9D520D11CA2CBB /* Products */,
 			);
 			name = CustomTemplate;
@@ -690,6 +693,7 @@
 		29B97323FDCFA39411CA2CEA /* Frameworks */ = {
 			isa = PBXGroup;
 			children = (
+				5279764815F00B2600F8435F /* libz.dylib */,
 				5257416C16C5653100530CCC /* Crashlytics.framework */,
 				5268510716AEFD20001F65A6 /* MobileCoreServices.framework */,
 				1DF5F4DF0D08C38300B7A737 /* UIKit.framework */,
@@ -707,6 +711,16 @@
 			name = Frameworks;
 			sourceTree = "<group>";
 		};
+		5207A4BF16C89B140006A4E6 /* Flurry */ = {
+			isa = PBXGroup;
+			children = (
+				5207A4C016C89B140006A4E6 /* Flurry.h */,
+				5207A4C116C89B140006A4E6 /* libFlurry.a */,
+			);
+			name = Flurry;
+			path = Dependencies/Flurry;
+			sourceTree = "<group>";
+		};
 		522B24E716B4BBC30084B023 /* Controls */ = {
 			isa = PBXGroup;
 			children = (
@@ -1299,6 +1313,7 @@
 		964FA39013CA5BE60018A65B /* Dependencies */ = {
 			isa = PBXGroup;
 			children = (
+				5207A4BF16C89B140006A4E6 /* Flurry */,
 				5257414C16C37E1A00530CCC /* SSPullToRefresh */,
 				93BC520A124C187700B7587C /* SynthesizeSingleton.h */,
 				91328278144E07EA00395F40 /* TestFlight SDK */,
@@ -1714,6 +1729,7 @@
 					"$(inherited)",
 					"\"$(SRCROOT)/TestFlight SDK\"",
 					"$(BUILT_PRODUCTS_DIR)/**",
+					"\"$(SRCROOT)/Dependencies/Flurry\"",
 				);
 				OTHER_LDFLAGS = "-ObjC";
 				PRODUCT_NAME = "U1 Music";
@@ -1754,6 +1770,7 @@
 					"$(inherited)",
 					"\"$(SRCROOT)/TestFlight SDK\"",
 					"$(BUILT_PRODUCTS_DIR)/**",
+					"\"$(SRCROOT)/Dependencies/Flurry\"",
 				);
 				OTHER_LDFLAGS = "-ObjC";
 				PRODUCT_NAME = "U1 Music";
 
=== modified file 'U1Music_Prefix.pch'
--- U1Music_Prefix.pch	2013-01-28 22:54:20 +0000
+++ U1Music_Prefix.pch	2013-02-11 04:20:26 +0000
@@ -21,10 +21,22 @@
 	#import "NSManagedObjectContext+Additions.h"
 	#import "NSString+Extras.h"
     #import "TestFlight.h"
+    #import "Flurry.h"
  	#define RELEASE_SAFELY(__obj) [__obj release], __obj = nil;
 
 	#define UBUNTU_ONE_SERVICE_NAME @"com.ubuntu.one"
 	#define UBUNTU_ONE_DUMMY_USER_NAME @"_UBUNTU_ONE_USER_NAME"
 
     #define AUTHORIZATION_HEADER_KEY @"Authorization"
+
+    #define EVENT_ALBUMS_VIEW @"AlbumsView"
+    #define EVENT_ARTISTS_VIEW @"ArtistsView"
+    #define EVENT_SONGS_VIEW @"SongsView"
+    #define EVENT_PLAYLISTS_VIEW @"PlaylistsView"
+    #define EVENT_SETTINGS_VIEW @"SettingsView"
+    #define EVENT_AUTHENTICATION_VIEW @"AuthenticationView"
+    #define EVENT_ALBUM_VIEW @"AlbumView"
+    #define EVENT_ARTIST_VIEW @"ArtistView"
+    #define EVENT_PLAYER_VIEW @"PlayerView"
+    #define EVENT_PLAYLIST_VIEW @"PlaylistView"
 #endif