Sincronização e atualização
Quando o TrueRoyalties atualiza seus dados, quão atualizados são os próprios relatórios da Amazon e como forçar uma sincronização.
Quando as sincronizações acontecem
Você nunca precisa disparar uma sincronização. Seus royalties do KDP e seu gasto no Amazon Ads vêm de dois lugares diferentes, então eles se atualizam em ritmos próprios.
Royalties do KDP — lidos pela extensão:
| Gatilho | Quando |
|---|---|
| App aberto | Enquanto uma aba do TrueRoyalties estiver visível, e no máximo a cada 15 minutos |
| Alarme em segundo plano | A cada 15 minutos, mesmo com o app fechado — só se os alertas de nova venda estiverem ligados |
| Sincronizar agora | Sempre que você clicar, em Configurações → Conexões |
Gasto do Amazon Ads — lido da API da Amazon, sem extensão:
| Gatilho | Quando |
|---|---|
| App aberto | Qualquer aba do TrueRoyalties, em primeiro plano ou não, quando a última sincronização bem-sucedida tiver mais de 2 horas |
| Reconexão | Na hora, sem esperar as 2 horas — você reconecta porque algo estava errado |
| Reparo automático | A cada 15 minutos retomamos qualquer sincronização que parou no meio |
A Amazon gera o relatório de anúncios no tempo dela, então uma atualização costuma levar alguns minutos para chegar. Nada para apertar enquanto espera.
Uma sincronização só roda se realmente estiver na hora, então abrir o app dez vezes seguidas não bate na Amazon dez vezes.
Quando o gasto com anúncios parece desatualizado
O painel avisa, em âmbar, acima dos seus números. Em quase todos os casos se resolve sozinho — deixe a aba aberta e ele atualiza.
Um caso precisa de você: se disser que a Amazon quer que você reconecte, sua autorização expirou ou foi revogada do lado da Amazon. Vá em Configurações → Conexões e conecte o Amazon Ads de novo — uma sincronização começa assim que você voltar. Nada mais desta lista exige um clique.
Quão atualizados são os dados da Amazon
Essa é a parte que mais surpreende. O TrueRoyalties nunca pode estar mais atualizado que o relatório que ele lê:
- Royalties do KDP — o estimador se atualiza aproximadamente a cada 24 a 48 horas.
- Pedidos do KDP — geralmente em até 24 horas.
- Kindle Unlimited — as páginas lidas aparecem rápido, mas a taxa de KU de um mês só é definida pela Amazon no meio do mês seguinte.
- Amazon Ads — diariamente, e a Amazon continua revisando os últimos dias.
Então as vendas de hoje normalmente aparecem amanhã. Um “Sincronizar agora” não fará a Amazon publicar um número que ela ainda não publicou.
Por que os últimos 60 dias são relidos
A Amazon revisa números recentes — devoluções, reembolsos, atribuições corrigidas. Cada sincronização relê os últimos 60 dias para que seu histórico reflita essas correções. Os dados mais antigos já são finais e não são tocados.
Pedidos de anúncios “aguardando envio”
Na página de Pedidos você pode ver um aviso sobre pedidos gerados por anúncios que estão aguardando envio. A Amazon registra uma venda impressa quando ela é despachada, não quando é pedida, então pedidos impressos atribuídos a anúncios aparecem um ou dois dias depois. Nada se perde.
Forçar uma sincronização
Configurações → Conexões → Sincronizar agora. Isso ignora o intervalo de 15 minutos.
Requisitos: a extensão ativada e uma sessão do KDP ativa. Se o botão não fizer nada, veja Solução de problemas.