O Play Billing Lab é um app complementar que ajuda a testar integrações com o sistema de faturamento do Google Play. Use o recurso de teste de compra fora do app (OOAP, na sigla em inglês) do Play Billing Lab para validar se o app e o back-end estão configurados corretamente para processar itens adquiridos fora do app, incluindo prêmios do Play Games.
Com o recurso de teste de OOAP, é possível selecionar uma oferta de prêmio do Play Games, simular o Google Play concedendo o prêmio ao usuário diretamente do Play Billing Lab e verificar o fluxo de aquisição e atendimento de direitos de ponta a ponta.
Pré-requisitos
Antes de usar o Play Billing Lab para testar fluxos de compra fora do app (OOAP, na sigla em inglês) e validar sua configuração para os prêmios do Play Games, verifique se você atende aos seguintes requisitos:
Status de testador licenciado: sua conta de teste precisa estar registrada como um testador licenciado para o jogo. Para mais detalhes, consulte a documentação do testador licenciado do Google Play.
Observação: embora qualquer usuário possa acessar o app Play Billing Lab, apenas testadores licenciados podem configurar e acionar substituições de OOAP.
Consistência de conta em todas as plataformas: faça login no Play Billing Lab e na Google Play Store usando a mesma conta de testador licenciado. Se houver uma incompatibilidade de conta, talvez a Google Play Store não mostre o produto ou a oferta de teste substituído nem conclua a compra de teste.
Fazer o download e instalar
Baixe e instale o app Play Billing Lab no Google Play.
Guia explicativo de integração e teste
As etapas a seguir detalham como integrar e testar os prêmios do Play Games usando o Play Billing Lab. Para informações gerais sobre como testar compras fora do app, consulte Testar compras fora do app.
Etapa 1: iniciar o Play Billing Lab e fazer login
Ao abrir o Play Billing Lab pela primeira vez após a instalação:
- Toque em Fazer login com o Google.
- Selecione a Conta do Google registrada como testador licenciado para seu app.
- Depois de fazer login, você verá o Painel principal.
Etapa 2: acessar o teste de compras fora do app (OOAP)
- No Painel, localize o card Compras fora do app.
- Toque em Testar para abrir a tela de configuração do OOAP.
Etapa 3: especificar o nome do pacote do app e o ID do produto
Na tela de configuração do OOAP, insira os identificadores de app necessários:
- Nome do pacote: o nome exato do pacote Android do seu app (por exemplo,
com.example.app). - Tipo de produto: use o menu suspenso para selecionar Produto único (item no app).
- ID do produto (SKU): é o ID do produto único que tem a oferta de prêmio do Play Games que você quer testar.
Etapa 4: selecionar a oferta de prêmios do Play Games
Depois que você inserir o nome do pacote, o ID do produto e o tipo de produto, o Play Billing Lab vai consultar o back-end e mostrar uma lista de ofertas disponíveis para esse produto.
Selecione a oferta de prêmios do Play Games que você quer testar.
Selecione uma oferta qualificada.
Etapa 5: iniciar o teste de OOAP
Depois de selecionar a oferta de prêmio do Play Games, toque em Iniciar teste. A configuração é salva e sincronizada com os servidores de back-end do Google Play.
Após a ativação, o Painel mostra um selo Ativo no card Compras fora do app, com o nome do pacote configurado, o ID do produto (SKU) e a duração restante.
Janela de teste: as configurações de teste de OOAP ativas permanecem ativas por 2 horas por padrão antes de expirar automaticamente. Depois desse período, você precisa reconfigurar o teste.
Inicie o teste de OOAP.
Etapa 6: conceder a recompensa e verificar a entrega
Enquanto o teste de OOAP estiver ativo para sua oferta de prêmio do Play Games, você poderá conceder o prêmio diretamente do Play Billing Lab sem comprá-lo na Google Play Store:
Conceder o prêmio: na tela Compra fora do app no Play Billing Lab, clique em Conceder prêmio para simular o Google Play concedendo o prêmio ao usuário. As recompensas atuais precisam ser processadas antes que outras possam ser concedidas.
Fluxo de teste dos prêmios do Play Games. Processar e entregar o direito de acesso: o app precisa detectar a compra fora do app (por exemplo, chamando
queryPurchasesAsyncquando o jogo é iniciado ou colocado em primeiro plano) e, em seguida, entregar o item ao respectivo usuário. Para ver o processo completo, consulte Como processar compras.
Etapa 7: interromper e limpar o teste de OOAP
Depois de concluir o teste:
- Acesse a página Compras fora do app.
- Toque em Limpar teste para interromper o teste de OOAP e limpar as configurações dele.
Como modificar configurações de teste
Não é possível mudar o nome do pacote, o ID do produto, a seleção de ofertas ou a substituição do país da Google Play Store enquanto um teste de OOAP está em andamento.
Para fazer isso, é necessário interromper e limpar o teste atual de OOAP.
Como editar um produto ou uma oferta
Se você estiver executando um teste de OOAP e quiser testar um produto ou uma oferta diferente:
- Abra o Play Billing Lab e toque em Ver no card ativo de Compras fora do app.
- Toque em Editar para modificar o nome do pacote, o ID do produto ou a oferta de teste.
- Confirme a opção Interromper teste quando solicitado. O teste será interrompido e todas as entradas relevantes serão apagadas.
- Insira o novo produto ou selecione a nova oferta e reinicie o teste.
Como testar configurações regionais com substituições de país
Com o Play Billing Lab, é possível substituir o país da Google Play Store para testar a qualificação para ofertas em diferentes regiões. Se você não selecionar um país, o Play Billing Lab vai usar o país do Google Play da sua conta de teste licenciada. As mudanças de país precisam ser sincronizadas com os testes de OOAP:
Interromper o teste ativo de OOAP: se você tentar editar a substituição de país enquanto um teste de OOAP estiver ativo, seja no painel ou na página de compra fora do app, o Play Billing Lab vai mostrar um aviso solicitando que você interrompa o teste primeiro. Toque em Interromper teste para confirmar. Isso vai interromper o teste de OOAP atual e limpar as entradas de teste.
Definir substituição de país: depois de interromper o teste de OOAP, você pode editar a configuração de país na página Configurações ou tocar em Definir substituição de país na tela Compra fora do app. Selecione o país de destino (por exemplo, Japão, Reino Unido) e toque em Aplicar.
Reinicie o teste de OOAP: depois que a substituição de país estiver ativa, volte ao card Compras fora do app, selecione seu produto e oferta e toque em Iniciar teste.
O painel agora vai mostrar uma substituição de país ativa e um teste de OOAP ativo.
Solução de problemas e perguntas frequentes
Por que não consigo selecionar ou ver ofertas ao configurar um produto no Play Billing Lab?
- Qualificação para ofertas: o Play Billing Lab só mostra ofertas que sua conta de teste específica está qualificada para adquirir. Para itens não consumíveis, você não pode ser o proprietário do produto. Para itens consumíveis, é necessário consumir todas as compras atuais antes de testar.
- Status do testador licenciado: verifique se a conta está listada como um testador licenciado ativo no Play Console.
Por que não consigo conceder outro prêmio no Play Billing Lab?
- Recompensa não processada: as recompensas atuais precisam ser processadas (confirmadas ou consumidas) antes que outras recompensas possam ser concedidas. Abra o jogo e verifique se a recompensa anterior foi processada.
- Expiração: os testes OOAP ativos expiram após 2 horas. Abra o Play Billing Lab para conferir se a tag de teste mudou para Expirada. Se sim, inicie um novo teste.
Por que não recebi o prêmio no jogo?
- Consistência da conta: verifique se a conta conectada ao Play Billing Lab, ao app Google Play Store e ao seu jogo é exatamente a mesma conta de testador licenciado.
- Processamento de compras fora do app: verifique a implementação de
queryPurchasesAsynce a lógica de processamento de compras do seu jogo. Como os prêmios são concedidos fora da interface padrão do app, o jogo ou o servidor de back-end precisa detectar e processar compras não confirmadas.
Como faço para interromper ou limpar um teste ativo antes que o timer de duas horas expire?
- Abra o Play Billing Lab, localize o card ativo (Compras fora do app ou Definições de configuração) e toque em Parar ou Excluir (ou toque em Limpar teste na tela Compra fora do app). Quando solicitado, confirme sua escolha. A substituição é removida imediatamente dos servidores do Google Play.