Connect to a new Google Analytics property
This guide shows how to create entirely new Google Analytics properties (Universal and GA4), and how to retrieve the relevant property IDs for the Pixel Manager for WooCommerce.
If you already have existing Google Analytics properties skip to the next guide.
Connect an existing Google Universal Analytics property
Google Analytics Universal has been decommissioned by Google. We recommend using GA4 instead. More information about the decommissioning of Google Analytics Universal can be found in the Google Analytics Universal decommissioning FAQ.
Connect an existing Google Analytics 4 property
Open the admin interface of your Google Analytics account and select your Google Analytics 4 property
GA4 API secret
Setting the GA4 API secret will enable the measurement protocol for GA4.
While the purchase count and total amount are tracked much more accurately using the GA4 Measurement Protocol it still has a several shortcomings. At this point GA4 is not at par with the former Google Universal Analytics, especially when using the Measurement Protocol.
Enabling the GA4 Measurement Protocol is optional and it comes with tradeoffs. It will give you more accurate order purchase counts and total amounts. But on the other side, several other metrics and dimensions will be missing or inaccurate. Here are some of the tradeoffs:
- The realtime order events will not be available.
- Orders will only show up after 24 hours.
- The geographic information on orders will be missing.
For a more complete list and more details about the tradeoffs read the GA4 Measurement Protocol shortcomings FAQ.
Open the admin interface for the GA4 property
Open the website data stream
Open the API secret setup menu
Start creating a new API secret
Give the new API secret a name. Use the plugin name. It will help you to associate which API key is being used by which app.
Copy the new API secret
Paste the new API secret into the plugin and save it. You'll find the API secret setting under Advanced > Google in the plugin.
GA4 Data API
Available from version
The Pixel Manager is able to connect to the GA4 Data API and retrieve reporting data through it.
The first report available is the order source attribution report. It shows the order source attribution using the connected GA4 accounts attribution method, which is data-driven by default.
GA4 can take up to 24 hours to process the attribution before it is available on a specific order.
GA4 Property ID
- Open the GA4 admin settings and then the property settings.
- Copy the property ID from the top right.
- In the Pixel Manager open > Advanced > Google and paste the property ID into the GA4 property ID field.
GA4 Data API Credentials
Enabling access to the GA4 property from which you want to retrieve data is a two-part process.
In the first part, we need to create access credentials, download them to the computer and upload them into the Pixel Manager.
In the second part, we need to add the
client_email from the access credentials to the GA4 property, which will authorize the retrieval of data from that GA4 property.
Open the GA4 API Quickstart manual: API Quickstart
Click the Enable the Google Analytics Data API v1 button.
- You will be prompted to enter a name for the project. Give it a name that contains the name of the website, like "GA4 example-com" (dots are not allowed, so we exchanged it with a dash). Then click NEXT.
Theoretically, you can use the same credentials for multiple websites. But, for long-term setup, we recommend creating separate credentials for each website. If you ever decide in the future to delete one of the credentials, because of a change of ownership or any other reason, only that particular website credentials will have to be recreated.
When creating the access credentials, they will be enabled on your personal Google account. That's why it is recommended that the credentials are created by the owner of the website. If you are working for an agency or if you are a freelancer, ask the owner of the website to create the credentials and upload them into the Pixel Manager.
- Download the credentials to your computer.
- In the Pixel Manager go to > Advanced > Google and import the credentials.
- Copy the
client_emailfrom the credentials settings.
- Go to your GA4 admin settings and open the Property Access Management.
- Click the big plus sign to add a new user.
- Paste the
client_emailinto the email addresses box. Make sure to only give it the Viewer role. And finally, click Add to add this new user to this GA4 property.
Enhanced E-Commerce Funnel Setup
The plugin outputs four standard funnel events. They need to be configured within Google Analytics. Once done they will be displayed in the Google Analytics > Conversions > E-commerce > Checkout Behavior report
Open the admin panel in Google Analytics. Chose your GA Universal property, then the view and then open the E-Commerce Settings.
Configure the funnel steps and save them. For step 1 set
checkout started. For step 2 set
billing email added. For step 3 set
payment provider chosen. And for step 4 set
Page Load Time Tracking
Available from version
1.30.6, only for users of the premium version
At the time of the release of this feature, GA4 still doesn't offer an integrated way to measure page speed load times like Google Analytics Universal does.
Therefore, we decided to add a basic page load time tracker for GA4.
We've made this feature an opt-in feature for now. We might change this in future and just enable it by default.
Here's how to set it up:
Enable the GA4 Page Load Time Tracker in the Pixel Manager.
Go to GA4 > Admin > Custom Definitions > Custom Metrics and click Create custom metrics.
- Set the following fields:
Page Load Time
(This will not be available in the drop down list. Simply write, or copy and paste it into the field.)
Unit of measurement: