GETTING STARTED. AppSher In-App Analytics for ios

Transcription

1 GETTING STARTED AppSher In-App Analytics for ios AppSher Analytics Tool for ios enables to analyze all consumer-activities of your application on the users device and edits all data into AppSher Analytics System. The basic programming background is very lean. The set-up is possible within 5 minutes. AppSher SDK for ios connects the AppSher online platform with all users of your application. This enables you to have an access to all user-activities, in-app-purchases and to specify further events for having a detailed analysis. All metrics will show you the cost-efficiency of your app, all optimization possibilities, the system arrangement, user-frequency, effectiveness and decision about all marketingsources and a lot more interesting individual indicators.

2 Index Prepare your app 3 Setup your app into the dashboard 3 Where to find your AppSher SDK 4 Integration of SDK into your app 5 Add to you project as following 5 Example integration of the AppSher SDK 6 App Analytics Tracking-Parameter 7 App opening (open) 7 App closes (close) 7 In-App SignUp Event with refund (e.g. newsletter-subscribes) 7 In-App purchase event with refund (in-app-purchase) 7 Transmission of a page-view-event (page-view) 7 FAQ 8

3 Prepare your app To use the AppSher Analytics Tool and App Download Tracking, you need to integrate the AppSher Tracking SDK into the application. Setup your app into the dashboard First you need to add your app as a new app to the AppSher tracking system Go to and log in Go to Mobile Apps and click on New App Choose an app-name and add the link to your application Click on create new app Now you are ready to start the SDK integration! If you should have any queries or questions please contact your account manager or to support@appsher.com.

4 Where to find your AppSher SDK For a simple integration, please follow these steps: 1 Go to and log in 2 3 Got to Mobile Apps and click to your app Click to download SDK and integration-manual The.zip file contains: AppSherAnalyticsREADMEv1.31.pdf UniqueAppParameter.txt AppSher/Tracking.h File for integration-guide for AppSher Analytics. Receiving your unique SDK Salt, and your app-name, which to use for integration of this SDK. Q.v. 2-e. This mandatory header-file has all methods for AppSher Analytics. AppSher/libTracking.a Mandatory library for AppSher s collection and reporting code. AppSher/libTrackingSim.a Mandatory library for AppSher s collection and reporting code for Apple s simulator-mode

5 Integration of SDK into your app The binary of this SDK (libtracking.a) was compiled for armv7 und ios 4.3+ and can be used in this form as static library for all types of applications on iphone, ipad and ipod Touch having the ios version Add to you project as following The file libtracking.a need to be added to your project directory and to your Xcode project (in Xcode: Targets / Build Phases / Link Binary With Libaries / + ). CAUTION: iphone targeting and Simulator targeting need different binaries from the Tracking.a file. Please mind to import the right one. As a developer it is recommendable to import both versions. Copy the file Tracking.h into your project-folder and integrate this file also into the Xcode-project. The best way is to set up a collection of all required libraries (e.g. Tracking.h) into one common folder (e.g. Support) and to adjust the headersearch-path from "Support/**" (in Xcode: Targets / Build Settings / Header Search Paths) For apps that need an ios4 compatibility the "-ObjC linker flag" needs to be set up, to avoid lifetime-bugs concerning missing selectors. Q.v. Please add all frameworks as following, to configure an efficient In-App tracking: SystemConfiguration.framework AdSupport.Framework Foundation.Framework

6 Example integration of the AppSher SDK The configuration of AppSher's SDK is effected by the Info.plist file of your ios-app. Please add all notified information s from UniqueAppParameter.txt file to this file. The best way to do this is to open Info.plist through your Xcode-developer environment and add a new row by doing a right mouse click in the menu "new row". Please look out for all stored variables. All yellow marked variables should be replaced of your individual ones. You will find them in: UniqueAppParameter.txt, which you have downloaded from the.zip file. Any queries please ask your account manager AppID: Salt: Please provide the App-ID from your AppSher Account ( ). Insert the salt of the included app from the AppSher Account. TrackingDemoAppDelegate.m // import the tracking header file #import window; - (BOOL)application:(UIApplication *)application didfinishlaunchingwithoptions:(nsdictionary *)launchoptions { // initialize the AppSher Tracking SDK [Tracking sharedinstance]; [window makekeyandvisible]; return YES;

7 App Analytics Tracking-Parameter App opening (open) - (void)applicationdidbecomeactive:(uiapplication *)application { NSLog(@"applicationDidBecomeActive"); // delegate all calls to applicationdidbecomeactive to tracking open [[Tracking sharedinstance] open]; App closes (close) - (void)applicationdidenterbackground:(uiapplication *)application { NSLog(@"applicationDidEnterBackground"); // delegate all calls to applicationdidenterbackground to tracking close [[Tracking sharedinstance] close]; In-App SignUp Event with refund (e.g. newsletter-subscribes) - (IBAction)signupClicked:(id)sender { // Example for sending a signup event [[Tracking sharedinstance] signupwithamount:@"8.15" currency:@"eur" description:@"signup Description" andviewname:@"signup-view-name"]; Note: The currency value must be in ISO 4217 size. In-App purchase event with refund (in-app-purchase) - (IBAction)inAppPurchaseClicked:(id)sender { // Example for sending a inapppurchasewithamount event [[Tracking sharedinstance] inapppurchasewithamount:@"123.45" currency:@"eur" description:@"purchase-description" andviewname:@"in-app-purchase-view-name"]; Note: The currency value must be in ISO 4217 size. Transmission of a page-view-event (page-view) - (IBAction)pageViewClicked:(id)sender { // Example for sending a pageview event [[Tracking sharedinstance] pageview:@"view-name"];

8 FAQ What happens within the AppSher ios SDK? The Appsher ios SDK send out activity information s of your App to the Appsher System, for all detailed analyses on relevant parameters. The SDK takes care about the best connectivity (WLAN) and about a sufficient battery capacity of the used device. After this checkup all collected events are bundled and transmitted to the Appsher-System. How much memory capacity needs the AppSher ios SDK? The AppSher SDK needs approx. 1,3 MB memory capacity. How many data is send out by the Appsher Agent for every session? All information s are transmitted via JSON-Transport to AppSher. Key figures are added in the holding stack, to every view request in your app, until the AppSher ios SDK is able to complete all accumulations. (Q.v. What happens within the AppSher ios SDK? ). For every view 100 Byte is added into the holding stack; the size of the outcomming request depends on how many data are collected until they can be send to the AppSher System. Because of an efficient zipped data-package, this request is generally not bigger than 1KB. Which data are send by the AppSher Agent? The SDK send information about the actual view e.g. information s about the used device (identifier, resolution), timeline of the released event (view, open, close, install, in-app-purchase etc.) and the given site- and event-indication. Which Xcode version is required? The AppSher Analytics SDK for ios requires an Xcode version Does this SDK recall the UDID? No, this version of the AppSher Analytics SDK recalls not the ios UDID.

9 Historie Version Admin Änderung Datum 1.2 M Initial P Funktions-Signaturen, Update-Funktion 1.31 S Auf neue SDK-Version angepasst