Spielerstatistiken für Android-Spiele

In diesem Leitfaden wird beschrieben, wie Sie die Player Stats API für Google Play Games-Dienste verwenden. Mit der Player Stats API können Sie Daten zur In-Game-Aktivität eines Spielers abrufen.

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 ein individuelles Erlebnis erstellen, das auf dem Fortschritt, den Ausgaben und der Interaktion der Spieler basiert. 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 Authentifizieren des Spielers neue In-Game-Artikel präsentieren und bewerben.

Die APIs befinden sich 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.

Spielerstatistiken-Client abrufen

Bevor Sie die Spielerstatistiken-API verwenden können, muss Ihr Spiel zuerst ein PlayerStatsClient-Objekt abrufen. Rufen Sie dazu die Methode PlayerStatsClient.getPlayersClient() auf und übergeben Sie die Aktivität.

In der Klasse PlayerStatsClient wird die Klasse Task der Google Play-Dienste verwendet, um Ergebnisse asynchron zurückzugeben. Weitere Informationen zur Verwendung von Aufgaben zum Verwalten von Threads finden Sie im Entwicklerleitfaden zur Tasks API.

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 Spielers in Minuten. Die Sitzungslänge wird durch die Zeit bestimmt, in der ein Spieler von den Google Play-Spieldiensten authentifiziert wird.

• 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 Authentifizierungen eines Spielers über die Google Play-Spieldienste bestimmt.

• Sitzungsperzentil: Die ungefähre Angabe 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 deuten 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 nicht festgelegte Wertkonstante zurück:

Spielerstatistiken abrufen

So rufen Sie Spielerstatistiken für den authentifizierten Spieler ab:

1. Rufen Sie die Methode PlayerStatsClient.loadPlayerStats() auf.

2. Wenn der Aufruf erfolgreich ist, geben die Google Play-Spieldienste 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 authentifizierten Spielers in Ihrer App abrufen.

Beispiel:

public void checkPlayerStats() {
  PlayGames.getPlayerStatsClient(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 ihrer Nutzerinteraktion und ‑bindung 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 Strategien zur Nutzerinteraktion und ‑bindung: