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 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. Informationen zur neuesten SDK-Version finden Sie in der Dokumentation zu Version 2.

Mit der API für Spielerstatistiken 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. Dazu 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 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-Statistik-API verwenden, müssen Sie Folgendes tun:

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

Client für Spielerstatistiken herunterladen

Damit Sie die Player Stats API 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 Spieler-Kontoinformationen finden Sie unter Anmeldung 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 (jeweils 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.

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

Spielerstatistiken abrufen

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

1. Rufen Sie die Methode PlayerStatsClient.loadPlayerStats() auf.
2. Wenn der Aufruf erfolgreich ist, geben die Google Play-Spieledienste ein Task-Objekt zurück, das asynchron ein PlayerStats-Objekt lädt. 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 finden Sie einige Beispiele für Spielersegmente und empfohlene Engagement-Strategien: