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:

Segment graczy	Strategia zaangażowania
Często grający użytkownicy z dużą liczbą sesji i dobrym odsetkiem wydatków, którzy nie grali przez co najmniej tydzień.	Wyślij powiadomienie o rabacie lub specjalnym bonusie, z których gracz będzie mógł skorzystać po powrocie do gry. wyświetlać wiadomość powitalną z podziękami za imponujące osiągnięcia i przyznawać odznakę, która zachęca do powrotu do gry;
Bardzo zaangażowani gracze w niskim centylu wydatków.	Dostosuj bonusy, aby zachęcić ich do zapraszania znajomych do zainstalowania gry i dołączenia do niej. To podejście polega na zachęcaniu do gry nowych graczy, którzy już wcześniej wykazali zainteresowanie grą.
gracze, którzy wydają dużo pieniędzy, wykazują oznaki szczytowego poziomu wydatków i zaczynają rzadziej grać;	Dostosuj bonusy, aby zachęcić graczy do ponownego zainteresowania się grą. Możesz na przykład zaoferować cenne narzędzia, broń lub rabaty na krótki okres. Gdy gracz zaloguje się po raz kolejny, wyświetl mu film, który kieruje go do funkcji społeczności, takich jak ataki klanów, które zwiększają częstotliwość i długość zaangażowania.