Android APIs
public interface

PlayerStats

implements Freezable<PlayerStats> Parcelable
com.google.android.gms.games.stats.PlayerStats

Class Overview

The PlayerStats API allows you to retrieve information about the player's activity in your application. Your app can then use this data to provide a different experience for each type of player (eg. players with a high probably of quitting).

Summary

Constants
float UNSET_VALUE The default value for each field when there isn't enough data to calculate.
[Expand]
Inherited Constants
From interface android.os.Parcelable
Public Methods
abstract float getAverageSessionLength()
The average session length of the player in minutes.
abstract float getChurnProbability()
The approximate probability of the player not returning to play the game.
abstract int getDaysSinceLastPlayed()
The approximate number of days since the player last played.
abstract int getNumberOfPurchases()
The approximate number of in-app purchases for the player.
abstract int getNumberOfSessions()
The approximate number of sessions of the player.
abstract float getSessionPercentile()
The approximation of sessions percentile for the player.
abstract float getSpendPercentile()
The approximate spend percentile of the player.
[Expand]
Inherited Methods
From interface com.google.android.gms.common.data.Freezable
From interface android.os.Parcelable

Constants

public static final float UNSET_VALUE

The default value for each field when there isn't enough data to calculate. Please check the value against this before using it.

Constant Value: -1.0

Public Methods

public abstract float getAverageSessionLength ()

The average session length of the player in minutes. Session length is determined by the time that a player is signed in to Google Play Games services.

Returns

public abstract float getChurnProbability ()

The approximate probability of the player not returning to play the game. Higher values indicate that a player is less likely to return.

Returns
  • A decimal number between 0 and 1 (inclusive) or UNSET_VALUE.

public abstract int getDaysSinceLastPlayed ()

The approximate number of days since the player last played.

Returns

public abstract int getNumberOfPurchases ()

The approximate number of in-app purchases for the player.

Returns

public abstract int getNumberOfSessions ()

The approximate number of sessions of the player. Sessions are determined by the number of times that a player signs in to Google Play Games services.

Returns

public abstract float getSessionPercentile ()

The approximation of sessions percentile for the player. This value indicates how many sessions the current player has played in comparison to the rest of this game's player base. Higher numbers indicate that this player has played more sessions.

Returns
  • A decimal number between 0 and 1 (inclusive) or UNSET_VALUE.

public abstract float getSpendPercentile ()

The approximate spend percentile of the player. This value indicates how much the current player has spent in comparison to the rest of this game's player base. Higher numbers indicate that this player has spent more.

Returns
  • A decimal number between 0 and 1 (inclusive) or UNSET_VALUE.