Meta tells you what was ordered. Your store tells you what was delivered and paid. Metrics needs the second to say anything true about profit — the blog post on cash-on-delivery unit economics walks through why.
Creativity connects to WooCommerce with a read-only key. It can read your orders and nothing else: it cannot change an order, a product, a price or a setting.
Before you start
- Your store must answer on HTTPS at its normal address (port 443). A store served only over plain HTTP, or on a custom port, cannot be connected.
- Use the address your customers see. If your store redirects
example.comtowww.example.com, type thewwwaddress. - You need to be an administrator of the store, and an owner or admin of the workspace in Creativity.
Steps
- Open Settings → Workspace → Data sources and click Connect on WooCommerce.
- Type your store address and press Continue to WooCommerce. A new tab opens on your own store, on WooCommerce's own screen.
- Check that the screen asks for Read access, then press Approve. Your store sends the key to Creativity; you never see or copy it.
- Come back to the Creativity tab. The dialog shows Saving your keys for up to a minute, then closes, the store's address appears on the WooCommerce card and the first sync starts. Orders sync every six hours after that.
If you prefer to paste a key yourself
Choose Paste keys instead in the dialog, then in WooCommerce open Settings → Advanced → REST API → Add key. Name it Creativity, set Permissions to Read, and paste the Consumer key and Consumer secret into the dialog with your store address, then press Connect. Give the key Read permission only: Creativity only reads, and never needs more.
What Creativity reads
For each order: its status, dates, totals, shipping and discount, the payment method, the lines (product, quantity, price, and the cost of goods when your store records one), refunds, and the customer's city and country.
The customer's phone number is turned into a one-way hash so repeat customers can be counted; the number itself is not kept. Names, emails, street addresses, order notes and IP addresses are not stored.
What the numbers mean for a WooCommerce store
WooCommerce has no confirmation step. A new cash-on-delivery order sits in Processing until you complete it, so Creativity cannot tell a confirmed order from one nobody has called yet. Confirmed therefore shows an em-dash with its reason, never a guess.
- Placed is an order your store received. Delivered is a Completed order; a cash-on-delivery order that is completed counts as paid.
- Cancelled and Failed orders are counted as rejected. A Refunded order is counted as returned and not paid.
- Revenue is net of refunds. A partial refund lowers the order's revenue and leaves its status alone.
- Prepaid orders stay out of the cash-on-delivery figures. Only orders paid by cash on delivery feed the funnel, the delivery rate and the cash-on-delivery cost per sale.
- Currency is your store's. If your ad spend is in US dollars and your orders are in dinars, Metrics shows the two side by side and marks the ratio as a currency mismatch. It never converts one into the other at an implied rate.
- Cost of goods comes from WooCommerce's own cost-of-goods field, when your store has it turned on and filled in. If any line of an order has no cost, that order's cost is left empty rather than partly counted.
- History: a sync reads up to 50,000 orders, oldest first, so a store with fewer orders is read in full with no history boundary. A store with more stops at its 50,000 oldest orders and the newer ones are not read yet; write to support@creativity.run and we raise the limit for your store.
When the connection fails
| What you see | What it means | What to do |
| --- | --- | --- |
| The store blocked us | A firewall, a security plugin or your host refused the request. | Allow server requests to /wp-json/wc/v3/ that carry a key in your firewall or security plugin (or ask your host to), then try again. |
| We could not reach this store | The address does not answer, or the store is down. | Check the address, and that the store loads in a browser. Once connected, the sync tries again by itself. |
| We did not receive the keys from your store | Your store did not send the key within a minute: the approval was cancelled, or a firewall stopped your store from reaching Creativity. | Press Try again, or use Paste keys instead. |
| WooCommerce rejected these keys | The pasted key is wrong, or it was deleted or revoked in WooCommerce. | Check the key, or create a new one. |
| Reconnect needed on the card | The stored key was deleted or revoked in WooCommerce, so the sync stopped. | Press Reconnect; the old key is replaced. |
| That address is not HTTPS | The store is served over plain HTTP. | Enable HTTPS on the store first. |
| The store redirects to another address | The address you typed redirects (often to www). | Type the final address, the one the browser ends on. |
| That is a different store from the one connected | Your workspace already has a store connected. | One store per workspace. Use Change store on the connected store's card to replace it; the previous store's orders leave your numbers. |
Disconnect
Settings → Workspace → Data sources → WooCommerce → ⋯ → Disconnect (owners). The sync stops immediately and the key is erased from Creativity. To revoke it on your side as well, delete the Creativity key in WooCommerce under Settings → Advanced → REST API. Removing the synced orders as well follows Data deletion.
