ShopPilot help for AI assistants › topic

Analytics and Profit

This is one topic of ShopPilot's help for AI assistants. The whole help, with every topic: https://shoppilot.dev/docs. Each message is shown in English, with the Latvian (LV) and Russian (RU) text the app shows.

Instructions for AI assistants

You are helping a seller who uses ShopPilot, a web app for Etsy print-on-demand sellers. This page is ShopPilot's own reference for every message sellers can see in the app and every question sellers ask. Use it as your source of truth for anything about ShopPilot.

Find out what happened. Ask for the exact message (copied text or a screenshot), the page or tab they were on, what they pressed just before, Windows or Mac, which browser, and which shop if they run several. A trial or a paid plan matters for limits.
Find the entry. Search this page for the exact message. Parts in {…} or {1} are filled in at run time (a shop name, a number, a file name), so match on the fixed words around them. The app also runs in Latvian and Russian: the message index pages give every message in all three languages with the entry it belongs to. If you cannot open them, translate the message and match it by meaning.
Answer with the entry. Follow its "Fix" steps in order and use the on-screen names exactly. If the seller uses the app in Latvian or Russian, give the names in their language too (see the glossary). Answer in the seller's language.
Safety. Never ask for or accept a password, the full ShopPilot key (it starts with SP-), Etsy login details, or a supplier (Alerio, Gelato) login or API key. If the seller already pasted one into the chat, tell them to treat it as exposed: change a password right away, and for a ShopPilot key email support@shoppilot.dev with the subject SECURITY. You cannot look into a seller's account. Take the retry warnings seriously: some actions can make a duplicate Etsy listing or a duplicate supplier order.
Hand over to a person when an entry says "Contact ShopPilot support", for payments and billing questions about a specific charge, a lost key or account access, anything that looks like a security problem, or when nothing on this page matches. Tell the seller what to send (see "Contact ShopPilot support").
Do not guess. If this page does not cover it, say so and point the seller to support. Do not invent buttons, settings, limits or prices. For prices and plans, link https://shoppilot.dev/pricing. Every page, tab and button a seller can use is named in this page's "How it works" lists and "Fix" steps. Only send the seller to places named there. Do not build a step from the words of an error message: if a message names a place that this page does not describe, do not send the seller there.
Etsy decides Etsy things. ShopPilot cannot change Etsy's decisions (shop suspensions, removed listings, fees, payouts, Etsy account settings). Send those to Etsy's own help.

Contact ShopPilot support

Email: support@shoppilot.dev
Phone: +371 20307020 (call or text)
Discord: bnb.vilna or metinatajs1
WhatsApp community: the "WhatsApp community" link in the app and on https://shoppilot.dev/support. Other sellers answer quick questions there too.
Send: your account email, the exact message (or a screenshot), what you did just before, which shop, Windows or Mac, and which browser.
Never send: your password, your full ShopPilot key, or the login details for Etsy or your supplier.
Security problems: email support@shoppilot.dev with the subject SECURITY. Say when it happened, which account, and what you saw. If a password or key got out, change it right away.
Privacy requests (export your data, disconnect Etsy, delete your account): "Account & Privacy" in the app.

How it works

