[GA4] Create or modify key events

Overview

Sometimes an event nearly measures what you want to measure as a key event. For example, you want to measure when someone lands on a confirmation page. The page_view event will tell you when someone lands on the page, but you can't mark that event as a key event since all pageviews will then count as key events.

Instead, you can modify existing events and create new events from existing events within Google Analytics so you can mark the events as key events without needing to change your website or app setup.

Create vs. modify

You can create and modify events in Google Analytics. Modifying an event is a way of changing an existing event so it measures what you want it to measure. Creating an event copies over an existing event so you can measure what you want to measure without changing the original event.

Create an event in Analytics

These instructions show you how to create a new event from the page_view event. In this example, you want the event to trigger when someone submits their contact information and lands on a confirmation page. You can then mark the event as a key event to see the number of people who successfully submit their contact information.

For more information on how to create an event from an existing event and mark it as a key event, watch Create Events in Google Analytics 4 Properties on YouTube.

Step 1: Create the event

1. In Admin, under Data display, click Events.
   Note: The previous link opens to the last Analytics property you accessed. You can change the property using the property selector. You must be a Viewer or above  at the property level to create the event.
2. Click Create event, then click Create.
3. Under Custom event name, enter the name in this example as thank_you.
4. In Matching conditions, under Value, enter page_view.
5. Click Add condition.
6. Under Parameter, select page_location from the drop-down.
7. Under Operator, choose "contains (ignore case)".
8. Under Value, enter the name of the page, which is https://example.com/thank-you.html.
9. Click Create.

The new event will appear in the Custom events table, but it won't appear in the Existing events table in Admin > Data display > Events until Analytics processes the event.

Step 2: Mark the new event as a key event

1. In Admin, under Data display, click Key events.
   Note: The previous link opens to the last Analytics property you accessed. You can change the property using the property selector. You must be a Marketer or above at the property level to mark the new event as a key event.
2. Click New key event.
3. Enter the name of the new event, which is thank_you.
4. Click Save.

Modify an event in Analytics

This section describes how to modify an event that was created in Analytics based on another event. For information on modifying events provided by Google, see the event documentation.

1. In Admin, under Data display, click Events.
   Note: The previous link opens to the last Analytics property you accessed. You can change the property using the property selector. You must be a Viewer or above  at the property level to modify an event in Analytics.
2. Click Create event.
3. In the Custom events table, click an event to modify, or click Create to create a new event.
4. Modify or add conditions or parameters.
5. Click Save.

Associate monetary values with key events

To measure the revenue associated with an event, add the value and currency parameters to the event. The parameters are already recommended for ecommerce events, but you can add the two parameters to any event. Learn more about the event parameters

The value parameter must be a number (e.g., 50) and must be accompanied by a currency parameter. The currency parameter must have a value in the ISO 4217 format (e.g., USD for the US dollar). If the parameter is missing or invalid, the event is recorded with the correct count, but it won't be sent to Google Ads.

The following example describes how to add a value to an event created in Analytics from another event:

1. In Admin, under Data display, click Events.
   Note: The previous link opens to the last Analytics property you accessed. You can change the property using the property selector. You must be a Viewer or above  at the property level to associate monetary values with key events.
2. Click Create event to display the table of custom events.
3. Click an event to modify, or click Create to create a new event.
4. In the Parameter configuration section, click Add modification.
5. In the Parameter field, enter currency.
6. In the New value field, enter a currency type (e.g., USD).
7. Click Add modification.
8. In the Parameter field, enter value.
9. In the New value field, enter the value (e.g., 50 for fifty dollars).
10. Click Save.

The Event count by Event name card in the Realtime report shows you the parameters associated with each event collected by Google Analytics in the last 30 minutes. You can use the Event parameter key column to see all the event parameters associated with an event and make sure the two parameters have been added correctly.