Learn how to set up Claspo events in Google Analytics (GA4) to gain actionable insights into your widgets’ performance. Track key activities like clicks, form displays, and subscription completions to measure engagement and conversions effectively.
What exactly does Claspo send to GA4?
All widget activities across your Claspo account are sent to GA4 under a single event name: Claspo. However, the event includes three additional parameters that provide detailed information about specific actions and widgets:
Event name | Event parameter | Description |
Claspo | eventCategory | Describes the type of widget (for example, inline, pop-up, floating box, etc.) |
| eventAction | Describes the type of event (for example, launcher button displayed, clicks, submits, etc.) |
| eventLabel | Contains the widget’s name (as you named it in Claspo) |
eventCategory values
Value | Description |
BUILT_IN | Inline widget or form |
DETACHED | Pop-ups |
FLOATING_BOX | Floating box, informer |
LAUNCHER | Launcher |
CONTENT_LOCKER | Content locker |
eventAction values
Value | Description |
LauncherShow_[ID] | Launcher button displayed |
LauncherClick_[ID] | Launcher button clicked |
FormShow_[ID] | Widget displayed on site |
FormClick_[ID] | Clicked anywhere on a widget, except the close icon (only for Informers) |
FormButtonClick_[ID] | Button clicked |
FormClose_[ID] | Widget closed by user |
FormStartFilling_[ID] | User started filling the form |
FormFinish_[ID] | Form successfully completed (e.g. visitor clicked ‘Subscribe’, no form validation errors) |
FormSuccessSubscribe_[ID] | Subscription successful |
FormAlreadySubscribe_[ID] | Already subscribed |
FormErrorSubscribe_[ID] | Subscription error |
The [ID] represents the widget and variant IDs (for example, FormShow_f781v781 indicates widget ID 781 and variant ID 781). This naming structure helps differentiate events for different widgets. In GA4, you can filter these events by their ID structure or the eventLabel parameter, which contains the widget's name.
You can find out your widget’s ID on the widget list page:
Tracking A/B tests in GA4
GA4 complements Claspo's A/B testing tools, helping you analyze user behavior and interaction patterns for different widget variants. For example:
Use FormStartFilling and FormFinish to track completion rates.
High drop-offs may indicate friction, such as too many required fields or unclear instructions.
For more guidance, see our dedicated A/B testing article.
How to enable Claspo events in GA4
By default, Claspo doesn’t send events to GA4. To enable event tracking for a widget:
1. Go to Widgets in your Claspo account and select the widget for which you want to enable events.
2. In the Widget Details menu, go to Integrations and toggle on Export data to Google Analytics.
NOTE When you enable event tracking from your Claspo widgets to GA4, the setup works automatically if the GA4 script (gtag.js) is installed directly on your website. However, if you’ve implemented GA4 using Google Tag Manager (GTM), you’ll need to configure additional settings in GTM to ensure the data transfer works properly. |
NOTE GA4 does not automatically process event parameters. To see detailed data in your reports, you need to set up custom dimensions in GA4. This one-time setup applies to all your Claspo widgets. |
Setting up custom dimensions in GA4
To get all the detailed event data, create custom dimensions for three event parameters (eventCategory, eventAction, and eventLabel) in Google Analytics (this is a one-time setup).
1. Go to Admin > Custom definitions > Custom dimensions.
2. Click Create custom dimension.
3. Let’s take the first event parameter eventCategory as an example. Enter a Dimension name (eventCategory) and the Event parameter (eventCategory). Set the scope to Event, and click Save.
4. Repeat for eventAction and eventLabel.
Setting up GA4 with GTM (if necessary)
If using Google Tag Manager (GTM), follow these steps to pass Claspo events to GA4:
1. In GTM, Create a Custom Event Trigger for the event name claspo event.
Set the following configuration in the trigger configuration window, then click Save:
Select Custom Event as the trigger type.
Enter claspo event as the event name.
Select All Custom Events for the trigger to fire on.
2. Go to Variables and select New in the User-Defined Variables section. Define Data Layer Variables for eventCategory, eventAction, and eventLabel.
In the slide-out window, set the following variable configuration, then click Save:
Variable type
Data Layer variable name
Data Layer version
You have to create 3 variables with the following parameters:
Variable type | Data Layer variable name | Data Layer version |
Data Layer Variable | eventAction | Version 2 |
Data Layer Variable | eventCategory | Version 2 |
Data Layer Variable | eventLabel | Version 2 |
3. Go to Tags and create a GA4 Event Tag:
Select Google Analytics: GA4 Event as Tag Type.
Enter claspo as the event name.
Map the Data Layer Variables as event parameters.
In Firing Triggers, select claspo event.
4. Save and publish your changes.