https://github.com/ichlubna/simpleqtga4

A very simple library that allows to send Google Analytics 4 events
https://github.com/ichlubna/simpleqtga4

ga4 google-analytics google-analytics-4 qml qt

Last synced: about 2 months ago
JSON representation

A very simple library that allows to send Google Analytics 4 events

• Host: GitHub
• URL: https://github.com/ichlubna/simpleqtga4
• Owner: ichlubna
• License: mit
• Created: 2022-08-11T17:51:35.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2022-08-20T05:59:53.000Z (almost 4 years ago)
• Last Synced: 2025-03-27T22:40:24.160Z (about 1 year ago)
• Topics: ga4, google-analytics, google-analytics-4, qml, qt
• Language: C++
• Homepage:
• Size: 8.79 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# SimpleQtGA4

A very simple library that allows to send Google Analytics 4 events.

## Instalation

Add *ga4.hpp* to the *HEADERS* in your project ad add Qt *network* module.

## Usage

	//C++

	GA4 ga4("YOUR_ID");

	ga4.sendEvent("ObiWan", {"talk", "HelloThere"});

	//QML

	GA4{

	  id: ga4

          measurementID: "YOUR_ID"}

	onActiveChanged: { ga4.sendEvent("Gandalf", ["talk", "YouShallNotPass"]) }

Use the functions like:

	sendEvent(eventName, eventParameters, turnOnDebugMode)

*QString eventName* - name of the event

*QList eventParameters* - pairs of parameters ["firstParamName", "firstParamValue",...]

*bool turnOnDebugMode* - if set to True, the events are shown in a few seconds in the Analytics realtime view and are deleted after 30 minutes

	overrideDebugMode(debug)

*bool debug* - all events will be in debug mode (ignoring the turnOnDebugMode parameter) if true, call with false to turn it off

## Additional info

You can obtain your ID when creating a Google Analytics service and creating a web data stream. Then you can get a Measurement ID there starting with G-..

If you send the events with custom parameters, you have to define them in Google Analytics settings, otherwise they will not be stored! You can do so by selecting Configure section and Custom definitions. Follow [this](https://youtu.be/Y6YyzX_7OXk) tutorial.

This library does not do any local storing of the events. All events are sent right when the function is called and in case of no Internet connection they are lost.

If you encounter a problem with encryption, not being able to send the request, you need to install SSL libraries for your given platform. Another hack is to change *https* to *http* in the *analyticsURL* private member.

## Sources

[Limits for the event properties (length of the event etc.)](https://support.google.com/analytics/answer/9267744?hl=en&ref_topic=9756175)

[APP + WEB: Google Analytics Measurement Protocol version 2

Date

](https://www.thyngster.com/app-web-google-analytics-measurement-protocol-version-2)

[Measurement protocol V2 Google analytics Apps+Web](https://lunaxod.com/measurement-protocol-v2-google-analytics-appsweb/)