<ph type="x-smartling-placeholder">
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ät und GoogleSignInAccount
für den aktuellen Spieler. Wenn Sie mehr darüber erfahren möchten, wie Sie
Informationen zum Spielerkonto abrufen, siehe
Anmeldung in Android-Spielen
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 geben an, 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 der aktuelle Spieler im Vergleich zu den anderen Spielern in diesem Spiel ausgegeben hat 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 ein nicht gesetztes 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 den nächsten 28 Tagen in diesem Spiel 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 einPlayerStats
-Objekt. Verwenden Sie die Methoden dieses Objekts, um Daten über Aktivitäten des angemeldeten Spielers in Ihrer App.
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 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. |
|
Sehr aktive Spieler bei einem niedrigen Ausgabenperzentil. |
|
Umsatzstarke Spieler, die Anzeichen dafür haben, dass sie ihren Höhepunkt erreicht haben und angefangen haben weniger häufig spielen. |
|
Spieler mit sehr hoher oder sehr niedriger Ausgabenwahrscheinlichkeit. |
|