Flurry

The Flurry item provides functions for getting insights into your app's usage. More...

Import Statement: import VPlayPlugins.flurry 1.0
Inherits:

Item

Properties

Methods

Detailed Description

The Flurry plugin provides functions for getting insights into your app's usage for iOS & Android.

Property Documentation

apiKey : string

Your Flurry API key for the set up project. Be sure to set this before calling any tracking functions. If you want separate tracking for iOS and Android, use the following example code:

 import VPlayPlugins.flurry 1.0

 Flurry {
   // a different API key is used for Android and iOS
   apiKey: Qt.platform.os === "ios" ? "<ios-api-key>" : "<android-api-key>"
 }

appVersion : string

Set this optional property to override the app version Flurry uses for reporting. If you do not set the property the plugin uses the default app version read from the app bundle.

Note: Make sure to set this before calling any tracking functions within your app.


eventLoggingEnabled : bool

Set this property to allow the capture of custom events. The default value is true, set it to false if you want to test and debug your app without sending any events to Flurry.


logLevel : enumeration

Set this property to display some debug information related to the native Flurry SDK in the log output.

Possible values are:

  • Flurry.LogLevelNone (no output)
  • Flurry.LogLevelCriticalOnly (outputs only critical log events, the default value)
  • Flurry.LogLevelDebug (outputs critical and main log events)
  • Flurry.LogLevelAll (outputs all log events)

sessionAutostart : bool

This property indicates if a Flurry session should automatically be started when the app starts and paused when the app goes into the background state. If set to false, you must start and stop the session manually. The default value is true, meaning that you don't have to call startSession() on your own.

See also startSession().


userAge : int

Sets the user's age for audience analysis. You have to prompt the user for the age or use another plugin like Facebook to retrieve the value, otherwise Flurry uses Flurry Estimates to provide information for audience analysis.


userGender : enumeration

Sets the user's gender for audience analysis. You have to prompt the user for the gender or use another plugin like Facebook to retrieve the value, otherwise Flurry uses Flurry Estimates to provide information for audience analysis.

Possible values are:

  • Flurry.UserGenderNone (unknown gender, the default value)
  • Flurry.UserGenderFemale
  • Flurry.UserGenderMale

userId : string

Set this optional property to keep track of individual users within your app.


Method Documentation

void endSession()

Call this method only if you set the sessionAutostart propertyto false and want to handle sessions on your own. It triggers a stop of the analytics session.

This is useful if you do not want to track an entire app usage session but only a certain part within your game.

See also sessionAutostart and startSession().


void endSession()

Call this method if the sessionAutostart property is set to false. It triggers a stop of the analytics session.

This is useful if you do not want to track an entire app usage session but only a certain part within your app.

See also sessionAutostart and startSession().


void endTimedEvent(string event)

Stops logging of one of timed events with the given event name and updates the given parameters. The duration from logTimedEvent() until endTimedEvent() is automatically measured and sent to the analytics server.

Note: The maximum number of keys in the keValueMAp is 10, due to limitations in the native Flurry SDK implementation.


void endTimedEvent(string event)

Stops logging of one of timed events with the given event name. The duration from logTimedEvent() until endTimedEvent() is automatically measured and sent to the analytics server.


void endTimedEvent(string event, variant keyValueMap)

Stops logging of one of the three timed-event calls. The duration from logTimedEvent() until endTimedEvent() is automatically measured and sent to the analytics server along the event.

The keyValueMap parameter is optional and can be used to add additional information to the event.


void logError(string name, string message)

Log any kind of app-specific error to Flurry, e.g. when the loading of content over the Internet failed.


void logError(string name, string message)

Log an error of the application in addition to automatically sent crash reports.


void logEvent(string event, variant keyValueMap)

Log a single event with name event and a JSON-encoded keyValueMap, e.g. to log an event named "Display.GameScene" call flurry.logEvent("Display.GameScene", {"level": 16, "numberDied": 2} ).

Note: The maximum number of keys in the keValueMAp is 10, due to limitations in the native Flurry SDK implementation.


void logEvent(string event, string key, string value)

Log a single event with name event and key / value pair, e.g. to log an event named "Tower.Built" call flurry.logEvent("Tower.Built", "eventType", "Flamethrower").


void logEvent(string event)

Log a single event with name event, e.g. to log an event named "Display.CreditsScene" call flurry.logEvent("Display.CreditsScene").


void logEvent(string event, variant keyValueMap)

Log a single event with name event and a JSON-encoded keyValueMap. For example flurry.logEvent("Display.GameScene", {"level": 16, "numberDied": 2} );

Note: The maximum number of keys in the keValueMAp is 10, due to limitations in the native Flurry SDK implementations.


void logEvent(string event, string key, string value)

Log a single event with name event and key with value. For example flurry.logEvent("Tower.Built", "eventType", "Flamethrower");


void logEvent(string event)

Log a single event with name event. For example flurry.logEvent("Display.CreditsScene");


void logTimedEvent(string event, variant keyValueMap)

Log a single timed event with name event and a JSON-encoded keyValueMap, e.g. flurry.logEvent("Display.GameScene", {"level": 16, "numberDied": 2} ).

Note: The maximum number of keys in the keValueMAp is 10, due to limitations in the native Flurry SDK implementation.


void logTimedEvent(string event, string key, string value)

Log a single timed event with name event and key with value, e.g. flurry.logEvent("Tower.Built", "eventType", "Flamethrower").


void logTimedEvent(string event)

Log a single timed event with name event, e.g. flurry.logEvent("Display.CreditsScene").


void logTimedEvent(string event, variant keyValueMap)

Log a single timed event with name event and a JSON-encoded keyValueMap. For example flurry.logEvent("Display.GameScene", {"level": 16, "numberDied": 2} );

Note: The maximum number of keys in the keValueMAp is 10, due to limitations in the native Flurry SDK implementations.


void logTimedEvent(string event, string key, string value)

Log a single timed event with name event and key with value. For example flurry.logEvent("Tower.Built", "eventType", "Flamethrower");


void logTimedEvent(string event)

Log a single timed event with name event. For example flurry.logEvent("Display.CreditsScene");


void startSession()

Call this method only if you set the sessionAutostart propertyto false and want to handle sessions on your own. It triggers a start of the analytics session.

This is useful if you do not want to track an entire app usage session but only a certain part within your game. Be sure to call endSession() at some point after calling this function.

See also sessionAutostart and endSession().


void startSession()

Call this method if you set the sessionAutostart property explicitly to false. It triggers a start of the analytics session.

This is useful if you do not want to track an entire app usage session but only a certain part within your app, like a game scene in a game. Be sure to call endSession() at some point after calling this function.

See also sessionAutostart and endSession().


Videos

Voted #1 for:

  • Easiest to learn
  • Most time saving
  • Best support

Develop Cross-Platform Apps and Games 50% Faster!

  • Voted the best supported, most time-saving and easiest to learn cross-platform development tool
  • Based on the Qt framework, with native performance and appearance on all platforms including iOS and Android
  • Offers a variety of plugins to monetize, analyze and engage users
FREE!
create apps
create games
cross platform
native performance
3rd party services
game network
multiplayer
level editor
easiest to learn
biggest time saving
best support