Hoe het werkt

Waar elk cijfer vandaan komt

Alles wordt in je account opgeslagen, dus de geschiedenis blijft ook offline bestaan en het dashboard hoeft haar nooit opnieuw te downloaden.

Waarom elke winkel wordt gelezen via een vastgelegde sessie, geen live browser

Geen van de platformen die we op deze manier koppelen — Amazon KDP, Kobo Writing Life en elke winkel die daarna volgt — heeft een publieke API. Hun rapporten zitten achter een sessie, en een sessie naspelen die je leent van je dagelijkse surfgedrag zou betekenen dat je cookies kopieert die je nooit had willen afstaan — precies het patroon dat een accountbeveiligingssysteem herkent als een overnamepoging, op het ene account waarvan je hele business afhangt. Dit is dus de vaste architectuur voor elk winkelplatform dat we ondersteunen, geen KDP-of-Kobo-specifiek ontwerp: een sessie van onszelf, eenmalig vastgelegd, daarna afgespeeld vanaf onze servers volgens hun eigen schema — nooit een browser die open moet blijven staan.

Koppelen vraagt in plaats daarvan om die sessie van onszelf: er opent een venster met hun eigen inlogpagina, jij typt daar je wachtwoord — nooit in de extensie — en die verse aanmelding is wat we vastleggen. Je dagelijkse browsersessie blijft ongemoeid. Vanaf dat moment spelen onze servers die vastgelegde sessie af volgens hun eigen schema, één account tegelijk, nooit als een uitbarsting over de hele vloot. Koppel op elk moment opnieuw in Platforms als een sessie ooit verloopt.

Twaalf andere winkels werken al zo, nog voordat we ze uitlezen. Barnes & Noble Press, ACX, Google Play Books en de rest leggen een sessie vast en houden die vast zodra je koppelt — zie Platforms die je vast kunt koppelen — dus de dag dat we elk platform gaan uitlezen, is het meteen ditzelfde servermodel, zonder dat jij iets opnieuw hoeft te koppelen.

Draft2Digital is het enige platform dat nog moet inhalen. De sessie is nog niet naar dit model overgezet, dus de extensie blijft de rapporten één keer per dag lezen, zolang Chrome draait en je ingelogd blijft op draft2digital.com — precies zoals KDP en Kobo vroeger werkten, voordat ze overstapten.

Waarom je advertentieplatforms geen extensie nodig hebben

Amazon Ads, Meta Ads en TikTok Ads hebben wel een officiële API. Je autoriseert eenmalig leestoegang en onze servers lezen je uitgaven via die API. Er komt geen extensie aan te pas: je cijfers worden bijgewerkt wanneer je TrueRoyalties opent, en één keer per dag vanzelf.

De nettowinstberekening

Dit is de enige berekening die beide kanten nodig heeft. Gelezen pagina's, reviews en klikken worden gelezen en opgeslagen zoals ze zijn; de nettowinst is het getal dat niemand je kant-en-klaar aanreikt.

Voor elke dag, elk boek en elke marketplace:

1. Royalty's worden verzameld in de valuta waarin elk platform ze heeft betaald.
2. Advertentie-uitgaven worden per campagne verzameld en daarna toegeschreven aan het boek dat ze promoten.
3. Beide worden omgerekend naar je rapportagevaluta tegen de koers van hun eigen datum.
4. Je belastingtarieven worden toegepast — btw op advertentie-uitgaven, bronbelasting op royalty's.
5. Wat overblijft is de nettowinst.

Omdat elke stap per dag wordt opgeslagen, herberekent elk filter dat je toepast — een marketplace, een boek, een datumbereik, een formaat — vanuit dezelfde basisdata.

Hoe actueel de data is

TrueRoyalties synchroniseert automatisch, maar kan alleen zo actueel zijn als Amazons eigen rapporten:

• KDP-royalty's — de schatter die TrueRoyalties leest ververst ongeveer elke 24 tot 48 uur.
• Amazon Ads — dagelijks bijgewerkt, en cijfers kunnen nog een paar dagen worden herzien.

Een verkoop van vanochtend is dus normaal gesproken morgen zichtbaar, niet over tien minuten. Zie Synchronisatie en actualiteit.

De uitzondering zijn smart link-klikken: die lopen via onze eigen redirect en verschijnen dus meteen. Het is het enige live cijfer op je dashboard.