Como funciona
De onde vem cada número — a extensão para royalties do KDP, rankings e avaliações, a API do Amazon Ads para o gasto, e os cálculos por cima.
De onde vem cada número
| Fonte | O que traz | Como é lida |
|---|---|---|
| Amazon KDP | Royalties, unidades, páginas KENP lidas | Extensão do navegador, com a sua sessão do KDP |
| Lojas da Amazon | Best Sellers Rank e rankings de categoria, notas e avaliações escritas | A mesma extensão, do seu próprio navegador |
| Amazon Ads | Gasto com anúncios, vendas atribuídas a anúncios, royalties de KU vindos de anúncios | API oficial do Amazon Ads, nos nossos servidores |
| Seus smart links | Cliques, países, dispositivos | Nosso próprio redirecionamento — a Amazon não entra nisso |
Tudo fica guardado na sua conta, então o histórico permanece mesmo offline e o painel nunca precisa baixá-lo de novo.
Por que a extensão é necessária para o KDP
O KDP não tem API pública. Os relatórios dele são protegidos pela sua sessão da Amazon.
Reproduzir essa sessão a partir de um servidor significaria copiar seus cookies para um datacenter longe de onde você entrou — exatamente o padrão que os sistemas de proteção de conta da Amazon tratam como tentativa de invasão, na única conta da qual todo o seu negócio depende.
Por isso a leitura roda onde a sessão já mora: no seu navegador. A Amazon vê uma requisição normal vinda da sua própria máquina, e nenhuma credencial da Amazon chega até nós.
Por que o Amazon Ads não precisa de extensão
O Amazon Ads tem uma API oficial. Você autoriza o acesso de leitura uma vez e a sincronização roda no servidor conforme um agendamento — nada para deixar aberto.
O cálculo do lucro líquido
Esse é o único cálculo que precisa dos dois lados. Páginas lidas, rankings, avaliações e cliques são lidos e guardados como estão; o lucro líquido é o número que ninguém te entrega pronto.
Para cada dia, cada livro e cada marketplace:
- Os royalties são coletados na moeda em que a Amazon os pagou.
- O gasto com anúncios é coletado por campanha e depois atribuído ao livro que ele promove.
- Os dois são convertidos para sua moeda de relatório pela taxa da própria data.
- Suas alíquotas são aplicadas — IVA sobre o gasto com anúncios, retenção sobre os royalties.
- O que sobra é o lucro líquido.
Como cada etapa é guardada por dia, qualquer filtro que você aplique — um marketplace, um livro, um intervalo de datas, um formato — recalcula a partir dos mesmos dados base.
Quão atualizados são os dados
O TrueRoyalties sincroniza automaticamente, mas só pode estar tão atualizado quanto os próprios relatórios da Amazon:
- Royalties do KDP — o estimador que o TrueRoyalties lê é atualizado aproximadamente a cada 24 a 48 horas.
- Amazon Ads — atualizado diariamente, e os números ainda podem ser revisados por alguns dias.
Então uma venda feita hoje de manhã normalmente aparece amanhã, não em dez minutos. Veja Sincronização e atualização.
A exceção são os cliques dos smart links: eles passam pelo nosso próprio redirecionamento, então aparecem na hora. É o único número ao vivo do seu painel.