Ajuda/Solução de problemas

Solução de problemas

Os sintomas comuns — extensão não detectada, importação travada, sem gasto com anúncios, avaliações faltando — e a solução de cada um.

"Extensão não detectada"

O Chrome não injeta uma extensão recém-instalada em abas que já estavam abertas.

  1. Recarregue a aba do TrueRoyalties.
  2. Confira se a extensão está ativada em chrome://extensions.
  3. Clique no ícone da extensão — o popup deve dizer que ela está conectada.

A importação nunca termina

Quase sempre é uma sessão do KDP expirada.

  1. Abra o KDP e faça login.
  2. Volte ao TrueRoyalties — a importação continua sozinha.

A primeira importação cobre todo o seu histórico, então em um catálogo grande vários minutos é normal. Deixe a aba aberta.

O gasto com anúncios está zerado ou baixo demais

  • O Amazon Ads não está conectado — conecte em Configurações → Conexões.
  • A primeira importação ainda está rodando — o preenchimento do histórico de anúncios volta no tempo e pode levar horas. Os períodos antigos vão sendo preenchidos aos poucos.
  • Visão filtrada — uma seleção de distribuição sem a venda da Amazon não tem gasto com anúncios, por definição.

"O gasto do Amazon Ads pode estar desatualizado"

Deixe a aba aberta. O gasto com anúncios se atualiza sozinho assim que a última sincronização bem-sucedida tem mais de 2 horas, e a Amazon leva alguns minutos para montar o relatório — não há nada para clicar.

A única exceção é uma mensagem dizendo que a Amazon precisa que você reconecte: essa autorização expirou ou foi revogada do lado da Amazon, e só você pode renová-la, em Configurações → Conexões.

Nada atualizou desde ontem

Muitas vezes está certo: o estimador do KDP só atualiza a cada 24 a 48 horas. Veja Sincronização e atualização.

Para forçar uma checagem: Configurações → Conexões → Sincronizar agora.

Aviso de "Dados parciais"

O período que você pediu tem mais linhas do que dá para ler de uma vez, então os números mostrados estão incompletos. Reduza o período. Se continuar aparecendo em períodos comuns, nos avise — não deveria acontecer.

A configuração está bloqueada com uma mensagem sobre minha conta do KDP

Uma conta do KDP corresponde a uma conta do TrueRoyalties, permanentemente. As quatro mensagens possíveis, e o que significam, estão em Royalties do KDP.

Faltam as avaliações de um país

A Amazon exige uma sessão para mostrar as páginas de avaliações, então uma loja em que você não está logado não pode ser lida. Faça login naquela loja da Amazon e o TrueRoyalties passa a captar automaticamente.

Um livro está faltando

Confira o período primeiro — um título sem vendas no período não aparece. Se ele tem vendas e mesmo assim some, rode uma sincronização manual e depois fale com a gente.

Três explicações normais antes de ser um bug:

  • As pré-visualizações de bots são filtradas. Facebook, Slack e WhatsApp abrem seu link sozinhos para montar o cartão de pré-visualização. Eles são contados à parte, em Bots filtrados, de propósito.
  • Cliques e visitantes únicos são números diferentes. Um visitante é contado uma vez por dia; três visitas numa tarde são três cliques e um visitante.
  • Uma VPN muda o leitor de lugar. Quem navega por uma VPN americana parece americano para qualquer site, então é mandado para a amazon.com.

Os cliques em si aparecem na hora — não há nenhum atraso de agregação para esperar.

Se a página é construída com JavaScript — Wix, Squarespace, Webflow, Notion, X, Instagram, TikTok — nossos servidores recebem uma casca vazia, então seu token pode estar na tela e invisível para nós.

Instale a extensão e clique em Permitir quando ela pedir para ler páginas; ela abre a página no seu próprio navegador e relata o que viu. Para um site, um registro DNS TXT é a opção mais robusta e não precisa de extensão nenhuma.

Veja Sua página verificada.

O mapa-múndi mostra terra, mas nenhum país nem cor

O mapa desenha o relevo e para por aí: sem fronteiras, sem nomes de países, nenhuma das suas lojas colorida.

Quase sempre é uma extensão do navegador. O mapa monta o detalhe em um worker em segundo plano, e uma extensão que mexe em como uma página inicia um deles — algumas extensões de privacidade, bloqueio de anúncios e senhas fazem isso — o interrompe sem nenhuma mensagem de erro.

Abra a página em uma janela anônima, onde as extensões ficam desligadas por padrão:

  • O mapa funciona → uma extensão é a causa. Desligue as suas uma por uma neste site para descobrir qual é.
  • O mapa continua vazio → nos avise, com um print do Console do navegador (clique direito → Inspecionar → Console). É o único lugar onde o erro real aparece.

Não consigo entrar

A página de login abre no formulário de senha. Se você nunca definiu uma — as contas criadas com código de uso único não têm — escolha Entrar com código OTP e mandamos um código novo por e-mail.

Ainda travado

Fale com o suporte informando a página, o período e o que você esperava ver.