Statystyki graczy w grach na Androida

Z tego przewodnika dowiesz się, jak korzystać z interfejsu API statystyk odtwarzacza w usługach gier Google Play. Dostępne opcje użyć interfejsu API statystyk graczy, aby pobrać dane o aktywności gracza w grze.

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.

Interfejsy API można znaleźć w com.google.android.gms.games.stats i com.google.android.gms.games pakietów.

Rodzaje danych graczy, 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:

  • Prawdopodobieństwo rezygnacji: prognoza, czy gracz zrezygnuje. w kolejnym dniu, podana jako wartość dziesiętna z zakresu 0 (niskie prawdopodobieństwo rezygnacje) na 1 (wysokie prawdopodobieństwo rezygnacji) włącznie. Rezygnacja została określona jako 7 dni braku aktywności.
  • Prawdopodobieństwo wydania: przybliżone prawdopodobieństwo gracza. decyzji o zakupie w tej grze, podawana jako wartość dziesiętna z zakresu od 0 (niska) prawdopodobieństwo wydatków) na 1 (wysokie prawdopodobieństwo wydatków) włącznie.
  • Łączne wydatki w ciągu następnych 28 dni: przybliżona łączna szacowana łączna liczba graczy wydatki w tej grze w ciągu najbliższych 28 dni.
  • Prawdopodobieństwo kupującego wysokie: przybliżone prawdopodobieństwo, że ponad w ciągu najbliższych 28 dni gracz wydaje kwotę 95. procenty użytkowników tej gry lub więcej. Jest podana jako ułamek dziesiętny wartość z zakresu od 0 (niskie prawdopodobieństwo uzyskania dużej kwoty wydatków) do 1 (wysokie prawdopodobieństwo uzyskania wysokich wydatków) prawdopodobieństwo, że użytkownik będzie dużo inwestował).

Zanim zaczniesz

Zanim zaczniesz korzystać z interfejsu API statystyk graczy:

Pobieranie klienta

Aby zacząć korzystać z interfejsu API statystyk graczy, gra musi najpierw uzyskać PlayerStatsClient. Aby to zrobić, wywołaj metodę Games.getPlayerStatsClient() i zaliczania zadania.

PlayerStatsClient klasa korzysta z Usług Google Play. Task do asynchronicznego zwracania wyników. Aby dowiedzieć się więcej o: za pomocą zadań do zarządzania pracą w wątkach zapoznaj się z Przewodnik dla programistów interfejsu Tasks API.

Odzyskaj dane

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

  1. Wywołaj funkcję PlayerStatsClient.loadPlayerStats() .

  2. Jeśli wywołanie się powiedzie, Usługi gier Google Play zwracają błąd Task który asynchronicznie wczytuje PlayerStats obiektu. Użyj metod tego obiektu, aby pobrać dane o tym, jak się zalogowano aktywności graczy w Twojej aplikacji.

Oto przykład:

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

Wskazówki

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ę zachęcającą 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ć.
  • Dostosowuj 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.