# Google Analytics 4
Track your game's performance with ease using the Google Analytics 4 plugin for Construct 3. Gain real-time insights, integrate effortlessly, and optimize player engagement. Compatible with multiple platforms and supported by expert customer service.
#### **Key Features**
* **Advanced Analytics**: Access GA4’s new metrics and dashboards to understand user engagement, track conversions, and analyze in-depth data for your games.
* **Seamless Integration**: Quickly set up tracking without any coding expertise. Simply input your GA4 GTAG ID and the plugin handles the rest.
* **Real-Time Data**: Get instant updates on your game's performance, including visits, events, and user interactions, all tracked in real time.
* **Customizable Tracking**: Tailor event tracking to suit your game’s unique needs, whether it's for tracking level completions, in-app purchases, or user interactions.
## 
GA4
Track your game's performance with ease using the Google Analytics 4. Gain real-time insights, integrate effortlessly, and optimize player engagement.
Download
## Properties
| **Property** | **Description** |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Google Analytics 4 ID` | Google Analytics 4 tracking ID |
| `Configuration (optional)` | JSON string containing additional configuration information for Google Analytics. For instance: app\_name |
| `Track Preview mode` | Enables tracking of C3 preview mode (Use for Testing) |
| `Initialization Type` | Sets the initialization type. Auto - Starts automatically the analytics engine and collects data immediatelly; Manual - requires Init action to be called to start collecting data. |
## Actions
***
### `Add GA4 Property`
Registers an additional GA4 property to your page. This allows you to add multiple tracking services.
| **Parameter** | **Description** |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Property ID` | Property ID. Supported properties are: Google Analytics 4 (G-XXXXX), Google Ads (AW-XXXXX),etc. Check Google Analytics 4 documentation for third party compatibility information. |
| `Configuration` | (Optional) Stringified JSON object containing the additional configuration. Check Google Analytics documentation for more information. |
### `Queue Event Params`
Queues parameters for the next Send Event Async action called.
| **Parameter** | **Description** |
| ------------- | ------------------------------------------------------------------------------- |
| `Parameter` | Parameter Name |
| `Value` | Parameter Value. Can be a string, a numeric value, or a stringified JSON object |
### `Send event`
Sends an event to google analytics service
| **Parameter** | **Description** |
| ------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `Event Name` | Event Name |
| `Event Data` | (Optional) Stringified JSON data to be sent. |
| `Send To` | Indicates the target property to send the data to. If empty, the plugin will send the data to all the available properties. |
### `Send Event Async`
Sends an event to google analytics service. Parameters are taken from the previous executions of the action Queue Event Params
| **Parameter** | **Description** |
| ------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `Event Name` | Event Name |
| `Send To` | Indicates the target property to send the data to. If empty, the plugin will send the data to all the available properties. |
### `Screen View`
Reports a screen view to measure specific screen views in Google Analytics.
| **Parameter** | **Description** |
| ------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `Screen Name` | Screen Name |
| `App Name` | Your application/game name |
| `Send To` | Indicates the target property to send the data to. If empty, the plugin will send the data to all the available properties. |
### `Set User Property`
Sets a user property value
| **Parameter** | **Description** |
| --------------- | --------------------------------------------------- |
| `Property Id` | Technical name of the property. E.g. 'app\_version' |
| `Property Data` | (Optional) Stringified JSON data to be sent. |
### `Initialize`
Initializes Google Analytics. If GA is already enabled, this action has no effect. Use only with the a Manual Initialization Type
| **Parameter** | **Description** |
| ------------- | --------------------------------------------- |
| `Enable` | Enable/Disabled the Google Analytics tracking |
## Conditions
***
### `Is Active`
Returns true if the GA4 engine is ready. Be aware that GA4 collects automatic metrics. If you don't want metrics to be collected, don't initialize any GA4 Property Id
### `On Initialized`
Triggered when GA4 initialization is completed only with Manual Initialization. For automatic initialization, this condition has no effect, use "Is Active" instead
## Expressions
***
**(c) Pixel Perfect Studio 2025**
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://smartui-docs.pixelperfectstudio.mx/miscellaneous-addons/google-analytics-4.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.