Diese Seite wurde von der Cloud Translation API übersetzt.

Spielerstatistiken in Android-Spielen

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 Games v1-Integrationen funktionieren zwar noch einige Jahre, aber wir empfehlen Ihnen, ab Juni 2025 zu Version 2 zu migrieren.
Dieser Leitfaden bezieht sich auf die Verwendung des Play-Spieldienste v1 SDK. Informationen zur neuesten SDK-Version finden Sie in der Dokumentation zu Version 2.

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. Sie können diese API beispielsweise verwenden, um proaktive Maßnahmen zu ergreifen, um einen weniger aktiven Spieler dazu zu bewegen, sich wieder mit Ihrem Spiel zu beschäftigen. Dazu können Sie beispielsweise neue In-Game-Artikel anzeigen und bewerben, wenn sich der Spieler anmeldet.

In diesem Leitfaden erfahren Sie, wie Sie die Player Stats API in Spielen mit Google Play-Spieldiensten verwenden. Die APIs finden Sie in den Paketen com.google.android.gms.games.stats und com.google.android.gms.games.

Hinweis

Bevor Sie die Player Stats API verwenden, sollten Sie Folgendes tun:

Laden Sie das Codebeispiel herunter und sehen Sie es sich an.
Mach dich mit den Empfehlungen in der Checkliste für die Qualität vertraut.

Client für Spielerstatistiken abrufen

Bevor Sie die API für Spielerstatistiken verwenden können, muss Ihr Spiel zuerst ein PlayerStatsClient-Objekt abrufen. Rufen Sie dazu die Methode Games.getPlayerStatsClient() auf und übergeben Sie die Aktivität und die GoogleSignInAccount für den aktuellen Spieler. Informationen zum Abrufen der Spielerkontoinformationen finden Sie unter Anmelden in Android-Spielen.

Grundlagen der Spielerstatistiken

Mit der Player Stats API 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.
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 weisen darauf hin, dass dieser Spieler mehr ausgegeben hat.

Die folgenden Arten von Spielerdaten sind veraltet und geben immer eine Konstante mit dem Wert „unset“ zurück:

Abwanderungswahrscheinlichkeit: Die Vorhersage, ob ein Spieler am nächsten Tag abwandern wird. Der Wert wird als Dezimalzahl zwischen 0 (geringe Wahrscheinlichkeit der Abwanderung) und 1 (hohe Wahrscheinlichkeit der Abwanderung) angegeben. Die Abwanderung wird als 7 Tage Inaktivität definiert.
Ausgabewahrscheinlichkeit: Die ungefähre Wahrscheinlichkeit, dass der Spieler in diesem Spiel Geld ausgibt. Der Wert wird als Dezimalzahl zwischen 0 (geringe Ausgabewahrscheinlichkeit) und 1 (hohe Ausgabewahrscheinlichkeit) angegeben.
Gesamtausgaben in den nächsten 28 Tagen: Die geschätzten Gesamtausgaben der Spieler in diesem Spiel in den nächsten 28 Tagen.
Wahrscheinlichkeit für hohe Ausgaben: Die ungefähre Wahrscheinlichkeit, dass ein Spieler in den nächsten 28 Tagen einen Betrag ausgibt, der zum 95. Prozentil oder höher der Spielerbasis dieses Spiels gehört. Dieser Wert wird als Dezimalwert zwischen 0 (geringe Wahrscheinlichkeit, dass der Nutzer viel ausgibt) und 1 (hohe Wahrscheinlichkeit, dass der Nutzer viel ausgibt) angegeben.

Spielerstatistiken abrufen

So rufen Sie Spielerstatistiken für den aktuell angemeldeten Spieler ab:

Rufen Sie die Methode PlayerStatsClient.loadPlayerStats() auf.
Wenn der Aufruf erfolgreich ist, geben die Google Play-Spieldienste ein Task-Objekt zurück, mit dem asynchron ein PlayerStats-Objekt geladen wird. Mit den Methoden dieses Objekts können Sie Daten zu den Aktivitäten des angemeldeten Spielers in Ihrer App abrufen.

Beispiel:

public void checkPlayerStats() {
  Games.getPlayerStatsClient(this, GoogleSignIn.getLastSignedInAccount(this))
      .loadPlayerStats(true)
      .addOnCompleteListener(new OnCompleteListener<AnnotatedData<PlayerStats>>() {
        @Override
        public void onComplete(@NonNull Task<AnnotatedData<PlayerStats>> task) {
          if (task.isSuccessful()) {
            // Check for cached data.
            if (task.getResult().isStale()) {
              Log.d(TAG, "using cached data");
            }
            PlayerStats stats = task.getResult().get();
            if (stats != null) {
              Log.d(TAG, "Player stats loaded");
              if (stats.getDaysSinceLastPlayed() > 7) {
                Log.d(TAG, "It's been longer than a week");
              }
              if (stats.getNumberOfSessions() > 1000) {
                Log.d(TAG, "Veteran player");
              }
              if (stats.getChurnProbability() == 1) {
                Log.d(TAG, "Player is at high risk of churn");
              }
            }
          } else {
            int status = CommonStatusCodes.DEVELOPER_ERROR;
            if (task.getException() instanceof ApiException) {
              status = ((ApiException) task.getException()).getStatusCode();
            }
            Log.d(TAG, "Failed to fetch Stats Data status: "
                + status + ": " + task.getException());
          }
        }
      });
}

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 sind einige Beispiele für Spielersegmente und empfohlene Engagement-Strategien aufgeführt:

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 Grundlage der nachgewiesenen Freude des Spielers am Spiel versucht, neue Spieler zu gewinnen.
Spieler mit hohen Ausgaben, die Anzeichen dafür zeigen, dass sie ihren Höhepunkt erreicht haben und seltener spielen.	Passe Boni an, um das Interesse der Nutzer aufzufrischen, 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.
Spieler mit einer sehr hohen oder sehr niedrigen Wahrscheinlichkeit, Ausgaben zu tätigen.	Wahrscheinlichkeit gering, dass Nutzer Geld ausgeben: Bieten Sie die Option an, sich eine Videoanzeige anzusehen. Günstigere Artikel zum Kauf anbieten. Wahrscheinlichkeit, dass Nutzer Geld ausgeben: Leiten Sie sie frühzeitig zum In-Game-Shop weiter und bieten Sie ihnen spezielle Angebote an, um sie zum Kauf zu animieren.