Statistiche sui giocatori per i giochi Android

Questa guida mostra come utilizzare l'API Statistiche dei giocatori per Google Play Services. Puoi utilizzare l'API Statistiche giocatore per recuperare i dati relativi all'attività in-game di un giocatore.

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 al fine di stimolare un giocatore meno attivo a interagire nuovamente con il tuo gioco, ad esempio mostrando e promuovendo nuovi articoli in-game quando il giocatore accede.

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

Prima di iniziare

Prima di iniziare a utilizzare l'API Statistiche giocatore:

• Scarica ed esamina il codice di esempio.
• Acquisisci familiarità con i consigli descritti nel Controllo qualità.

Ottenere il client delle statistiche dei giocatori

Per iniziare a utilizzare l'API di statistiche dei giocatori, il tuo gioco deve prima ottenere un oggetto PlayerStatsClient. Per farlo, puoi chiamare il metodo PlayerStatsClient.getPlayersClient() e passare 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 in sequenza, consulta la guida per gli sviluppatori dell'API Tasks.

Nozioni di base sulle statistiche dei giocatori

Puoi utilizzare l'API Statistiche giocatore 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.

• 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, espresso come valore decimale compreso tra 0 e 1. Questo valore indica quante sessioni ha giocato il giocatore corrente rispetto al resto della base di giocatori di questo gioco. Numeri più elevati indicano che questo giocatore ha completato più sessioni.

• Percentile di spesa: il percentile di spesa approssimativo del player, 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ù.

I seguenti tipi di dati del player sono deprecati e restituiscono sempre un valore costante non impostato:

Recuperare i dati delle statistiche dei giocatori

Per recuperare i dati delle statistiche del giocatore che ha eseguito l'accesso:

1. Chiama il metodo PlayerStatsClient.loadPlayerStats().

2. Se la chiamata va a buon fine, Google Play Services per i giochi restituisce un oggetto Task che carica in modo asincrono un oggetto PlayerStats. Utilizza i metodi di questo oggetto per recuperare i dati sulle attività del giocatore 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 per l'utilizzo dei dati delle statistiche dei giocatori

L'API Play Stats ti consente di identificare 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: