BlackberryAnalytics Class Reference

Class for BlackBerry Analytics. More...

Description

BlackBerry Analytics

BlackBerry Analytics provides developers and UEM administrators metrics about the BlackBerry Dynamics apps and devices in an organization's environment. BlackBerry Dynamics apps with this feature enabled by their administrator will periodically send events (including startup, crash information) and data (including OS, minutes used, app name, version) to the BlackBerry Analytics platform. The BlackBerry Analytics platform processes and compiles the events and data into dashboard reports. An app developer can optionally use this programmatic interface to record usage of custom features or events within their app to enable these metrics to be included within the Analytics dashboard.

For more information, see the BlackBerry Analytics documentation.

Static Public Member Functions
static synchronized AnalyticsResponse	trackFeatureEvent (final AnalyticsEvent eventType, final String featureName)
	Record feature events to analyse the period a specific app feature is used. More...
static synchronized AnalyticsResponse	trackApplicationEvent (AnalyticsEvent eventType, String eventValue, String eventKey)
	Record adoption events to analyse the frequency of specific user actions or events. More...

Member Function Documentation

trackFeatureEvent()

static synchronized AnalyticsResponse trackFeatureEvent ( final AnalyticsEvent  eventType, final String  featureName  )

static

Call to record an event that has a start point (a "feature active event") followed by a stop point (a "feature inactive event"). The start and stop points provide a period of time where the feature was active. This type of event is typically used to measure user engagement of app features. The name that is used to track a feature must be unique within the app.

Parameters

eventType	AnalyticsEvent specifies the type of event. For example, FEATURE_ACTIVE or FEATURE_INACTIVE.
featureName	String containing the name of the feature for a given event.

Returns

AnalyticsResponse will return RECORD_SUCCESS if event is valid or a specific error otherwise.

trackApplicationEvent()

static synchronized AnalyticsResponse trackApplicationEvent ( AnalyticsEvent  eventType, String  eventValue, String  eventKey  )

static

Call to record an event which occurs in your application. An adoption event has two attributes, key and value. The key must be unique within the app, and the value is a count of the number of times a specific event occurs (for example, an event key called "Emails deleted" that tracks the number of emails deleted by a user). The adoption event value should be the string representation of the integer count. An app can combine events and record a single event.

Parameters

eventType	AnalyticsEvent specifies the type of event. In this case use ADOPTION_EVENT.
eventValue	String containing the event value to record for the given event key.
eventKey	String to define the name of the event.

Returns

AnalyticsResponse will return RECORD_SUCCESS if event is valid or a specific error otherwise.