Estatísticas do jogador para jogos no Android

Este guia mostra como usar a API Player Stats nos serviços relacionados a jogos do Google Play. Você pode usar a API Player Stats para extrair dados sobre a atividade de um jogador no jogo.

A API Player Stats permite personalizar experiências de jogo para segmentos específicos de jogadores e diferentes fases do ciclo de vida do jogador. Você pode criar experiências personalizadas para cada segmento de jogadores de acordo com a forma como eles progridem, gastam e interagem. Por exemplo, você pode usar essa API para executar ações proativas, encorajando um jogador menos ativo a se envolver novamente com o jogo, como mostrar e promover novos itens no jogo quando o usuário fizer login.

As APIs podem ser encontradas nos pacotes com.google.android.gms.games.stats e com.google.android.gms.games.

Antes de começar

Antes de começar a usar a API Player Stats:

• Faça o download e analise o exemplo de código (em inglês).
• Familiarize-se com as recomendações descritas na Lista de verificação de qualidade.

Acessar o cliente de estatísticas do jogador

Para começar a usar a API Player Stats, o jogo precisa incluir um objeto PlayerStatsClient. Para isso, chame o método PlayerStatsClient.getPlayersClient() e transmita a atividade.

A classe PlayerStatsClient usa a classe Task do Google Play Services para retornar resultados de forma assíncrona. Para saber mais sobre o uso de tarefas para gerenciar trabalhos em linhas de execução, consulte o guia para desenvolvedores da API Tasks.

Conceitos básicos das estatísticas do jogador

Você pode usar a API Player Stats para extrair dados sobre a atividade de um jogador no jogo. Os tipos de dados de jogador que é possível extrair incluem:

• Duração média da sessão: a duração média da sessão do jogador em minutos. A duração de cada sessão é determinada pelo período em que o jogador permaneceu conectado aos serviços relacionados a jogos do Google Play.

• Dias desde o último jogo: o número aproximado de dias desde a última vez que o usuário jogou.

• Número de compras: o número aproximado de compras no app feitas pelo jogador.

• Número de sessões: o número aproximado de sessões do jogador. As sessões são determinadas pelo número de vezes que o jogador faz login nos serviços relacionados a jogos do Google Play.

• Percentil de sessões: o percentil de sessões aproximado do jogador, indicado como um valor decimal entre 0 e 1. Esse valor indica o número de sessões do jogador atual em comparação com o restante da base de usuários do jogo. Números maiores indicam que esse jogador jogou mais sessões.

• Percentil de gastos: o percentil aproximado de gastos do jogador, indicado como um valor decimal entre 0 e 1. Esse valor indica quanto o jogador atual gastou em comparação com o restante da base de usuários do jogo. Números mais altos indicam que esse jogador gastou mais.

Os tipos de dados do jogador abaixo foram descontinuados e sempre retornam uma constante de valor não definido:

Extrair dados da Player Stats

Para extrair dados da Player Stats do jogador conectado, siga estas etapas:

1. Chamando o método PlayerStatsClient.loadPlayerStats().

2. Se a chamada for bem-sucedida, os serviços relacionados a jogos do Google Play vão retornar um objeto Task que carrega de forma assíncrona um objeto PlayerStats. Use os métodos desse objeto para extrair dados sobre as atividades do jogador conectado ao app.

Veja um exemplo:

public void checkPlayerStats() {
  PlayGames.getPlayerStatsClient(this)
      .loadPlayerStats(true)
      .addOnCompleteListener(new OnCompleteListener<AnnotatedData<PlayerStats>>() {
        @Override
        public void onComplete(@NonNull Task<AnnotatedData<PlayerStats>> task) {
          if (task.isSuccessful()) {
            // Check for cached data.
            if (task.getResult().isStale()) {
              Log.d(TAG, "using cached data");
            }
            PlayerStats stats = task.getResult().get();
            if (stats != null) {
              Log.d(TAG, "Player stats loaded");
              if (stats.getDaysSinceLastPlayed() > 7) {
                Log.d(TAG, "It's been longer than a week");
              }
              if (stats.getNumberOfSessions() > 1000) {
                Log.d(TAG, "Veteran player");
              }
              if (stats.getChurnProbability() == 1) {
                Log.d(TAG, "Player is at high risk of churn");
              }
            }
          } else {
            int status = CommonStatusCodes.DEVELOPER_ERROR;
            if (task.getException() instanceof ApiException) {
              status = ((ApiException) task.getException()).getStatusCode();
            }
            Log.d(TAG, "Failed to fetch Stats Data status: "
                + status + ": " + task.getException());
          }
        }
      });
}

Dicas para usar dados de estatísticas do jogador

Com a API Play Stats, é possível identificar vários tipos de jogadores de acordo com o comportamento de engajamento e gastos, além de aplicar estratégias adequadas para aprimorar a experiência do jogo.

A tabela abaixo lista alguns exemplos de segmentos de jogadores e as estratégias de engajamento recomendadas: