Spielerstatistiken zu Ihrem Spiel hinzufügen

Nach der Einstellung der Google Sign-In API entfernen wir 2026 das Games v1 SDK. Nach Februar 2025 können Sie bei Google Play keine Titel mehr veröffentlichen, die neu mit dem Games v1 SDK eingebunden sind. Wir empfehlen stattdessen die Verwendung des Games V2 SDK.
Vorhandene Titel mit der vorherigen V1-Integration für Spiele funktionieren noch einige Jahre lang. Wir empfehlen dir jedoch, ab Juni 2025 auf V2 umzustellen.
Dieser Leitfaden bezieht sich auf die Verwendung des Play Games Services SDK v1. Das C++ SDK für Play Games Services 2 ist noch nicht verfügbar.

Mit der Player Stats API können Sie das Spielerlebnis auf bestimmte Spielersegmente und verschiedene Phasen des Spielerlebenszyklus zuschneiden. Sie können für jedes Spielersegment personalisierte Inhalte erstellen, die auf dem Fortschritt, den Ausgaben und der Interaktion der Spieler basieren. Sie können diese API beispielsweise verwenden, um proaktive Maßnahmen zu ergreifen, um weniger aktive Spieler dazu anzuregen, Ihr Spiel wieder zu spielen. So können Sie beispielsweise neue In-Game-Artikel präsentieren und bewerben, wenn sich der Spieler anmeldet.

In diesem Leitfaden erfährst du, wie du die Player Stats API in einer nativen C++- oder Objective-C-Anwendung verwendest.

Spielerstatistiken – Grundlagen

Mit den Player Stats APIs kannst du Daten zu den Aktivitäten eines Spielers im Spiel abrufen. Du kannst unter anderem folgende Spielerdaten abrufen:

• Durchschnittliche Sitzungsdauer: Die durchschnittliche Sitzungsdauer des Nutzers in Minuten. Die Sitzungsdauer wird durch die Zeit bestimmt, während der ein Spieler in den Google Play-Spieldiensten angemeldet ist.
• Abwanderungswahrscheinlichkeit: Die Vorhersage, ob ein Spieler am nächsten Tag abwandert, angegeben als 0 (geringe Abwanderungswahrscheinlichkeit) oder 1 (hohe Abwanderungswahrscheinlichkeit). Als Abwanderung wird eine Inaktivität von 7 Tagen definiert.
• Tage seit der letzten Aktivität: Die ungefähre Anzahl der Tage, seit der Spieler zuletzt aktiv war.
• Anzahl der Käufe: Die ungefähre Anzahl der In-App-Käufe des Spielers.
• Anzahl der Sitzungen: Die ungefähre Anzahl der Sitzungen des Spielers. Sitzungen werden anhand der Häufigkeit bestimmt, mit der sich ein Spieler in den Google Play-Spieldiensten anmeldet.
• Sitzungsprozentil: Die Schätzung des Sitzungsprozentils für den Spieler, angegeben als Dezimalzahl zwischen 0 und 1 (einschließlich). Dieser Wert gibt an, wie viele Sitzungen der aktuelle Spieler im Vergleich zum Rest der Spielerbasis dieses Spiels gespielt hat. Je höher die Zahl, desto mehr Sitzungen hat dieser Spieler absolviert.
• Perzentil der Ausgaben: Das ungefähre Perzentil der Ausgaben des Spielers, angegeben als Dezimalzahl zwischen 0 und 1 (einschließlich). Dieser Wert gibt an, wie viel der aktuelle Spieler im Vergleich zum Rest der Spielerbasis dieses Spiels ausgegeben hat. Je höher die Zahl, desto mehr hat dieser Spieler ausgegeben.

Spielerstatistiken für einen aktuell angemeldeten Spieler mit C++ abrufen

// 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);

Spielerstatistiken für einen aktuell angemeldeten Spieler mit Objective-C abrufen

// 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);
  }
}];

Tipps zur Verwendung von Spielerstatistiken

Mit der Play Stats API können Sie verschiedene Arten von Spielern anhand ihres Interaktions- und Ausgabeverhaltens ganz einfach identifizieren und entsprechende Strategien zur Verbesserung des Spiels anwenden.

In der folgenden Tabelle findest du einige Beispiele für Spielersegmente und empfohlene Strategien für die Interaktion: