Spielerstatistiken zu Ihrem Spiel hinzufügen

Nach der Einstellung der Google-Anmeldung-API wird das games v1 SDK im Jahr 2026 entfernt. Ab Februar 2025 kannst du bei Google Play keine Titel mehr veröffentlichen, die neu in Games SDK V1 integriert wurden. Wir empfehlen, stattdessen das Games SDK V2 zu verwenden.
Bestehende Titel mit den vorherigen Integrationen für Spiele v1 funktionieren zwar noch einige Jahre, aber wir empfehlen Ihnen, ab Juni 2025 zu Version 2 zu migrieren.
In diesem Leitfaden wird die Verwendung des Play Games Services SDK V1 beschrieben. Das C++ SDK für Play Games Services v2 ist noch nicht verfügbar.

Mit der Player Stats API können Sie das Spielerlebnis an bestimmte Spielersegmente und verschiedene Phasen des Spielerlebenszyklus anpassen. Sie können für jedes Spielersegment maßgeschneiderte Erlebnisse erstellen, die auf dem Fortschritt, den Ausgaben und dem Engagement der Spieler basieren. Mit dieser API können Sie beispielsweise proaktive Maßnahmen ergreifen, um weniger aktive Spieler dazu zu bewegen, sich wieder mit Ihrem Spiel zu beschäftigen. So können Sie beim Anmelden des Spielers neue In-Game-Artikel präsentieren und bewerben.

In diesem Leitfaden erfahren Sie, wie Sie die Player Stats API in einer nativen C++- oder Objective-C-Anwendung verwenden.

Grundlagen der Spielerstatistiken

Mit den Player Stats APIs können Sie Daten zur In-Game-Aktivität eines Spielers abrufen. Sie können unter anderem folgende Arten von Spielerdaten abrufen:

  • Durchschnittliche Sitzungslänge: Die durchschnittliche Sitzungslänge des Players in Minuten. Die Sitzungslänge wird durch die Zeit bestimmt, die ein Spieler in den Google Play-Spieldiensten angemeldet ist.
  • Abwanderungswahrscheinlichkeit: Die Vorhersage, ob ein Spieler am nächsten Tag abwandern wird. Angegeben als 0 (geringe Wahrscheinlichkeit der Abwanderung) oder 1 (hohe Wahrscheinlichkeit der Abwanderung). Die Abwanderung wird als 7 Tage Inaktivität definiert.
  • Tage seit dem letzten Spiel: Die ungefähre Anzahl der Tage seit dem letzten Spiel des Spielers.
  • Anzahl der Käufe: Die ungefähre Anzahl der In-App-Käufe für den Spieler.
  • Anzahl der Sitzungen: Die ungefähre Anzahl der Sitzungen des Spielers. Sitzungen werden durch die Anzahl der Anmeldungen eines Spielers bei den Google Play-Spieldiensten bestimmt.
  • Sitzungsperzentil: Die Schätzung des Sitzungsperzentils für den Spieler als Dezimalwert 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. Höhere Zahlen weisen darauf hin, dass dieser Spieler mehr Sitzungen gespielt hat.
  • Ausgaben-Perzentil: Das ungefähre Ausgaben-Perzentil des Spielers als Dezimalwert 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. Höhere Zahlen bedeuten, dass dieser Spieler mehr ausgegeben hat.

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 Engagements und ihrer Ausgaben identifizieren und geeignete Strategien anwenden, um ihr Spielerlebnis zu verbessern.

In der folgenden Tabelle finden Sie einige Beispiele für Spielersegmente und empfohlene Engagement-Strategien:

Player-Segment Strategie zur aktiven Einbindung der Teilnehmer
Häufige Spieler mit einer hohen Anzahl von Sitzungen und einem guten Ausgaben-Perzentil, die in der letzten Woche oder länger nicht gespielt haben.
  • Senden Sie eine Benachrichtigung über einen Rabatt oder einen besonderen Bonus, der bei der Rückkehr zum Spiel verfügbar ist.
  • Zeige eine Willkommensnachricht an, in der beeindruckende Leistungen gewürdigt werden, und verleihe ein Badge, das zur Rückkehr ins Spiel anregen soll.
Spieler mit hoher Interaktion in einem niedrigen Ausgaben-Perzentil.
  • Passen Sie Boni an, um Nutzer dazu zu motivieren, ihre Freunde einzuladen, Ihr Spiel zu installieren und zu spielen. Bei diesem Ansatz wird auf der Freude des Spielers am Spiel aufgebaut, um neue Spieler zu gewinnen.
Spieler mit hohen Ausgaben, die Anzeichen dafür zeigen, dass sie ihren Höhepunkt erreicht haben und seltener spielen.
  • Passen Sie Boni an, um das Interesse der Nutzer zu wecken, z. B. durch hochwertige, kurzlebige Tools, Waffen oder Rabatte.
  • Wenn sich der Spieler das nächste Mal anmeldet, zeige ihm ein Video, in dem er auf Community-Funktionen wie Clankämpfe hingewiesen wird, die zu häufigeren und längeren Interaktionen führen.