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:

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 attività.

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 effettuate dal 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:

  • Probabilità di abbandono dell'utente: la previsione dell'abbandono di un giocatore. nel giorno successivo, espresso come un valore decimale compreso tra 0 (bassa probabilità di tasso di abbandono) su 1 (alta probabilità di abbandono) inclusi. Il tasso di abbandono si riferisce a 7 giorni di inattività.
  • Probabilità di spesa: la probabilità approssimativa del giocatore scegliere di spendere in questo gioco, espresso come un valore decimale compreso tra 0 (basso probabilità di spesa) a 1 (alta probabilità di spesa) incluse.
  • Spesa totale dei prossimi 28 giorni: valore approssimativo del giocatore totale previsto spendere nei prossimi 28 giorni in questo gioco.
  • Probabilità di acquisto elevato: la probabilità approssimativa che su nei prossimi 28 giorni un giocatore spenderà un importo pari a percentile o superiore della base di giocatori di questo gioco. Questo valore viene fornito come decimale valore compreso tra 0 (bassa probabilità di spendere di più) e 1 (alta probabilità probabilità di spendere molto di più).

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() {
  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 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 non riprodotti da almeno nell'ultima settimana.
  • 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.