Requirements: QLM Enterprise v11+
QLM Enterprise allows you to collect analytics about your application's usage.
In the current release, QLM can collect and reports analytics about installations and usage of your software application.
In subsequent releases, QLM will allow you to collect and report data on feature usage.
Analytics Installs
To collect data about your application's installs and uninstalls, QLM provides 3 methods: AddInstall, UpdateInstall and RemoveInstall.
AddInstall should be called during the installation of your application or the first time your application runs.
UpdateInstall should be called if any of the data published to the server during installation was modified.
RemoveInstall should be called when your application is uninstalled.
UpdateLastAccessedDate should be called every time your application runs and at least once per day.
To view reports about your applications installations, start the QLM Application and click on the Analytics tab.
The Analytics tab displays two graphs and a table.
The Trial Installs graph displays statistics about all the trial installs and uninstalls of your application.
The Permanent Installs graph displays statistics about all the permanent installs and uninstalls of your application.
The All Installs grid displays data about all installs and uninstalls.
Methods
AddInstall
public bool AddInstall(string softwareVersion, string osVersion, string computerName, string computerID, string activationKey, string computerKey, bool trial, string productName, int majorVersion, int minorVersion, ref string installID).
Description
Registers an installation with the server. You should call this function once when your application is installed. You should store the returned installID in your application's settings and reuse it on subsequent calls to the QlmAnalytics API.
Parameters
softwareVersion: Version of your software
osVersion: Version of the operating system
computerName: Name of the computer
computerID: Unique identifier of the computer
activationKey: activation key on the system
computerKey: computer key associated to the system
productName: name of your product
majorVersion: major version of your product
minorVersion: minor version of your product
installID: unique identifier of this installation, returned from the server.
Return
Returns true of the data was successfully published to the server.
UpdateInstall
public bool UpdateInstall(string installID, string softwareVersion, string osVersion, string computerName, string computerID, string activationKey, string computerKey, bool trial, string productName, int majorVersion, int minorVersion).
Description
Updates information of a registered installation on the server.
Parameters
installID: unique identifier of this installation, returned by a call to AddInstall
softwareVersion: Version of your software
osVersion: Version of the operating system
computerName: Name of the computer
computerID: Unique identifier of the computer
activationKey: activation key on the system
computerKey: computer key associated to the system
productName: name of your product
majorVersion: major version of your product
minorVersion: minor version of your product
Return
Returns true of the data was successfully published to the server.
RemoveInstall
Description
Unregisters an application with the server. You should call this function when the user uninstalls your application.
Parameters
installID: unique identifier of this installation, returned from the server.
errorMessage: returned error message if the call fails.
Return
Returns true of the data was successfully published to the server.
UpdateLastAccessedDate
Description
Updates the last accessed date. You should call this function every time your application starts up and at least once a day.
Parameters
installID: unique identifier of this installation, returned from the server.
Return
Returns true of the data was successfully published to the server.
Comments
0 comments
Article is closed for comments.