Sales Analytics

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

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. Linking with your own key keeps your billing with Publisher Champ. To use the analytics included with your account instead, the account owner can press Move billing to StorytellerOS on the same page and follow the steps: it unlinks the key, then you sign in to Publisher Champ through StorytellerOS. Your last 12 months of sales come back on their own; contact support if you need older history restored.

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.

Map Sales to Titles

Sales Studio automatically matches retailer ASINs, ISBNs and SKUs to title variations in Project Studio. A SKU is optional: add one on a variation when a store lists it by your own code, such as a box set or an ebook sold direct. 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.

Each unmatched item shows the product name the store or retailer reported next to its code, so you can tell what it is at a glance. The code is labeled ASIN, ISBN or Store ID. A retailer's own number is a Store ID. An ISBN is matched for you as soon as it is on a variation, even when the store adds its name in front of it or the ISBN is written with hyphens.

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

Sales that aren't books

Some unmatched sales are not books at all: merch, gift cards, or a product you no longer sell. Choose Not a book on one, or tick several and set them all aside in one click. Their money still counts in your store total and your overall royalties; they simply stop asking to be matched, are not listed as a title, and are not counted as books sold. Nothing is deleted. Open Show items set aside at the bottom of the card and choose Put back to undo it at any time, and right after setting something aside you can also click Undo.

Tips your readers add at checkout in your Shopify store are recognized for you. They show as one line, "Tips from your store", count as store income in your totals, and are never matched to a book, so they never change any title's numbers.

Publisher Champ reports sales in two ways. Sales with a format (ebook, paperback, hardcover, audiobook) land on that format. Store totals for the whole book have no format, so they sit on the format whose ASIN or ISBN Publisher Champ uses for the book, usually the one listed first there. Mapping an audiobook ASIN to your audiobook moves that format's own sales, not the whole book's store totals.

The Sales with no buy link card suggests buy links only for formats that have their own sales, and only at stores that sell that format: audiobooks go to Audible, and print formats are never suggested at ebook-only stores such as Kobo or Apple Books. Each suggestion shows what was earned there, all time.

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.

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, set sales that aren't books aside (and put them back) several at a time, and read or update per-pen-name KENP rates. Public responses use StorytellerOS names and do not identify the upstream analytics provider.