Table Of ContentKony 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
Description:This document contains information proprietary to Kony, Inc., is bound by the Kony license agreements, and may not be used except in the context of