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. Cada plataforma se atualiza no seu próprio ritmo.
KDP e Kobo Writing Life — lidos diretamente pelos próprios servidores do TrueRoyalties, usando a sessão que você capturou ao conectar. Nenhum navegador ou aba do app precisa estar aberto:
| Gatilho | Quando |
|---|---|
| Automático | KDP aproximadamente a cada hora, Kobo uma vez por dia — cada conta no seu próprio horário, ancorado no momento em que foi conectada |
| Automático — Apple Books e suas próprias lojas | Apple Books uma vez por dia; Shopify, WooCommerce, Squarespace, ThriveCart e Fourthwall a cada 4 horas — lidos pelos nossos servidores com a chave ou a autorização que você deu ao conectar |
| Sincronizar agora | Sempre que você clicar, em Plataformas |
Draft2Digital — ainda lido pela extensão, a partir do seu próprio navegador:
| Gatilho | Quando |
|---|---|
| Alarme em segundo plano | Uma vez por dia, enquanto o Chrome estiver aberto e você permanecer logado em draft2digital.com |
| Sincronizar agora | Sempre que você clicar, em Plataformas |
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 |
| Meta Ads | Também lido da API da Meta, sem extensão: quando você abre a página dele no TrueRoyalties, se a última sincronização bem-sucedida tiver mais de 2 horas |
| Automático — uma vez por dia | Mesmo que você nunca abra o TrueRoyalties: cada conta de anúncios é sincronizada uma vez por dia pelos nossos servidores, no horário dela |
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 laranja, 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 Plataformas 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
Plataformas → Sincronizar agora. Isso ignora o ritmo normal e pede uma atualização na hora.
Requisitos: a plataforma conectada, com uma sessão capturada que ainda não expirou (KDP, Kobo) ou, no caso do Draft2Digital, a extensão ativada e uma sessão de navegador ativa. Se o botão não fizer nada, veja Solução de problemas.