Source: https://docs.amadalis.ai/insights/connections/

# Connect Google Analytics

Checked against the product’s code on 7 November 2026.

Connect [Google Analytics](https://docs.amadalis.ai/reference/glossary/#google-analytics) 4 (GA4) in **Insights** > **Connections** in the site admin. Editors and Admins can enter the property and [service account key](https://docs.amadalis.ai/reference/glossary/#service-account-key). This screen configures an outside property. It does not replace Praxis’s first party Analytics or display GA4 report tables itself.

The [reports and annotations](https://docs.amadalis.ai/insights/connections/#reports-and-annotations) section below explains what is still coming soon. Use Praxis’s own **Analytics** for current reports.

## Review the connection

Editors and Admins can connect, replace or disconnect the Google Analytics key. Before entering it, prepare the service account: a software identity in Google. Use its [JSON](https://docs.amadalis.ai/reference/glossary/#json) key file, and give that identity access to the intended property. Keep the key out of the copilot conversation.

1.  Enter **Property id**, the number identifying your Google Analytics property.
    
2.  Enter the **Service account key** only on the connection card.
    
3.  Choose **Connect**.
    
4.  Review the proposed connection.
    
5.  Apply it only for the intended property.
    
6.  Read the status badge.
    
7.  Read the result of the last check.
    

A passing check names the property Google answered for; if it says this platform’s default property, your own property is not connected yet. A stored key and a connected status alone are not proof that a particular report query has succeeded.

## Check, rotate or disconnect

Use **Check now** to test the configured path.

To replace a key:

1.  Choose **Rotate key**.
2.  Enter the replacement in the trusted key form.
3.  Choose **Save the new key**.
4.  Read its review.
5.  Approve the intended replacement.
6.  Read the updated status.

Disconnecting cannot restore the old key, so reconnecting needs a new key entry.

1.  Choose **Disconnect** only when you intend to destroy the stored credential.
2.  Read **Disconnect Google Analytics?**.
3.  Choose **Disconnect it** if that is the intended change.
4.  Read the resulting review.
5.  Approve the intended disconnection.
6.  Read the updated status.

## Reports and annotations

An annotation is a dated note on a report.

The connection supplies copilot requests for reading a GA4 report and proposing an annotation. Reading and writing have different approval rules. An annotation write requires approval.

Reading Google Analytics reports and writing annotations through this connection is coming soon. Until then, use Praxis’s own **Analytics** for your numbers.