Files
mintlify__docs/integrations/analytics/google-analytics.mdx
mintlify[bot] 6268d03cc2 style: convert future tense to present tense (#3717)
* style: convert future tense 'will' to present tense across docs

Generated-By: mintlify-agent

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-02-24 12:05:49 -08:00

48 lines
1.8 KiB
Plaintext

---
title: "Google Analytics 4"
description: "Track visitor behavior and engagement with Google Analytics."
keywords: ["GA4 integration", "measurement ID", "web stream", "Universal Analytics"]
---
You need to generate a new <Tooltip tip="Google Analytics 4">GA4</Tooltip> property to use with Mintlify. The data collected goes into the same project as your other Google Analytics data.
If you are using the old version of Google Analytics, Universal Analytics, you can still generate a <Tooltip tip="Google Analytics 4">GA4</Tooltip> property. <Tooltip tip="Google Analytics 4">GA4</Tooltip> data is slightly different from UA data but still gets collected in the same project.
## How to Connect GA4 to Mintlify
### Create a web stream
You need to create a web stream to get the Measurement ID to put into Mintlify.
Click the cog at the bottom left of the Google Analytics screen. Then click Data Streams.
<Frame>![Screenshot of the Data Streams page in the Google Analytics dashboard.](/images/ga4-web-streams.png)</Frame>
Create a Web Stream and put the URL of your Mintlify docs site as the stream URL.
Your Measurement ID looks like `G-XXXXXXX` and appears under Stream Details immediately after you create the Web Stream.
### Put measurement ID in docs.json
Add your Measurement ID to your `docs.json` file like so:
```json docs.json
"integrations": {
"ga4": {
"measurementId": "G-XXXXXXX"
}
}
```
### Wait
Google Analytics takes two to three days to show your data.
You can use the [Google Analytics Debugger](https://chrome.google.com/webstore/detail/google-analytics-debugger/jnkmfdileelhofjcijamephohjechhna?hl=en) to check analytics are enabled correctly. The extension will log to your browser's console every time GA4 makes a request.
<Note>
Preview links have analytics turned off.
</Note>