Sincronize suas plataformas
A página Plataformas — todas as suas plataformas numa grade, o que significa cada estado e como conectar uma com antecedência, antes mesmo de lermos ela.
Uma página para todas as plataformas
Plataformas, na barra lateral, é onde você conecta tudo aquilo em que vende e anuncia. Um cartão por plataforma: o logotipo, se está funcionando, e o único botão que importa naquele momento.

Busque pelo nome ou filtre por estado. Só são oferecidos os filtros que realmente mostrariam alguma coisa, então um filtro vazio nunca custa um clique.
O que significa cada estado
A faixa no topo do cartão é toda a resposta.

| Estado | O que significa | O que fazer |
|---|---|---|
| Atualizada | Conectada, e a última sincronização funcionou | Nada |
| Sincronizando | Uma sincronização está rodando agora | Aguarde — ela termina sozinha |
| Nunca sincronizada | Conectada, mas nenhuma sincronização deu certo ainda | Clique em Sincronizar agora |
| Precisa de você | Conectada, mas há contas de anúncios esperando confirmação. Nada é importado até isso acontecer | Abra Gerenciar e marque as contas que são suas |
| Dessincronizada | A última sincronização falhou, ou nada chega há mais de um dia | Clique em Sincronizar agora; se continuar falhando, reconecte |
| Precisa reconectar | A sessão capturada expirou, ou a plataforma recusou a chave de API que guardávamos | Clique em Reconectar para capturar uma nova sessão ou colar uma nova chave |
| Conectado ✓ — sincronizando em breve | Sua sessão está guardada, pronta para o dia em que a leitura dessa plataforma entrar no ar | Nada — você verá números no dia em que ela entrar no ar |
| Não conectada | Nós já suportamos essa plataforma, você ainda não conectou | Clique em Conectar |
| Em breve | Ainda não lemos essa plataforma, e ainda não dá para conectá-la | Nada por enquanto |
Dessincronizada nem sempre é um problema. O Draft2Digital só atualiza enquanto um navegador está aberto. Suas plataformas de anúncios atualizam quando você abre o TrueRoyalties e, no mais tardar, uma vez por dia sozinhas. O KDP, o Kobo, o ThriveCart, o Fourthwall, o Squarespace, o WooCommerce, a Shopify e a Apple Books atualizam no ritmo deles próprios, no servidor, independentemente disso. Voltar depois de um dia fora e ver laranja geralmente significa exatamente isso: seus números têm um dia, e a próxima sincronização resolve.
O que você pode conectar hoje
| Plataforma | O que ela traz | Como |
|---|---|---|
| Amazon KDP | Seus royalties, livro a livro e loja a loja | Um login único pela extensão do navegador — depois é lido diretamente pelos nossos servidores, sem precisar de navegador |
| Kobo Writing Life | Vendas na Kobo, leitura no Kobo Plus e os downloads gratuitos que nenhum extrato mostra | O mesmo login único, depois lido diretamente pelos nossos servidores, sem precisar de navegador |
| Draft2Digital | Royalties de todas as lojas para onde distribui — Apple Books, Kobo, Everand e as demais | A extensão do navegador e depois Conectar — continua lendo uma vez por dia enquanto o Chrome estiver rodando |
| ThriveCart | As vendas das suas próprias páginas de pagamento: cada pagamento, parcela e reembolso, produto a produto | Cole uma chave de API das configurações do ThriveCart — depois é lido diretamente pelos nossos servidores a cada 4 horas, sem precisar de navegador |
| Fourthwall | As vendas da sua loja Fourthwall — livros, produtos personalizados e produtos digitais — e as doações | Cole o usuário e a senha de API das configurações do Fourthwall — depois é lido diretamente pelos nossos servidores a cada 4 horas, sem precisar de navegador |
| Squarespace | As vendas da sua loja Squarespace, produto a produto, e as doações | Cole uma chave de API das configurações do Squarespace — depois é lido diretamente pelos nossos servidores a cada 4 horas, sem precisar de navegador |
| WooCommerce | As vendas da sua própria loja WooCommerce, produto a produto | Informe o endereço da sua loja e aprove um acesso somente leitura na sua loja — depois é lido diretamente pelos nossos servidores a cada 4 horas, sem precisar de navegador |
| Shopify | As vendas da sua loja Shopify, produto a produto | Crie um app para a sua loja no Dev Dashboard da Shopify e cole o Client ID e o secret dele — depois é lido diretamente pelos nossos servidores a cada 4 horas, sem precisar de navegador |
| Apple Books | Suas vendas na Apple Books, livro a livro e país a país, e os exemplares que você deu | Cole o token de acesso do Reporter que você gera no iTunes Connect — depois é lido diretamente pelos nossos servidores uma vez por dia, sem precisar de navegador |
| Amazon Ads | Gasto em Sponsored Products, Brands e Display | Autorize uma vez com sua conta Amazon |
| Meta Ads | Gasto em anúncios no Facebook e Instagram | Conecte com a Meta e confirme suas contas de anúncios |
| TikTok Ads | Gasto em anúncios no TikTok | Conecte com o TikTok e confirme seus anunciantes |
A Meta e o TikTok têm página própria no app, onde você decide quais contas de anúncios contam e a qual livro cada anúncio pertence. O cartão te leva até lá em vez de repetir esses controles.
ThriveCart
No ThriveCart, abra Settings, depois API & webhooks, depois API tokens, e crie um token. Cole-o na janela que abre quando você clica em Conectar. Verificamos o token com o ThriveCart antes de salvá-lo e depois importamos todo o seu histórico de vendas — alguns minutos numa conta grande.

