Come funziona

Come funziona

Da dove arriva ogni numero — una sessione catturata una volta e letta dai nostri server per ogni piattaforma di vendita, l'API Amazon Ads per la spesa, e i calcoli che ci stanno sopra.

Da dove arriva ogni numero

FonteCosa portaCome viene letta
Amazon KDPRoyalty, unità, pagine KENP letteUna sessione catturata una volta, poi letta dai nostri server
Kobo Writing LifeVendite Kobo, lettura Kobo Plus, download gratuitiUguale: catturata una volta, poi letta dai nostri server
Draft2DigitalRoyalty di ogni negozio in cui distribuisceEstensione del browser, dalla tua sessione, una volta al giorno — l'unica piattaforma ancora a metà del passaggio al modello qui sopra
Apple Books, Shopify, WooCommerce, Squarespace, ThriveCart, FourthwallLe tue vendite su ogni negozio, titolo per titoloUna chiave API o l'autorizzazione del negozio stesso, poi letta dai nostri server
Store AmazonValutazioni e recensioni scritteL'estensione del browser, dal tuo browser
Amazon AdsSpesa pubblicitaria, vendite attribuite alle inserzioni, royalty KU dalle inserzioniAPI ufficiale Amazon Ads, sui nostri server
Meta AdsSpesa pubblicitaria su Facebook e InstagramAPI ufficiale di Meta, sui nostri server
TikTok AdsSpesa pubblicitaria su TikTokAPI ufficiale TikTok Ads, sui nostri server
I tuoi smart linkClic, paesi, dispositiviIl nostro reindirizzamento — Amazon non è coinvolta

Tutto viene salvato nel tuo account, quindi lo storico resta anche offline e la dashboard non deve mai riscaricarlo.

Perché ogni negozio viene letto da una sessione catturata, non da un browser sempre attivo

Nessuna delle piattaforme che colleghiamo in questo modo — Amazon KDP, Kobo Writing Life e ogni rivenditore che si aggiunge — pubblica un'API pubblica. I loro report sono protetti da una sessione, e riprodurne una presa in prestito dalla tua navigazione quotidiana significherebbe copiare cookie che non intendevi cedere — esattamente lo schema che un sistema di protezione degli account è costruito per segnalare come un tentativo di furto, sull'unico account da cui dipende tutta la tua attività. Questa è quindi l'architettura di fondo per ogni piattaforma di vendita che supportiamo, non una scelta specifica di KDP o Kobo: una sessione tutta nostra, catturata una volta, poi riprodotta dai nostri server secondo il proprio calendario — mai un browser che deve restare aperto.

Collegarsi chiede quella sessione tutta nostra invece di prendere in prestito la tua: si apre la pagina di accesso loro, digiti la password lì — mai nell'estensione — e quel nuovo accesso è ciò che catturiamo. La tua sessione di navigazione quotidiana resta intatta. Da quel momento i nostri server riproducono la sessione catturata secondo il proprio calendario, un account alla volta, mai come un'ondata su tutta la flotta insieme. Ricollegati in qualsiasi momento da Piattaforme se una sessione dovesse scadere.

Altri dodici rivenditori funzionano già così, prima ancora di leggerli. Barnes & Noble Press, ACX, Google Play Books e gli altri catturano e conservano una sessione nel momento in cui li colleghi — vedi Le piattaforme che puoi collegare in anticipo — così il giorno in cui inizieremo a leggerli, sarà già questo stesso modello lato server fin dal primo giorno, senza nulla da ricollegare o rifare.

Draft2Digital è l'unica piattaforma ancora in ritardo. La sua sessione non è ancora passata a questo modello, quindi l'estensione continua a leggere i suoi report una volta al giorno, finché Chrome è in esecuzione e resti connesso a draft2digital.com — proprio come funzionavano KDP e Kobo prima di passare al nuovo modello.

Perché le tue piattaforme pubblicitarie non hanno bisogno di un'estensione

Amazon Ads, Meta Ads e TikTok Ads hanno un'API ufficiale. Autorizzi l'accesso in lettura una volta e i nostri server leggono la tua spesa tramite quell'API. Nessuna estensione è coinvolta: i tuoi numeri si aggiornano quando apri TrueRoyalties, e una volta al giorno da soli.

Il calcolo del profitto netto

È l'unico calcolo che ha bisogno di entrambi i lati. Pagine lette, recensioni e clic vengono letti e salvati così come sono; il profitto netto è il numero che nessuno ti consegna già pronto.

Per ogni giorno, ogni libro e ogni marketplace:

  1. Le royalty vengono raccolte nella valuta in cui le ha pagate ciascuna piattaforma.
  2. La spesa pubblicitaria viene raccolta per campagna, poi attribuita al libro che promuove.
  3. Entrambe vengono convertite nella tua valuta di riferimento al cambio della loro data.
  4. Vengono applicate le tue aliquote — IVA sulla spesa pubblicitaria, ritenuta sulle royalty.
  5. Quel che resta è il profitto netto.

Poiché ogni passaggio è salvato per giorno, qualsiasi filtro tu applichi — un marketplace, un libro, un intervallo di date, un formato — ricalcola dagli stessi dati di base.

Quanto sono aggiornati i dati

TrueRoyalties si sincronizza automaticamente, ma può essere aggiornato solo quanto lo sono i report di Amazon:

  • Royalty KDP — lo stimatore che TrueRoyalties legge si aggiorna all'incirca ogni 24-48 ore.
  • Amazon Ads — aggiornato ogni giorno, e i dati possono ancora essere rivisti per qualche giorno.

Una vendita fatta stamattina è quindi normalmente visibile domani, non tra dieci minuti. Vedi Sincronizzazione e aggiornamento.

L'eccezione sono i clic degli smart link: passano dal nostro reindirizzamento, quindi compaiono subito. È l'unico numero in tempo reale della tua dashboard.