L'API Player Stats vous permet d'adapter l'expérience de jeu à des segments de joueurs spécifiques et à différentes étapes du cycle de vie des joueurs. Vous pouvez créer des expériences personnalisées pour chaque segment de joueurs en fonction de leur progression, de leurs dépenses et de leur engagement. Par exemple, vous pouvez utiliser cette API pour prendre des mesures proactives afin d'encourager un joueur moins actif à réengager votre jeu, par exemple en affichant et en promouvant de nouveaux articles dans le jeu lorsque le joueur se connecte.
Ce guide vous explique comment utiliser l'API Player Stats dans une application native C++ ou Objective-C.
Principes de base des statistiques relatives aux joueurs
Vous pouvez utiliser les API Player Stats pour récupérer des données sur l'activité d'un joueur dans un jeu. Voici quelques exemples de types de données de joueurs que vous pouvez obtenir :
- Durée moyenne de la session : durée moyenne de la session du joueur, en minutes. La durée de la session est déterminée par le temps pendant lequel le joueur est connecté aux services de jeux Google Play.
- Probabilité de perte de l'utilisateur: prédiction de la perte d'utilisateurs d'un joueur le lendemain, exprimée sous la forme 0 (faible probabilité de perdre des utilisateurs) ou 1 (forte probabilité de perte de l'utilisateur). La perte d'utilisateurs correspond à une période d'inactivité de sept jours.
- Nombre de jours depuis la dernière partie : nombre approximatif de jours écoulés depuis la dernière partie.
- Nombre d'achats : nombre approximatif d'achats via l'application pour ce joueur.
- Nombre de sessions : nombre approximatif de sessions du joueur. Ce nombre est déterminé par le nombre de fois où un joueur se connecte aux services de jeux Google Play.
- Centile de session: approximation du centile de session pour le lecteur, sous la forme d'une valeur décimale comprise entre 0 et 1 (inclus). Cette valeur indique le nombre de sessions auxquelles le joueur actuel a joué par rapport au reste de la base de joueurs de ce jeu. Un nombre élevé indique qu'il a joué plus de sessions.
- Centile de dépenses: centile approximatif des dépenses du lecteur, sous forme de valeur décimale comprise entre 0 et 1 (inclus). Cette valeur indique le montant dépensé par ce joueur actuel par rapport au reste de la base de joueurs de ce jeu. Un nombre élevé indique des dépenses plus importantes.
Obtenir des statistiques de joueur pour un joueur actuellement connecté avec 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);
Obtenir des statistiques de joueur pour un joueur actuellement connecté avec 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);
}
}];
Conseils d'utilisation des données des statistiques relatives aux joueurs
L'API Play Stats vous permet d'identifier facilement différents types de joueurs en fonction de leur engagement et de leur comportement d'achat. Vous pouvez ainsi appliquer les stratégies appropriées pour améliorer leur expérience de jeu.
Le tableau suivant présente quelques exemples de segments de joueurs et les stratégies d'engagement correspondantes recommandées :
| Segment de joueurs | Stratégie d'engagement |
|---|---|
| Joueurs fréquents avec un grand nombre de sessions et un niveau de dépenses satisfaisant, mais qui n'ont pas joué depuis au moins une semaine. |
|
| Joueurs très engagés dans un centile de dépenses faible. |
|
| Joueurs ayant beaucoup dépensé, mais dont l'activité décline. |
|