Statistiche sui giocatori per i giochi Android

Questa guida illustra come utilizzare l'API Player stats per i servizi per i giochi di Google Play. Puoi utilizzare l'API Player stats per recuperare i dati sull'attività in-game di un giocatore.

L'API delle statistiche dei giocatori ti consente di personalizzare le esperienze di gioco per segmenti specifici di giocatori e diverse fasi del loro ciclo di vita. Puoi creare esperienze su misura per ogni segmento di giocatori in base ai progressi, alla spesa e al coinvolgimento dei giocatori. 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 elementi in-game quando il giocatore esegue l'accesso.

Le API sono disponibili nei pacchetti com.google.android.gms.games.stats e com.google.android.gms.games.

I tipi di dati del player 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 esegue l'accesso ai servizi di Google Play Giochi.

  • Giorni dall'ultima riproduzione: il numero approssimativo di giorni dall'ultima riproduzione del player.

  • Numero di acquisti: il numero approssimativo di acquisti in-app per il player.

  • 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 di Google Play Giochi.

  • Percentile sessione: l'approssimazione del percentile di sessioni per il player, espresso come valore decimale compreso tra 0 e 1 inclusi. Questo valore indica il numero di sessioni giocate dall'attuale giocatore rispetto al resto della base di giocatori del gioco. Numeri più alti indicano che questo giocatore ha giocato più sessioni.

  • Percentile di spesa: il percentile di spesa approssimativo del player, espresso come valore decimale compreso tra 0 e 1 inclusi. Questo valore indica quanto ha speso il giocatore attuale rispetto al resto della base di giocatori del gioco. Numeri più elevati indicano che questo giocatore ha speso di più.

I seguenti tipi di dati dei giocatori sono deprecati e restituiscono sempre una costante del valore non impostata:

  • Probabilità di abbandono dell'utente: la previsione dell'abbandono di un giocatore nel giorno successivo, espressa come valore decimale compreso tra 0 (bassa probabilità di abbandono) e 1 (alta probabilità di abbandono). Il tasso di abbandono è definito come un periodo di inattività di 7 giorni.
  • Probabilità di spesa: la probabilità approssimativa che il giocatore sceglie di spendere in questo gioco, espressa come valore decimale compreso tra 0 (bassa probabilità di spesa) e 1 (alta probabilità di spesa) inclusi.
  • Spesa totale per i prossimi 28 giorni: la spesa totale approssimativa prevista dei giocatori nei prossimi 28 giorni in questo gioco.
  • Probabilità di spesa elevata: la probabilità approssimativa che nei prossimi 28 giorni un giocatore spenderà un importo pari o superiore al 95° percentile della base di giocatori di questo gioco. Viene dato come un valore decimale compreso tra 0 (bassa probabilità di spendere molto) e 1 (alta probabilità di spendere troppo).

Prima di iniziare

Prima di iniziare a utilizzare l'API delle statistiche dei giocatori:

Ottieni il client

Per iniziare a utilizzare l'API Player stats, il gioco deve prima ottenere un oggetto PlayerStatsClient. Per farlo, chiama il metodo Games.getPlayerStatsClient() e trasmetti l'attività.

La classe PlayerStatsClient utilizza la classe Task di Google Play Services per restituire i risultati in modo asincrono. Per scoprire di più sull'utilizzo delle attività per gestire il lavoro con conversazioni in thread, consulta la guida per gli sviluppatori dell'API Tasks.

Recupera i dati

Per recuperare i dati delle statistiche giocatore relativi al giocatore attualmente connesso, svolgi i seguenti passaggi:

  1. Chiama il metodo PlayerStatsClient.loadPlayerStats().

  2. Se la chiamata ha esito positivo, i servizi per i giochi di Google Play restituiscono un oggetto Task che carica in modo asincrono un oggetto PlayerStats. Utilizza i metodi di questo oggetto per recuperare i dati sulle attività del player che ha eseguito l'accesso nella tua app.

Ecco un esempio:

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());
          }
        }
      });
}

Suggerimenti

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

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

Segmento giocatori Strategia di coinvolgimento
Giocatori frequenti con un numero elevato di sessioni e un buon percentile di spesa, ma che non hanno giocato nell'ultima settimana o più.
  • Invia una notifica relativa a uno sconto o a un bonus speciale disponibile al suo ritorno a giocare.
  • Mostra un messaggio di benvenuto che riconosca i traguardi raggiunti e assegna un badge progettato per incoraggiare il ritorno del gioco.
Giocatori molto coinvolti in un percentile di spesa bassa.
  • Personalizza i bonus per incentivarli a invitare gli amici a installare e partecipare al tuo gioco. Questo approccio si basa sull'appetito del gioco dimostrato da parte dei giocatori nel reclutare nuovi giocatori.
Giocatori con una spesa elevata che mostrano segni di aver raggiunto un picco e di iniziare a giocare con meno frequenza.
  • Personalizza i bonus per rinnovare il loro interesse, ad esempio offrendo strumenti, armi o sconti di valore elevato e di breve durata.
  • La prossima volta che il giocatore esegue l'accesso, mostra un video che lo indirizzi alle funzionalità della community, come gli attacchi di clan, che favoriscono un coinvolgimento più frequente e più lungo.
Giocatori con una probabilità di spesa molto alta o molto bassa.
  • Scarsa probabilità di spesa: offri la possibilità di guardare un video pubblicitario. Mostra gli articoli di prezzo più basso per l'acquisto.
  • Probabilità di spesa: indirizzali al negozio in-game in anticipo e offri promozioni speciali per incentivarli all'acquisto.