๐Ÿ“Š
Commerce Ace ยท App Guide

GA4 Agent

Plain-English analytics and a weekly insights digest, pulled straight from your Google Analytics 4 property โ€” ask questions in plain English, get real answers.

Step 0

Before you start

A few things need to be in place before GA4 Agent can connect to your analytics. Skim both lists โ€” the second one saves support tickets later.

Requirements
  • โœ“An active Shopify plan with GA4 Agent installed from the Commerce Ace listing.
  • โœ“A Google Analytics 4 property already collecting data from your Shopify store.
  • โœ“Owner or Editor access to that GA4 property โ€” needed to authorize the Google OAuth connection.
  • โœ“At least a few weeks of GA4 data โ€” fresh properties with no history won't have much to report on.
Out of scope
  • ร—GA4 Agent reads and explains your data โ€” it does not change your GA4 configuration or tracking setup.
  • ร—It won't set up GA4 tracking or fix missing events โ€” that's a GA4 / Shopify theme task done separately.
  • ร—It reports on GA4 data only โ€” not Shopify's native analytics dashboard.
  • ร—It doesn't store or export raw user-level data from your GA4 property.
Setup

Step-by-step setup

Four steps from install to querying your analytics in plain English. Screenshots coming soon.

01

Install on Shopify

From the Commerce Ace listing, click Install. GA4 Agent opens in your Shopify admin under Apps โ€” no separate login required.

Tip Have your Google account login ready โ€” you'll authorize the GA4 connection in the next step.
Screenshot coming soon
02

Connect Google Analytics

In the GA4 Agent app, click Connect Google Analytics. You'll be redirected to Google to authorize access. Log in with the Google account that has access to your GA4 property and approve the connection.

Tip You need Owner or Editor access to the GA4 property โ€” Viewer access is not sufficient to authorize the connection.
Screenshot coming soon
03

Select your GA4 property

After authorizing, select which GA4 property to connect. If you have multiple properties (separate brands or stores), choose the one that tracks your Shopify storefront.

Screenshot coming soon
04

Ask your first question

Type a plain-English question like "What were my top traffic sources last week?" or "Which products had the most views this month?" Claude queries your GA4 data and returns a clear, actionable answer.

Tip The more specific your question, the more useful the answer. "Top states by sessions last 30 days" beats "how's my traffic."
Screenshot coming soon
Settings

Configuration guide

GA4 Agent is mostly self-configuring after the Google OAuth connection. These are the settings worth knowing about.

SettingWhat it doesRecommended
GA4 Property The connected Google Analytics 4 property all queries run against. Your primary Shopify store property
Weekly digest Automatic weekly summary emailed to you โ€” top traffic, top products, key changes. On โ€” delivered Monday morning
Default date range The date range used when you don't specify one in your question. Last 30 days
Currency The currency used to display revenue figures in responses. Match your store currency
Best practices

Merchant recommendations

What we tell every Commerce Ace merchant on their onboarding call.

โœฆ

Ask by geography

"Top states by sessions this month" is one of the most useful queries. Helps you understand where to focus ad spend or which markets are growing.

โœฆ

Ask about traffic sources

"Which channels drove the most revenue last week?" tells you what's actually converting โ€” not just what's driving clicks.

โœฆ

Use it for weekly check-ins

Replace your Monday morning spreadsheet ritual with a single question: "Compare this week to last week across sessions, revenue, and conversion rate."

โœฆ

Enable the weekly digest

The Monday digest emails you a plain-English summary of last week's performance. Skim it in 2 minutes โ€” no login required.

โœฆ

Set up GA4 ecommerce tracking first

Revenue, product performance, and conversion queries only work if GA4 has ecommerce events configured. Make sure your Shopify store has the GA4 pixel installed with purchase events firing.

โœฆ

Be specific with time ranges

"Last 7 days" vs "last 30 days" can tell very different stories. Include the time range in your question for the most relevant answer.

FAQ

Frequently asked

Do I need to know GA4 to use this?

No โ€” that's the point. You ask in plain English and Claude translates it into a GA4 query, runs it, and explains the result. No dimension IDs, no metric names, no spreadsheets.

Why can't I see revenue data?

Revenue data requires GA4 ecommerce events (specifically the "purchase" event) to be firing from your store. If revenue shows $0 or nothing, your GA4 tracking setup is missing ecommerce events โ€” this is a tracking configuration issue, not a GA4 Agent issue.

Can I disconnect and reconnect Google?

Yes โ€” in Settings you can revoke the Google OAuth connection and reconnect with a different account or property at any time.

Does it have access to individual user data?

No. GA4 Agent queries aggregated analytics data only โ€” sessions, events, conversions, revenue by dimension. It does not access individual user profiles, identities, or PII.

How far back can I query?

As far back as your GA4 property has data โ€” GA4 doesn't expire historical data. Just include the date range in your question: "Top products by revenue in Q1 2025."