A simple iOS mobile app event logger / flight data recorder
You upload tapp-tracker.php to your web server, add the TappEventTracker class to your iOS app, configure it when your app starts, and when your app has something to track you call [TappEventTracker trackEvent:@"my_event"];.
TappEventTracker takes care of periodically pushing your event data to your server and you get a nice CSV with timestamp, client IP address, device id, and event info. You can process it, parse it, or load it into Google Docs if you're of a mind to.
To use the tapp-tracker.php script you will need a web hosting account or server with PHP 5. Simply customize the log file path and name in the script if desired and then upload the script into your web site account.
You may want to specify a directory for your log files that is not within your web site's html files area, otherwise people may be able to retrieve your log files through your web server.
Add TappEventTracker.h and TappEventTracker.m to your iOS app in Xcode. If you are using ARC for your project (you probably are if you don't know what that is) then you will need to disable ARC for the TappEventTracker.m file:
- Click on your project name in the Project Navigator
- Under Targets select your app name
- Select the Build Phases tab
- Expand the Compile Sources section
- Double-click on TappEventTracker.m
- In the popup add the test
-fno-objc-arc
At the top of your AppDelegate.m file include the TappEventTracker header:
#include "TappEventTracker.h"
In your AppDelegate's application:didFinishLaunchingWithOptions: method configure the tracking service:
// You can set this to YES to log lots of messages to the console via NSLog()
[TappEventTracker sharedInstance].beVerbose = NO;
// Point this to the tracker script you installed on your web site
[TappEventTracker sharedInstance].reportURL = [NSURL URLWithString:@"http://www.example.com/path/to/tapp-tracker.php"];
// Control whether to perform a last-minute data push when the app goes to the background
[TappEventTracker sharedInstance].reportAtShutdown = YES;
// Control how many seconds elapse between attempts to push data up to the server
[TappEventTracker sharedInstance].reportInterval = 60;
Whenever you need to record an event simply call:
[TappEventTracker trackEvent:@"MY_EVENT_NAME"];
or
[TappEventTracker trackEvent:@"MY_EVENT_NAME" withValue:@"VALUE"];
app-event-tracker is Copyright (c) 2013, Tappister, LLC. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of Tappister, LLC nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL TAPPISTER, LLC BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.