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

# Connect Google Analytics 4 to VeluraHQ for traffic data

> Sync GA4 sessions, engagement time, and channel attribution into VeluraHQ so Pages and Actions combine traffic metrics with search rankings per URL.

Connecting Google Analytics 4 to VeluraHQ adds sessions, users, engagement time, and channel attribution to your page intelligence layer. Combined with Search Console and AI citation data, GA4 completes the picture — you can see whether a page is winning in search but losing in engagement, or gaining citations but losing organic traffic.

## What GA4 data you get

Once connected, the following metrics are available in the Pages module and Actions engine for every URL in your GA4 property:

* **Sessions and users per URL** — raw traffic volume to each page over your selected date range
* **Average engagement time per session** — how long visitors actively engage before leaving
* **Traffic channel breakdown** — organic, direct, referral, social, and other channel attribution per page
* **Engagement rate** — the percentage of sessions that include more than 10 seconds of engagement or a meaningful page interaction

## Connecting GA4

<Steps>
  <Step title="Open the integration settings">
    Go to **Settings > Integrations > Google Analytics** in your workspace.
  </Step>

  <Step title="Start the OAuth flow">
    Click **Connect with Google**.
  </Step>

  <Step title="Authenticate">
    Sign in with the Google account that has access to your GA4 property.
  </Step>

  <Step title="Select your property">
    Choose your GA4 property from the dropdown. If you have multiple properties, select the one that corresponds to the site you're tracking.
  </Step>

  <Step title="Connect">
    Click **Connect**. GA4 data will appear in the Pages module within a few minutes.
  </Step>
</Steps>

## GA4 and Pages

Once connected, the Pages module shows engagement metrics alongside GSC and AI citation data — giving you a single view of how each URL performs across search, traffic, and AI visibility. Use the **low engagement time** filter to find pages that attract traffic but fail to hold attention. These pages typically have thin content, poor structure, or mismatched search intent — a strong signal for a content quality pass.

## Using engagement data in Actions

VeluraHQ's Actions engine factors engagement time and session quality into opportunity scoring. A page ranking at position 8 with 45-second average engagement time scores differently than the same page with 3-minute engagement time — because the underlying content quality signal is different. This helps you prioritize recovery opportunities where a quality improvement is most likely to drive measurable ranking and traffic gains, rather than chasing positions on pages that already convert poorly.

<Note>
  VeluraHQ matches GA4 data to Search Console data by **canonical URL**. Ensure your GA4 property uses consistent URL formats — with or without trailing slash, and consistent use of subdomains — to maximize match rates between the two data sources. Mismatched URL formats can result in pages appearing in GSC without corresponding GA4 data.
</Note>

<Tip>
  Use the **"Solve engagement"** opportunity filter in Pages to surface URLs with above-average traffic but below-average engagement time. These are your highest-leverage content quality improvements — you already have the traffic, you just need the content to earn the visit.
</Tip>