Top
Whatfix Mobile Events
  • 20 Jun 2024
  • 7 Minutes To Read
  • Dark
    Light
  • PDF

Whatfix Mobile Events

  • Dark
    Light
  • PDF

Article summary

Whatfix Mobile generates particular events as your end user interacts with the Walkthrough or elements. These events are used by Whatfix Mobile to generate insights on your Dashboard. Also, Whatfix enables you to send these events to third-party platforms via integration or custom code.

There are two entities that constitute Whatfix Mobile's in-app engagement platform:
Element: To drive single interaction on any particular screen
Flow: To drive multi-interactions across different screens. It contains one or more elements

your title goes here

For more information on how events are generated across different types of projects, see

The following are the Whatfix Mobile events that are generated:

flow_start

This event is generated in the following scenarios:

  • When a user sees the Start Screen (configured from the Dashboard).
  • When a user clicks the Icon and the Walkthrough is triggered.

This means that the Walkthrough has been shown to the end user on the screen but the user didn't interact with the Walkthrough. This event precedes flow opt in/flow opt-out event.

Validity: Flow

your title goes here

This is the initial step in the case of a Walkthrough type project in the Dashboard.

Event properties:

{
	"projectName" : "", //Name of project in dashboard
	"language" : "ang", //current leap language for this event
	"timestamp" : "2021-03-28T09:26:55Z", 
	"eventName" : "flow_start",
	"deploymentName" : "", //Name of deployment in dashboard
	"id" : "", // unique id for the event
	"deploymentVersion": "", //version of deployment
	"projectId" :"" // This key is sent only when project is started with startProject
}
your title goes here

deploymentVersion is to know if the project was changed and deployed again.


flow_opt_in

This event is generated when a user opts-in for the Whatfix Mobile experience. This means that the user has clicked on button to start a Walkthrough, and it has started on the mobile screen. This event succeeds the flow_start event.
Validity: Flow
Event properties:

{
	"projectName" : "", //Name of project in dashboard
	"language" : "ang", //current leap language for this event
	"timestamp" : "2021-03-28T09:26:55Z", 
	"eventName" : "flow_opt_in",
	"deploymentName" : "", //Name of deployment in dashboard	
	"id" : "", // unique id for the event
	"deploymentVersion": "", //version of deployment
	"projectId" :"" // This key is sent only when project is started with startProject
}

flow_opt_out

This event is generated when a user opts out of the Whatfix Mobile experience. This means that the user has clicked on the dismiss button or cross icon to close the Walkthrough when it started on screen. This event succeeds the flow_start event.

This event is generated in the following scenarios,

  • When a user clicks the dismiss button in the discovery
  • When a user clicks a cross button in the discovery
  • When a user clicks outside the discovery i.e Popup/BottomUp/Highlight/Tooltip etc.
  • When a user goes to another screen without selecting anything in the Ping Discovery

Validity: Flow
Event properties:

{
	"projectName" : "", //Name of project in dashboard
	"language" : "ang", //current leap language for this event
	"timestamp" : "2021-03-28T09:26:55Z", 
	"eventName" : "flow_opt_out",
	"deploymentName" : "", //Name of deployment in dashboard
	"id" : "", // unique id for the event
	"deploymentVersion": "", //version of deployment
	"projectId" :"" // This key is sent only when project is started with startProject
}

element_seen

This event is generated when a user sees a Whatfix Mobile element. An element may or may not have audio.
Validity: Flow and Elements
Event properties (for Flows):

{
	"projectName" : "", //Name of project in dashboard
	"language" : "ang", //current leap language for this event
	"timestamp" : "2021-03-28T09:26:55Z",
	"eventName" : "element_seen",
	"pageName" : "", //Name of page in dashboard
	"instructionName" : "", //Name of instruction in dashboard
	"deploymentName" : "", //Name of deployment in dashboard
	"id" : "", // unique id for the event
	"deploymentVersion": "", //version of deployment
	"projectId" :"" // This key is sent only when project is started with startProject
}

Event properties (for Elements):

your title goes here

element_seen is the initial step in the case of an Element type project in the Dashboard.

{
	"projectName" : "", //Name of project in dashboard
	"language" : "ang", //current leap language for this event
	"timestamp" : "2021-03-28T09:26:55Z",
	"eventName" : "element_seen",
	"instructionName" : "", //Name of instruction in dashboard
	"deploymentName" : "", //Name of deployment in dashboard
	"id" : "", // unique id for the event
	"deploymentVersion": "", //version of deployment
	"projectId" :"" // This key is sent only when project is started with startProject
}

flow_success

This event is generated when the flow is completed successfully. This event occus if a step is marked as EXIT FLOW on the Dashboard.
Validity: Flow
Event properties:

{
	"projectName" : "", //Name of project in dashboard
	"language" : "ang", //current leap language for this event
	"timestamp" : "2021-03-28T09:26:55Z",
	"eventName" : "flow_success",
	"instructionName" : "", //Name of instruction in dashboard
	"deploymentName" : "", //Name of deployment in dashboard
	"id" : "", // unique id for the event
	"deploymentVersion": "", //version of deployment
	"projectId" :"" // This key is sent only when project is started with startProject
}

