Connect Google Analytics 4 (GA4)

Required preparation before connecting

Before connecting GA4 to PageFly, ensure you have:

1. A Google Analytics 4 property set up

• If you haven't created one yet, follow Google's GA4 setup guide

• GA4 is free for most businesses

1. Proper account permissions

• Your Google account needs an Editor or Admin role on the GA4 property

• Check this in GA4: Admin → Property access management

1. User Data Collection Terms acknowledged (required for sales and revenue tracking)

• If you encounter an error, click the “See how” button in the error message to see instructions on how to fix it.

1. Matching currencies

• Currency in GA4 must match your Shopify store's currency

• Check GA4: Admin → Property details → Currency

How to Connect GA4

Step 1: Access the connection modal

You can start the connection process from two places:

Option A: From Analytics Tab

1. Click Analytics in PageFly's left sidebar

2. You'll see a demo dashboard with a banner saying "You're viewing demo Analytics"

3. Click the Connect GA4 button

Option B: From the PageFly dashboard

1. Go to the PageFly dashboard

2. Locate the overview analytics section at the top, and click the Connect GA4 button

Step 2: Sign in with Google

After clicking Connect GA4:

1. A Google sign-in pop-up appears

2. Grant PageFly full permissions to access your GA4 data

   • PageFly needs these permissions to fetch analytics data and create custom dimensions

   • If you deny any permissions, the connection will fail and you'll need to start over

   

Step 3: Select your GA4 account, property, and data stream

After successful OAuth, you'll see three dropdown menus:

1. Select Account

• Choose your GA4 account from the dropdown

2. Select Property

• Choose the GA4 property for your Shopify store

• If you have multiple properties, select the one tracking your storefront

3. Select Data Stream

• Choose the web data stream for your store

• If you have multiple streams, select the one associated with your store

Step 4: Save and Verify

1. Click the Save button at the bottom of the modal

1. PageFly will verify your connection and start fetching data

2. You'll see a success message and a green "Connected" badge when the connection is established

---

Handling connection errors

If you encounter errors during setup, here's how to resolve them:

Error: "No accounts found."

What it means:

• You don't have access to any GA4 properties with this Google account

• Or you haven't created one

How to fix:

1. Ask your GA4 administrator to grant you Editor or Admin access

2. Config GA4 property by following Google's GA4 setup guide

Error: "No properties found" or "No data streams found."

What it means:

• Your GA4 account doesn't have a property or a web data stream configured, or both

How to fix:

1. Go to GA4 → Admin → Data Streams → Add stream → Web

2. Enter your store URL and create the stream

3. Return to PageFly and start over the connecting process

Error: "Missing access to your GA4 account."

What it means: Your Google account doesn't have sufficient permissions on the GA4 property, or you haven't granted PageFly full permissions.

How to fix:

1. Ask your GA4 administrator to grant you the Editor or Admin role

2. Grant PageFly full permissions in Step 2

3. After permissions are granted, connect to GA4 again

Error: "User Data Collection Acknowledgement Required"

What it means: You haven't acknowledged Google's data collection terms in GA4. This is required to track revenue metrics.

How to fix:

1. Access the Data streams table in your GA4 account and select the data stream that you want to connect.

1. Scroll down and click Measurement Protocol API secrets

1. You'll see a banner about User Data Collection. Click the Review terms button

2. Read the terms and select I acknowledge

1. Return to PageFly and click Save again in the connection modal

---

Post-connection Tips

If your connection drops, check if:

• OAuth token expired (refresh needed every ~6 months for security)

• Your GA4 permissions changed

• The GA4 property was renamed or deleted

• The GA4 data stream was renamed or deleted

Solution: Go to the Analytics page → Click Connect and repeat the connection steps.