Checklist: how to add Google analytics to your program

SoftMeter is a software usage analytics library for Windows, MacOS and IOS that allows software developers to send "pageview", "event", "screenview" and "Exception" hits from their programs to their Google Analytics profile.

With SoftMeter, shareware authors can see the active installations of their programs in the same way they see the visits to their website.

The following checklist will guide you to add SoftMeter's application analytics to your application.

# Task Duration
  A. Prerequisites (5 min)  
A1 Read the SoftMeter license agreement. By implementing SoftMeter in your software you agree to these terms. 5 min
  B. Prepare the reporting platform to "listen" to your software (12 - 22 min)  
  SoftMeter uses Google Analytics as the default reporting platform. Read here why.
You can also use Matomo/Piwik as the reporting platform for the usage statistics of your desktop software.
B1 Create a Google Analytics (GA) account if you do not already have one for your website monitoring. 10 min

If you already have a GA account, create a new property, name it after the name of your software. Google recently introduced a new type of properties, the Google Analytics 4 property.
For SoftMeter you must create a Universal Analytics property.
It is recommended to track each software product with its own dedicated GA "Universal Analytics" property (a new property ID under the same account) to allow easy separation of statistics.

You will be asked to select the reporting type between "Website" and "Mobile App".
Here is a comparison of the two reporting view types.
Select "Website" because "Mobile App" will require to fill in details about your firebase app, which you normally don't have. Later, you can still create a "Mobile App" reporting view (if you want to send "screenView" events from your application).

Write down the property ID number. It is in the form UA-xxxx-y, where xxxx is your account number and y is the property.
If your Google Analytics property ID number does not start with UA- then probably the property is a Google Analytics 4 property instead of a Universal Analytics property. You can create a Universal Analytics property: read here.

This completes
a) the creation of the Property, and
b) the creation of the reporting view under that property

5 min
B3 Download our demo application and the SoftMeter library.
Use your new property ID to send test hits to the reporting view.
Use the Google Analytics real-time report for start.
5 min
B4 Subscribe to the SoftMeter newsletter so you can receive status alerts and new version announcements. 2 min
B5 Success level 1 reached: You have a new GA property for your software, and you have sent test hits from SoftMeter. Now, you just need to send these hits from your own application.
Take a coffee break
  C. Implementation (2.5 - 5 hours)  
C1 "Watch", "Star" or "Fork" our GitHub repository. If you do not have a GitHub account, you can create one for free.  
C2 If you are implementing installation/uninstall statistics:  
  For Inno setup, use our ready example: example files and blog article. 20 min
  For Installaware, use our all-in-one function aioSendEvent_stdcall. 15 min
  For other installation packages, see our Inno setup and Installaware examples to implement installation analytics in a similar way. 1 hour
C3 If you are implementing runtime software analytics inside your software, see our examples.
You can start with a minimum of calling the sendScreenView() function on application launch.
For C++ Windows and/or Mac software: example files.
For Delphi/Pascal console software: example files.
For Delphi/Pascal GUI software: example files and blog article.
For IOS app software: example files.
3 hours
C4 If you digitally sign your installation package or your software, code sign also the SoftMeter library. 30 min
C5 Run your installation package or your software to see the hits arriving at your GA reporting.
Adjust your code and textual parameters of SoftMeter according to your wishes.
1 hour
C6 Add a paragraph in your EULA and a screen at the UI of your application to notify the users about the telemetry.
Download this sample telemetry consent EULA that you can use as a template to write your own.
If your users are also from the EU and the EEA, you must give them an opt-in/opt-out option, where the default is opt-out, in order to comply with the 2018 GDPR law about the personal data.
2 hours
C7 Success level 2: SoftMeter implemented. Please send us any comments you might have.  
  D. Packaging, release and start monitoring the usage of your application (30 min)  
D1 Include the SoftMeter library in your installation package. 15 min
D2 Check our GitHub space and our news for the latest version of SoftMeter.
If a new version exists, you just need to replace the SoftMeter DLL (or dylib on Mac) with the new file.
Note: Every time you publish a new release of your software, it is highly recommended to use the latest version of SoftMeter. Subscribing to the SoftMeter newsletter and alerts and "Watching" our GitHub repository can help achieve this with minimal effort.
5 min
D3 Do you normal quality checks and publish the new release.  
D4 On the next day, log in to GA or to our pre-configured reports to see the first installation and usage statistics. 15 min
D5 Success level 3: You are a hero. Modest or not, the truth is that you brought new information, of high value to your software development house.
You have implemented an advanced technology that allows you for the first time:
  • to see what happens after the download,
  • see the conversion rate of free to paid users
  • to look at how your users use the features of your software,
  • understand their needs and build better software,
  • discover bugs immediately (via crash and exception reporting)
  • work with focused effort.

Take some screenshots or print-outs of your first reports, for your fellow developers and the management team.

  E. Post-launch tasks and graceful project completion (2 hours)  
Go to our preconfigured application analytics reports to see key usage figures of your program.
You can also take our template reports and dashboards from the GA reports gallery and import them into your GA property.
SoftMeter GA dashboard
GA solutions gallery for SoftMeter
2 hours
E2 At any time you can also build your own custom reports, or even take the data to Google data studio to perform an advanced analysis.  
E3 If you only implemented Installation analytics, consider adding SoftMeter also in your application.
If you only implemented SoftMeter in your application, consider adding it also in your setup package.
E4 Consider purchasing a SoftMeter Pro license or making a donation to this project. 5 min
E5 Send us your feedback 5 min
E6 Success level 4: By using our library, and optionally buying the Pro edition, or donating to this project, you increased our development happiness.  

Add new comment