Statistiche dei giocatori nei giochi Android

L'API delle statistiche dei giocatori ti consente di personalizzare le esperienze di gioco in base a segmenti specifici di giocatori e le diverse fasi del loro ciclo di vita. Puoi creare modelli esperienze per ogni segmento di giocatori in base all'avanzamento, alla spesa dei giocatori e coinvolgenti. Ad esempio, puoi utilizzare questa API per intraprendere azioni proattive per incoraggiare un giocatore meno attivo a interagire nuovamente con il gioco, ad esempio mostrare e promuovere nuovi articoli in-game quando il giocatore esegue l'accesso.

Questa guida mostra come utilizzare l'API delle statistiche dei giocatori nei giochi che usano Servizi per i giochi di Google Play. Le API sono disponibili nella com.google.android.gms.games.stats e com.google.android.gms.games pacchetti.

Prima di iniziare

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

• Scarica e rivedi il esempio di codice.
• Acquisisci familiarità con i consigli descritti in Elenco di controllo della qualità.

Recupero del client delle statistiche sui giocatori in corso...

Per iniziare a utilizzare l'API per le statistiche dei giocatori, il tuo gioco deve prima ottenere un PlayerStatsClient. A questo scopo, puoi richiamare Games.getPlayerStatsClient() e trasferire il valore e l'attività GoogleSignInAccount del player corrente. Per scoprire come recuperare i dati dell'account giocatore, controlla Accedi in Giochi Android.

Nozioni di base sulle Statistiche giocatore

Puoi utilizzare l'API delle statistiche dei giocatori per recuperare i dati relativi al gioco in-game di un giocatore attività. 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 è connesso Servizi per i giochi di Google Play.

• Giorni dall'ultima partita: il numero approssimativo di giorni dall'ultima partita del giocatore. utilizzato l'ultima volta.

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

• Numero di sessioni: il numero approssimativo di sessioni del player. Le sessioni sono determinate dal numero di volte in cui un giocatore esegue l'accesso Servizi per i giochi di Google Play.

• Percentile sessione: l'approssimazione del percentile di sessioni per il player, indicato come un valore decimale compreso tra 0 e 1 inclusi. Questo valore indica il numero sessioni su cui ha giocato il giocatore corrente rispetto al resto del giocatore di questo gioco base. Numeri più alti indicano che questo giocatore ha giocato più sessioni.

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

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

Recupero dei dati sulle statistiche dei giocatori

Per recuperare i dati statistici relativi al giocatore che ha eseguito l'accesso al momento, segui questi passaggi: passaggi:

1. Chiama il metodo PlayerStatsClient.loadPlayerStats().
2. Se la chiamata ha esito positivo, i servizi per i giochi di Google Play restituiscono un Task che carica in modo asincrono un oggetto PlayerStats. Utilizza i metodi di questo oggetto per recuperare i dati su le attività del giocatore che ha eseguito l'accesso nella tua app.

Ecco un esempio:

public void checkPlayerStats() {
  Games.getPlayerStatsClient(this, GoogleSignIn.getLastSignedInAccount(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 Statistiche di Google Play ti consente di identificare facilmente i vari tipi di giocatori, in base a: il loro coinvolgimento e comportamento di spesa e applicare le strategie appropriate migliorare la loro esperienza di gioco.

Nella tabella seguente sono elencati alcuni segmenti di giocatori di esempio e alcuni video consigliati strategie di coinvolgimento:

Segmento di giocatori	Strategia di coinvolgimento
Giocatori abituali con un elevato numero di sessioni e una buona spesa percentile, ma contenuti che non sono stati riprodotti nell'ultima settimana o più.	Invia una notifica relativa a uno sconto o a un bonus speciale disponibili quando torneranno a giocare. Mostra un messaggio di benvenuto di conferma dell'impressione risultati raggiunti e di assegnare un badge finalizzato a incoraggiare restituisci la riproduzione.
Giocatori molto coinvolti in un percentile di spesa basso.	Personalizza i bonus per incoraggiarli a invitare gli amici per installare il gioco e partecipare. Questo approccio si basa sulla dimostrato la soddisfazione del gioco per reclutare nuovi giocatori.
Giocatori con una spesa elevata che mostrano segni di picco e di iniziare a giocare con meno frequenza.	Personalizza i bonus per rinnovare il loro interesse, ad esempio che offrono strumenti, armi di breve durata o di alto valore sconti. Al successivo accesso del player, verrà mostrato un video che indirizza alle funzioni della community, come gli attacchi ai clan, generano un coinvolgimento più frequente e più lungo.
Giocatori con probabilità di spesa molto alta o molto bassa.	Scarsa probabilità di spesa: offri la possibilità di guardare un annuncio video. Mostra articoli di prezzo più basso da acquistare. Probabilità di spesa: indirizzali in anticipo allo store in-game e offrire promozioni speciali per incentivarli all'acquisto.