> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mainwp.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Google Analytics
> The MainWP Google Analytics Extension gives you the ability to view your Google Analytics data for your child sites in your MainWP Dashboard. It adds a widget to your main dashboard where you can monitor Google Analytics data from.
## What You'll Learn
* Connecting Google Analytics via Sign In with Google or Service Account JSON
* Assigning GA4 properties to child sites
* Viewing visitor data across all child sites
* Managing account refresh and reconnection
***
**Integration Add-on** - This add-on extends MainWP to work with Google Analytics. Requires Google Analytics to be installed on your child sites.
The [MainWP Google Analytics Extension](https://mainwp.com/extension/google-analytics/) gives you valuable insights into your visitors' traffic patterns and campaign performance so you can optimize your strategy and user experience.
## Use this Extension To Track:
* Views
* Views by Page
* Users
* Users by Device
* Users by Country
* New Users
* Average Engagement Time
* Sessions by Source
**Requirements**
* PHP 8.1 or higher on the MainWP Dashboard
* Google Analytics (GA4) installed on your child sites
* For JSON import: Google Analytics Admin API, Google Analytics API, and Google Analytics Data API
## Connect your Google Analytics Account
You can connect Google Analytics in two ways. Use whichever fits your setup (you can use both):
### Option A: Sign In with Google
1. In your MainWP Dashboard, go to **MainWP > Add-ons > Google Analytics > Add Account**.
2. Keep the **Sign In with Google** tab selected, then click **Sign In with Google**.
3. Complete Google authorization in the popup window.
4. In **Select Google Analytics Project**, choose the account(s) you want to connect, then click **Continue**.
5. In **Confirm Google Analytics Connection**, review the summary and click **Confirm**.
6. Your account will appear under **Manage Accounts** in **Accounts by Sign In**.
**Notes**
* If your MainWP Dashboard server does not meet the required PHP version, the **Sign In with Google** tab is disabled and you can use **Import JSON File**.
* This flow uses MainWP Bridge (`bridge.mainwp.com`) for secure authentication. See [MainWP Bridge](/advanced/miscellaneous/mainwp-bridge) and the [MainWP Bridge Privacy Policy](https://mainwp.com/mainwp-bridge-privacy-policy).
If HTTP basic auth protects your MainWP Dashboard before it has paired with MainWP Bridge, **Sign In with Google** can fail because MainWP Bridge must be able to reach your Dashboard. If you need to keep HTTP basic auth enabled, use **Import JSON File** instead.
### Option B: Connect a Service Account (JSON file)
**Step 1 - Enable required APIs in Google Cloud Console**
Enable:
1. **Google Analytics Admin API**
2. **Google Analytics API**
3. **Google Analytics Data API**
**Step 2 - Create a Service Account and JSON key**
1. In **APIs & Services**, click **+ Create credentials** and select **Service Account**.
2. Give it a name and click **Done**.
3. Open the new Service Account, then go to the **KEYS** tab.
4. Click **Add Key > Create new key > JSON > Create**.
5. A JSON file will download automatically.
**Step 3 - Add the Service Account as Viewer in Google Analytics**
The Service Account can be added as a Viewer to the entire Google Analytics account (all properties) or to specific GA4 properties.
Go to [Google Analytics Dashboard](https://analytics.google.com/) and open Admin settings.
If you added property-level access, repeat for each GA4 property you want to use.
**Step 4 - Connect the JSON key in MainWP**
1. In your MainWP Dashboard, go to **MainWP > Add-ons > Google Analytics > Add Account > Import JSON File**.
2. Upload the JSON key file and click **Connect Account**.
3. The account will appear under **Manage Accounts** in **Accounts by JSON**.
**Important Notes**
* The Google Analytics Extension does not insert Google Analytics tracking code on child sites.
* Add the tracking code manually or by using a third-party plugin.
## Assigning sites from your Google Account to Child Sites in your MainWP Dashboard
The add-on automatically assigns properties to child sites based on URL matching. You can also assign properties manually:
Locate the site and click its name to open Settings.
Find the **Google Analytics** section and choose the **Google Analytics property**.
## Google Analytics Visitor Data
After you connect your Google Analytics account and assign GA4 properties to child sites, you can view data on **MainWP > Add-ons > Google Analytics > Visitor Data**.
You can enable or disable widgets in [Page Settings](/getting-started/mainwp-user-interface), and rearrange them as needed.
To change the child site, select it from the site dropdown.
## Widgets
A Google Analytics widget is available on the MainWP Overview page and on each individual child site Overview page.
As always, widgets can be enabled or disabled in [Page Settings](/getting-started/mainwp-user-interface), and they can be rearranged as needed.
## Settings & Data Refresh
* **Graphs display interval**: Choose **Week** or **Month**
* **Fetch Google Analytics data automatically**: Enable scheduled data refresh
* **Auto fetch GA data frequency**: Set how often automatic refresh runs
* **Save Settings**: Save your interval and schedule preferences
* **Refresh Data**: Trigger an immediate data refresh
## Troubleshooting
**Sign In with Google shows `site secret not found`**
* This error usually means the default WordPress REST API endpoint at `/wp-json/` is blocked, disabled, filtered, or behind authentication.
* Make sure your MainWP Dashboard allows access to `/wp-json/`.
* If HTTP basic auth protects your MainWP Dashboard, **Sign In with Google** can fail because MainWP Bridge cannot complete the initial pairing or re-registration check.
* If you need to keep HTTP basic auth enabled, use **Import JSON File** instead.
**Sign-in account needs verification/reconnection**
* Go to **MainWP > Add-ons > Google Analytics > Manage Accounts**
* For disconnected Sign In accounts, click **Reconnect Account**
* Use **Refresh Data** after reconnecting
**Service Account key disabled or rotated**
* Re-enable the Service Account in Google Cloud Console
* Create and download a new JSON key from **Keys > Add Key > Create new key**
* Upload the new key in **MainWP > Add-ons > Google Analytics > Add Account > Import JSON File**
**Required PHP functions missing**
* Google Analytics requires `bccomp`, `putenv`, and `getmypid`.
* If Google Analytics data is unavailable, review [Required PHP Functions for MainWP](/advanced/miscellaneous/required-php-functions-for-mainwp) to check whether these functions are disabled on your server.
***
## Related Resources
* [Analytics Add-ons](/add-ons/analytics) - Browse all analytics integrations
* [Pro Reports Extension](/add-ons/agency/pro-reports-extension-overview) - Include analytics data in reports
* [Available Pro Reports Tokens](/add-ons/agency/available-pro-reports-tokens) - Google Analytics tokens
* [MainWP Bridge Privacy Policy](https://mainwp.com/mainwp-bridge-privacy-policy) - Privacy details for Bridge-based sign in
### Option A: Sign In with Google
1. In your MainWP Dashboard, go to **MainWP > Add-ons > Google Analytics > Add Account**.
2. Keep the **Sign In with Google** tab selected, then click **Sign In with Google**.
3. Complete Google authorization in the popup window.
4. In **Select Google Analytics Project**, choose the account(s) you want to connect, then click **Continue**.
5. In **Confirm Google Analytics Connection**, review the summary and click **Confirm**.
6. Your account will appear under **Manage Accounts** in **Accounts by Sign In**.
**Notes**
* If your MainWP Dashboard server does not meet the required PHP version, the **Sign In with Google** tab is disabled and you can use **Import JSON File**.
* This flow uses MainWP Bridge (`bridge.mainwp.com`) for secure authentication. See [MainWP Bridge](/advanced/miscellaneous/mainwp-bridge) and the [MainWP Bridge Privacy Policy](https://mainwp.com/mainwp-bridge-privacy-policy).
**Step 3 - Add the Service Account as Viewer in Google Analytics**
The Service Account can be added as a Viewer to the entire Google Analytics account (all properties) or to specific GA4 properties.
**Important Notes**
* The Google Analytics Extension does not insert Google Analytics tracking code on child sites.
* Add the tracking code manually or by using a third-party plugin.
## Assigning sites from your Google Account to Child Sites in your MainWP Dashboard
The add-on automatically assigns properties to child sites based on URL matching. You can also assign properties manually:
You can enable or disable widgets in [Page Settings](/getting-started/mainwp-user-interface), and rearrange them as needed.
To change the child site, select it from the site dropdown.
## Widgets
A Google Analytics widget is available on the MainWP Overview page and on each individual child site Overview page.
As always, widgets can be enabled or disabled in [Page Settings](/getting-started/mainwp-user-interface), and they can be rearranged as needed.
## Settings & Data Refresh
* **Graphs display interval**: Choose **Week** or **Month**
* **Fetch Google Analytics data automatically**: Enable scheduled data refresh
* **Auto fetch GA data frequency**: Set how often automatic refresh runs
* **Save Settings**: Save your interval and schedule preferences
* **Refresh Data**: Trigger an immediate data refresh
## Troubleshooting
**Sign In with Google shows `site secret not found`**
* This error usually means the default WordPress REST API endpoint at `/wp-json/` is blocked, disabled, filtered, or behind authentication.
* Make sure your MainWP Dashboard allows access to `/wp-json/`.
* If HTTP basic auth protects your MainWP Dashboard, **Sign In with Google** can fail because MainWP Bridge cannot complete the initial pairing or re-registration check.
* If you need to keep HTTP basic auth enabled, use **Import JSON File** instead.
**Sign-in account needs verification/reconnection**
* Go to **MainWP > Add-ons > Google Analytics > Manage Accounts**
* For disconnected Sign In accounts, click **Reconnect Account**
* Use **Refresh Data** after reconnecting
**Service Account key disabled or rotated**
* Re-enable the Service Account in Google Cloud Console
* Create and download a new JSON key from **Keys > Add Key > Create new key**
* Upload the new key in **MainWP > Add-ons > Google Analytics > Add Account > Import JSON File**
**Required PHP functions missing**
* Google Analytics requires `bccomp`, `putenv`, and `getmypid`.
* If Google Analytics data is unavailable, review [Required PHP Functions for MainWP](/advanced/miscellaneous/required-php-functions-for-mainwp) to check whether these functions are disabled on your server.
***
## Related Resources
* [Analytics Add-ons](/add-ons/analytics) - Browse all analytics integrations
* [Pro Reports Extension](/add-ons/agency/pro-reports-extension-overview) - Include analytics data in reports
* [Available Pro Reports Tokens](/add-ons/agency/available-pro-reports-tokens) - Google Analytics tokens
* [MainWP Bridge Privacy Policy](https://mainwp.com/mainwp-bridge-privacy-policy) - Privacy details for Bridge-based sign in