Sales Studio

Sales Analytics

See royalties, units, page reads, and tracked ad spend across connected sales channels.

Open Sales Studio

Sales Studio opens to a unified report. Choose 30 days, 90 days, or one year, then optionally select a pen name. The report includes:

  • Retailer royalties, kept separate by currency
  • Paid units, free downloads, returns, and preorders
  • Kindle Unlimited page reads and their separate estimated revenue
  • Daily royalty, ad-spend, and unit trends
  • Title and source comparisons
  • Tracked book-level ad spend and net royalties after ads
  • The percentage of sales records mapped to your StorytellerOS titles

Note

StorytellerOS does not silently convert currencies. USD, GBP, EUR, and other royalties stay in separate totals so they remain reconcilable with the source reports.

KENP Page-Read Revenue

Kindle Unlimited page reads are not book sales. Sales Studio keeps them separate from paid units and estimates their USD value using the KENP rate for the title's pen name.

Set that rate in Settings under Sales Integrations. The default is $0.0044 per page. The estimate is informational and is not added on top of retailer royalties, because reported royalty totals can already include page-read earnings.

Connect Sales Accounts

Retailer analytics is powered by Publisher Champ, and your subscription to it is included with StorytellerOS. Go to Settings under Sales Integrations and press Connect Publisher Champ: that takes you to Publisher Champ, where you sign up or sign in, and the account is linked back to StorytellerOS automatically. There is no card to enter and no second subscription to pay.

Publisher Champ does not send you back to StorytellerOS when you finish, so the Sales Integrations page watches for the confirmation and updates itself once it arrives — you do not need to refresh.

Already have your own Publisher Champ account? Choose I already have a Publisher Champ account on the same page and paste the API key from your Publisher Champ settings. We use that account instead of setting up a new one, and the key is stored encrypted.

Your stores and ad accounts are attached inside Publisher Champ. Settings → Sales Integrations → Connected Accounts lists each linked account with every platform on it and when each last reported, and signs you straight into Publisher Champ to add one or re-authorize one that has stopped reporting.

Direct2Readers and paid orders from connected WooCommerce or FluentCart stores are brought into the same report.

Unlinking ends our access and the included subscription. Your Publisher Champ account and its data are not deleted — you keep the account, and can subscribe directly or reconnect through StorytellerOS later.

Tip

Use the Sync command in Sales Studio after connecting an account. The first managed retailer sync can import up to one year; later syncs refresh the recent rolling window.

Map Sales to Titles

Sales Studio automatically matches retailer ASINs and ISBNs to title variations in Project Studio. Open the Mapping tab when a record remains unmatched, choose the correct variation, and attach it. That decision is applied to historical and future sales.

Title mappings are shared with Ads Studio. Once a sale is mapped, the same title can be used to compare royalties and ad spend.

How Duplicate Sales Are Prevented

Every retailer figure now arrives through one connection, so a retailer period cannot be counted twice. Your direct channels stay separate by design: Direct2Readers and your own website-store orders are recorded as their own sources alongside the retailer feed, never merged into it.

Sales captured by the retired Sales Bridge browser extension are kept and still appear in your history under their original source. Where an imported retailer period fully covers one of those older records, the retailer figure is the one used.

Royalties and ad attribution are different

Retailer royalties are the money reported by the sales source. An ad platform's attributed sales are its own attribution measurement. StorytellerOS keeps them separate rather than adding them together.

Direct Store

The Direct store tab contains Direct2Readers activation, lifetime marketplace totals, and product management. Direct2Readers orders also appear in the unified title and source views after sync.

API and MCP Access

StorytellerOS API and MCP clients can read the same canonical report and detailed sales facts, inspect or provision connections, trigger a sync, list unmapped identifiers, persist title mappings, and read or update per-pen-name KENP rates. Public responses use StorytellerOS names and do not identify the upstream analytics provider.