Diese Seite wurde von der Cloud Translation API übersetzt.

Spielerstatistiken in Android-Spielen

Mit der Player Stats API können Sie das Spielerlebnis an bestimmte Segmente Spieler und verschiedene Phasen des Spielerlebenszyklus. Sie können maßgeschneiderte Erfahrungen für jedes Spielersegment basierend auf Fortschritt, Ausgaben, und ansprechend zu gestalten. Mit dieser API können Sie beispielsweise proaktive Maßnahmen einen weniger aktiven Spieler dazu zu bringen, sich wieder mit Ihrem Spiel zu beschäftigen, z. B. indem Anzeigen und Werbung für neue In-Game-Artikel, wenn sich der Spieler anmeldet

In diesem Leitfaden erfährst du, wie du die Player Stats API in Spielen mithilfe der Google Play-Spieldienste. Die APIs finden Sie in der com.google.android.gms.games.stats und com.google.android.gms.games Pakete.

Hinweis

Bevor du die Player Stats API verwendest:

Laden Sie die Codebeispiel an.
Machen Sie sich mit den Empfehlungen vertraut, die in der Checkliste für die Qualität

Client für Spielerstatistiken abrufen

Um die Player Stats API nutzen zu können, muss dein Spiel zunächst eine PlayerStatsClient-Objekt. Rufen Sie dazu die Methode Games.getPlayerStatsClient() und übergeben die Aktivitäten.

Grundlagen der Spielerstatistiken

Mit der Player Stats API können Sie Daten über das Spielgeschehen eines Spielers abrufen. Aktivitäten. Sie können unter anderem folgende Spielerdaten abrufen:

Durchschnittliche Sitzungslänge: Die durchschnittliche Sitzungslänge des Spielers in Minuten. Die Sitzungslänge wird durch die Zeit bestimmt, zu der ein Spieler angemeldet ist. Google Play-Spieldienste
Tage seit der letzten Wiedergabe: Die ungefähre Anzahl der Tage seit der letzten Wiedergabe. zuletzt gespielt.
Anzahl der Käufe: Die ungefähre Anzahl der In-App-Käufe für Player.
Anzahl der Sitzungen: Die ungefähre Anzahl der Sitzungen des Spielers. Sitzungen werden durch die Anzahl der Anmeldungen eines Spielers bestimmt. Google Play-Spieldienste
Sitzungsperzentil: Die Annäherung des Sitzungsperzentils für die Player als Dezimalwert zwischen 0 und 1 (jeweils einschließlich). Dieser Wert gibt an, wie viele Sitzungen, die der aktuelle Spieler im Vergleich zu den anderen Spielern in diesem Spiel gespielt hat und die Basis verwenden. Höhere Zahlen bedeuten, dass dieser Spieler mehr Sitzungen gespielt hat.
Ausgabenperzentil: Das ungefähre Ausgabenperzentil des Spielers unter Berücksichtigung der als Dezimalwert zwischen 0 und 1 (einschließlich). Dieser Wert gibt an, wie viel hat der aktuelle Spieler im Vergleich zum Rest des Spielers in diesem Spiel ausgegeben und die Basis verwenden. Höhere Werte bedeuten, dass dieser Spieler mehr ausgegeben hat.

Die folgenden Arten von Spielerdaten werden nicht mehr unterstützt. Sie geben immer einen nicht festgelegten Wert zurück. Wertkonstante:

Abwanderungswahrscheinlichkeit: Die Vorhersage, ob ein Spieler abwandern wird am nächsten Tag als Dezimalwert zwischen 0 (geringe Wahrscheinlichkeit von Abwanderung) bis einschließlich 1 (hohe Abwanderungswahrscheinlichkeit). Die Abwanderung ist definiert als 7 Tage Inaktivität.
Ausgabenwahrscheinlichkeit: die ungefähre Wahrscheinlichkeit des Spielers in diesem Spiel als Dezimalwert zwischen 0 (niedrig Ausgabenwahrscheinlichkeit) bis einschließlich 1 (hohe Ausgabenwahrscheinlichkeit).
Gesamtausgaben in den nächsten 28 Tagen: der ungefähre Gesamtwert des erwarteten Spielers in diesem Spiel in den nächsten 28 Tagen ausgeben.
Wahrscheinlichkeit des Kaufs mit hohem Ausgaben: Die ungefähre Wahrscheinlichkeit, dass über wird ein Spieler in den nächsten 28 Tagen einen Betrag in Höhe von 95 Tagen oder höher der Spielerbasis dieses Spiels. Wird als Dezimalzahl angegeben Wert zwischen 0 (geringe Wahrscheinlichkeit, zahlungskräftig zu werden) bis 1 (hoch) Wahrscheinlichkeit, kaufkräftig zu werden).

Spielerstatistikdaten werden abgerufen

So kannst du Spielerstatistiken für den aktuell angemeldeten Spieler abrufen: Schritte:

Rufen Sie die Methode PlayerStatsClient.loadPlayerStats() auf.
Wenn der Anruf erfolgreich ist, geben die Google Play-Spieldienste eine Task-Objekt, das lädt asynchron ein PlayerStats-Objekt. Verwenden Sie die Methoden dieses Objekts, um Daten über Aktivitäten des angemeldeten Spielers in Ihrer App.

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 Spielerstatistikdaten

Mit der Play Stats API kannst du ganz einfach verschiedene Spielertypen anhand der ihr Engagement- und Ausgabenverhalten anpassen und geeignete Strategien das Spielerlebnis zu verbessern.

In der folgenden Tabelle sind einige Beispiele für Spielersegmente und empfohlene Strategien zur Interaktion:

Spielersegment	Interaktionsstrategie
Häufige Spieler mit vielen Sitzungen und guten Ausgaben -Perzentil, aber seit mindestens einer Woche nicht mehr abgespielt.	Benachrichtigung über einen Rabatt oder einen Sonderbonus senden nach ihrer Rückkehr ins Spiel verfügbar. Zeigen Sie eine Willkommensnachricht, die eine beeindruckende und ein Abzeichen erhalten, das Ihre die Wiedergabe zurück.
Sehr aktive Spieler bei einem niedrigen Ausgabenperzentil.	Individuelle Boni als Anreiz für das Einladen von Freunden um dein Spiel zu installieren und ihm beizutreten. Dieser Ansatz baut auf der Spaß am Spiel gezeigt hat, um neue Spieler zu rekrutieren.
Umsatzstarke Spieler, die Anzeichen dafür haben, dass sie ihren Höhepunkt erreicht haben seltener zu spielen.	Individuelle Boni, um ihr Interesse zu wecken, z. B. durch die hochwertige, kurzzeitige Werkzeuge, Waffen Rabatte. Wenn sich der Spieler das nächste Mal anmeldet, wird ein Video mit auf Community-Funktionen wie Clan-Angriffe, die Interaktionen häufiger und länger fördern.
Spieler mit sehr hoher oder sehr niedriger Ausgabenwahrscheinlichkeit.	Unwahrscheinliche Ausgaben: Option zum Ansehen einer Anzeige anbieten Video. Günstigere Artikel zum Kauf anzeigen. Kaufwahrscheinlich: Zeige den Kunden frühzeitig den In-Game-Store, und bieten spezielle Werbeaktionen an, um Nutzer zum Kauf anzuregen.