Spielerstatistiken für Android-Spiele

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

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. 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 authentifiziert.

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:

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 PlayerStatsClient.getPlayersClient() auf und übergeben Sie die Aktivität.

Die Klasse PlayerStatsClient verwendet die Google Play-Dienste-Klasse Task, um Ergebnisse asynchron zurückzugeben. Weitere Informationen zur Verwendung von Aufgaben zum Verwalten von Threads finden Sie im Entwicklerleitfaden für die 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 Players 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 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:

  • 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 dem 95. Perzentil oder höher der Spielerbasis dieses Spiels entspricht. Dieser Wert wird als Dezimalwert zwischen 0 (geringe Wahrscheinlichkeit, dass der Nutzer zu einem Nutzer mit hohen Ausgaben wird) und 1 (hohe Wahrscheinlichkeit, dass der Nutzer zu einem Nutzer mit hohen Ausgaben wird) angegeben.

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-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 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 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.
  • Zeige dem Spieler bei der nächsten Authentifizierung 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.
  • Wahrscheinlich keine Ausgaben: 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.