KappS Base de conhecimento · Blog

Configurando IAP, AdMob e assinaturas no Google Play em 2026

Blog Tutorial

A maioria dos desenvolvedores perde dinheiro não porque o app é ruim, mas porque a monetização está configurada errado. Uma conta de comerciante ausente, um plano base de assinatura mal configurado ou um SDK do AdMob sem o fluxo de consentimento correto podem desligar a receita silenciosamente por semanas. Este tutorial percorre a configuração completa de monetização do Google Play — compras dentro do app, assinaturas e AdMob — do jeito que deve ser feito em 2026.

Ao final, você terá um fluxo de pagamento funcionando: produtos definidos no Play Console, a Play Billing Library integrada ao seu app, unidades de anúncio veiculando anúncios reais e um fluxo de teste que comprova que tudo funciona antes de o primeiro usuário pagar você.


Etapa 1: complete sua conta de comerciante antes de qualquer outra coisa

O motivo nº 1 de falha dos apps monetizados é um perfil de pagamentos incompleto. O Play Console não permite criar produtos, e seu app não ganha um centavo, até que sua conta de comerciante esteja totalmente verificada. Isso inclui:

  • Informações fiscais: Seu formulário W-8BEN (fora dos EUA) ou W-9 (EUA) preenchido e — para desenvolvedores fora dos EUA — seu PIN fiscal dos EUA solicitado. Seu primeiro repasse fica retido até o PIN chegar pelo correio, o que leva de 2 a 4 semanas.
  • Conta bancária: Uma conta bancária válida para repasse em um país compatível, com o nome legal exatamente igual ao da sua conta de desenvolvedor.
  • Verificação de identidade: Documentos pessoais ou da organização que correspondam ao nome do titular da conta.

Dica: Conclua a configuração fiscal e bancária no mesmo dia em que criar sua conta de desenvolvedor. Não espere o app ficar pronto — a verificação do perfil de pagamento não tem caminho "acelerado" e bloqueia totalmente a criação de produtos.


Passo 2: crie seus produtos no Play Console

Depois que a conta de comerciante for verificada, abra Monetizar → Produtos no Play Console e crie dois tipos de itens:

Produtos dentro do app (pagamento único)

  • O ID do produto deve estar em minúsculas e se torna permanente — você não pode excluí-lo depois, apenas desativá-lo. Escolha com cuidado, por exemplo coin_pack_100.
  • Defina o preço, ou deixe em branco e precifique por país no modelo de preços para ter mais controle.

Assinaturas

As assinaturas em 2026 usam a estrutura plano base + oferta, que substituiu o antigo modelo de "assinatura com fases":

  • Crie um plano base por faixa de preço — por exemplo, mensal, anual. Um plano base não pode ser editado após a criação; em vez disso, você o clona.
  • Vincule ofertas aos planos base para testes gratuitos (trial_7d), preços introdutórios ou descontos de reativação. As ofertas podem ser editadas depois; os planos base, não.
  • Defina o período de tolerância para renovação (padrão de 7 dias) e ative o Account Hold para que os usuários mantenham o acesso durante as novas tentativas de pagamento.
  • Em 2026, o Google também exige que você declare claramente os mecanismos de cancelamento de assinatura na ficha do app — faça isso na seção de conteúdo do app.

Etapa 3: integre a Play Billing Library

Seu app conversa com o Google Play por meio da Play Billing Library. A base para 2026 é a Billing Library 7.x, que exige um targetSdk atualizado e APIs Kotlin-first. O fluxo principal:

  1. Adicione a dependência ao seu build.gradle: com.android.billingclient:billing-ktx:7.x.x
  2. Conecte um BillingClient com PendingPurchasesParams ativado — necessário para recuperar compras feitas enquanto o app estava fechado ou em outro dispositivo.
  3. Consulte produtos com queryProductDetailsAsync() usando seus IDs de produto.
  4. Inicie a compra com launchBillingFlow(), passando o BillingFlowParams.
  5. Trate o resultado da compra em onPurchasesUpdated(), confirme cada compra com acknowledgePurchase() — compras não confirmadas são reembolsadas automaticamente após 3 dias.
  6. Para assinaturas, escute onPriceChangeConfirmation() para aumentos de preço e use queryPurchasesAsync() a cada abertura do app para restaurar os direitos.

Não crie sua própria camada de pagamento sobre o faturamento do Google Play — a política exige que todos os bens digitais usem o sistema de faturamento do Play, e contorná-lo (links de pagamento externos, SDKs próprios) é um dos principais gatilhos de suspensão em 2026.


Etapa 4: Adicione AdMob da forma correta

