Recompensas de teste

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:

  1. 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.

  2. 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.
Painel do Play Billing Lab
Painel do Play Billing Lab.
  • 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:

  1. Nome do pacote: o nome exato do pacote Android do seu app (por exemplo, com.example.app).
  2. Tipo de produto: use o menu suspenso para selecionar Produto único (item no app).
  3. ID do produto (SKU): é o ID do produto único que tem a oferta de prêmio do Play Games que você quer testar.
Especificar o nome do pacote do app e o ID do produto
Especifique o nome do pacote do app e o ID do produto.

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
    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.

    Iniciar o teste de OOAP
    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:

  1. 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.

    Três telas mostrando o fluxo de teste dos prêmios do Play Games. Na
       primeira tela, o usuário seleciona a opção para conceder a recompensa. A segunda
       tela mostra o prêmio sendo concedido pelo Google Play. Em seguida, o
       usuário clica para que o prêmio seja concedido novamente. A terceira tela
       mostra um estado de erro porque a primeira recompensa não foi processada
       corretamente.
    Fluxo de teste dos prêmios do Play Games.
  2. Processar e entregar o direito de acesso: o app precisa detectar a compra fora do app (por exemplo, chamando queryPurchasesAsync quando 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:

  1. Acesse a página Compras fora do app.
  2. Toque em Limpar teste para interromper o teste de OOAP e limpar as configurações dele.
Interromper e limpar o teste de OOAP
Limpe o teste de OOAP.

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:

  1. Abra o Play Billing Lab e toque em Ver no card ativo de Compras fora do app.
  2. Toque em Editar para modificar o nome do pacote, o ID do produto ou a oferta de teste.
  3. Confirme a opção Interromper teste quando solicitado. O teste será interrompido e todas as entradas relevantes serão apagadas.
  4. Insira o novo produto ou selecione a nova oferta e reinicie o teste.
Editar produto ou oferta
Editar produto ou oferta.

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:

  1. 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.

  2. 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.

  3. 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.

Testar configurações regionais com substituições de país
Teste as configurações regionais com substituições de país.

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 queryPurchasesAsync e 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.