Instructions for Delphi

Thank you for choosing Software Statistics Service - a perfect tool for Delphi application monitoring!

These instructions will help you to install and integrate Software Statistics Service tracker into your Delphi application within a few minutes. If you experience any problems, please consult the online documentation. And, please don’t hesitate to contact us – we’re always glad to help.

Check the instructions for other technologies: .NET, C++, JavaMicrosoft SilverlightWindows Phone 7Windows Presentation FoundationJava for Android.

Technical Requirements

Delphi 2007 – 2011

Installation

Open the appropriate package – SoftwareStatisticsServiceTracker.dpk. In Project Manager window click right mouse button and choose “Build”. After that click right mouse button again and select “Install”.
You may need to add the directory containing SoftwareStatisticsServiceTracker (and all subdirectories) to your library search path (which can be found under Environment Options).

Once installed you will find one extra page of components on your component palette, namely Software Statistics Service. You can now place these components onto the form of your application to start the data collection.

Integration with Your Software

Drag-and-drop Software Statistics Service Tracker component from the component page to your form or data module. Select the component and then open Object Inspector to view component properties. Paste your Project Key string copied from your account control panel (website) to ProjectKey property. Make sure you have UseSandbox property properly set – it should be False for production release. Check demo application for more information.

Usage

Please find demo application inside the package to see how to integrate Software Statistics Service Tracker into your Delphi application and how to use its features. Also check component help in Help directory to get more information about types and functions.

Note: Software Statistics Service Tracker is designed to automatically collect anonymous usage information and transfer it to the Software Statistics Service host server. In addition this service allows you to collect your own custom data that may not be anonymous and violate user level agreement and country laws. You should include prominent option in your software informing users about such behaviour and allowing them to turn this feature off. Usual practice is to show such option during software installation and to add it to the software program options/preferences.

How to Test Your Integration

  1. Signup at software-statistics-service.com and create a new project.
  2. Create a new application and use Software Statistics Service Tracker client module in it as it is described in integration instructions.
  3. Copy Project Key from your account and set Project Key property of tracker module in your application.
  4. Make sure you’ve set UseSandbox property to “True”. When this option is used your data will be posted to our sandbox server which is faster but limited by the number of requests – up to 100 requests per project per day. In case you were trying integration and reached the limit you should create a new project and use another Project Key.

The very simple way to test is to run and then close your application. Software Statistics Service Tracker module will send data when application is about to be closed. If there are delays/troubles with internet connection, it will try to send data next time application is started.

Usually it takes up to 15 minutes between data transfer to the server and the moment when you can see them on the graphs under your account.

By default Tracker module collects such events as application start and shutdown as well as such data as RAM amount, number of CPU cores and CPU frequency, location and operating system i.e. very common usage information. If you want to track your own data e.g. number of times a button was clicked or feature was used you should use Custom Events.

Uninstallation

In RAD Studio click main menu “Component” item and then click “Install Packages”. Find “Software Statistics Service”, select it and click “Remove” button.

Changelog

Check out our changelog for Delphi from time to time to follow up with our latest updates.

Frequently Asked Questions

Please read Frequently Asked Questions
We are open to your suggestions and ready to discuss your needs and ideas at: support@software-statistics-service.com

Thank you for reading this far. Good luck with your e-business!

This component is copyrighted (c) 2010-2011 MagneticOne, Eleks
All trademarks are property of their respective owners.