flow_stop

This event is generated when a user stops a Flow by clicking the Stop button in the Whatfix Mobile Icon.
flow_stop

Validity: Flow (because a Flow project has a Whatfix Mobile icon)
Event properties:

{
	"projectName" : "", //Name of project in dashboard
	"language" : "ang", //current leap language for this event
	"timestamp" : "2021-03-28T09:26:55Z",
	"eventName" : "flow_stop",
	"pageName" : "", //Name of page in dashboard
	"instructionName" : "", //Name of instruction in dashboard
	"deploymentName" : "", //Name of deployment in dashboard
	"id" : "", // unique id for the event
	"deploymentVersion": "", //version of deployment
	"projectId" :"" // This key is sent only if when project is started with startProject
}

flow_disable

This event is generated when a user drags the Whatfix Mobile icon to the cross symbol on the bottom, and then agrees to disable it by clicking Yes.
Validity: Flow (because a Flow project has a Whatfix Mobile icon)
Event properties:

{
	"projectName" : "", //Name of project in dashboard
	"language" : "ang", //current leap language for this event
	"timestamp" : "2021-03-28T09:26:55Z",
	"eventName" : "flow_disable",
	"pageName" : "", //Name of page in dashboard
	"instructionName" : "", //Name of instruction in dashboard
	"deploymentName" : "", //Name of deployment in dashboard
	"id" : "", // unique id for the event
	"deploymentVersion": "", //version of deployment
	"projectId" :"" // This key is sent only when project is started with startProject
}

flow_language_change

This event is generated when a user changes the language in Whatfix Mobile.
Validity: Flow (because a Flow project has a Whatfix Mobile icon)
Event properties:

{
	"projectName" : "", //Name of project in dashboard
	"previousLanguage" : "ang" //previous language
	"language" : "hin", // new language selected
	"timestamp" : "2021-03-28T09:26:55Z", 
	"eventName" : "flow_language_change",
	"deploymentName" : "", //Name of deployment in dashboard
	"id" : "", // unique id for the event
	"deploymentVersion": "", //version of deployment
	"projectId" :"" // This key is sent only when project is started with startProject
}

element_action

This event is generated when a user takes any action on the Whatfix Mobile AUI configured via the Dashboard.
actionEventType can be close, end_flow, external_link, anchor_click
actionEventValue: Text of the button with which the action is done is null if there is no interaction with the button. This is possible in scenarios where the elements are dismissed by clicking elsewhere.
Validity: Flow or Elements
Event properties:

{
	"projectName" : "" //Name of project in dashboard
	"language" : "ang", //current leap language for this event
	"timestamp" : "2021-03-28T09:26:55Z",
	"eventName" : "element_action",
	"actionEventType" : "", //action name
  "actionEventValue": "", // action value
	"deploymentName" : "", //Name of deployment in dashboard
	"id" : "", // unique id for the event
	"deploymentVersion": "", //version of deployment
	"projectId" :"" // This key is sent only when project is started with startProject
}

leap_sdk_disable

This event is generated when Whatfix Mobile SDK is programmatically disabled i.e. by using LeapAUI.disable()
Validity: Flow or Elements
Event properties:

{
	"projectName" : "", //Name of project in dashboard
	"language" : "ang", //current leap language for this event
	"timestamp" : "2021-03-28T09:26:55Z", 
	"eventName" : "leap_sdk_disable",
	"deploymentName" : "", //Name of deployment in dashboard
	"id" : "", // unique id for the event
	"deploymentVersion": "", //version of deployment
	"projectId" :"" // This key is sent only when project is started with startProject
}

project_termination

This event is generated when the termination frequency is matching with the ones configured in Whatfix Mobile Studio. This is only valid if the project is started via startProject. The configurable termination parameters are:

  • After n flow completion (where n is always a valid integer, valid only in case of FLOW)
  • At discovery dismiss by user (valid only in case of FLOW)
  • At assist dismiss by user (valid only for ELEMENT)
  • After n sessions (where n is always a valid integer, valid case of FLOW/ELEMENT)
    Validity: Flow or Elements started with startProject
    Event properties:
{
	"projectName" : "", //Name of project in dashboard
	"language": "ang", //current leap language for this event
	"timestamp" : "2021-03-28T09:26:55Z", //GMT Timestamp always
	"eventName" : "project_termination",
	"id" : "uuid",
  "terminationRule": "After 5 sessions", //"After 3 flow completion", "At discovery dismiss by user", "At Assist dismiss by user"
	"projectId" :"", // project ID started with startProject
	"deploymentName" : "", // Name of the deployment in dashboard
  "deploymentVersion": "" // version of the deployment
}

Validity table

eventName validity
flow_start Flow
flow_opt_in Flow
flow_opt_out Flow
element_seen Flow and Element
flow_success Flow
flow_stop Flow
flow_disable Flow
flow_language_change Flow
element_action Flow and Element
leap_sdk_disable Flow and Element
project_termination Flow and Element

Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.