Aggiungere statistiche dei giocatori al tuo gioco

A seguito del ritiro dell'API Google Sign-in, rimuoveremo l'SDK di Google Play Services per i giochi v1 nel 2026. Dopo febbraio 2025, non potrai pubblicare su Google Play titoli appena integrati con l'SDK v1 per i giochi. Ti consigliamo di utilizzare invece l'SDK giochi v2.
Sebbene i titoli esistenti con le integrazioni precedenti della versione 1 dei giochi continuino a funzionare per un paio di anni, ti invitiamo a eseguire la migrazione alla versione 2 a partire da giugno 2025.
Questa guida è dedicata all'utilizzo dell'SDK Play Services v1. L'SDK C++ per la versione 2 dei servizi per i giochi di Google Play non è ancora disponibile.

L'API Statistiche dei giocatori ti consente di personalizzare le esperienze di gioco in base a segmenti specifici di giocatori e a diverse fasi del loro ciclo di vita. Puoi creare esperienze personalizzate per ogni segmento di giocatori in base al loro avanzamento, alle loro spese e al loro coinvolgimento. Ad esempio, puoi utilizzare questa API per intraprendere azioni proattive per incoraggiare un giocatore meno attivo a interagire nuovamente con il tuo gioco, ad esempio mostrando e promuovendo nuovi articoli in-game quando il giocatore accede.

Questa guida mostra come utilizzare l'API Statistiche giocatore in un'applicazione nativa C++ o Objective-C.

Nozioni di base sulle statistiche dei giocatori

Puoi utilizzare le API Player Stats per recuperare i dati sull'attività in-game di un giocatore. I tipi di dati dei giocatori che puoi recuperare includono:

• Durata media della sessione: la durata media della sessione del player in minuti. La durata della sessione è determinata dal momento in cui un giocatore accede ai servizi per i giochi di Google Play.
• Probabilità di abbandono dell'utente: la previsione di un abbandono da parte di un utente il giorno successivo, indicata come 0 (probabilità bassa di abbandono) o 1 (probabilità elevata di abbandono). Il tasso di abbandono viene calcolato in base a 7 giorni di inattività.
• Giorni dall'ultima partita: il numero approssimativo di giorni dall'ultima partita del giocatore.
• Numero di acquisti: il numero approssimativo di acquisti in-app per il giocatore.
• Numero di sessioni: il numero approssimativo di sessioni del player. Le sessioni sono determinate dal numero di volte in cui un giocatore accede ai servizi per i giochi di Google Play.
• Percentile delle sessioni: l'approssimazione del percentile delle sessioni per il giocatore, dato come valore decimale tra 0 e 1 (inclusi). Questo valore indica quante sessioni ha giocato il giocatore corrente rispetto al resto della base di giocatori del gioco. Numeri più elevati indicano che questo giocatore ha completato più sessioni.
• Percentile di spesa: il percentile di spesa approssimativo del giocatore, fornito come valore decimale compreso tra 0 e 1 (inclusi). Questo valore indica quanto ha speso il giocatore corrente rispetto al resto della base di giocatori del gioco. Numeri più elevati indicano che questo giocatore ha speso di più.

Recuperare le statistiche di un giocatore che ha eseguito l'accesso 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);

Ottenere le statistiche di un giocatore che ha eseguito l'accesso 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);
  }
}];

Suggerimenti per l'utilizzo dei dati delle statistiche dei giocatori

L'API Play Stats ti consente di identificare facilmente vari tipi di giocatori in base al loro coinvolgimento e al loro comportamento di spesa e di applicare strategie appropriate per migliorare la loro esperienza di gioco.

La tabella seguente elenca alcuni esempi di segmenti di giocatori e strategie di coinvolgimento consigliate: