Statystyki graczy w grach na Androida

Interfejs API statystyk graczy pozwala dostosować sposób grania do konkretnych segmentów graczy i na różnych etapach ich cyklu życia. Możesz tworzyć dostosowane do Twoich potrzeb w zależności od segmentu graczy, w zależności od postępów, wydatków i angażująca. Za pomocą tego interfejsu API można np. podejmować działania prewencyjne, aby: zachęcić mniej aktywnego gracza do ponownego zaangażowania się w grę, np. przez wyświetlanie i promowanie nowych przedmiotów w grze, gdy gracz się loguje.

Z tego przewodnika dowiesz się, jak korzystać z interfejsu API statystyk graczy w grach za pomocą Usługi gier Google Play. Interfejsy API można znaleźć w com.google.android.gms.games.stats i com.google.android.gms.games pakietów.

Zanim zaczniesz

Zanim zaczniesz korzystać z interfejsu API statystyk graczy:

• Pobierz i przejrzyj przykładowy kod.
• Zapoznaj się z zaleceniami opisanymi w Lista kontrolna jakości.

Uzyskiwanie klienta statystyk graczy

Aby zacząć korzystać z interfejsu API statystyk graczy, gra musi najpierw uzyskać PlayerStatsClient. Aby to zrobić, wywołaj metodę Games.getPlayerStatsClient() i przekazywanie funkcji oraz GoogleSignInAccount dla bieżącego gracza. Aby dowiedzieć się, jak: pobierania informacji o koncie gracza, patrz sekcja Logowanie się w Grach na Androida

Podstawowe informacje o Statystykach gracza

Do pobierania danych o graczach w grze można używać interfejsu API statystyk graczy. działania. Rodzaje danych odtwarzacza, które możesz pobrać, to m.in.:

• Średnia długość sesji: średnia długość sesji odtwarzacza w min. Długość sesji zależy od czasu, w którym gracz jest zalogowany Usługi Gier Google Play.

• Dni od ostatniego grania: przybliżona liczba dni od momentu, gdy gracz ostatnio rozegranej.

• Liczba zakupów: przybliżona liczba zakupów w aplikacji .

• Liczba sesji: przybliżona liczba sesji odtwarzacza. Sesje zależą od tego, ile razy gracz zalogował się na swoje konto Usługi Gier Google Play.

• Percentyl sesji: przybliżony percentyl sesji dla odtwarzacza podana jako wartość dziesiętna z zakresu od 0 do 1 włącznie. Wartość ta wskazuje sesje obecnego gracza w porównaniu z resztą gracza w tę grę wiele instalacji. Wyższe liczby oznaczają, że ten gracz zagrał więcej sesji.

• Percentyl wydatków: przybliżony centyl wydatków odtwarzacza, biorąc pod uwagę jako wartość dziesiętną z zakresu od 0 do 1 włącznie. Ta wartość wskazuje, jak wydane środki przez obecnego gracza w porównaniu z pozostałymi graczami w tej grze wiele instalacji. Wyższe liczby oznaczają, że dany gracz wydał więcej.

Te typy danych graczy są wycofane i zawsze zwracają wartość nieskonfigurowaną stała wartości:

Pobieranie danych statystycznych graczy

Aby pobrać dane statystyczne aktualnie zalogowanego gracza, postępuj zgodnie z tymi instrukcjami kroki:

1. Wywołaj metodę PlayerStatsClient.loadPlayerStats().
2. Jeśli wywołanie się powiedzie, Usługi gier Google Play zwracają błąd Task obiekt, który asynchronicznie wczytuje obiekt PlayerStats. Użyj metod tego obiektu, aby pobrać dane o: aktywności zalogowanego gracza w Twojej aplikacji.

Oto przykład:

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

Wskazówki dotyczące korzystania z danych Statystyk graczy

Interfejs Play Stats API pozwala łatwo identyfikować różne typy graczy ich zaangażowania i wydatków, a także stosować odpowiednie strategie, poprawić wrażenia użytkowników.

W tabeli poniżej znajdziesz przykładowe segmenty graczy i zalecane strategie zaangażowania:

Segment graczy	Strategia zaangażowania
Użytkownicy często grający z dużą liczbą sesji i rozsądnymi wydatkami percentyl, ale nie grali od co najmniej tygodnia.	Wyślij powiadomienie o rabacie lub bonusie specjalnym dostępnych po powrocie do gry. Pokaż wiadomość powitalną potwierdzającą imponujące wyniki osiągnięć oraz nagradzać odznakę zapewniającą zachęty powrotną.
Bardzo zaangażowani gracze przy niskim centylu wydatków.	Dostosuj bonusy, aby zachęcić ich do zapraszania znajomych aby zainstalować grę i do niej dołączyć. W tym podejściu wykazali radość z gry, aby rekrutować nowych graczy.
Wysoko płacący gracze wykazujący oznaki wzrostu popularności i startu aby rzadziej odtwarzać.	Personalizuj bonusy, aby odświeżyć ich zainteresowanie, np. oferowanie wartościowych, krótkotrwałych narzędzi, broni lub rabaty. Następnym razem, gdy odtwarzacz się zaloguje, wyświetl film, który instruuje użytkownika. do funkcji społecznościowych, takich jak ataki klanów, zwiększają ich zaangażowanie i dłuższe zaangażowanie.
Gracze z bardzo wysokim lub bardzo niskim prawdopodobieństwem wydatku.	Prawdopodobnie nie dokonają wydatków: zapewnij możliwość obejrzenia reklamy film. Pokaż produkty w niższej cenie. Osoby skłonne do wydania: przekieruj ich wcześniej do sklepu w grze, i udostępniać specjalne promocje, aby zachęcić ich do zakupu.