Conecte seus dados/Sincronize suas plataformas

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.

O cabeçalho da página Plataformas com a busca e os filtros de estado, acima da grade "Onde você ganha" com os cartões da Amazon KDP, Draft2Digital, Kobo Writing Life e Barnes & Noble Press

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.

Oito cartões de plataforma em duas fileiras: Não conectada com um botão Conectar para WooCommerce, Squarespace, ThriveCart, Fourthwall, Ingram Lightning Source e StreetLib, e Em breve sem botão para Square e Smashwords

EstadoO que significaO que fazer
AtualizadaConectada, e a última sincronização funcionouNada
SincronizandoUma sincronização está rodando agoraAguarde — ela termina sozinha
Nunca sincronizadaConectada, mas nenhuma sincronização deu certo aindaClique em Sincronizar agora
Precisa de vocêConectada, mas há contas de anúncios esperando confirmação. Nada é importado até isso acontecerAbra Gerenciar e marque as contas que são suas
DessincronizadaA última sincronização falhou, ou nada chega há mais de um diaClique em Sincronizar agora; se continuar falhando, reconecte
Precisa reconectarA sessão capturada expirou, ou a plataforma recusou a chave de API que guardávamosClique em Reconectar para capturar uma nova sessão ou colar uma nova chave
Conectado ✓ — sincronizando em breveSua sessão está guardada, pronta para o dia em que a leitura dessa plataforma entrar no arNada — você verá números no dia em que ela entrar no ar
Não conectadaNós já suportamos essa plataforma, você ainda não conectouClique em Conectar
Em breveAinda não lemos essa plataforma, e ainda não dá para conectá-laNada 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

PlataformaO que ela trazComo
Amazon KDPSeus royalties, livro a livro e loja a lojaUm login único pela extensão do navegador — depois é lido diretamente pelos nossos servidores, sem precisar de navegador
Kobo Writing LifeVendas na Kobo, leitura no Kobo Plus e os downloads gratuitos que nenhum extrato mostraO mesmo login único, depois lido diretamente pelos nossos servidores, sem precisar de navegador
Draft2DigitalRoyalties de todas as lojas para onde distribui — Apple Books, Kobo, Everand e as demaisA extensão do navegador e depois Conectar — continua lendo uma vez por dia enquanto o Chrome estiver rodando
ThriveCartAs vendas das suas próprias páginas de pagamento: cada pagamento, parcela e reembolso, produto a produtoCole uma chave de API das configurações do ThriveCart — depois é lido diretamente pelos nossos servidores a cada 4 horas, sem precisar de navegador
FourthwallAs vendas da sua loja Fourthwall — livros, produtos personalizados e produtos digitais — e as doaçõesCole 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
SquarespaceAs vendas da sua loja Squarespace, produto a produto, e as doaçõesCole uma chave de API das configurações do Squarespace — depois é lido diretamente pelos nossos servidores a cada 4 horas, sem precisar de navegador
WooCommerceAs vendas da sua própria loja WooCommerce, produto a produtoInforme 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
ShopifyAs vendas da sua loja Shopify, produto a produtoCrie 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 BooksSuas vendas na Apple Books, livro a livro e país a país, e os exemplares que você deuCole 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 AdsGasto em Sponsored Products, Brands e DisplayAutorize uma vez com sua conta Amazon
Meta AdsGasto em anúncios no Facebook e InstagramConecte com a Meta e confirme suas contas de anúncios
TikTok AdsGasto em anúncios no TikTokConecte 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.

A janela de chave de API do ThriveCart: onde encontrar a chave no ThriveCart, um link para abrir o ThriveCart, o campo da chave de API e o botão Conectar

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.

A janela de conexão do Fourthwall: onde criar o usuário de API no Fourthwall, um link para abrir o Fourthwall, os campos de usuário e senha de API e o botão Conectar

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.

A janela de chave de API do Squarespace: onde criar a chave no Squarespace, um link para abrir o Squarespace, o campo da chave de API e o botão Conectar

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.

A janela de conexão do WooCommerce: por que entrar primeiro no WordPress, o campo do endereço da loja e o botão Conectar

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:

  1. No Dev Dashboard da Shopify, crie um app.
  2. Dê à versão dele os acessos read_orders e read_products, publique a versão e depois instale o app na sua loja.
  3. 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 janela de conexão da Shopify: onde criar o app, um link para abrir a Shopify, os campos de endereço da loja, Client ID e Client secret e o botão Conectar

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

Três cartões de plataformas de anúncios marcados Atualizada, cada um com a hora da última sincronização e um link Gerenciar para a própria página, ao lado de um cartão BookBub Ads marcado Não 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:

PlataformasO 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, BookReverbUma 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
BookFunnelUma 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 AttributionNada 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.