# 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](https://support.google.com/analytics/answer/9304153)
* GA4 is free for most businesses
2. **Proper account permissions**
* Your Google account needs an **Editor** or **Admin** role on the GA4 property
* Check this in GA4: **Admin** → **Property access management**
3. **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.
4. **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
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** link on the banner or the button in the Google Analytics 4 section
You will be taken to the Analytics settings interface at **Preferences > Analytics**. Here, check the box next to **Enable PageFly Analytics**:
#### Step 2: Sign in with Google
After clicking on the checkbox **Enable PageFly Analytics**:
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 **Select** button at the bottom of the modal
2. PageFly will verify your connection and start fetching data
3. 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](https://support.google.com/analytics/answer/9304153)
#### **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 they were deleted
**How to fix:**
1. Go to GA4 → Admin and then create a new Property or Data stream
2. 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. Start over the connecting to GA4 process by clicking on the button.
2. Remember to grant PageFly full permissions in [Step 2](#step-2-sign-in-with-google).
#### 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](https://analytics.google.com/analytics/web/?utm_source=demoaccount\&utm_medium=demoaccount\&utm_campaign=demoaccount#/a54516992p213025502/admin/streams/table) in your GA4 account and select the data stream that you want to connect.
2. Scroll down and click **Measurement Protocol API secrets**
3. You'll see a banner about User Data Collection. Click the **Review terms** button
4. Read the terms and select **I acknowledge**
5. 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.
button in the Google Analytics 4 section