Cada produto, bump, upsell e downsell que você vende vira um título em Livros. Como os números são contados:
- Os valores são os que o ThriveCart registra, antes das taxas do seu processador de pagamentos e de eventuais comissões de afiliados. Eles serão maiores do que o que chega à sua conta bancária.
- Um pagamento parcelado ou uma assinatura conta como uma venda. Cada parcela seguinte soma dinheiro, não mais um exemplar.
- Um reembolso é descontado no dia em que acontece. Um reembolso total também retira a venda.
- Compras de teste nunca são importadas.
O ThriveCart não informa onde o comprador mora, então essas vendas não ficam ligadas a nenhum país.
Fourthwall
No Fourthwall, abra Settings, depois For developers, depois Open API, e clique em Create API user. Copie o usuário e a senha exibidos — só um superadministrador da loja pode criá-los — e cole os dois na janela que abre quando você clica em Conectar. Verificamos os dados com o Fourthwall antes de salvá-los e depois importamos todo o seu histórico de pedidos.

Cada produto que você vende vira um título em Livros — produtos digitais como ebooks, os demais como livros impressos. Como os números são contados:
- Os valores são o seu lucro em cada produto: o que o comprador pagou, menos o desconto e o custo de produção que o Fourthwall cobra de você. Frete e impostos ficam de fora.
- Um produto que o Fourthwall envia sem custo de produção conta pelo preço cheio, e a página do Fourthwall no app avisa.
- Um pedido cancelado é retirado, e as doações concluídas são somadas.
- Taxas de pagamento, reembolsos parciais e pagamentos de assinaturas de membros não estão incluídos — a API do Fourthwall não os fornece.
- Vendas de cartões-presente e seus próprios pedidos de amostras nunca contam. Um cartão-presente conta quando um comprador o usa.
As vendas são datadas no dia em que o pedido foi feito (UTC) e não ficam ligadas a nenhum país.
Squarespace
No Squarespace, abra Configurações, depois Ferramentas de desenvolvedor, depois Chaves de API de desenvolvedor. Gere uma chave com Pedidos e Transações em somente leitura, copie-a na hora — ela só aparece uma vez — e cole-a na janela que abre quando você clica em Conectar. Verificamos com o Squarespace se a chave consegue ler seus pedidos antes de salvá-la e depois importamos todo o seu histórico de pedidos. Segundo a documentação do Squarespace, as chaves de API são oferecidas aos sites no plano Commerce Advanced.

