Log Custom Events to GA4

Table of Contents

• Log Custom Events to GA4
  • Use Custom Parameters
  • Further reading

Log Custom Events to GA4

You can easily record custom events using the plugin method UGoogleAnalyticsMPStatics::RecordNamedEvent():

RecordNamedEvent method

Attention: GA4 has strict naming rules and reserved event names (read more), we suggest to use a unique common safe prefix for your custom event names.

Use Custom Parameters

To be able to log custom parameters with your events, Google Analytics 4 requires you to explicitly register them in advance. You can find detailed instructions on how to register a custom parameter here: Custom Dimensions and Metrics.

Once the parameters are registered with their event parameter names, using them is very simple:

RecordNamedEvent method with custom parameters

You must only remember to add, to the registered event parameter names, the correct prefix:

• ep for Custom Dimensions (Event Parameter);
• epn for Custom Metrics (Event Parameter Numeric).

In the example above:

• the registered parameter test_event_label is a Custom Dimension, and so it uses the prefix ep;
• the registered parameter test_event_value is a Custom Metric, and so it uses the prefix epn;

Further reading

• Look at UGoogleAnalyticsMPStatics for the complete list of available methods.
• Custom Dimensions and Metrics.
• List of official GA4 events and parameters.