> ## Documentation Index
> Fetch the complete documentation index at: https://hyperfx.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Analytics

> Set up and use the Google Analytics integration with Hyper AI

Auth type: OAuth

<Info>
  For general setup steps, permissions, and troubleshooting, start with: [App Integrations](/integrations/overview).
</Info>

## Connect Google Analytics

1. Go to Settings → Apps in Hyper
2. Select Google Analytics → Connect New
3. Complete OAuth and select the property to connect

## Common capabilities

* Analyze website traffic and user behavior
* Generate automated performance reports
* Track conversions, goals, and key metrics

## Use in Chat

Enable Google Analytics in the tool selector. Ask your agent for traffic summaries, conversion reports, or audience insights.

## Use in Agents

Add Google Analytics to an agent's toolkits and select the connection.

## Use in Flows

Automate reporting, anomaly detection, and performance tracking using Google Analytics action nodes.

## Troubleshooting

* No data returned: verify the correct property is selected and has active data
* Permission errors: re-authorize with required scopes

***

## Available Actions

Hyper agents can run the following actions for this integration. Each action can be individually set to **Enabled**, **Requires Approval**, or **Disabled** in your agent's toolkit settings.

Actions can be set to one of three control states:

| State                 | Behavior                                                       |
| --------------------- | -------------------------------------------------------------- |
| **Enabled**           | Agent runs the action automatically                            |
| **Requires Approval** | Agent pauses and waits for your confirmation before proceeding |
| **Disabled**          | Action is blocked and cannot be used                           |

Configure these in the agent's toolkit settings or in workspace defaults.

| Action                           | Description                                                                                             |
| -------------------------------- | ------------------------------------------------------------------------------------------------------- |
| Acknowledge User Data Collection | Acknowledge user data collection for a Google Analytics property using direct API proxy (more reliable) |
| Archive Custom Dimension         | Archive a custom dimension in Google Analytics using direct API proxy (more reliable)                   |
| Archive Custom Metric            | Archive a custom metric in Google Analytics using direct API proxy (more reliable)                      |
| Create Custom Dimension          | Create a custom dimension in Google Analytics using direct API proxy (more reliable)                    |
| Create Custom Metric             | Create a custom metric in Google Analytics using direct API proxy (more reliable)                       |
| Create Data Stream               | Create a new data stream in a Google Analytics property using direct API proxy                          |
| Create Ga4 Property              | Create a new GA4 property in Google Analytics                                                           |
| Create Key Event                 | Create a new key event in Google Analytics GA4 property                                                 |
| Delete Data Stream               | Delete a data stream from a Google Analytics property using direct API proxy                            |
| Delete Key Event                 | Delete a key event from Google Analytics using direct API proxy (more reliable)                         |
| Delete Property                  | Delete (soft-delete) a Google Analytics property using direct API proxy (more reliable)                 |
| Get Custom Dimension             | Get a single custom dimension from Google Analytics using direct API proxy (more reliable)              |
| Get Custom Metric                | Get a single custom metric from Google Analytics using direct API proxy (more reliable)                 |
| Get Data Retention Settings      | Get data retention settings for a Google Analytics property using direct API proxy (more reliable)      |
| Get Data Stream                  | Get a specific data stream from a Google Analytics property using direct API proxy                      |
| Get Key Event                    | Get a single key event from Google Analytics using direct API proxy (more reliable)                     |
| Get Property                     | Get a single Google Analytics property using direct API proxy (more reliable)                           |
| List Accounts                    | List all Google Analytics accounts accessible to the authenticated user using direct API                |
| List Custom Dimensions           | List custom dimensions in a Google Analytics property using direct API proxy (more reliable)            |
| List Custom Metrics              | List custom metrics in a Google Analytics property using direct API proxy (more reliable)               |
| List Data Streams                | List data streams in a Google Analytics property using direct API proxy                                 |
| List Key Events                  | List key events in a Google Analytics property using direct API proxy (more reliable)                   |
| List Properties                  | List Google Analytics properties                                                                        |
| Run Ga4 Report                   | Run a Google Analytics GA4 report to retrieve metrics and dimensions                                    |
| Update Custom Dimension          | Update a custom dimension in Google Analytics using direct API proxy (more reliable)                    |
| Update Custom Metric             | Update a custom metric in Google Analytics using direct API proxy (more reliable)                       |
| Update Data Retention Settings   | Update data retention settings for a Google Analytics property using direct API proxy (more reliable)   |
| Update Data Stream               | Update a data stream in a Google Analytics property using direct API proxy                              |
| Update Key Event                 | Update a key event in Google Analytics using direct API proxy (more reliable)                           |
| Update Property                  | Update a Google Analytics property using direct API proxy (more reliable)                               |