Cada produto que você vende vira um título em Livros — produtos físicos como livros impressos, os demais como ebooks. Como os números são contados:
- Os valores são o que os compradores pagaram pelos seus produtos, depois dos descontos, sem impostos nem frete. As taxas de processamento de pagamento não são descontadas.
- O imposto incluído num preço é retirado, com base no imposto que o Squarespace registrou no pedido.
- Um reembolso retira a parte dele no pedido. Um reembolso total remove a venda; um parcial a mantém.
- Só contam pedidos pagos. Pedidos não pagos, cancelados e de teste ficam de fora, e um pagamento parcelado conta quando estiver totalmente pago.
- As doações são incluídas quando a chave consegue ler as transações; caso contrário, a página do Squarespace no app avisa que elas estão faltando.
- Vendas de cartões-presente e pedidos importados de outros canais de venda nunca contam. Um cartão-presente conta quando um comprador o usa.
As vendas são datadas no dia em que o pedido foi feito (UTC) e não ficam ligadas a nenhum país.
WooCommerce
Entre no WordPress como administrador, depois clique em Conectar e informe o endereço da sua loja. Enviamos você para a sua própria loja para aprovar um acesso somente leitura — nada para criar à mão, nenhuma chave para copiar. Assim que a sua loja confirma o acesso, importamos todo o seu histórico de pedidos.

Cada produto que você vende vira um título em Livros — produtos baixáveis e virtuais como ebooks, os demais como livros impressos. Como os números são contados:
- Os valores são o que os compradores pagaram pelos seus produtos, depois dos cupons, sem impostos nem frete. As taxas de processamento de pagamento não são descontadas.
- Um reembolso sai da linha que ele reembolsa. Reembolse um livro de dois, e uma unidade e o preço dela saem desse livro. Um reembolso de um valor sem produtos indicados é dividido entre os produtos do pedido.
- Só contam pedidos pagos. Pedidos pendentes, aguardando (uma transferência ainda não recebida), cancelados e com falha ficam de fora, e um pedido que você move para a lixeira sai dos seus números na sincronização seguinte.
- Vendas de cartões-presente nunca contam. Um cartão-presente conta quando um comprador o usa.
As vendas são datadas no dia em que o pedido foi feito (UTC) e não ficam ligadas a nenhum país. Sua loja precisa ter os links permanentes «bonitos» do WordPress ativados.
Shopify
A Shopify é lida por meio de um pequeno app que você cria para a sua própria loja, uma única vez:
- No Dev Dashboard da Shopify, crie um app.
- Dê à versão dele os acessos read_orders e read_products, publique a versão e depois instale o app na sua loja.
- Nas configurações do app, copie o Client ID e o Client secret.
Clique em Conectar, informe o endereço da sua loja — o que termina em .myshopify.com, mesmo que a sua loja use um domínio próprio — e cole os dois valores. Verificamos com a Shopify que o app consegue ler seus pedidos e seus produtos antes de salvar qualquer coisa, e depois importamos o seu histórico de pedidos.

