iOS实例开发源码——jashmenn-shapes-panels-53a982e.zip

Welcome to Flurry Analytics! This README contains: 1. Introduction 2. Integration 3. Latest SDK Update 4. Optional Features 5. Recommendations 6. FAQ ===================================== 1. Introduction The Flurry iPhone Analytics Agent allows you to track the usage and behavior of your iPhone application on users' phones for viewing in the Flurry Analytics system. It is designed to be as easy as possible with a basic setup complete in under 5 minutes. This archive should contain these files: - ProjectApiKey.txt : This file contains the name of your project and your project's API key. - Analytics-README.txt : This text file containing instructions. - FlurryLibWithLocation/FlurryAPI.h - FlurryLibWithLocation/libFlurryWithLocation.a : The library containing Flurry's collection and reporting code. This version includes GPS location capabilities. Requires Xcode 3.2.3 or above. - FlurryLib/FlurryAPI.h - FlurryLib/libFlurry.a : The library containing Flurry's collection and reporting code. This version does not include GPS location capabilities. Requires Xcode 3.2.3 or above. - FlurryLib/FlurryAdDelegate.h - FlurryLibWithLocation/FlurryAdDelegate.h : These are optional files for use with Flurry AppCircle. You do NOT need them for Flurry Analytics. Note that there are two versions of the Flurry analytics library: With and without location. We recommend using FlurryLibWithLocation so that you can receive detailed analytics about where your users are using your app. However, if you do not currently use location in your application, you can use FlurryLib and receive all of the same analytics without detailed location information. We also recommend calling FlurryAPI from the main thread. FlurryAPI is not supported when called from other threads. ===================================== 2. Integration To integrate Flurry Analytics into your iPhone application, first decide if you want to use location services or not. If you do wish to use location, see the steps in 2a. If you do not wish to use location, skip to 2b. Note that you should only use Flurry location services if your application already uses the CLLocationManager. You should not enable location services for analytics if you do not already use the CLLocationManager as your application will be rejected by Apple. Apple requires that your application use location in a way useful to the end user in order to access the CLLocationManager. 2a. Integration without Location ------------------------------------------------------------- 1. In the finder, drag FlurryLib into project's file folder. NOTE: If you are upgrading the Flurry iPhone SDK, be sure to remove any existing Flurry library folders from your project's file folder before proceeding. 2. Now add it to your project => Project > Add to project > FlurryLib - Choose 'Recursively create groups for any added folders' 3. In your Application Delegate: a. Import FlurryAPI => #import "FlurryAPI.h" b. Inside "applicationDidFinishLaunching:" add => [FlurryAPI startSession:@"YOUR_API_KEY"]; - (void)applicationDidFinishLaunching:(UIApplication *)application { [FlurryAPI startSession:@"YOUR_API_KEY"]; //your code } You're done! That's all you need to do to begin receiving basic metric data. 2b. Integration with location ------------------------------------------------------------- 1. In the finder, drag FlurryLibWithLocation into project's file folder. NOTE: If you are upgrading the Flurry iPhone SDK, be sure to remove any existing Flurry library folders from your project's file folder before proceeding. 2. Now add it to your project => Project > Add to project > FlurryLibWithLocation - Choose 'Recursively create groups for any added folders' 3. At this point, there are two options. First, if your application already has initialized a CLLocationManager, you can simply pass location information to the Flurry API for each session. For this option see the steps in 3a. Second, if your application has not already defined a CLLocationManager and you want Flurry to handle this for you, see the steps in 3b. 3a. You pass location information to the FlurryAPI. In your Application Delegate: a. Import FlurryAPI => #import "FlurryAPI.h" b. Inside "applicationDidFinishLaunching:" add => [FlurryAPI startSession:@"YOUR_API_KEY"]; - (void)applicationDidFinishLaunching:(UIApplication *)application { [FlurryAPI startSession:@"YOUR_API_KEY"]; //your code } c. Each time you want to update the location that Flurry Analytics will record, use the function below. Only the last location reported will be used for each session. [FlurryAPI setLocation:YOUR_UPDATED_CLLOCATION]; 3b. Flurry manages all location capabilities. In your Application Delegate: a. Import FlurryAPI => #import "FlurryAPI.h" b. Inside "applicationDidFinishLaunching:" add => [FlurryAPI startSessionWithLocationServices:@"YOUR_API_KEY"]; - (void)applicationDidFinishLaunching:(UIApplication *)application { [FlurryAPI startSessionWithLocationServices:@"YOUR_API_KEY"]; //your code } NOTE: You must also include the CoreLocation.framework if you do this. To add this framework, go to Project > Edit Active Target "YOUR_APP" > Add Libraries ('+' sign at the bottom) and select CoreLocation.framework You're done! That's all you need to do to begin receiving basic metric data. For optional advanced features, skip to Section 3. ===================================== 3. Latest SDK Update Going forward, the Flurry SDK will only support Xcode 3.2.3 and above. Please email support if you need to use older versions of the Flurry SDK. This version of the Flurry SDK is compatible with Xcode 3.2.3 and designed for OS 4.0 (iOS) applications. In this version of the Flurry SDK, we modified which data is collected. This updated SDK version does not collect the following device data: device name, operating system version and firmware version. Because Apple allows the collection of UDID for the purpose of advertising, we continue to collect this data as the Flurry SDK includes AppCircle, Flurry's mobile advertising solution. Per Flurry's existing Terms of Service and Privacy Policy, please inform your consumers about data you collect through the use of our services. Additionally, please remember that you must abide by the rules set forth in the new Apple iPhone Developer Program License Agreement. Despite our latest efforts, please understand that we are unable to guarantee whether Apple reviewers will approve your application in its App Store submission process. ===================================== 4. Optional / Advanced Features You can use the following methods to report additional data. These methods work exactly the same with or without location services enabled. [FlurryAPI logEvent:@"EVENT_NAME"]; Use logEvent to count the number of times certain events happen during a session of your application. This can be useful for measuring how often users perform various actions, for example. Your application is currently limited to counting occurrences for 100 different event ids (maximum length 255 characters). [FlurryAPI logEvent:@"EVENT_NAME" withParameters:YOUR_NSDictionary]; Use this version of logEvent to count the number of times certain events happen during a session of your application and to pass dynamic parameters to be recorded with that event. For example, you could record that a user used your search box tool and also dynamically record which search terms the user entered. Your application is currently limited to counting occurrences for 100 different event ids (maximum length 255 characters). An example NSDictionary to use with this method