Dimensions and metrics

[GA4] Create event-scoped custom dimensions

Report on and advertise with the categorical data from custom event parameters

Next: [GA4] Create item-scoped custom dimensions

Create event-scoped custom dimensions to report on custom event parameter, which measure details about user actions captured through an event. Whether you're identifying clicked links or video engagement, adding a custom event parameter to your recommended events or custom events allows for in-depth analysis of these interactions.

Before you begin

Don't create a custom event parameter if a predefined dimension already exists.
Add the custom event parameter to your website or mobile app.

Note: The integer values from the event parameters aren’t parsed for event-scoped custom dimensions in apps, but parsed for web events. Hence, it is recommended to add alphanumerical values instead of numerical values.

Make sure the custom event parameter is being collect. For example, you can select an event in the Event count by Event name card in the Realtime report.
Make sure you're an editor or administrator.

Instructions

In Admin, under Data display, click Custom definitions.

Note: The previous link opens to the last Analytics property you accessed. You can change the property using the property selector. You must be an Editor or above at the property level to create event-scoped custom dimensions.
Select the Custom dimensions tab
Click Create custom dimensions.

Complete the following fields:

Field	Description
Dimension name	Enter a unique name for the new dimension. The name you choose will appear in your reports and ad platform. You can't use hyphens in the name, but you can use underscores and spaces instead.
Scope	Select Event to create an event-scoped custom dimension. You can't change this field after you save the new dimension.
Description	Optional text used to identify the event-scoped custom dimension.
Event parameter	Enter the name of the custom event parameter in your website or app code. You can't change this field after you save the new dimension.

Click Save.

Example

You configure the recommended payment_type event parameter for the add_payment_info recommended event. To analyze different payment types, you create the following event-scoped custom dimension:

Dimension name: Payment type
Scope: Event
Description: The chosen method of payment
Event parameter: payment_type

Next steps

Analyze the custom dimension in a report

If you are an editor or administrator, you can add the custom dimension to any report after 24-48 hours from when the custom data was sent and the custom dimension was created.

Learn how to Customize dimensions in detail reports.

Analyze the custom dimension in an exploration

To add the custom dimension to a free-form exploration:

In Google Analytics, click Explore on the left.
Create or open a free-form exploration.
In the Variables column on the left, click + next to Dimensions.
Click the Custom tab at the top.
Select the custom dimension.
Click Import.
Drag the dimension from the Variables column.
Drop the dimension into Rows or Columns in the Settings column.

Build an audience using the dimension

To build an audience using the custom dimension:

In Admin, under Data display, click Audiences.
In the top right, click New audience.
Click Create a custom audience.
Expand the Add new condition drop down.
Select Custom, then select the custom dimension.
Add a filter, then click Save.

Was this helpful?

How can we improve it?