A Shopify só mostra a um app os pedidos dos últimos 60 dias, a menos que ele também tenha o acesso read_all_orders, que a Shopify concede mediante pedido. Sem ele, a página da Shopify no app avisa você; assim que ele é concedido, suas vendas mais antigas são importadas automaticamente.
Cada produto que você vende vira um título em Livros — os produtos enviados como livros impressos, o resto como ebooks. É assim que os números são contados:
- Os valores são o que os compradores pagaram pelos seus produtos, depois de todos os descontos, sem impostos nem frete — também quando seus preços incluem imposto. As taxas de processamento de pagamento não são descontadas.
- Um reembolso retira o que reembolsa. Reembolse um de dois livros e uma unidade e o preço dela saem desse livro. Um reembolso digitado como valor, sem produto escolhido, sai dos produtos do pedido de acordo com a parte de cada um.
- Só contam pedidos pagos. Pedidos pendentes (um pagamento manual ainda não recebido), cancelados, de teste e totalmente reembolsados ficam de fora.
- Um ebook e um livro impresso são dois livros, mesmo quando você os vende como duas variantes de um mesmo produto.
- Vendas de cartões-presente nunca contam. Um cartão-presente conta quando um comprador o usa.
As vendas são datadas no dia em que a Shopify processou o pedido (UTC), na moeda da sua loja, e não ficam vinculadas a nenhum país.
Apple Books
No iTunes Connect, abra a página de relatórios em Sales and Trends, gere um token de acesso do Reporter e cole-o na janela que abre quando você clica em Conectar. Perguntamos à Apple se o token abre a sua conta de editora antes de salvar qualquer coisa e depois importamos o ano inteiro de relatórios diários que a Apple mantém.
Duas coisas sobre esse token, as duas são regras da Apple: ele expira em 180 dias e existe um por conta Apple — gerar outro em qualquer lugar mata o nosso na hora. O cartão avisa antes de expirar e mostra Reconectar assim que a Apple o recusa.
Cada livro que a Apple vende vira um título em Livros, no formato que a Apple informa (ebook ou audiolivro). É assim que os números são contados:
- Os valores são a estimativa da própria Apple do que você vai receber — o guia dela diz isso —, por livro e por país, depois da comissão da Apple. Impostos e retenções não estão nessas linhas, e o demonstrativo financeiro mensal definitivo da Apple ainda não é lido.
- Downloads gratuitos nunca são vendas. Eles aparecem nas suas unidades gratuitas, nunca nos seus royalties.
- Uma correção sai no dia em que a Apple a publica. A Apple pode corrigir um dia depois; cada passagem relê os últimos dias justamente por isso.
- Um dia sem vendas é um dia, não uma sincronização com falha.
As vendas são datadas no dia do relatório da Apple (UTC) e levam o país da compra, então aparecem no mapa e em Marketplaces. A Apple mantém 365 dias de relatórios diários: nada mais antigo pode ser importado.
Sincronizar agora
Sincronizar agora pede uma atualização imediata em vez de esperar pela automática. Duas coisas que vale a pena saber:
- A Amazon Ads aceita uma sincronização manual por hora. Depois disso, o botão avisa quando a próxima vai ser aceita, em vez de fingir.
- Uma sincronização não é instantânea. A Amazon gera o relatório no ritmo dela, então uma atualização geralmente demora alguns minutos para chegar. Não há nada para clicar enquanto você espera.
Você raramente vai precisar disso — tudo se atualiza sozinho, como descrito em Sincronização e atualização dos dados.
Gerenciando uma plataforma conectada

Toda plataforma que você pode conectar hoje tem sua própria página no app — clique no cartão para abrir. Lá você pode:
- Desconectar — para de ler e remove a sessão ou a chave que guardamos, mas mantém seus números. Útil se você está trocando de computador ou de conta Amazon.
- Apagar seus dados — desconecta e apaga tudo o que essa plataforma já contribuiu, de forma permanente. Use se você conectou a conta errada.
Plataformas que você já pode conectar antecipadamente
Há mais dezessete plataformas já conectáveis, antes mesmo de começarmos a lê-las. Nada entra nos seus números ainda — o cartão mostra Conectado ✓ — sincronizando em breve — mas no dia em que a leitura de uma plataforma entrar no ar, ela começa a importar sem nenhuma ação a mais da sua parte. Você pode desconectar a qualquer momento nesse meio-tempo.
O que Conectar faz depende da plataforma:
| Plataformas | O que acontece quando você clica em Conectar |
|---|---|
| Barnes & Noble Press, ACX, PublishDrive, IngramSpark, Ingram Lightning Source, Voices, Google Play Books, StreetLib, Tolino Media, Authors Republic, Bookmundo, Spotify for Authors, BookBub Ads, Launch Reads, BookReverb | Uma janela de login abre pela extensão do navegador. Guardamos uma sessão somente leitura, do mesmo jeito que com o KDP e o Kobo |
| BookFunnel | Uma janela pede a chave de API que você cria nas configurações dessa plataforma e mostra onde encontrá-la — a mesma janela do ThriveCart. Verificamos a chave com a plataforma antes de salvá-la. Não precisa da extensão |
| Amazon Attribution | Nada para digitar: usa a sua conexão do Amazon Ads, então conecte ela primeiro. Seus resultados aparecem depois em Amazon Attribution |
Três limites para conhecer antes de tentar:
- A API da BookFunnel só existe nos planos Bestseller e Publisher, e o suporte da BookFunnel precisa ativá-la na sua conta.
- O Amazon Attribution não é oferecido na Amazon Austrália nem no Japão. Se todas as suas contas do Amazon Ads estiverem lá, o cartão avisa.
- O Square mostra Em breve até a conexão dele ser liberada. A partir daí, as vendas dele são lidas diretamente pelos nossos servidores a cada 4 horas, e um reembolso sai no dia em que é feito.
Uma plataforma — Smashwords — continua marcada como Em breve: ainda não é conectável mesmo, sem nada para clicar.