Os anúncios são a segunda fonte de receita, e a integração do AdMob tem três partes inegociáveis em 2026:

  • SDK + manifesto: adicione o SDK do AdMob, configure seu AdMob App ID no AndroidManifest.xml e crie unidades de anúncio no console do AdMob. Banner, intersticial, premiado e nativo precisam cada um do seu próprio ID de unidade.
  • Manifesto de privacidade e Segurança dos dados: o SDK do AdMob coleta identificadores, então o formulário de Segurança dos dados do seu app precisa declará-lo, e o SDK deve constar na auditoria do seu manifesto de privacidade. Apps com SDKs de anúncios não declarados estão sujeitos a remoção forçada em 2026 — isso agora é automatizado.
  • Consentimento: Se você exibe anúncios no EEE/Reino Unido, precisa usar uma plataforma de gestão de consentimento certificada ou o SDK UMP (User Messaging Platform) do Google, e repassar o consentimento ao AdMob antes de carregar anúncios. Exibir anúncios personalizados sem consentimento válido é uma violação direta de política.

Testar é grátis: Use IDs de bloco de anúncios de teste (ca-app-pub-3940256099942544/6300978111 para banner etc.) durante o desenvolvimento — anúncios reais em um dispositivo de teste podem causar o banimento da conta do AdMob por tráfego inválido.


Passo 5: conecte seu backend (validação de recibo)

Para qualquer app além do casual, valide as compras no lado do servidor. Use a Google Play Developer API (purchases.products.get / purchases.subscriptions.get) para confirmar o estado da compra no seu backend e use as Real-time Developer Notifications (RTDN) via Pub/Sub para acompanhar eventos de assinatura — renovações, cancelamentos e mudanças de preço — sem polling.

É também aqui que você concede os direitos: libera recursos premium, atualiza o status sem anúncios do usuário ou estende o acesso à assinatura no seu próprio banco de dados. Nunca conceda direitos apenas com base em dados do lado do cliente — é trivial de falsificar.


Etapa 6: Teste tudo antes do lançamento

Código de monetização que funciona em produção é raro sem uma rodada de testes estruturada. Configure:

  • Teste de licença: Adicione contas de teste (até 20) em Configuração → Teste de licença — os testadores podem comprar com cartões de teste e nunca são cobrados.
  • Faixa de teste interno: Distribua o app para os seus testadores, depois compre todos os produtos, cancele uma assinatura, reinicie o app e confirme que os direitos são restaurados.
  • AdMob anúncios de teste: Ative o modo de teste e verifique se cada formato de anúncio é exibido corretamente.
  • Recuperação de compra: Desinstale o app no meio da compra, reinstale e confirme que a compra pendente é recuperada e reconhecida.

Armadilhas comuns de 2026 a evitar

  • Retenção do pagamento no primeiro repasse: Quase sempre é o PIN fiscal dos EUA ainda não recebido. Envie os formulários fiscais no dia em que você se cadastra, não no dia em que você fatura.
  • SDK de anúncios não declarado: o AdMob precisa estar no seu formulário de Segurança dos dados e no manifesto de privacidade antes do envio — correções retroativas disparam uma nova revisão completa.
  • Compras não reconhecidas: Falta de acknowledgePurchase() = reembolsos automáticos após 3 dias. Este é o "vazamento de receita" mais comum em novas integrações de cobrança.
  • Editar um plano base: Não é possível. Planeje mudanças de preço clonando o plano base e descontinuando o antigo, e sempre anuncie mudanças de preço com 30 dias de antecedência pelo Play Console.

Checklist final

  1. Conta de comerciante verificada: formulário fiscal + banco + identidade
  2. PIN fiscal dos EUA solicitado (desenvolvedores fora dos EUA)
  3. IDs de produto de IAP criados e com preço definido
  4. Planos base de assinatura + ofertas de teste configurados
  5. Billing Library 7.x integrada, compras confirmadas
  6. AdMob SDK declarado na Segurança dos dados, fluxo de consentimento adicionado para o EEE
  7. Validação no servidor + webhooks de RTDN ativos
  8. Testadores de licença concluíram o fluxo completo de compra

A configuração de monetização é uma tarefa única de 3 dias que decide sua receita pelos próximos 3 anos. Faça na ordem certa, teste de ponta a ponta, e seu primeiro repasse chegará sem drama. Pule uma etapa e você vai descobrir três semanas após o lançamento — do jeito difícil.

Gerencia contas de desenvolvedor em escala? Cuidamos do lado operacional.

Clique para escolher um arquivo · clique com o botão direito → Colar, ou pressione Ctrl/⌘+V para colar uma captura de tela

Você também pode arrastar um arquivo para esta caixa.

Respondemos ao e-mail que você fornecer. Seus dados ficam com KappS.

✔ Enviado

Recebemos sua mensagem e responderemos em até 24 horas.


← Voltar para editar