Como funciona
De onde vem cada número — uma sessão capturada uma vez e lida pelos nossos próprios servidores para cada plataforma de venda, 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 | Uma sessão capturada uma vez, depois lida pelos nossos próprios servidores |
| Kobo Writing Life | Vendas na Kobo, leitura no Kobo Plus, descargas gratuitas | O mesmo: capturada uma vez, depois lida pelos nossos próprios servidores |
| Draft2Digital | Royalties de todas as lojas onde distribui | Extensão do navegador, a partir da sua própria sessão, uma vez por dia — a única plataforma ainda em transição para o modelo acima |
| Apple Books, Shopify, WooCommerce, Squarespace, ThriveCart, Fourthwall | Suas vendas em cada loja, título por título | Uma chave de API ou a autorização da própria loja, depois lida pelos nossos próprios servidores |
| Lojas da Amazon | Notas e avaliações escritas | A extensão do navegador, a partir 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 |
| Meta Ads | Gasto com anúncios no Facebook e no Instagram | API oficial da Meta, nos nossos servidores |
| TikTok Ads | Gasto com anúncios no TikTok | API oficial do TikTok 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 toda loja é lida a partir de uma sessão capturada, não de um navegador ao vivo
Nenhuma das plataformas que conectamos desse jeito — Amazon KDP, Kobo Writing Life e todas as lojas que vierem depois — publica API pública. Os relatórios delas ficam atrás de uma sessão, e reproduzir uma sessão emprestada da sua navegação do dia a dia significaria copiar cookies que você nunca pretendeu entregar — exatamente o padrão que um sistema de proteção de conta é feito para marcar como tentativa de invasão, na única conta da qual todo o seu negócio depende. Por isso essa é a arquitetura padrão para toda plataforma de venda que suportamos, não um design específico do KDP ou do Kobo: uma sessão só nossa, capturada uma vez, depois reproduzida pelos nossos servidores no ritmo dela — nunca um navegador que precisa ficar aberto.
Conectar pede essa sessão só nossa em vez de pegar emprestada a sua: abre-se uma janela com a página de login deles, você digita sua senha ali — nunca na extensão — e é esse login novo que capturamos. Sua sessão comum de navegação fica intocada. Dali em diante, nossos servidores reproduzem essa sessão capturada no ritmo deles, uma conta de cada vez, nunca como uma rajada de toda a frota. Reconecte a qualquer momento em Plataformas se uma sessão expirar.
Mais doze lojas já funcionam desse jeito, antes mesmo de lermos os dados delas. Barnes & Noble Press, ACX, Google Play Books e as demais capturam e guardam uma sessão assim que você conecta — veja a página Plataformas — então no dia em que começarmos a ler cada uma, já será esse mesmo modelo do lado do servidor desde o primeiro dia, sem nada para você reconectar ou refazer.
O Draft2Digital é a única plataforma ainda alcançando as outras. A sessão dele ainda não passou para esse modelo, então a extensão continua lendo os relatórios uma vez por dia, enquanto o Chrome estiver aberto e você permanecer logado em draft2digital.com — do mesmo jeito que KDP e Kobo funcionavam antes de migrarem.
Por que suas plataformas de anúncios não precisam de extensão
O Amazon Ads, o Meta Ads e o TikTok Ads têm uma API oficial. Você autoriza o acesso de leitura uma vez e nossos servidores leem seu gasto por ela. Nenhuma extensão entra nisso: seus números são atualizados quando você abre o TrueRoyalties, e uma vez por dia sozinhos.
O cálculo do lucro líquido
Esse é o único cálculo que precisa dos dois lados. Páginas lidas, 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 cada plataforma 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.