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

# Connect Google Analytics

> Connect Google Analytics 4 to Signals with one click, read only, to add a behavioral second signal. This is what lets a scan confirm an idea and mark it Test ready.

<Note>
  **Beta.** The GA4 connection for Signals is part of the Signals Beta.
  See the [Signals overview](/signals/overview).
</Note>

Every scan already reads your page **structure**. Connecting Google
Analytics 4 adds the second, independent signal: **behavior**. With
both connected, a scan can confirm an idea against what visitors
actually do, which is what moves an idea from **Validation required** to
**Test ready**. See the [overview](/signals/overview) for that framing.

## Connect it

<Steps>
  <Step title="Open Settings, then Signals">
    Go to **Site → Settings → Signals** and click **Connect Google
    Analytics**.
  </Step>

  <Step title="Sign in with Google">
    Sign in with Google once. ABTestly requests **read only** access.
    It can read your GA4 reports. It can never write to, change, or
    delete anything in your analytics.
  </Step>

  <Step title="Pick the GA4 property for this site">
    Choose the property that measures the site you are scanning. The
    connection check confirms it lines up with your site, see the
    requirement below.
  </Step>
</Steps>

## The one requirement

The GA4 property you pick must have a **web data stream whose domain
matches the site you are scanning.** If the stream points at a
different domain, the behavioral signal cannot line up with the pages
in your scan, and the connect check tells you so instead of guessing.

If the check fails, open the property in Google Analytics, confirm it
has a web data stream, and confirm that stream's domain is the same
site you connected in ABTestly.

## What the behavioral signal adds

Once connected, scans of this site gain behavior alongside structure:

* **Funnel drop off**, where visitors fall out of a path you walked.
* **Conversion by device**, whether mobile and desktop convert
  differently on the same page.
* **Revenue by channel**, where the money actually comes from.

An idea that the structure raised and the behavior confirms is marked
**Test ready**. An idea the behavior cannot speak to stays **Validation
required**, an honest finding for you to check rather than a claim.
Signals never manufactures a number the data does not support.

## This is not the GA4 analytics adapter

There are two GA4 connections in ABTestly and they run in opposite
directions. Do not confuse them.

| Connection                                        | Direction                        | Purpose                               |
| ------------------------------------------------- | -------------------------------- | ------------------------------------- |
| **Signals GA4** (this page)                       | Reads **in** from GA4, read only | Adds the behavioral signal to a scan  |
| [Analytics adapter](/settings/analytics-adapters) | Pushes **out** to GA4 dataLayer  | Lets you slice conversions by variant |

You can use either, both, or neither. They do not depend on each other.

## Security and revoking access

* The connection is **read only**. ABTestly cannot alter your Google
  Analytics.
* You can revoke ABTestly's access at any time from your Google
  Account permissions, or by disconnecting under **Settings → Signals**.
* Revoking the connection removes the behavioral signal from future
  scans. Existing ideas keep whatever they were marked at the time.

## Next

<CardGroup cols={2}>
  <Card title="Run a scan" icon="magnifying-glass" href="/signals/scan-a-page">
    With behavior connected, capture a page or a funnel walk.
  </Card>

  <Card title="Read the idea board" icon="list-check" href="/signals/read-a-scan">
    See which ideas reached Test ready and which need validation.
  </Card>
</CardGroup>