> For the complete documentation index, see [llms.txt](https://docs.coupler.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coupler.io/sources/category/ppc/google-analytics.md).

# Google Analytics 4 (GA4)

Google Analytics 4 (GA4) is Google's analytics platform for tracking user behavior across websites and apps. It uses an event-based data model to capture how visitors interact with your content — from page views and sessions to conversions and e-commerce transactions. By connecting GA4 to Coupler.io, you can automatically export your analytics data to spreadsheets, BI tools, or databases without any manual work.

## Why connect Google Analytics to Coupler.io?

* **Automate reporting** — Schedule regular data refreshes so your dashboards and spreadsheets always reflect the latest website or app performance.
* **Combine with other sources** — Merge GA4 data with Google Ads, Facebook Ads, CRM, or e-commerce data for a complete view of your marketing funnel.
* **Overcome GA4 interface limits** — The GA4 UI limits you to a handful of dimensions and metrics at a time. Coupler.io lets you build custom reports with up to 9 dimensions and 10 metrics per data flow.
* **Flexible destinations** — Export to AI tools like Claude or ChatGPT, Google Sheets, Excel, BigQuery, Looker Studio, or other supported destinations.

## Prerequisites

{% hint style="warning" %}
Before connecting, make sure you have all of the following. Missing permissions are the most common setup issue.
{% endhint %}

* A Google account with access to at least one **GA4 property** in [Google Analytics](https://analytics.google.com/)
* **Viewer** (or higher) permissions on the GA4 property you want to pull data from
* A Coupler.io account

## Quick start

{% hint style="success" %}
Start with the default metrics — Views, Total users, New users, Event count, and Key events — with the Date dimension for the last 60 days (default). Proceed to the Data sets to get a quick snapshot of your website performance and verify everything is connected correctly, or simply ask the Coupler AI agent to summarize the data.
{% endhint %}

## How to connect

Google Analytics uses **OAuth authentication** — you sign in with your Google account directly.

{% stepper %}
{% step %}
In Coupler.io, create a new **data flow** and select **Google Analytics 4** as the source.\
Click **Connect** and sign in with your Google account.
{% endstep %}

{% step %}
Grant Coupler.io read-only access to your analytics data.
{% endstep %}

{% step %}
Select the **Source accounts** you want to connect. Then, select **Properties**.
{% endstep %}

{% step %}
Choose **Metrics** (like Views, Total users, and Key events) and **Dimensions** (like Date or Country).
{% endstep %}

{% step %}
Choose your **destination** and run the import.
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.coupler.io/sources/category/ppc/google-analytics.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
