Statistiche sui giocatori per i giochi Android

Questa guida mostra come utilizzare l'API delle statistiche dei giocatori per i servizi per i giochi di Google Play. Puoi Utilizzare l'API PlayerStatistics 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 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.

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

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ù).

Prima di iniziare

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

Ottieni il cliente

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 passare l'attività.

La PlayerStatsClient utilizza Google Play Services Task per restituire i risultati in modo asincrono. Per scoprire di più su usando le attività per gestire i lavori in thread, consulta Guida per gli sviluppatori dell'API Tasks.

Recupera i dati

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

  1. Chiama il 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 PlayerStats . Utilizza i metodi di questo oggetto per recuperare i dati sull'utente che ha eseguito l'accesso le attività del giocatore 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 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.