Extensão do Chrome
O TrueRoyalties Connector conecta suas plataformas capturando a sessão única que o TrueRoyalties passa a ler dos próprios servidores — hoje, o Draft2Digital ainda depende do navegador, mas está a caminho de deixar de depender.
O que é
TrueRoyalties Connector é a pequena extensão de navegador que conecta suas plataformas. Nenhuma delas — KDP, Kobo Writing Life, Draft2Digital ou as lojas que forem se juntando — tem API pública, então ela é o único jeito de entrar. Para todas elas o objetivo é o mesmo: capturar uma sessão única que os nossos próprios servidores passam a ler dali em diante, no ritmo deles, sem precisar de navegador depois disso. KDP e Kobo já funcionam assim, e toda nova loja conectável captura sua sessão desde já, pelo mesmo motivo. O Draft2Digital é a exceção de hoje — a leitura dele ainda não passou para o lado do servidor, então a extensão continua lendo os relatórios a partir do seu navegador, uma vez por dia.
Instale pela Chrome Web Store. Ela funciona no Chrome, Edge, Brave e Arc. Outros navegadores ainda não são suportados.
No Edge, a Chrome Web Store pede primeiro para permitir extensões de outras lojas — aceite e adicione a extensão.
O que ela faz
- Conecta Amazon KDP e Kobo Writing Life com um login único — depois disso, o TrueRoyalties os lê diretamente dos próprios servidores, na frequência deles, esteja ou não seu navegador aberto. Veja Sincronização e atualização dos dados.
- Captura o mesmo tipo de sessão única para qualquer outra loja conectável que você conectar antecipadamente — Barnes & Noble Press, ACX e as demais — para que cada uma já esteja pronta para ser lida pelo servidor no dia em que começarmos a lê-la. Veja a página Plataformas.
- Lê seus relatórios do Draft2Digital uma vez por dia, enquanto o Chrome estiver aberto e você permanecer logado em draft2digital.com — a única plataforma ainda esperando para passar para o lado do servidor.
- Envia tudo para a sua conta do TrueRoyalties e copia as capas dos seus livros para o app poder exibi-las.
- Lê suas avaliações de clientes da Amazon (veja Avaliações).
- Mostra uma notificação do navegador a cada nova venda ou reembolso, se você ativar — detectado nos nossos servidores, exibido pelo seu navegador.
- Verifica uma página que você indicou procurando seu token de verificação, quando nossos servidores não conseguem lê-la (veja Sua página verificada).
O que ela não pode fazer
- Ela nunca vê sua senha. Conectar o KDP ou o Kobo abre a página de login da própria Amazon ou do próprio Kobo — você digita sua senha ali, nunca na extensão, e nem a extensão nem o TrueRoyalties a veem em nenhum momento.
- Ela nunca grava nada em nenhuma plataforma — nenhuma mudança de preço, nenhuma edição de campanha.
Por padrão ela roda na Amazon (KDP e lojas), no Kobo Writing Life, no Draft2Digital e no TrueRoyalties. A lista de permissões é propositalmente curta: armazenamento, alarmes, notificações e os cabeçalhos de requisição de que ela precisa.
Um extra opcional. Verificar um link em um site feito em JavaScript (Wix, Squarespace, X, Instagram, TikTok) exige abrir aquela página no seu navegador, o que precisa de uma permissão mais ampla de “ler as páginas que você visita”. Ela é pedida uma única vez, só quando você adiciona um link desses, e é você quem aperta Permitir. Se recusar, todo o resto funciona exatamente igual. Veja Privacidade.
Conferir se está conectada
Clique no ícone da extensão. O popup mostra se ela está conectada à sua conta, com atalhos para o app e para Plataformas, além dos interruptores de notificação de nova venda e nova avaliação.
Dentro do app, Plataformas mostra o status de sincronização de cada plataforma, mais um botão Sincronizar agora.
Para continuar funcionando
| Sintoma | Solução |
|---|---|
| “Extensão não detectada” em uma página que já estava aberta | Recarregue a aba — o Chrome não injeta a extensão em abas abertas antes da instalação |
| Uma plataforma mostra “Reconexão necessária” | A sessão capturada expirou — abra Plataformas e conecte de novo |
| O Draft2Digital para de atualizar | Entre de novo em draft2digital.com no seu navegador; a passagem diária precisa de uma sessão ativa ali |
| Nada sincroniza | Confira se a extensão está ativada em chrome://extensions |
Mais em Solução de problemas.
Atualizações
O Chrome atualiza a extensão sozinho. Você nunca precisa reinstalá-la.