Dodawanie statystyk graczy do gry

W związku z wycofaniem interfejsu Logowania przez Google w 2026 r. usuniemy pakiet SDK gier w wersji 1. Po lutym 2025 r. nie będzie można publikować w Google Play tytułów, które zostały dopiero zintegrowane z pakietem SDK gier w wersji 1. Zalecamy zamiast tego korzystać z pakietu SDK gier w wersji 2.
Chociaż istniejące tytuły z integracją poprzedniej wersji gry 1 będą działać przez kilka lat, zachęcamy do przejścia na wersję 2 od czerwca 2025 r.
Ten przewodnik dotyczy pakietu SDK usług gier Play w wersji 1. Pakiet C++ SDK usług gier Google Play w wersji 2 nie jest jeszcze dostępny.

Interfejs API Statystyk gracza pozwala dostosować rozgrywkę do konkretnych segmentów graczy i różnych etapów ich cyklu życia. Możesz tworzyć dostosowane wrażenia dla każdego segmentu graczy na podstawie ich postępów, wydatków i zaangażowania. Możesz na przykład użyć tego interfejsu API, aby podjąć działania zachęcające mniej aktywnych graczy do ponownego zaangażowania się w Twoją grę, np. wyświetlając i promując nowe przedmioty w grze, gdy gracz się zaloguje.

Z tego przewodnika dowiesz się, jak korzystać z interfejsu Player Stats API w natywnej aplikacji w C++ lub Objective-C.

Podstawy statystyk zawodników

Za pomocą interfejsów API Statystyk gracza możesz pobierać dane o aktywności gracza w grze. Dostępne typy danych dotyczących odtwarzania:

• Średni czas trwania sesji: średni czas trwania sesji użytkownika w minutach. Długość sesji zależy od czasu, przez który gracz jest zalogowany w usługach gier Google Play.
• Prawdopodobieństwo rezygnacji: prognoza dotycząca tego, czy gracz zrezygnuje z gry następnego dnia. Wartość ta jest wyrażana jako 0 (niskie prawdopodobieństwo rezygnacji) lub 1 (wysokie prawdopodobieństwo rezygnacji). Rezygnacja jest zdefiniowana jako 7 dni bezczynności.
• Dni od ostatniej rozgrywki: przybliżona liczba dni od ostatniej rozgrywki.
• Liczba zakupów: przybliżona liczba zakupów w aplikacji dokonanych przez gracza.
• Liczba sesji: przybliżona liczba sesji odtwarzacza. Sesje są określane na podstawie liczby logowań gracza w usługach gier Google Play.
• Procent sesji: przybliżony odsetek sesji gracza podany jako wartość dziesiętna z zakresu od 0 do 1 (włącznie). Ta wartość wskazuje, ile sesji odbył obecny gracz w porównaniu z resztą graczy tej gry. Wyższe liczby wskazują, że ten gracz odtworzył więcej sesji.
• Procent wydatków: przybliżony odsetek wydatków gracza podany jako wartość dziesiętna z zakresu od 0 do 1 (włącznie). Ta wartość wskazuje, ile wydał obecny gracz w porównaniu z resztą graczy w tej grze. Wyższe liczby wskazują, że ten gracz wydał więcej.

Pobieranie statystyk gracza, który jest obecnie zalogowany, za pomocą C++

// Create the callback for our asynchronous fetch call.  This callback will
// log either an error or the average session length for the currently
// signed-in player.
gpg::StatsManager::FetchForPlayerCallback callback = [](gpg::StatsManager::FetchForPlayerResponse const &response) {
  if (IsError(response.status)) {
    LogE("An error occurred fetching player stats.");
  } else {
  gpg::PlayerStats const & player_stats = response.data;
    if (player_stats.HasAverageSessionLength()) {
      LogI("Average session length: %f", player_stats.AverageSessionLength());
    } else {
      LogW("Currently signed-in player had no associated average session length stats.");
    }
  }
};
// Asynchronously fetch the Player Stats.  When the fetch is finished it
// will call our callback. game_services_ is the std::unique_ptr<GameServices>
// returned by gpg::GameServices::Builder.Create()
game_services_->Stats().FetchForPlayer(callback);

Pobieranie statystyk gracza, który jest obecnie zalogowany, w języku Objective-C

// Asynchronously fetches the Player Stats and then logs either a
// description of them or an error
[GPGPlayerStats playerStatsWithCompletionHandler:^(GPGPlayerStats *playerStats, NSError *error) {
  if (error) {
    NSLog(@"Error fetching player stats: %@", error);
  } else {
    NSLog(@"Description of stats for the currently signed-in player: %@", playerStats);
  }
}];

Wskazówki dotyczące korzystania z danych statystyk graczy

Interfejs Play Stats API umożliwia łatwe rozpoznawanie różnych typów graczy na podstawie ich zaangażowania i zachowania w zakresie wydawania środków oraz stosowanie odpowiednich strategii, aby zwiększyć ich wrażenia z gry.

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