# TrueRoyalties — full content TrueRoyalties is the all-in-one dashboard for Amazon KDP authors and publishers: it combines KDP royalties, Amazon Ads spend, Kindle Unlimited pages read, series read-through, Best Sellers Rank, customer reviews and reader links across every marketplace, and computes the real net profit that neither KDP nor Amazon Ads shows. Base URL: https://trueroyalties.com Map of this site: https://trueroyalties.com/llms.txt # TrueRoyalties Documentation Track royalties, ad spend, Kindle Unlimited, series, ranks and reviews for every KDP book — and see the real profit KDP and Amazon Ads never show. Base URL: https://trueroyalties.com ## Documentation Index - [Qu'est-ce que TrueRoyalties ?](https://trueroyalties.com/docs/what-is-trueroyalties) - Un seul tableau de bord pour toute ton activité KDP — royalties, dépenses pub, Kindle Unlimited, séries, classements, avis et liens — et le vrai bénéfice en dessous. - [Extension Chrome](https://trueroyalties.com/docs/connect/extension) - Le TrueRoyalties Connector lit tes rapports KDP depuis ton propre navigateur. Ce qu'il installe, ce qu'il peut voir, et ce qu'il ne peut pas. - [Bénéfice net](https://trueroyalties.com/docs/metrics/net-profit) - Le seul chiffre pour lequel TrueRoyalties existe — ce qui entre dedans, ce qui reste dehors, et pourquoi les royalties sont affichées avant impôt mais le bénéfice après. - [Démarrage rapide](https://trueroyalties.com/docs/quick-start) - Crée ton compte, connecte KDP et Amazon Ads, et obtiens ton catalogue, tes ventes et ton premier vrai chiffre de bénéfice net en environ cinq minutes. - [Royalties KDP](https://trueroyalties.com/docs/connect/kdp) - Ce que TrueRoyalties importe depuis KDP, comment se passe le premier import de tout l'historique, et pourquoi un compte KDP correspond à un seul compte TrueRoyalties. - [Organique vs généré par la pub](https://trueroyalties.com/docs/metrics/organic-vs-ad-generated) - Comment TrueRoyalties répartit tes ventes entre celles que tes pubs ont amenées et celles qui sont venues gratuitement. - [Comment ça marche](https://trueroyalties.com/docs/how-it-works) - D'où vient chaque chiffre — l'extension pour les royalties KDP, les classements et les avis, l'API Amazon Ads pour les dépenses, et les calculs par-dessus. - [Amazon Ads](https://trueroyalties.com/docs/connect/amazon-ads) - Connecte ton compte Amazon Ads pour transformer les royalties en bénéfice — ce qui est importé, comment les dépenses sont attribuées aux livres, et à quoi ressemble le premier import. - [True ACOS](https://trueroyalties.com/docs/metrics/true-acos) - Les dépenses pub divisées par les royalties que tes pubs ont réellement rapportées. Le seuil de rentabilité est à 100 %, et c'est tout l'intérêt. - [Synchronisation et fraîcheur](https://trueroyalties.com/docs/connect/syncing) - Quand TrueRoyalties actualise tes données, à quel point les rapports d'Amazon eux-mêmes sont frais, et comment forcer une synchronisation. - [Impôts et devises](https://trueroyalties.com/docs/metrics/taxes-and-currencies) - Renseigne une fois la TVA sur les dépenses pub et la retenue à la source KDP, choisis ta devise de reporting, et chaque chiffre de l'app devient celui que tu encaisses vraiment. - [Taux par page Kindle Unlimited](https://trueroyalties.com/docs/metrics/kindle-unlimited-page-rates) - Ce que paie Kindle Unlimited, ce qu'est vraiment une « page lue », d'où vient le taux, et comment lire notre page de taux gratuite. ## Full Documentation --- # Qu'est-ce que TrueRoyalties ? Un seul tableau de bord pour toute ton activité KDP — royalties, dépenses pub, Kindle Unlimited, séries, classements, avis et liens — et le vrai bénéfice en dessous. URL: https://trueroyalties.com/docs/what-is-trueroyalties ## Le problème Piloter une activité KDP, c'est lire un écran différent pour chaque question que tu te poses. KDP affiche tes royalties. Amazon Ads affiche tes dépenses. Aucun des deux n'affiche ton **bénéfice** — tu peux donc vendre plus chaque mois et perdre quand même de l'argent, parce que les deux chiffres vivent dans deux tableaux de bord, dans des devises différentes, avant impôt. Et le bénéfice n'est que la première question. Est-ce que les gens finissent le livre ? Le tome 1 emmène-t-il les lecteurs vers le tome 2 ? Où se classe chaque titre aujourd'hui, dans chaque pays ? Que disait ce nouvel avis ? Chacune de ces réponses vit encore ailleurs, et aucune n'est sur la même page que l'argent. ## Ce que fait TrueRoyalties TrueRoyalties est le tableau de bord tout-en-un des auteurs et éditeurs Amazon KDP : il réunit les royalties KDP, les dépenses Amazon Ads, les pages lues Kindle Unlimited, le read-through des séries, le Best Sellers Rank, les avis clients et les liens lecteurs sur tous les marketplaces, et calcule le vrai bénéfice net que ni KDP ni Amazon Ads n'affiche. C'est cette dernière partie qu'aucun autre tableau de bord ne fait : ``` Bénéfice net = Royalties − Dépenses pub ``` Par livre, par marketplace, par jour — sur chaque boutique KDP où tu vends. ![Tableau de bord TrueRoyalties affichant le bénéfice net, les royalties, les dépenses pub, le True ACOS et les unités vendues d'un catalogue Amazon KDP](/images/docs/dashboard.png) ## Ce qu'il y a dedans Quatre questions, quatre parties de l'app. Chacune lit les mêmes données importées, donc rien n'a besoin d'être connecté deux fois — la [page fonctionnalités](/features) les parcourt toutes les quatre dans l'ordre. | | Répond à | Où | | --- | --- | --- | | **Bénéfice** | Est-ce que je gagne de l'argent ? | [Tableau de bord](/docs/app/dashboard), [Livres](/docs/app/books), [Marketplaces](/docs/app/marketplaces), [Commandes](/docs/app/orders), [Comparaison](/docs/app/comparison) | | **Lecteurs** | Est-ce que quelqu'un lit, et jusqu'où ? | [Kindle Unlimited](/docs/app/kenp), [Séries et read-through](/docs/app/series) | | **Visibilité** | Où suis-je classé, et qu'est-ce qu'on dit ? | [Best Sellers Rank](/docs/app/bsr), [Avis](/docs/app/reviews) | | **Vendre et prouver** | Comment vendre plus, et le prouver ? | [Smart links](/docs/app/smart-links), [Page vérifiée](/docs/app/verified) | Deux d'entre elles méritent une phrase à part, parce que ce ne sont pas des rapports — elles font quelque chose des chiffres. Un **[smart link](/docs/app/smart-links)** est un seul lien court qui envoie chaque lecteur vers *sa propre* boutique Amazon, avec un QR code pour ta fin d'ouvrage et un compteur de clics qui atterrit à côté de tes royalties. Ta **[page vérifiée](/docs/app/verified)** est une page publique de tes vrais chiffres KDP que personne ne peut modifier, toi compris — pour prouver un revenu sans une capture d'écran que n'importe qui aurait pu truquer. ## Ce qu'il gère à ta place Les parties du calcul qui sont fastidieuses, faciles à rater, et appliquées partout sans que tu aies à le demander : | | | | --- | --- | | **Multi-marketplace** | US, UK, DE, FR, ES, IT, JP, CA, AU et les autres, en une seule vue | | **Devises** | Chaque montant converti au taux de sa propre date de transaction | | **Impôts** | Retenue à la source KDP et TVA sur les dépenses pub, appliquées automatiquement | | **Kindle Unlimited** | Pages KENP lues et royalties KU comptées comme un vrai revenu | | **Attribution pub** | Quelles ventes tes pubs ont réellement générées, et ce qu'elles ont coûté | ## Des outils gratuits, sans compte Une partie du calcul est utile avant même d'être client, alors elle est publique et gratuite : le [calculateur de royalties KDP](/amazon-kdp-royalty-calculator), le [calculateur KENP](/kenp-calculator), l' [historique des taux par page Kindle Unlimited](/kindle-unlimited-page-rates), le [calculateur de ventes de livres](/amazon-book-sales-calculator), le [générateur de code-barres ISBN](/isbn-barcode-generator) et le [générateur de QR code](/qr-code-generator). Ils tournent entièrement dans ton navigateur. ## Ce qu'il ne fait jamais TrueRoyalties est **en lecture seule** chez Amazon. Il ne modifie jamais tes livres, tes prix, tes campagnes ni tes enchères. Il lit tes rapports et fait les calculs. ## Essaie avant de t'inscrire La [démo en direct](https://trueroyalties.com/demo) ouvre la vraie app sur un compte d'exemple en lecture seule — pas d'inscription, pas de carte. --- # Extension Chrome Le TrueRoyalties Connector lit tes rapports KDP depuis ton propre navigateur. Ce qu'il installe, ce qu'il peut voir, et ce qu'il ne peut pas. URL: https://trueroyalties.com/docs/connect/extension ## De quoi il s'agit **TrueRoyalties Connector** est la petite extension de navigateur qui récupère tes rapports KDP. Elle est indispensable : KDP n'a pas d'API publique, il n'y a donc aucun autre moyen de lire tes royalties. Installe-la depuis le [Chrome Web Store](https://chromewebstore.google.com/detail/mafehnimnbbodfmifjfneljbcialmhcd). Elle fonctionne sur **Chrome, Brave et Arc**. Les autres navigateurs ne sont pas encore pris en charge. ## Ce qu'elle fait - Lit tes rapports KDP de royalties, de commandes et de KENP, en utilisant la session KDP déjà ouverte dans ton navigateur. - Les envoie vers ton compte TrueRoyalties. - Copie les couvertures de tes livres pour que l'app puisse les afficher. - Lit tes avis clients Amazon (voir [Avis](/docs/app/reviews)). - Affiche une notification navigateur à chaque nouvelle vente, si tu l'actives. - Vérifie une page **que tu as désignée** pour y trouver ton jeton de vérification, quand nos serveurs ne peuvent pas la lire (voir [Ta page vérifiée](/docs/app/verified)). ## Ce qu'elle ne peut pas faire - Elle **ne voit jamais ton mot de passe Amazon**. Elle utilise une session que tu as ouverte toi-même. - Elle **n'écrit jamais** rien chez Amazon — aucun changement de prix, aucune modification de campagne. Par défaut, elle ne tourne que sur `kdpreports.amazon.com`, les boutiques Amazon et TrueRoyalties. Sa liste d'autorisations est volontairement courte : stockage, alarmes, notifications, et les en-têtes de requête dont elle a besoin pour parler à KDP. **Un extra facultatif.** Vérifier un lien sur un site construit en JavaScript (Wix, Squarespace, X, Instagram, TikTok) suppose d'ouvrir cette page dans ton navigateur, ce qui demande une autorisation plus large « lire les pages que tu visites ». Elle est **demandée une seule fois, uniquement quand tu ajoutes un tel lien**, et c'est toi qui appuies sur Autoriser. Si tu refuses, tout le reste fonctionne exactement pareil. Voir [Confidentialité](/docs/help/privacy). ## Vérifier qu'elle est connectée Clique sur l'icône de l'extension. Le popup indique si elle est connectée à ton compte et quand elle s'est synchronisée pour la dernière fois. Dans l'app, **Paramètres → Connexions** affiche le même état, plus un bouton **Synchroniser**. ## Pour qu'elle continue de fonctionner | Symptôme | Solution | | --- | --- | | « Extension non détectée » sur une page déjà ouverte | Recharge l'onglet — Chrome n'injecte pas l'extension dans les onglets ouverts avant l'installation | | L'import s'arrête au bout d'un moment | Reconnecte-toi à [KDP](https://kdp.amazon.com/bookshelf) ; la session a expiré | | Rien ne se synchronise du tout | Vérifie que l'extension est activée dans `chrome://extensions` | Plus de détails dans [Dépannage](/docs/help/troubleshooting). ## Mises à jour Chrome met l'extension à jour tout seul. Tu n'as jamais besoin de la réinstaller. --- # Bénéfice net Le seul chiffre pour lequel TrueRoyalties existe — ce qui entre dedans, ce qui reste dehors, et pourquoi les royalties sont affichées avant impôt mais le bénéfice après. URL: https://trueroyalties.com/docs/metrics/net-profit ## La formule ``` Bénéfice net = Royalties conservées − Dépenses pub (taxes comprises) ``` Les « royalties conservées » sont tes royalties **après retenue à la source KDP**. Les dépenses pub, c'est ce que tes pubs coûtent réellement, **TVA comprise**. ![Cartes KPI du tableau de bord : bénéfice net, royalties, dépenses pub, True ACOS, unités vendues](/images/docs/dashboard-kpis.png) ## Ce qui compte comme royalties Tout ce que KDP te verse, en un seul chiffre : - Ventes payantes — ebook, broché, relié - Pages lues Kindle Unlimited - Distribution étendue La carte **Royalties** affiche le montant **brut**, avant retenue à la source. C'est volontaire : c'est le chiffre que tu peux comparer, ligne à ligne, avec ton tableau de bord KDP. ## Ce qui compte comme dépenses pub Toutes tes dépenses Amazon Ads, y compris la part qui ne peut être rattachée à aucun livre précis (Sponsored Brands, pubs sur des ASIN hors de ton catalogue). C'est de l'argent réel, donc sa place est dans le total. Les dépenses sont comptées **TVA comprise**, au taux que tu renseignes par marketplace — voir [impôts et devises](/docs/metrics/taxes-and-currencies). ## Où apparaît la retenue à la source Uniquement dans le bénéfice net. Les deux cartes se lisent donc différemment, et c'est voulu : | Carte | Traitement fiscal | | --- | --- | | Royalties | Brut — correspond à KDP | | Bénéfice net | Après retenue — correspond à ta banque | ## Par livre, par marketplace, par jour Le même calcul tourne à tous les niveaux — par titre sur [Livres](/docs/app/books), par boutique sur [Marketplaces](/docs/app/marketplaces), et de toutes les autres façons de découper sur [Comparaison](/docs/app/comparison). Le bénéfice net d'un livre, c'est ses royalties moins les dépenses pub qui lui sont attribuées ; ton total est la somme de tout, y compris les dépenses non attribuables. C'est pourquoi la somme des bénéfices nets de tes livres peut être **supérieure** à ton bénéfice net global : les campagnes de marque comptent dans le total, mais n'appartiennent à aucun livre. ## Les filtres changent le chiffre Chaque filtre — plage de dates, marketplace, livre, format, canal de distribution — recalcule le bénéfice net à partir des données quotidiennes sous-jacentes. Rien n'est estimé depuis un total. Une exception à connaître : choisir un canal sans publicité (distribution étendue seule) retire les dépenses pub de la vue, donc les indicateurs basés sur la pub sont masqués plutôt qu'affichés à zéro. --- # Démarrage rapide Crée ton compte, connecte KDP et Amazon Ads, et obtiens ton catalogue, tes ventes et ton premier vrai chiffre de bénéfice net en environ cinq minutes. URL: https://trueroyalties.com/docs/quick-start Cinq étapes, environ cinq minutes. Les étapes 2 et 3 font entrer tout ton catalogue — ses ventes, ses pages lues Kindle Unlimited, puis ses [classements](/docs/app/bsr) et ses [avis](/docs/app/reviews). L'étape 4 ajoute Amazon Ads, et c'est elle qui transforme des royalties en **bénéfice**. ## 1. Crée ton compte Inscris-toi avec n'importe quelle adresse e-mail — ce n'a **pas** besoin d'être ton adresse Amazon. Tu as **14 jours d'essai gratuit**, sans carte bancaire. Une fois ton e-mail vérifié, l'assistant de configuration s'ouvre automatiquement. ## 2. Installe l'extension de navigateur KDP n'a pas d'API publique, les royalties sont donc lues par l'extension **TrueRoyalties Connector**, dans ton propre navigateur, avec ta propre session KDP. ![Étape d'onboarding demandant sur quel navigateur installer l'extension TrueRoyalties : Brave, Arc, Google Chrome ou autres](/images/docs/onboarding-install.png) Choisis ton navigateur et installe-la. Chrome, Brave et Arc sont pris en charge. Reviens ensuite sur l'onglet — la suite se fait toute seule. ## 3. Connecte-toi à KDP L'import a besoin d'une session KDP active : connecte-toi donc sur [kdp.amazon.com](https://kdp.amazon.com/bookshelf) si tu es déconnecté. ![Panneau d'onboarding avec un bouton Se connecter à KDP et un bouton Je me suis connecté](/images/docs/onboarding-kdp.png) Le premier import démarre alors tout seul et récupère **tout ton historique**, pas seulement aujourd'hui. Les gros catalogues prennent quelques minutes — tu peux laisser l'onglet tourner. ![Barre de progression d'import indiquant Import de tes données KDP à 42 pour cent, 12 titres trouvés](/images/docs/onboarding-progress.png) > **Important.** Un compte KDP ne peut être lié qu'à un seul compte > TrueRoyalties, définitivement. Vérifie que tu es connecté au bon compte Amazon > avant d'importer. ## 4. Connecte Amazon Ads Cette étape est facultative dans l'assistant, mais sans elle TrueRoyalties ne connaît que tes revenus — pas tes coûts. ![Étape d'onboarding proposant de connecter un compte Amazon Ads ou de passer pour l'instant](/images/docs/onboarding-ads.png) Tu es envoyé chez Amazon pour autoriser un accès en lecture, puis renvoyé vers l'app. L'historique publicitaire est récupéré automatiquement. Voir [Amazon Ads](/docs/connect/amazon-ads). ## 5. Lis ton tableau de bord Tu arrives sur le tableau de bord avec cinq chiffres : bénéfice net, royalties, dépenses pub, True ACOS et unités vendues. ![Cartes KPI du tableau de bord affichant bénéfice net, royalties, dépenses pub, True ACOS et unités vendues](/images/docs/dashboard-kpis.png) Avant de te fier aux chiffres au centime près, renseigne tes taux une fois dans **Paramètres → Impôts** — voir [Impôts et devises](/docs/metrics/taxes-and-currencies). ## 6. Puis, quand tu veux plus que des chiffres Aucun des deux n'est nécessaire pour voir ton bénéfice, et les deux prennent une minute : - **[Smart links](/docs/app/smart-links)** — un lien qui envoie chaque lecteur vers sa propre boutique Amazon, avec un QR code pour la fin de ton broché. - **[Ta page vérifiée](/docs/app/verified)** — une page publique de tes vrais chiffres, pour prouver ce que tu gagnes sans capture d'écran. --- # Royalties KDP Ce que TrueRoyalties importe depuis KDP, comment se passe le premier import de tout l'historique, et pourquoi un compte KDP correspond à un seul compte TrueRoyalties. URL: https://trueroyalties.com/docs/connect/kdp ## Ce qui est importé De tes rapports KDP, trois familles de données : - **Royalties** — l'argent, par livre, par marketplace, par jour, dans la devise où Amazon l'a versé. - **Commandes** — unités commandées, par format (ebook, broché, relié). - **KENP** — pages lues Kindle Unlimited. Ensemble, elles couvrent les ventes payantes, Kindle Unlimited et la distribution étendue. ## Le premier import La première synchronisation récupère **tout ton historique**, jusqu'à la création de ton compte KDP — pas seulement le mois en cours. Sur un gros catalogue, cela peut prendre plusieurs minutes, et l'import continue même si tu changes d'onglet. Toutes les synchronisations suivantes ne relisent que les **60 derniers jours**, la fenêtre qu'Amazon peut encore réviser. Les données plus anciennes sont déjà stockées et ne sont jamais retéléchargées. ## Tu dois être connecté à KDP L'extension emprunte la session de ton navigateur. Si tu es déconnecté de [KDP](https://kdp.amazon.com/bookshelf), l'import ne peut pas tourner et l'app te le dit. Connecte-toi, et il reprend tout seul. ## Un compte KDP, un compte TrueRoyalties Un compte KDP ne peut être lié qu'à un seul compte TrueRoyalties, et le lien est **définitif**. Il protège tes données de royalties et garde les essais honnêtes. Si tu connectes un compte KDP déjà lié ailleurs, la configuration s'arrête et explique le cas rencontré : | Message | Signification | | --- | --- | | Compte verrouillé | Ce compte TrueRoyalties est déjà rattaché à un autre compte KDP | | Compte déjà pris | Ce compte KDP appartient déjà à un autre compte TrueRoyalties actif | | Essai déjà utilisé | Ce compte KDP a déjà consommé son essai gratuit | | Compte non vérifié | Le compte Amazon connecté n'est pas un compte KDP, ou sa configuration est incomplète | Contacte le [support](https://trueroyalties.com/contact) si tu penses qu'un blocage est injustifié. ## Changer de devise de reporting KDP renvoie les montants convertis dans la devise que tu demandes. Quand tu changes ta devise de reporting, TrueRoyalties réimporte tout l'historique dans cette devise pour que le passé et le présent concordent. Voir [Impôts et devises](/docs/metrics/taxes-and-currencies). --- # Organique vs généré par la pub Comment TrueRoyalties répartit tes ventes entre celles que tes pubs ont amenées et celles qui sont venues gratuitement. URL: https://trueroyalties.com/docs/metrics/organic-vs-ad-generated ## La répartition ``` Unités totales = Générées par la pub + Organiques ``` **Générées par la pub**, c'est ce qu'Amazon attribue à tes annonces : quelqu'un a cliqué sur une pub et a acheté dans la fenêtre d'attribution d'Amazon (14 jours pour les livres). **Organiques**, c'est tout le reste — ce que ton catalogue a vendu sans que tu paies le clic. ![Unités quotidiennes sur la page Commandes en graphique à barres empilées, chaque jour réparti entre les unités organiques en bleu et les unités générées par la pub en orange](/images/docs/orders-organic-split.png) ## Pourquoi c'est important Les ventes organiques sont la mesure honnête de la traction de ton livre. Un titre 100 % généré par la pub cesse de se vendre le jour où tu arrêtes de payer. Un titre avec une part organique saine s'est construit son propre élan. La même répartition existe pour les pages Kindle Unlimited, sur la [page KENP](/docs/app/kenp). ## D'où viennent les chiffres - **Total** vient de KDP — c'est la vérité de terrain sur ce qui s'est vendu. - **Généré par la pub** vient d'Amazon Ads. - **Organique** est la soustraction, jamais un rapport séparé. ## Deux limites honnêtes **L'attribution est le modèle d'Amazon, pas un fait.** C'est Amazon qui décide de ce qui compte comme piloté par la pub. Un lecteur qui clique sur une annonce, y réfléchit trois semaines puis achète est compté comme organique. **Les pubs augmentent aussi les ventes organiques.** La publicité améliore le classement, et un meilleur classement vend des exemplaires enregistrés comme organiques. La part générée par la pub est donc un plancher de ce que tes pubs ont fait, pas un plafond. ## Le décalage Amazon comptabilise une vente papier à l'**expédition**, pas à la commande. Les commandes papier attribuées aux pubs peuvent donc apparaître un ou deux jours après le clic. La page Commandes t'indique combien sont encore en attente d'expédition. --- # Comment ça marche D'où vient chaque chiffre — l'extension pour les royalties KDP, les classements et les avis, l'API Amazon Ads pour les dépenses, et les calculs par-dessus. URL: https://trueroyalties.com/docs/how-it-works ## D'où vient chaque chiffre | Source | Ce qu'elle apporte | Comment elle est lue | | --- | --- | --- | | **Amazon KDP** | Royalties, unités, pages KENP lues | Extension de navigateur, avec ta session KDP | | **Boutiques Amazon** | Best Sellers Rank et rangs de catégorie, notes et avis rédigés | La même extension, depuis ton propre navigateur | | **Amazon Ads** | Dépenses pub, ventes attribuées aux pubs, royalties KU issues des pubs | API officielle Amazon Ads, sur nos serveurs | | **Tes smart links** | Clics, pays, appareils | Notre propre redirection — Amazon n'intervient pas | Tout est stocké dans ton compte : l'historique reste même hors ligne, et le tableau de bord n'a jamais besoin de le retélécharger. ## Pourquoi l'extension est nécessaire pour KDP KDP n'a **aucune API publique**. Ses rapports sont protégés par ta session Amazon. Rejouer cette session depuis un serveur reviendrait à copier tes cookies dans un datacenter loin de l'endroit où tu t'es connecté — exactement le schéma que les systèmes de protection de compte d'Amazon traitent comme une tentative de piratage, sur le seul compte dont dépend toute ton activité. La récupération tourne donc là où la session vit déjà : **ton navigateur**. Amazon voit une requête normale depuis ta propre machine, et aucun identifiant Amazon ne nous parvient jamais. ## Pourquoi Amazon Ads n'a besoin d'aucune extension Amazon Ads, lui, *a* une API officielle. Tu autorises un accès en lecture une fois, et la synchronisation tourne côté serveur selon un planning — rien à garder ouvert. ## Le calcul du bénéfice net C'est le seul calcul qui a besoin des deux côtés. Les pages lues, les classements, les avis et les clics sont lus et stockés tels quels ; le bénéfice net est le chiffre que personne ne te livre tout fait. Pour chaque jour, chaque livre et chaque marketplace : 1. Les **royalties** sont collectées dans la devise où Amazon les a versées. 2. Les **dépenses pub** sont collectées par campagne, puis attribuées au livre qu'elles promeuvent. 3. Les deux sont converties dans ta devise de reporting **au taux de leur propre date**. 4. Tes **taux d'imposition** sont appliqués — TVA sur les dépenses pub, retenue à la source sur les royalties. 5. Ce qu'il reste est le **bénéfice net**. Comme chaque étape est stockée au jour le jour, n'importe quel filtre que tu appliques — un marketplace, un livre, une plage de dates, un format — recalcule à partir des mêmes données de base. ## À quel point les données sont fraîches TrueRoyalties se synchronise automatiquement, mais il ne peut être plus frais que les rapports d'Amazon eux-mêmes : - **Royalties KDP** — l'estimateur que lit TrueRoyalties se rafraîchit environ toutes les 24 à 48 heures. - **Amazon Ads** — mis à jour quotidiennement, et les chiffres peuvent encore être révisés pendant quelques jours. Une vente faite ce matin est donc normalement visible demain, pas dans dix minutes. Voir [Synchronisation et fraîcheur](/docs/connect/syncing). L'exception, ce sont les **clics des smart links** : ils passent par notre propre redirection, donc ils apparaissent immédiatement. C'est le seul chiffre en direct de ton tableau de bord. --- # Amazon Ads Connecte ton compte Amazon Ads pour transformer les royalties en bénéfice — ce qui est importé, comment les dépenses sont attribuées aux livres, et à quoi ressemble le premier import. URL: https://trueroyalties.com/docs/connect/amazon-ads ## Pourquoi le connecter Sans Amazon Ads, TrueRoyalties montre ce que tu **gagnes**. Avec, il montre ce que tu **gardes**. Les dépenses pub sont l'autre moitié de la soustraction. ## Connexion Va dans **Paramètres → Connexions → Amazon Ads** et autorise l'accès. Tu es envoyé chez Amazon, tu approuves, et tu reviens **sur la page que tu avais quittée**. L'accès est **en lecture seule** — campagnes, enchères et budgets ne sont jamais touchés. Tes comptes publicitaires sont détectés automatiquement, sur chaque marketplace où tu fais de la publicité. ## Reconnexion Si TrueRoyalties indique qu'Amazon demande une reconnexion, c'est que ton autorisation a expiré ou a été révoquée côté Amazon. Reconnecte-toi au même endroit. Se connecter n'est pas synchroniser — cela rétablit la permission de lire tes dépenses. Une synchronisation démarre juste après, toute seule, et la carte t'indique qu'elle tourne. Tes dépenses sont à jour quand elle se termine, pas quand la connexion réussit. ## Le premier import La première synchronisation récupère tout ton historique publicitaire. Sur de longs historiques, elle tourne par segments et peut prendre du temps — parfois des heures. Pendant ce temps, les dépenses pub du tableau de bord peuvent sembler **faibles ou absentes** sur les périodes anciennes. C'est l'import qui remonte encore le temps, pas des données perdues. Cela se règle tout seul. ## Comment les dépenses sont attribuées Les dépenses pub sont regroupées en trois catégories, que le tableau de bord affiche séparément : | Catégorie | Ce que c'est | | --- | --- | | **Tes ASIN** | Sponsored Products sur des livres de ton catalogue KDP — rattachées au livre | | **ASIN hors de ton catalogue KDP** | Sponsored Products sur des ASIN que nous ne pouvons pas rattacher à ton catalogue | | **Sponsored Brands** | Campagnes de marque, qu'Amazon ne rapporte pas par ASIN | Seule la première catégorie peut être attribuée à un livre précis. Les deux autres comptent quand même dans ton bénéfice net **total** — c'est de l'argent réel — mais ne peuvent apparaître sur aucune ligne par livre. ## Ce qui est importé - Les dépenses pub, par jour, par marketplace - Les unités et ventes attribuées aux pubs - Les pages lues Kindle Unlimited et les royalties KU générées par les pubs - **Impressions et clics** — combien de fois Amazon a affiché tes pubs, et combien de fois des lecteurs ont cliqué. Ensemble, ils donnent ton coût moyen par clic. Voir [Comparaison](/docs/app/comparison). ## TVA sur les dépenses pub Amazon facture la publicité avec TVA dans de nombreux pays, et ses rapports affichent des montants **hors taxes**. Renseigne ton taux par marketplace dans **Paramètres → Impôts** pour que les dépenses soient comptées à ce qu'elles te coûtent vraiment. Voir [Impôts et devises](/docs/metrics/taxes-and-currencies). ## Déconnexion **Paramètres → Connexions** te permet de déconnecter Amazon Ads, et de supprimer les données publicitaires importées si tu le souhaites. Tes royalties KDP n'en sont pas affectées. --- # True ACOS Les dépenses pub divisées par les royalties que tes pubs ont réellement rapportées. Le seuil de rentabilité est à 100 %, et c'est tout l'intérêt. URL: https://trueroyalties.com/docs/metrics/true-acos ## Ce qu'il mesure ``` True ACOS = Dépenses pub ÷ Royalties générées par la pub ``` En clair : **pour chaque euro de royalties que mes pubs m'ont rapporté, combien ai-je dépensé pour l'obtenir ?** - Sous **100 %** — les pubs se paient elles-mêmes. - Au-dessus de **100 %** — chaque royalty issue de la pub coûte plus qu'elle ne rapporte. ## Pourquoi pas l'ACOS classique L'ACOS d'Amazon divise les dépenses pub par la **valeur des ventes** attribuées — le prix payé par le client. Or tu ne gardes pas le prix du client, tu gardes une royalty. Sur un ebook à 4,99 $ à 70 %, environ 3,44 $ te reviennent, et sur un broché bien moins. L'ACOS paraît donc flatteur sur les livres où ta part de royalty est faible. Le True ACOS utilise la royalty : le seuil de rentabilité est donc exactement 100 % sur chaque livre, chaque format, chaque marketplace. Certains outils appellent « TACOS » les dépenses pub ÷ ventes **totales**. Cela mesure ta dépendance à la pub, pas la rentabilité des pubs. Les deux sont utiles ; ils répondent à des questions différentes. ## Comment les royalties générées par la pub sont construites Deux parties : | Partie | Source | | --- | --- | | **Ventes payantes** | Unités attribuées aux pubs × la vraie royalty du livre par vente, prise dans tes données KDP | | **Kindle Unlimited** | Les royalties KU qu'Amazon rapporte directement en face de tes pubs | La partie payante est une **estimation**, parce qu'Amazon ne rapporte jamais la royalty de l'auteur sur une vente — seulement la valeur de vente. TrueRoyalties utilise la royalty par vente que ce livre a réellement réalisée, plutôt qu'une règle générique à 70 %. ## Bien le lire - Un True ACOS élevé sur le **tome 1** peut être acceptable si la série le rembourse. Vérifie [Séries et read-through](/docs/app/series) avant de couper la campagne. - Le True ACOS ignore la hausse organique que tes pubs provoquent : c'est donc une mesure **prudente**. - Il nécessite Amazon Ads connecté. Sans lui, la carte est vide. ## Où le trouver Sur le tableau de bord en carte KPI, par livre sur [Livres](/docs/app/books), et par marketplace sur [Marketplaces](/docs/app/marketplaces). --- # Synchronisation et fraîcheur Quand TrueRoyalties actualise tes données, à quel point les rapports d'Amazon eux-mêmes sont frais, et comment forcer une synchronisation. URL: https://trueroyalties.com/docs/connect/syncing ## Quand les synchronisations ont lieu Tu n'as jamais à déclencher une synchronisation. Tes royalties KDP et tes dépenses Amazon Ads viennent de deux endroits différents, elles s'actualisent donc selon leurs propres rythmes. **Royalties KDP** — lues par l'extension : | Déclencheur | Quand | | --- | --- | | **App ouverte** | Tant qu'un onglet TrueRoyalties est visible, et au plus toutes les 15 minutes | | **Alarme en arrière-plan** | Toutes les 15 minutes, même app fermée — uniquement si les **alertes de nouvelle vente** sont activées | | **Synchroniser** | Dès que tu cliques, dans **Paramètres → Connexions** | **Dépenses Amazon Ads** — lues via l'API d'Amazon, sans extension : | Déclencheur | Quand | | --- | --- | | **App ouverte** | N'importe quel onglet TrueRoyalties, au premier plan ou non, dès que la dernière synchronisation réussie a plus de 2 heures | | **Reconnexion** | Immédiatement, sans attendre les 2 heures — tu te reconnectes parce que quelque chose n'allait pas | | **Réparation automatique** | Toutes les 15 minutes, nous reprenons toute synchronisation arrêtée en chemin | Amazon génère le rapport publicitaire à son rythme : une actualisation met donc généralement quelques minutes à arriver. Rien à presser en attendant. Une synchronisation ne tourne que si elle est réellement due — ouvrir l'app dix fois de suite ne sollicite donc pas Amazon dix fois. ## Quand les dépenses pub semblent dépassées Le tableau de bord te le dit, en ambre, au-dessus de tes chiffres. Dans la quasi- totalité des cas, cela se règle tout seul — laisse l'onglet ouvert et ça s'actualise. **Un seul cas demande ton intervention :** s'il indique qu'Amazon demande une reconnexion, ton autorisation a expiré ou a été révoquée côté Amazon. Va dans **Paramètres → Connexions** et reconnecte Amazon Ads — une synchronisation démarre dès ton retour. Rien d'autre dans cette liste ne demande un clic. ## À quel point les données d'Amazon sont fraîches C'est la partie qui surprend le plus de monde. TrueRoyalties ne peut jamais être plus frais que le rapport qu'il lit : - **Royalties KDP** — l'estimateur se rafraîchit environ toutes les **24 à 48 heures**. - **Commandes KDP** — généralement sous 24 heures. - **Kindle Unlimited** — les pages lues apparaissent vite, mais le *taux* KU d'un mois n'est fixé par Amazon qu'au milieu du mois suivant. - **Amazon Ads** — quotidiennement, et Amazon continue de réviser les derniers jours. Les ventes du jour sont donc normalement visibles le lendemain. Un « Synchroniser » ne fera pas publier à Amazon un chiffre qu'il n'a pas encore publié. ## Pourquoi les 60 derniers jours sont relus Amazon révise les chiffres récents — retours, remboursements, attributions corrigées. Chaque synchronisation relit les **60 derniers jours** pour que ton historique reflète ces corrections. Les données plus anciennes sont déjà définitives et ne sont pas touchées. ## Commandes pub « en attente d'expédition » Sur la page Commandes, tu peux voir une note sur des commandes générées par les pubs et en attente d'expédition. Amazon comptabilise une vente papier à l'**expédition**, pas à la commande : les commandes papier attribuées aux pubs apparaissent donc un ou deux jours plus tard. Rien n'est perdu. ## Forcer une synchronisation **Paramètres → Connexions → Synchroniser**. Cela contourne l'intervalle de 15 minutes. Prérequis : l'extension activée et une session KDP active. Si le bouton ne fait rien, voir [Dépannage](/docs/help/troubleshooting). --- # Impôts et devises Renseigne une fois la TVA sur les dépenses pub et la retenue à la source KDP, choisis ta devise de reporting, et chaque chiffre de l'app devient celui que tu encaisses vraiment. URL: https://trueroyalties.com/docs/metrics/taxes-and-currencies ## TVA sur les dépenses pub Amazon rapporte les dépenses pub **hors** taxes, mais te les facture **avec** TVA dans la plupart des pays. L'ignorer sous-estime tes coûts. Dans **Paramètres → Impôts → TVA sur les dépenses pub par pays**, renseigne ton taux par marketplace. Les dépenses sont alors comptées TTC partout dans l'app. Saisis le taux que tu ne peux **pas** récupérer. Si tu récupères la TVA via ton entreprise, mets 0. ## Retenue à la source KDP Amazon peut retenir une partie de tes royalties au titre de l'impôt avant de te payer. Ton taux vient de ton entretien fiscal KDP, et TrueRoyalties le **détecte automatiquement** à la première synchronisation. Dans **Paramètres → Impôts**, l'interrupteur *Compter la retenue sur les royalties* décide si elle est déduite : - **Désactivé** — royalties et bénéfice net affichent tous deux des montants avant retenue. - **Activé** — le bénéfice net est calculé sur ce que tu reçois réellement. La carte **Royalties** reste toujours en brut, pour continuer à correspondre à KDP. Voir [Bénéfice net](/docs/metrics/net-profit). ## Devise de reporting Ta devise de reporting se règle dans **Paramètres → Préférences → Devise de reporting**. C'est la devise dans laquelle ton historique est stocké et présenté. La changer réimporte tout ton historique KDP dans la nouvelle devise, pour que le passé et le présent concordent toujours. Cela prend un instant — le tableau de bord affiche un état de chargement en attendant. Le tableau de bord et la page KENP ont aussi un sélecteur de **devise d'affichage**, pour jeter un œil dans une autre devise sans changer ta devise de reporting. ## Comment fonctionne la conversion Chaque montant est converti au taux de change de **sa propre date de transaction** — une vente de mars 2023 utilise le taux de mars 2023, pas celui d'aujourd'hui. C'est plus juste qu'un taux unique, et cela explique une petite différence que tu peux remarquer : le total multi-devises de KDP utilise une approximation grossière, les chiffres peuvent donc différer d'environ 1 %. TrueRoyalties est le plus précis des deux. Pour correspondre exactement à KDP, consulte ton tableau de bord dans la devise avec laquelle KDP te paie. ## Où vérifier tes taux **Paramètres → Impôts** affiche les deux cartes côte à côte, avec le taux actuellement appliqué. Si tes chiffres ont l'air trop beaux, c'est la première page à ouvrir. --- # Taux par page Kindle Unlimited Ce que paie Kindle Unlimited, ce qu'est vraiment une « page lue », d'où vient le taux, et comment lire notre page de taux gratuite. URL: https://trueroyalties.com/docs/metrics/kindle-unlimited-page-rates Kindle Unlimited ne te paie pas à l'exemplaire. Il te paie à la **page lue** — et le montant change chaque mois. Nous publions tout l'historique sur une page gratuite : [Taux par page Kindle Unlimited](/kindle-unlimited-page-rates). ## D'abord : ce qu'est Kindle Unlimited Kindle Unlimited est l'abonnement de lecture d'Amazon. Les lecteurs paient un forfait mensuel et empruntent autant de livres inscrits qu'ils veulent, sans coût supplémentaire par livre. Comme le lecteur ne paie rien pour ton livre en particulier, il n'y a ni vente ni pourcentage de royalty. À la place : 1. Chaque mois, Amazon met de côté une cagnotte — le **KDP Select Global Fund**. 2. Toutes les pages lues du mois sont additionnées. 3. La cagnotte est divisée par les pages. Cela donne le **taux par page**. 4. Tu reçois ce taux × tes propres pages lues. Tu n'y participes que si ton ebook est dans **KDP Select** (exclusivité Amazon). Les brochés et les reliés n'en font jamais partie. ## Ce qu'est réellement une « page lue » Pas une page de ton broché, et pas un écran sur le téléphone de quelqu'un. Amazon convertit chaque livre dans une mesure standard appelée **KENP** — Kindle Edition Normalized Pages — pour qu'un livre en gros caractères ne puisse pas gagner plus qu'un livre normal pour le même texte. Deux choses surprennent la plupart des auteurs : - **Tu es payé pour les pages lues, pas pour les emprunts.** Un lecteur qui emprunte ton livre et s'arrête page 3 te rapporte trois pages. - **Chaque page compte une fois.** Relire la même page ne paie pas deux fois. Le nombre de KENP de ton livre est sur ta bibliothèque KDP. Il est généralement un peu supérieur au nombre de pages de ton broché. ## Pourquoi le taux change chaque mois La cagnotte est répartie entre les pages de tout le monde. Le taux **baisse** donc quand les lecteurs lisent plus que la cagnotte n'a grandi, et **monte** quand la cagnotte grandit plus vite que la lecture. Ni l'un ni l'autre n'est de ton ressort, et ni l'un ni l'autre ne dit quoi que ce soit sur la qualité de tes livres. Un mois où ton revenu KU a baissé alors que tes pages lues sont restées stables, c'est en général juste le taux. En pratique, le taux américain oscille depuis plusieurs années entre environ **0,0040 et 0,0050 $** la page — soit près de 25 % entre un bon et un mauvais mois. ## Ce qu'Amazon publie, et ce qu'il ne publie pas Une fois par mois, Amazon annonce **un** chiffre : la taille totale de la cagnotte, dans le monde. Il le publie sur le forum KDP Community, autour du 15 du mois suivant — tu peux lire chaque annonce toi-même : [Annonces du KDP Select Global Fund](https://www.kdpcommunity.com/s/all-announcements?language=en_US&forum=KDP%20Forum) C'est tout. Amazon n'a jamais publié : - le taux par page, - la répartition de la cagnotte entre les boutiques, - le moindre chiffre pour un marketplace donné. Donc tout taux KENP que tu as vu cité — n'importe où, y compris ici — est **calculé**, pas publié. ## Comment il est calculé C'est une division que tu peux faire toi-même, sur ton propre tableau de bord KDP : ``` taux = royalties Kindle Unlimited ÷ pages KENP lues ``` Fais-le pour une boutique, pour un mois, et tu as le taux de cette boutique. Plus le compte sur lequel tu le fais est gros, plus la réponse est précise, parce que KDP arrondit les royalties au centime. Si tu as un compte TrueRoyalties, tu n'as pas à le faire : ta [page KENP](/docs/app/kenp) fait la même division sur tes propres chiffres, boutique par boutique, pour que tu puisses confronter ton taux au taux publié. ## Chaque boutique paie dans sa propre devise Amazon paie une page lue sur amazon.de en euros, et une sur amazon.co.jp en yens. Un taux ne veut dire quelque chose qu'à côté de sa devise. | Boutique | Paie en | | --- | --- | | Amazon.com | USD | | Amazon.co.uk | GBP | | Amazon.de · .fr · .es · .it · .nl | EUR | | Amazon.co.jp | JPY | | Amazon.ca | CAD | | Amazon.com.au | AUD | | Amazon.in | INR | | Amazon.com.br | BRL | | Amazon.com.mx | MXN | La page de taux te permet aussi de lire le chiffre **pour 1 000 ou 10 000 pages** plutôt que par page. Rien ne change sauf l'échelle : un taux de 0,00470 $, c'est 4,70 $ pour 1 000 pages lues, ce qui est en général plus facile à projeter. Sur la page de taux, tu peux changer la devise d'affichage. Nous stockons toujours le chiffre dans la devise propre à la boutique et ne convertissons que pour l'affichage, au taux de change de la **fin du mois affiché** — le même mois se convertit donc toujours en le même nombre, quel que soit le moment où tu le regardes. Le Global Fund est l'exception à « chaque boutique sa devise » : Amazon annonce un montant mondial unique, en dollars. La page l'affiche dans la devise que tu choisis, convertie de la même façon, et le signale quand ce n'est pas de l'USD. ## Quand un mois devient définitif Amazon annonce la cagnotte d'un mois autour du **15 du mois suivant** — « autour », pas à date fixe, cela tombe donc parfois quelques jours avant ou après. Avant cela, personne ne connaît le taux : tout chiffre publié où que ce soit est une estimation. La page de taux intègre un nouveau mois toute seule, dans la semaine qui suit son apparition. Personne ne saisit ces nombres à la main, et il n'y a aucun mois où la page attend que quelqu'un la mette à jour. Sur la page de taux, ces mois sont marqués **EST** dans l'en-tête de colonne, pour que tu les distingues d'un coup d'œil. ## D'où viennent nos chiffres Aujourd'hui, ils viennent du registre public tenu par des trackers animés par des auteurs, recoupés avec une seconde série indépendante partout où il en existe une. Nous sommes en train de les remplacer par le même calcul, exécuté sur l'ensemble des comptes TrueRoyalties. Un marketplace ne bascule que lorsque suffisamment de comptes y contribuent pour que les royalties d'aucun auteur ne puissent être retrouvées à partir du chiffre publié. Chaque chiffre de la page indique lequel des deux il est. ## Ce que cela veut dire pour tes propres chiffres Tes royalties KENP dans TrueRoyalties ne sont **pas** estimées à partir de ces taux — ce sont les montants réels que KDP a déclarés pour ton compte. La page de taux est une référence de contexte et de projection, pas une entrée de ton tableau de bord. Elle explique en revanche une chose que tu remarqueras : ton mois le plus récent peut bouger légèrement après que tu l'as vu pour la première fois. KDP déclare les royalties Kindle Unlimited comme une estimation tant que le taux n'est pas arrêté, puis les fige, et TrueRoyalties relit ces mois pour toi.