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

# Google Analytics 4

> Connect selected GA4 properties for read-only acquisition and landing-page context beside advertising performance.

The product labels this integration **Google Analytics**. It syncs read-only GA4 sessions, channels, campaigns, and landing pages from the properties you select.

## Before you connect

* Use a Marketer Owner, Admin, or Member role. Viewers can inspect but not manage the connection.
* Use a Google identity that can read the intended GA4 properties.
* Know the property names or IDs that belong in this workspace.
* Choose a completed date range for validation; GA4 and ad platforms use different attribution models.

## Connect and choose properties

<Steps>
  <Step title="Open Google Analytics">
    Go to **Integrations** → **Google Analytics** and select **Connect Google Analytics**.
  </Step>

  <Step title="Complete Google consent">
    The full-page consent flow authorizes read-only GA4 access.
  </Step>

  <Step title="Choose properties">
    In **Choose the GA4 properties to sync**, use **Pick a GA4 property** or search by property name, account, or ID.
  </Step>

  <Step title="Save the selection">
    Select **Sync N selected property** or **Sync N selected properties**.
  </Step>

  <Step title="Verify the connection">
    Check **Account**, **Properties selected**, **Connected**, and the roster under **Synced GA4 properties**.
  </Step>
</Steps>

If no active property is available, the page can offer **How to set up GA4**. Create or regain access to the property in Google Analytics, then return and refresh access.

## Read the setup state

| State                  | Meaning                                                                             | Next action                                                |
| ---------------------- | ----------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| **Status unavailable** | Marketer cannot verify the latest GA4 state and preserves the last-known connection | Refresh before changing anything                           |
| **Disconnected**       | No usable Google Analytics authorization exists                                     | Select **Connect Google Analytics**                        |
| **Reconnect needed**   | Google rejected the saved authorization                                             | Select **Reconnect Google Analytics**                      |
| **Choose properties**  | Authorization exists, but no valid property selection is saved                      | Choose and sync properties                                 |
| **Refresh access**     | Authorization exists, but no selectable property roster was resolved                | Fix Google access, then select **Refresh property access** |
| **Connected**          | Authorization and at least one property selection are present                       | Verify roster and sync coverage                            |

If the page says the Google Analytics status could not be verified, refresh rather than replacing the connection.

## Manage properties

Select **Manage properties** to change a healthy selection. A Viewer sees **View properties**, and the dialog explains that the selection is read-only for that role.

The management dialog can be titled **Manage synced properties** or **Google Analytics properties**. Use property name, account, and ID—not name alone—to avoid mixing brands with similar GA4 labels.

## Follow the sync

| Sync display                                  | Interpretation                                                  |
| --------------------------------------------- | --------------------------------------------------------------- |
| **Syncing**                                   | Property data is importing                                      |
| **Syncing history · X%**                      | Historical coverage is still expanding                          |
| **All synced**                                | The requested history completed; inspect last sync and coverage |
| **Last sync didn't finish - Resync to retry** | The import did not finish                                       |
| **Not synced yet**                            | No completed property import exists                             |

Use **Resync** or **Retry sync** after access and selection are healthy. GA4 does not show the same in-flight cancel affordance as some ad-platform syncs.

## Interpret GA4 beside advertising data

The integration does not edit GA4. It adds site-analytics context beside advertising performance.

* GA4 sessions are not the same measure as ad-platform clicks.
* GA4 campaign and channel attribution can differ from Meta or Google Ads conversions.
* Recent or current-day GA4 values can continue processing.
* A valid difference between sources is not automatically a sync failure.

When asking Marketer to compare sources, name both the GA4 property and the ad account, plus the date range and metric definition.

## Recovery decision tree

1. **Status unavailable:** refresh and retain the last-known connection.
2. **Reconnect needed:** select **Reconnect Google Analytics**.
3. **Choose properties:** save at least one accessible GA4 property.
4. **Refresh access:** restore Google-side access and use **Refresh property access**.
5. **Missing property:** verify the signed-in Google identity and search by ID.
6. **Sync failure with healthy access:** resync or retry.
7. **Unexpected totals:** compare attribution and processing status before treating the difference as a connection problem.

## Next step

Compare one acquisition channel or landing-page question across a named GA4 property and connected ad account over a completed period. Keep each source's attribution model explicit.


## Related topics

- [Troubleshoot integrations](/integrations/troubleshooting.md)
- [Analytics](/product-guides/analytics.md)
- [Sources and data freshness](/essential-guidelines/sources-and-freshness.md)
- [Performance and custom views](/product-guides/analytics-performance-and-views.md)
- [Set up your workspace and data](/get-started/workspace-and-data.md)