Kony Fabric Reporting and Analytics User Journey - Funnel Reports, App Events and APM Release V8 SP1 DocumentRelevanceandAccuracy ThisdocumentisconsideredrelevanttotheReleasestatedonthistitlepageandthedocumentversionstatedonthe RevisionHistorypage.Remembertoalwaysviewanddownloadthelatestdocumentversionrelevanttothesoftware releaseyouareusing. ©2017byKony,Inc.Allrightsreserved 1of32 UserJourney-AppEventsandAPM Version1.2 Copyright©2015byKony,Inc. Allrightsreserved. December,2017 ThisdocumentcontainsinformationproprietarytoKony,Inc.,isboundbytheKonylicense agreements,andmaynotbeusedexceptinthecontextofunderstandingtheuseandmethodsof Kony,Inc.,softwarewithoutprior,express,writtenpermission.Kony,EmpoweringEverywhere,Kony Fabric,KonyNitro,andKonyVisualizeraretrademarksofKony,Inc.MobileFabricisaregistered trademarkofKony,Inc.Microsoft,theMicrosoftlogo,InternetExplorer,Windows,andWindowsVista areregisteredtrademarksofMicrosoftCorporation.Apple,theApplelogo,iTunes,iPhone,iPad,OS X,Objective-C,Safari,ApplePay,AppleWatch,andXcodearetrademarksorregisteredtrademarks ofApple,Inc.Google,theGooglelogo,Android,andtheAndroidlogoareregisteredtrademarksof Google,Inc.ChromeisatrademarkofGoogle,Inc.BlackBerry,PlayBook,ResearchinMotion,and RIMareregisteredtrademarksofBlackBerry.SAP®andSAP®BusinessSuite®areregistered trademarksofSAPSEinGermanyandinseveralothercountries.Allotherterms,trademarks,or servicemarksmentionedinthisdocumenthavebeencapitalizedandaretobeconsideredthe propertyoftheirrespectiveowners. ©2017byKony,Inc.Allrightsreserved 2of32 UserJourney-AppEventsandAPM Version1.2 Revision History Date DocumentVersion Description ofModifications/Release 12/18/2017 1.2 DocumentpublishedforV8SP1 09/19/2017 1.0 DocumentpublishedforV8GA ©2017byKony,Inc.Allrightsreserved 3of32 UserJourney-AppEventsandAPM Version1.2 Table of Contents 1. Types ofApplicationEvents 5 1.1 StandardEvents 5 1.2 CustomEvents 6 2. ApplicationPerformanceMonitoring 7 3. TrackingUser Journey 8 3.1 TrackingUserJourneyManually 8 3.2 AutomaticTracking(KonyVisualizeronly) 8 4. EnablingAutoEventCapture 10 5. TuningAutoEventCapture 11 5.1 EventAnalyticsAPIstoTunePerformance 11 5.2 PerformanceConsiderations 14 6. ReportingonEvents 16 6.1 StandardReports 16 6.2 CustomReports 17 7. Funnel Reports 19 7.1 UseCase 19 7.2 Prerequisites 22 8. APM Extension/ThirdParty APM Integration 31 8.1 GlobalErrorHandler(KonyVisualizerOnly) 31 ©2017byKony,Inc.Allrightsreserved 4of32 1. Types ofApplicationEvents UserJourney-AppEventsandAPM Version1.2 1. Types of Application Events Therearetwotypesofapplicationevents: 1. StandardEvents 2. CustomEvents 1.1 Standard Events KonyFabricprovidesthefollowingtypesofeventsforreporting: FormEntry–Invokedwhenaformisenteredintheapplication. l FormExit-Invokedwhenaformisexitedintheapplication. l Touch–Toucheventisextendedtothebelowwidgetsalongwithbuttononclick. l o Widget:FlexContainer/ScrollContainer onClick l onTouchStart(ifregistered) l onTouchEnd(ifregistered) l o Widget:Segment onRowClick l o Widget:Button onClick l o Widget:Image onTouchStart(ifregistered) l onTouchEnd(ifregistered) l ©2017byKony,Inc.Allrightsreserved 5of32 1. Types ofApplicationEvents UserJourney-AppEventsandAPM Version1.2 o Widget:Switch onSlide l ServiceRequest–Invokedwhenaservicecallornetworkcallistriggeredfromtheapplication l ServiceResponse–Invokedwhenaservicecallornetworkcallrespondsback. l Gesture–Invokedwhenagesturerecognizerforawidgethasbeensetandoneoftheset l gesturepatterns likedoubletap,righttoleftswipe,longpressaredoneonthesame. Orientation–Invokedwhendeviceorientationismodifiedforapp. l Error–Invokedwhenapplicationendsupinanunhandledexception. l Exception–Invokedwhenapplicationflowlandsinahandledexceptioncodeblockinapp. l Crash–Invokedwhenapplicationcrashesandresumesaftercrash. l AppLoad–Invokedwhentheapplicationisloadedandthefirstformisshown. l AppTransition-Invokedwhentheapplicationtransitseitherfromforegroundtobackgroundand l viceversa. Note:Whenanapplicationgoesbackground,thetimespentinmili-secondsbythat applicationinforegroundwillbecapturedbytheAppTransitionevent. 1.2 Custom Events Custom–Invokeforlogicaleventsintheapplicationlikelogin,checkdeposit oranyotherevent specifictotheapplicationthatisused.RefertosendcustomeventsAPI.Formoredetails,referto KonyVisualizerforReporting ©2017byKony,Inc.Allrightsreserved 6of32 2. ApplicationPerformanceMonitoring UserJourney-AppEventsandAPM Version1.2 2. Application Performance Monitoring Applicationperformancemonitoring(APM)istheabilitytocheckandtracktheperformanceofan application.APMisanabilitytodiagnosetheissuestobeabletomaintainanexpectedlevelof performancefortheapplication. WithavailabilityoftheoutoftheboxKonyAPMfeature,Konyallowsdevelopersandbusiness analyststomonitortheperformanceoftheappandseethejourneyofvarioususersusingtheapp. APMgivesthemthemuchneededinsightintouserbehaviorandthedatatoidentifyusagepatterns. Thisallowsthebusinesstomakedatadrivendecisionsfortheappbasedonapplicationusabilityand usagepatterns. ©2017byKony,Inc.Allrightsreserved 7of32 3. TrackingUser Journey UserJourney-AppEventsandAPM Version1.2 3. Tracking User Journey Youcantracktheuserjourneyinthefollowingtwoways: 1. Manually 2. AutomaticTracking(KonyVisualizeronly) 3.1 Tracking User Journey Manually YoucansentalleventsmentionedinTypesofApplicationEventsbyinvokingAPIs. 3.2 Automatic Tracking (Kony Visualizer only) KonyVisualizerallowsautomatictrackingforiOSnativeandandroidnativeappsforthefollowing eventtypes. FormEntry–Invokedwhenaforminapplicationisentered. l FormExit-Invokedwhenaformisexitedintheapplication. l Touch–Toucheventisextendedtothebelowwidgetsalongwithbuttononclick. l o Widget:FlexContainer/ScrollContainer onClick l onTouchStart(ifregistered) l onTouchEnd(ifregistered) l o Widget:Segment onRowClick l o Widget:Button onClick l ©2017byKony,Inc.Allrightsreserved 8of32 3. TrackingUser Journey UserJourney-AppEventsandAPM Version1.2 o Widget:Image onTouchStart(ifregistered) l onTouchEnd(ifregistered) l o Widget:Switch onSlide l ServiceRequest–Invokedwhenaservicecallornetworkcallisinitiatedfromtheapplication. l ServiceResponse–InvokedwhenanHTTPresponseisreceivedfromtheservicerequestor l networkcallintheapplication. Gesture-Invokedwhenagesturerecognizerforawidgetissetandoneofthesetgesture l patternslikedoubletap,righttoleftswipe,longpressaredoneonthesame. Orientation-Invokedwhenthedeviceorientationismodifiedforanapp,andtheapplication l formthatuserwasin,issettoactonorientationchange. Error-WhenapplicationendsupinanunhandledexceptioninJavaScriptcodethattheglobal l exceptionhandlercatchesup. Crash-Invokedwhenapplicationcrashesandresumesaftercrash. l AppLoad–Invokedwhentheapplicationisloadedandthefirstformisshown. l AppTransition-Invokedwhentheapplicationtransitseitherfromforegroundtobackgroundand l viceversa. Note:Whenanapplicationgoesbackground,thetimespentinmili-secondsbythat applicationinforegroundwillbecapturedbytheAppTransitionevent. ©2017byKony,Inc.Allrightsreserved 9of32 4. EnablingAutoEventCapture UserJourney-AppEventsandAPM Version1.2 4. Enabling Auto Event Capture Toenableautoeventcapture,follow thesesteps: 1. LaunchKonyVisualizer. 2. IntheApplicationPropertiesdialog,clicktheMetrics APMtabandselecttheEnableautomatic eventcapturecheckboxandchoosetheeventstocaptureautomaticallyasinthebelowimage: Note: APIoverridesareavailabletomodifytheeventsthatareautomaticallycapturedat anypointoftimefromtheapplication.RefertosetEventTracking ©2017byKony,Inc.Allrightsreserved 10of32