WooCommerce
WooCommerce is an open-source e-commerce plugin for WordPress. It lets you create and manage an online store with features like inventory management, secure payments, and shipping integration. Connecting WooCommerce to AgencyAnalytics allows you to pull important analytics directly from your WooCommerce store into client reports and dashboards.
Data is fetched every 24 hours, starting from when it is connected
24 months of historical data are available
Click here to view all available WooCommerce metrics and learn what's possible.
Before You Start
To avoid a failed connection or error when connecting WooCommerce to a client, the person connecting must have:
API access with read permissions
WordPress version 4.4 or higher
WooCommerce version 3.5 or higher
Connect WooCommerce
Follow these steps to connect WooCommerce to a client in AgencyAnalytics:
Step 1: Open the client where you'd like to connect WooCommerce, then click the Data Sources tab at the top.
Step 2: Click the blue Connect Data Source button in the upper right corner of the page.
Step 3: Search for WooCommerce in the search bar at the top, then click the WooCommerce card.
Step 4: Enter your WooCommerce website's Store URL, API Key, and API Secret (generated from your WooCommerce plugin in WordPress), then click Save.
Once connected, you can add WooCommerce widgets to dashboards and reports, or learn to configure the prebuilt WooCommerce dashboard.
FAQ
Which URL do I use when connecting to WooCommerce?
Enter the full root domain as the Store URL, including either http:// or https:// depending on which your website uses.
For example, enter https://www.mywebsite.com/, rather than www.mywebsite.com/my-store/.
Why am I seeing a "JSON: Syntax error" when connecting WooCommerce?
This error usually means the Store URL entered in the connection wizard includes a store subdirectory path rather than the root domain. The WooCommerce authenticator only accepts the root domain.
For example, enter https://www.mywebsite.com/, not https://www.mywebsite.com/store/. Update the Store URL to the root domain and try connecting again.
Why am I seeing a "cURL Error: Operation timed out" when connecting WooCommerce?
This error means the WordPress server hosting your WooCommerce store took too long to respond to AgencyAnalytics. It's a server configuration issue, not a problem with your connection credentials.
To resolve it, a developer or server admin will need to adjust the WordPress server's cURL timeout or performance settings.
Steps to fix this are usually available in your hosting provider's documentation, and you can also reference this guide to fixing a cURL timeout error in WordPress.
Which order statuses does AgencyAnalytics show for WooCommerce?
AgencyAnalytics supports the seven core (default) WooCommerce order statuses in your WooCommerce widgets:
Cancelled
Completed
Failed
On Hold
Pending Payment
Processing
Refunded
These statuses display in whichever language the client's report is set to under AgencyAnalytics's localization feature. If you've set up custom order statuses in WooCommerce, they can also appear in your widgets, and you can select them directly in the settings filter.
Custom statuses always appear exactly as they're named in WooCommerce, and they can't be translated by AgencyAnalytics.
Can I view historical data?
Yes, historical data is available for the past 24 months.
Why isn't my data matching what I see in WooCommerce?
This usually happens for one of a few reasons.
The timezone setting in WooCommerce may differ from the timezone selected in your client's AgencyAnalytics settings. Depending on the hour difference, orders may display on the next or previous day. To resolve this, double-check the time zone on your WooCommerce account, then update the client's time zone to match.
Another cause is how WooCommerce applies refunds in its native platform UI versus its API (which is where AgencyAnalytics fetches all WooCommerce data). In the WooCommerce native UI, refunds apply on the day they are issued, and the refund amount is deducted from that day's gross revenue. In the WooCommerce API, refunds are applied on the day the purchase was made, which can sometimes lead to discrepancies.
If you're using the "Currency Switcher" feature in WooCommerce, it changes the currency shown in the WooCommerce app's UI, but it does not change the currency in the WooCommerce API. As a result, the currency displayed in AgencyAnalytics may differ from the currency shown in the WooCommerce "Currency Switcher".
đŹ Need additional help?
If you have any questions, please contact our friendly support team by following these instructions! We're available 24/5 to help đ
