Agrega estadísticas de jugadores a tu juego

Después de la baja de la API de Acceso a Google, quitaremos el SDK de juegos v1 en 2026. Después de febrero de 2025, no podrás publicar títulos que se hayan integrado recientemente con el SDK de juegos v1 en Google Play. Te recomendamos que uses el SDK de juegos v2.
Si bien los títulos existentes con las integraciones de la versión 1 de los juegos anteriores seguirán funcionando durante un par de años, te recomendamos que migres a la versión 2 a partir de junio de 2025.
Esta guía se aplica al uso del SDK de la versión 1 de los Servicios de juego de Play. El SDK de C++ para la versión 2 de los Servicios de juego de Play aún no está disponible.

La API de Player Stats te permite personalizar experiencias del juego para segmentos específicos de jugadores y diferentes etapas del ciclo de vida del jugador. Puedes crear experiencias personalizadas para cada segmento de jugadores según su avance, gasto y participación. Por ejemplo, puedes usar esta API para realizar acciones proactivas a fin de incentivar a un jugador menos activo para que vuelva a interesarse en tu juego; por ejemplo, mostrando y promocionando nuevos elementos del juego cuando acceda el jugador.

En esta guía, se muestra cómo usar la API de Player Stats en una aplicación nativa de C++ o Objective-C.

Aspectos básicos de las estadísticas del jugador

Puedes usar las APIs de Player Stats para recuperar datos sobre la actividad de un jugador en el juego. Entre los tipos de datos sobre los jugadores que puedes obtener, se incluyen los siguientes:

• Duración promedio de la sesión: Indica la duración promedio de la sesión del jugador en minutos. La extensión de la sesión se determina por el tiempo que el jugador permanece conectado a los Servicios de juego de Google Play.
• Probabilidad de deserción: Indica la predicción de si un jugador abandonará el próximo día, dado como 0 (baja probabilidad de deserción) o 1 (alta probabilidad de deserción). Por definición, la migración equivale a 7 días de inactividad.
• Días desde la última vez que se jugó: Indica la cantidad aproximada de días desde la última vez que el usuario jugó.
• Cantidad de compras: Indica la cantidad aproximada de compras directas del jugador desde la aplicación.
• Cantidad de sesiones: Indica la cantidad aproximada de sesiones del jugador. Las sesiones se determinan por la cantidad de veces que el jugador accede a los Servicios de juego de Google Play.
• Percentil de sesiones: Indica la aproximación del percentil de sesiones del jugador, dada como un valor decimal entre 0 y 1 inclusive. Este valor indica la cantidad de sesiones en las que participó el jugador actual en comparación con el resto de la base de jugadores del juego. Los números más altos indican que ese jugador participó en más sesiones.
• Percentil de gasto: Indica el percentil de gasto aproximado del jugador, dado como un valor decimal entre 0 y 1 inclusive. Este valor indica el consumo del jugador actual en comparación con el resto de la base de jugadores del juego. Los números más altos indican que los gastos de este jugador fueron mayores.

Cómo obtener estadísticas del jugador que está conectado actualmente con C++

// Create the callback for our asynchronous fetch call.  This callback will
// log either an error or the average session length for the currently
// signed-in player.
gpg::StatsManager::FetchForPlayerCallback callback = [](gpg::StatsManager::FetchForPlayerResponse const &response) {
  if (IsError(response.status)) {
    LogE("An error occurred fetching player stats.");
  } else {
  gpg::PlayerStats const & player_stats = response.data;
    if (player_stats.HasAverageSessionLength()) {
      LogI("Average session length: %f", player_stats.AverageSessionLength());
    } else {
      LogW("Currently signed-in player had no associated average session length stats.");
    }
  }
};
// Asynchronously fetch the Player Stats.  When the fetch is finished it
// will call our callback. game_services_ is the std::unique_ptr<GameServices>
// returned by gpg::GameServices::Builder.Create()
game_services_->Stats().FetchForPlayer(callback);

Cómo obtener estadísticas del jugador que accedió con Objective-C

// Asynchronously fetches the Player Stats and then logs either a
// description of them or an error
[GPGPlayerStats playerStatsWithCompletionHandler:^(GPGPlayerStats *playerStats, NSError *error) {
  if (error) {
    NSLog(@"Error fetching player stats: %@", error);
  } else {
    NSLog(@"Description of stats for the currently signed-in player: %@", playerStats);
  }
}];

Sugerencias para usar los datos de Player Stats

La API de Play Stats te permite identificar con facilidad varios tipos de jugadores según su participación y comportamiento de consumo, y aplicar estrategias adecuadas para mejorar la experiencia de juego.

En la siguiente tabla se muestran algunos ejemplos de segmentos de jugadores y estrategias de participación recomendadas: