> For the complete documentation index, see [llms.txt](https://smartui-docs.pixelperfectstudio.mx/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://smartui-docs.pixelperfectstudio.mx/miscellaneous-addons/google-analytics-4.md).

# 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.

## <img src="/files/Tqq68e0TRKwDB74o4JuW" alt="" data-size="line">GA4

Track your game's performance with ease using the Google Analytics 4. Gain real-time insights, integrate effortlessly, and optimize player engagement.

<details>

<summary>Download</summary>

<https://store.pixelperfectstudio.mx/product/ga4/>

</details>

## 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**