## **📋 Overview**

Google Analytics 4 (GA4) key events track the actions that matter most to your business — purchases, form submissions, sign-ups, and more. This article explains where GA4 key event data appears in Search Atlas, how to work with it today, and what is coming in a future update.

## **🔍 Where GA4 Key Events Appear**

GA4 key event data is available inside **Report Builder**. Once your GA4 property is connected, Report Builder displays a dedicated **Key Events** section that lists your designated key events in a paginated table.

To access this section:

1. Open **Report Builder** from the left sidebar.
2. Select or create the report you want to work with.
3. Scroll to the **Key Events** section within the report view.
4. Review your paginated key event data pulled directly from your connected GA4 property.

## **🤖 Using the AI Agent to Work with Key Events**

Report Builder includes a built-in AI agent that can help you pull and organise data inside your reports. You can use prompts like the ones below to work with your GA4 key event data:

- **"Show me the key events from my GA4 property in this report."**
- **"Add a Key Events section to this report."**
- **"Summarise my top GA4 key events for the selected date range."**

Type your prompt directly into the agent chat inside Report Builder. The agent will reference your connected GA4 data and update the report accordingly.

## **⚠️ Current Limitations: Executive Summary Cards**

At this time, it is **not yet possible** to add individual GA4 key event cards — with customisable visual indicators such as charts or trend widgets — directly to the **Executive Summary** section of a report. This is a known feature request (**RB-1600**) that is actively being tracked by our product team.

What you **can** do today:

- View all designated GA4 key events in the Key Events section of Report Builder.
- Use the AI agent to include key event summaries in your report content.
- Share or export the report with the Key Events section included.

## **✅ Confirming Your GA4 Property Is Connected**

Key event data will only appear if your GA4 property is properly connected to Search Atlas. To verify your connection:

1. Go to **Site Metrics** in the left sidebar.
2. Select **Overview** or **Site Events** to confirm GA4 data is populating.
3. If no GA4 data appears, check your integration settings and reconnect your GA4 property if needed.

## **🛠️ Troubleshooting: Key Events Not Showing Correctly**

If you see events in the Key Events section that do not match the key events you have designated inside GA4, try the following steps:

- Confirm that the events are marked as key events inside your **GA4 property settings**, not just tracked as standard events.
- Allow up to 24 hours for newly designated key events to sync and appear in Report Builder.
- Disconnect and reconnect your GA4 integration if data still appears inconsistent.

## **🚀 What's Coming Next**

The ability to add individual GA4 key event cards with customisable visual indicators to the Executive Summary is on the product roadmap under feature request **RB-1600**. When this feature is released, you will be able to surface specific key events as visual cards directly within your executive-level report views.

We recommend checking the Search Atlas changelog or release notes for updates on this feature.

## **💬 Need More Help?**

If you need further assistance, open the chat widget in the bottom-right corner of the platform and type **human teammate** to be instantly connected with a member of our team.