Connect your Google Analytics account to Goodweek to access website traffic data, audience insights, and performance metrics directly from your AI workspace.
ℹ️ Governance note
Goodweek will never exceed the access levels granted to the user within Google Analytics, guaranteeing alignment with your organization's governance policies. Outcomes and available features may vary depending on each user's specific permissions and authenticated access.
📋 Prerequisites
Before any user can see and connect the Google Analytics integration, your organization admin must first enable it from the Goodweek Admin Panel under the Integrations tab.
Admin Setup
Personal Google accounts (@gmail.com)
No admin setup required. Connect directly following the User Connection steps below.
Google Workspace accounts (work or school)
Depending on your organization's API access policy, one of the following scenarios may apply.
Scenario 1 — Default (unrestricted third-party access)
Any user can connect directly without admin intervention.
Scenario 2 — Third-party access is restricted (admin_policy_enforced error)
A Google Workspace Super Admin must mark Composio as a trusted app:
Log in to admin.google.com as a Super Admin.
Go to Security → Access and data control → API controls → Manage Third-Party App Access.
Click Configure new app, search for Composio, select it, set access to Trusted, and click Save.
Google Analytics property access
In addition to OAuth consent, your Google account must have been granted access to the specific Google Analytics property you want to work with. If a property is missing, ask your Google Analytics admin to grant you access from Google Analytics → Admin → Access Management.
User Connection
In Goodweek, go to Integrations.
Find Google Analytics and click Connect.
You will be redirected to Google, where you will be asked to sign in.
Review the requested permissions and click Allow to return to Goodweek.
Important Notes
Each user must connect their own account individually.
Goodweek can only access the Google Analytics properties that your individual user account has been granted access to.
If you have multiple Google accounts, make sure you select the correct one during the connection step.
You can revoke Goodweek's access at any time from myaccount.google.com → Security → Third-party apps with account access.
Available Tools
Tool | Description | Type |
Run Report | Runs a customized GA4 data report specifying dimensions, metrics, and date ranges. | Read |
Run Realtime Report | Runs a realtime report showing data from the last 30–60 minutes for a GA4 property. | Read |
Run Pivot Report | Runs a customized pivot report with advanced segmentation and multi-dimensional analysis. | Read |
Run Funnel Report | Runs a funnel analysis report for a GA4 property, showing conversion steps in sequence. | Read |
Batch Run Reports | Returns multiple analytics data reports for one GA4 property in a single batch request. | Read |
Batch Run Pivot Reports | Returns multiple pivot reports in a single batch request for a GA4 property. | Read |
Get Metadata | Retrieves available dimensions and metrics for a GA4 property, useful for discovering valid fields before building a report. | Read |
Check Compatibility | Lists dimensions and metrics that are compatible with a specific GA4 report request. | Read |
Get Property | Retrieves configuration details for a specific GA4 property including display name, timezone, and currency. | Read |
List Accounts | Lists all Google Analytics accounts accessible to the authenticated user. | Read |
List Account Summaries | Retrieves high-level summaries of all GA accounts and their associated properties. | Read |
List Audiences | Lists audience configurations defined for a GA4 property. | Read |
List Key Events | Lists all key event definitions for a given GA4 property. | Read |
List Custom Dimensions | Lists all custom dimensions configured for a GA4 property. | Read |
List Custom Metrics | Lists all custom metrics configured for a GA4 property. | Read |
List Conversion Events | Lists all conversion events configured for a GA4 property. | Read |
Create Custom Dimension | Creates a new custom dimension for a GA4 property to track additional user or event data. | Write |
Create Custom Metric | Creates a new custom metric for tracking specific event parameters in GA4. | Write |
Create Audience Export | Creates an export snapshot of users in a specific GA4 audience at a point in time. | Write |
Query Audience Export | Queries a completed audience export to retrieve user rows with pagination. | Read |
Send Events | Sends server-side event data to GA4 using the Measurement Protocol. | Write |
Validate Events | Validates Measurement Protocol events before sending them to production. | Read |
Get Attribution Settings | Retrieves attribution model configuration for a GA4 property. | Read |
Get Data Retention Settings | Retrieves event-level and user-level data retention duration settings for a GA4 property. | Read |
Update Property | Updates settings for an existing GA4 property such as display name, timezone, or currency. | Write |
Use Cases
Pull performance reports on demand. Run custom GA4 reports from within Goodweek to retrieve traffic, engagement, or conversion data for a specific date range and set of dimensions — without opening the Analytics UI.
Check real-time traffic during campaigns. Use the realtime report to monitor active users, traffic sources, and event counts during a live campaign or product launch.
Analyse conversion funnels. Run a funnel report to identify where users are dropping off in a conversion flow, and use the data to inform decisions on where to focus optimisation efforts.
Export audience data for review. Create and query audience exports to inspect the user segments defined in GA4, useful for validating targeting criteria before using them in campaigns.
Troubleshooting
"Error 400: admin_policy_enforced" when connecting
Your organization's admin has restricted third-party app access. Only a Google Workspace Super Admin can resolve this by following Scenario 2 above.
Connected successfully but a Google Analytics property is missing
Your Google account has not been granted access to that property. Ask your Google Analytics admin to grant you access from Google Analytics → Admin → Access Management.
Integration not visible in Goodweek
Make sure your organization admin has enabled the Google Analytics integration from the Goodweek Admin Panel under the Integrations tab.