> For the complete documentation index, see [llms.txt](https://docs.frase.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.frase.io/integrations/connectors/google-analytics-4.md). # Google Analytics 4 Connecting **Google Analytics 4 (GA4)** to a Frase site shows you how much real traffic AI assistants like ChatGPT, Perplexity, and Gemini send your pages, so AI visibility becomes something you can measure, not just guess at. Once connected, Frase reads your GA4 data and surfaces it as ***AI Referrals*** under [**AI Visibility**](https://docs.frase.io/core-workflows/ai-visibility-and-geo): sessions, share of traffic, week-over-week movement, and conversions from AI assistants. ### Why Connect Google Analytics 4 to Frase #### See Real AI Referral Traffic Find out how many sessions ChatGPT, Perplexity, Gemini, and other assistants actually drive to your site. Google Search Console can't show this, because AI assistants aren't search results, so GA4 is the only way to prove those mentions send real people. #### Track Share and Movement See what portion of your traffic comes from AI assistants and how it moves week over week, so you can tell whether your AI visibility is growing or slipping. #### Measure Conversions Go past visits to outcomes. Frase reads conversion metrics from GA4, so you can see whether AI-referred traffic converts. #### Catch Every Assistant Frase ranks the assistants it recognizes and keeps other referrers separate. When a new assistant shows up that Frase doesn't recognize yet, it's still counted, so nothing goes missing. ### Before You Connect {% hint style="danger" %} You first need to [connect a site ](https://docs.frase.io/get-started/connect-your-site-and-brand)and [**Google Search Console**](https://docs.frase.io/integrations/connectors/google-search-console) to enable GA4. Disconnecting GSC also disconnects GA4. {% endhint %} ### How to Connect Google Analytics 4 Frase connects to GA4 through a shared Google service account. You grant that account read-only access inside GA4, then paste your property ID. 1. In Frase, go to **Settings → Integrations**, find *Google Analytics*, and start the connection on the site you want. 2. Copy the Frase service account email shown on the connect screen. 3. In Google Analytics, open **Admin → Property access management** for the property you want to connect. 4. Click **+ → Add users** and paste the Frase service account email. 5. Set the role to **Viewer**. Frase only ever reads your analytics, it never writes to them. 6. Uncheck **Notify new users by email**. The service account isn't a real mailbox. 7. Back in Frase, paste your **Property ID** and finish connecting. {% hint style="warning" %} **Use your numeric Property ID, not your Measurement ID.** Your Property ID is a number like `123456789`, found under **Admin → Property details**. It is *not* the `G-XXXXXXX` Measurement ID. Pasting the `G-` value is the most common reason a connection fails. {% endhint %} Frase confirms the connection with a live read of your property, so you'll know right away if it worked. If something's off, Frase tells you what to fix, whether access hasn't been granted yet, the property ID is wrong, or the property is a Universal Analytics property instead of GA4. ### Where to See Your Data Once you're connected, your first sync runs right away. After that, Frase syncs your GA4 data daily. Find your results under **Monitor → AI Visibility → AI Referrals**. If there's no AI referral traffic yet, the empty state tells you why and points you to the next step. {% hint style="warning" %} **A note on what these numbers mean.** A session from an AI assistant is a *referral*, not proof that a specific mention caused the visit. Assistants are also increasingly dropping referrer data, so treat AI Referrals as a floor on your real AI traffic, not an exact count. {% endhint %} --- # 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.frase.io/integrations/connectors/google-analytics-4.md?ask=&goal= ``` `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.