Files
mintlify__docs/integrations/analytics/google-analytics.mdx
mintlify[bot] 4e69772d60 Fix Vale style violations: sentence case headings and AM/PM format (#3614)
Generated-By: mintlify-agent

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-02-20 17:17:22 -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 will need to generate a new <Tooltip tip="Google Analytics 4">GA4</Tooltip> property to use with Mintlify. The data collected will go into the same project as your other Google Analytics data.
If you are using the old version of Google Analytics, Universal Analytics, you will still be able to 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 will 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 will show up 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>