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
| Fonte | Cosa porta | Come viene letta |
|---|---|---|
| Amazon KDP | Royalty, unità, pagine KENP lette | Una sessione catturata una volta, poi letta dai nostri server |
| Kobo Writing Life | Vendite Kobo, lettura Kobo Plus, download gratuiti | Uguale: catturata una volta, poi letta dai nostri server |
| Draft2Digital | Royalty di ogni negozio in cui distribuisce | Estensione 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, Fourthwall | Le tue vendite su ogni negozio, titolo per titolo | Una chiave API o l'autorizzazione del negozio stesso, poi letta dai nostri server |
| Store Amazon | Valutazioni e recensioni scritte | L'estensione del browser, dal tuo browser |
| Amazon Ads | Spesa pubblicitaria, vendite attribuite alle inserzioni, royalty KU dalle inserzioni | API ufficiale Amazon Ads, sui nostri server |
| Meta Ads | Spesa pubblicitaria su Facebook e Instagram | API ufficiale di Meta, sui nostri server |
| TikTok Ads | Spesa pubblicitaria su TikTok | API ufficiale TikTok Ads, sui nostri server |
| I tuoi smart link | Clic, paesi, dispositivi | Il 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:
- Le royalty vengono raccolte nella valuta in cui le ha pagate ciascuna piattaforma.
- La spesa pubblicitaria viene raccolta per campagna, poi attribuita al libro che promuove.
- Entrambe vengono convertite nella tua valuta di riferimento al cambio della loro data.
- Vengono applicate le tue aliquote — IVA sulla spesa pubblicitaria, ritenuta sulle royalty.
- 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.