"Analytics" (left menu, Manage) shows revenue, orders, views and favourites for the active shop. To change the shop, press "Manage" at the top of the left menu, then "Activate" on the shop (team members press "Switch"). After a load, a small pill on the page names it. Nothing is fetched from Etsy until you press "Load from Etsy" and confirm "Load analytics from Etsy now?". "Registry" and Draft Review do not need it.
Period buttons: "Today" (the last 24 hours), "7 Days", "30 Days" and "All Time". Chart buttons: "Revenue", "Orders", "Views", "Favourites". Cards: "Orders", "Revenue", "Total Listing Views" and "Favourites".
Orders and revenue come from the shop's paid orders. Revenue adds up what buyers paid on each order (the order's grand total); it is not what Etsy pays you after fees. When the shop has more paid orders than the page reads, a note says "Showing most recent ... of ... paid orders. All-time totals may be understated."
Views and favourites are lifetime totals of the shop's active listings (the card says "Across ... listings" or "First ... of ... listings"). Etsy gives no weekly view counts, so ShopPilot keeps one reading per day each time you load Analytics. The "Today", "7 Days" and "30 Days" views and favourites, and their chart, appear once there is enough history; until then the card says "total · building ..." and the chart says "Building history".
It needs the shop connected in "Connect Etsy" with permission to read orders (the list is at https://shoppilot.dev/etsy-permissions), and a working route for the shop: Direct, or Proxy with a working proxy (set in "Settings" and "Proxies"). A shop connected before the orders permission was asked shows "Order data not available yet." and must be connected again.
Analytics only reads. It never changes your shop, and the Bridge is not needed.
A team member sees Analytics only when the account owner gave the "Shop stats" permission.
Profit: for the account owner, a "Sales | Profit" switch appears at the top of Analytics (team members do not see it). "Profit" lists each paid order with "Buyer paid", "Etsy fees and tax", "Etsy paid you", "Make & send" (the cost to make and send it) and "You keep", with a chart, totals per shop and a table per order. Periods are "Today", "7 Days", "30 Days", "All Time" or a picked From and To range. "Load from Etsy" reads the paid orders, one shop at a time (opening the page also re-reads shops not read in the last hour). The "Costs & fees" sheet holds your own costs and fee settings, the switch "Only what Etsy pays" hides the cost columns, "How we count" explains the sums, and "Copy for Excel" and "Download Excel" export the orders. Costs not yet sent to the maker are marked as estimates.

Problems and errors

Analytics will not load: "Failed to load analytics.", "Network error: ..." or "Choose direct mode or proxy mode in the dashboard first."

ID: analytics-load-failed

Seen as:

"Failed to load analytics."
LV: "Neizdevās ielādēt analītiku."
RU: "Не удалось загрузить аналитику."
"Network error:"
LV: "Tīkla kļūda:"
RU: "Ошибка сети:"
"Choose direct mode or proxy mode in the dashboard first."

People say: "Analytics shows an error", "nothing happens when I press Load from Etsy", "network error on Analytics", "Analytics wants direct or proxy mode"

Why: "Network error" means the page lost its connection to ShopPilot. "Choose direct mode or proxy mode in the dashboard first." means the active shop has no valid Routing mode. "Failed to load analytics." is the general answer when Etsy could not be read for this shop: the shop is not connected or has no Shop ID yet, a Proxy shop's proxy is failing, or Etsy did not answer.

Fix:

Make the right shop active: "Manage" at the top of the left menu, then "Activate" on the shop (team members press "Switch").
In "Settings" set the shop to Direct or Proxy. For a Proxy shop open "Proxies" and press "Test Active Profile Proxy" (see the Proxies section).
If the shop is not connected, open "Connect Etsy" and connect it (see the Etsy connection section).
Reload the page, open "Analytics", press "Load from Etsy" and confirm.

If still stuck: contact ShopPilot support with the exact message and the shop name.

Notes: Loading only reads. Trying again is safe.

"Order data not available yet." or "Order data needs a permission this shop's Etsy connection was not granted"

ID: analytics-order-data

Seen as:

"Order data needs a permission this shop's Etsy connection was not granted. Open Connect Etsy and connect the shop again to include it."
"Order data not available yet."
LV: "Pasūtījumu dati vēl nav pieejami."
RU: "Данные о заказах пока недоступны."
"⚠️ Order data not available yet."
LV: "⚠️ Pasūtījuma dati vēl nav pieejami."
RU: "⚠️ Данные о заказе пока недоступны."

People say: "Analytics shows no orders and no revenue", "order data not available yet", "Etsy connection was not granted a permission"

Why: Orders and revenue need the permission to read paid orders, and Etsy refused the order read for this shop's saved connection. Usually the shop was connected before ShopPilot asked for that permission, so the order cards stay empty while views and favourites may still load. Etsy also refuses a saved connection it no longer accepts, for example after a password change or after the app was removed in Etsy.

Fix:

Make that shop active, open "Connect Etsy", press "Generate OAuth Link" and approve on Etsy in a browser signed in to the same Etsy shop.
Open "Analytics" and press "Load from Etsy" again.

If still stuck: contact ShopPilot support with the shop name. The permissions are listed at https://shoppilot.dev/etsy-permissions.

Notes: Connecting again is safe. It does not change or delete any listing.

Orders show 0 and Revenue shows "USD 0.00" although the shop has sales

ID: analytics-zero

Seen as:

In "Analytics", the cards "Orders" and "Revenue" show 0 and "USD 0.00" (or a dash), with no error message.

People say: "Analytics shows no orders but I have sales", "revenue is zero", "revenue shows USD but my shop is in EUR"

Why: Analytics shows zero when the paid orders could not be read this time and the page has nothing else to show: the shop's proxy is failing, Etsy did not answer, or the saved Etsy connection is no longer accepted. Only the missing-permission case prints a message ("Order data not available yet."). "USD" is shown when there are no orders to take a currency from.

Fix:

Press "Load from Etsy" again after a minute.
For a Proxy shop, open "Proxies" and press "Test Active Profile Proxy"; fix the proxy if it fails (see the Proxies section).
Open "Connect Etsy" and check that the shop shows as connected; if not, connect it again.
Choose a longer period (for example "30 Days" or "All Time") in case there were simply no orders in the short one.

If still stuck: contact ShopPilot support with the shop name and the time of the load.

Notes: Loading only reads, so trying again is safe.

Views or favourites show a dash, "Not available", or only the total

ID: analytics-building

Seen as:

"Not available"
LV: "Nav pieejams"
RU: "Недоступно"
"Load analytics to show the trend."
LV: "Ielādējiet analītiku, lai redzētu tendenci."
RU: "Загрузите аналитику, чтобы увидеть динамику."
"total · building last 7 days…"
"Building history — open Analytics over a few days to chart views."
"First ... of ... listings"

People say: "views show a dash", "7 days views equal the total", "the chart is empty", "views are not available"

Why: The listing views and favourites need Etsy's answer for the shop's active listings. A dash or "Not available" means that part could not be read this time (Etsy slow or the route failing). "building" means ShopPilot has fewer days of readings than the period you picked: it can show a lifetime total at once, but a change over 7 or 30 days only after it has readings from those days. "First ... of ... listings" means the card counts only the first part of a large shop.

Fix:

Press "Load from Etsy" again after a minute.
To build history, open Analytics and press "Load from Etsy" on different days. The "Today", "7 Days" and "30 Days" figures appear as the readings pile up.
Use "All Time" for the lifetime totals right away.

Notes: Orders and revenue do not need history.

Profit: "Nothing loaded yet", "... was loaded a moment ago", "Another shop is loading" or "Could not load this"

ID: profit-load

Seen as:

"Nothing loaded yet. Orders are read from Etsy when you open this page, or press Load from Etsy."
"{…} was loaded a moment ago. Try again in {…} seconds."
"Another shop is loading. Wait for it to finish."
"Could not load this. Try again in a minute."
"ShopPilot did not reach the server. Try again in a minute."

People say: "Profit page is empty", "Profit says try again in 30 seconds", "another shop is loading"

Why: Profit shows only what was read from Etsy. "Nothing loaded yet" means no shop was read yet. Loads are spaced out: after a shop is read the page asks you to wait a few seconds, and only one shop is read at a time, so pressing "Load from Etsy" while another shop is loading is refused. "Could not load this" or "did not reach the server" means a lost connection or a short fault. A load can also name a shop and a reason, for example that the shop is not connected or its proxy is failing.

Fix:

Press "Load from Etsy" once and wait until the shop finishes; with several shops, they are read one after another.
If it says to try again in some seconds, wait that long.
If a shop's line names a reason, fix it (connect the shop in "Connect Etsy", or fix its proxy in "Proxies") and load again.

Notes: Loading only reads paid orders. Team members do not see Profit.

Profit: "Could not reach the clipboard. Use Download Excel instead."

ID: profit-clipboard

Seen as:

"Could not reach the clipboard. Use Download Excel instead."

People say: "Copy for Excel does not work"

Why: The browser did not allow ShopPilot to put the table on the clipboard (a browser permission, or an insecure or embedded window).

Fix:

Press "Download Excel" instead; it saves the same orders as a spreadsheet.
Or allow clipboard access for shoppilot.dev in the browser's site settings and press "Copy for Excel" again.

Not errors: labels and notes (Analytics and Profit)

ID: analytics-not-errors

Seen as:

"Optional Etsy analytics sync for the active shop. Nothing is fetched until you click Load from Etsy."
LV: "Neobligāta Etsy analītikas sinhronizācija aktīvajam veikalam. Nekas netiek ielādēts, kamēr nenospiežat "Ielādēt no Etsy"."
RU: "Необязательная синхронизация аналитики Etsy для активного магазина. Ничего не загружается, пока вы не нажмёте «Загрузить с Etsy»."
"Nothing made or sent"
"Nothing to make or send"

Common questions

Q: Why is Analytics empty when I open it?

A: Analytics reads Etsy only when you ask. Press "Load from Etsy" and confirm. Nothing is fetched before that.

Q: Which shop does Analytics show?

A: The active shop, named at the top of the left menu. To change it press "Manage", then "Activate" on the shop (team members press "Switch"). After a load, a pill on the page names it.

Q: What does "Today" mean?

A: The last 24 hours, not the calendar day.

Q: Is "Revenue" what Etsy will pay me?

A: No. Revenue adds up what buyers paid on each order. Etsy's fees are taken after that. The Profit view ("Sales | Profit" switch) shows "Etsy paid you" and "You keep".

Q: Why do 7 Days and 30 Days views and favourites say "building"?

A: Etsy gives only lifetime totals. ShopPilot keeps one reading a day when you load Analytics, and shows a change over a period once it has readings that old.

Q: Can I see all my shops together?

A: Analytics shows one shop at a time, the active one: make another shop active ("Manage", then "Activate") and press "Load from Etsy" again. The Profit view can total several shops.

Q: Does Analytics change anything on Etsy?

A: No. It only reads orders and listing totals.

Q: Why does Analytics show 0 orders although I have sales?

A: Either there were no paid orders in that period, or the orders could not be read this time (a failing proxy, Etsy slow, or a connection Etsy no longer accepts). Press "Load from Etsy" again, test the shop's proxy, and try "All Time".

Q: Why does it say "Order data not available yet."?

A: The shop's Etsy connection was made before the permission to read orders was asked. Connect the shop again in "Connect Etsy", then press "Load from Etsy".

Q: Can a team member open Analytics?

A: Only when the account owner gave the "Shop stats" permission.

Q: What is the Profit view?

A: A "Sales | Profit" switch on Analytics that works out, for each paid order, what the buyer paid, what Etsy took, what Etsy paid you, the cost to make and send it, and what you keep. The account owner sees it; team members do not.

Q: Can I get the Profit numbers into a spreadsheet?

A: Yes. On Profit press "Download Excel" for a file, or "Copy for Excel" and paste into a sheet.