Spielstatistiken einbinden

In diesem Dokument wird erläutert, wie Sie Spielstatistiken über die Google Play Console in Ihr Spiel einbinden. Darin werden die wichtigsten CSV- und ZIP-Dateiformate behandelt und es wird beschrieben, wie Sie sie erstellen, importieren und verwalten.

Ereignisse erstellen

So erstellen Sie ein Ereignis für ein neues, unveröffentlichtes Spiel:

  1. CSV-Datei für Ereignisse erstellen: PlayerGameEvent.csv
  2. Wählen Sie in der Google Play Console ein Spiel aus.
  3. Wählen Sie auf der Seite Play Games-Dienste – Spielstatistiken (Nutzer gewinnen > Play Games-Dienste > Einrichtung und Verwaltung > Spielstatistiken) die Option Ereignisse einrichten aus.
  4. Ziehen Sie die CSV-Datei, die Sie hochladen möchten, auf der Seite Ereigniskonfiguration in den entsprechenden Bereich.
  5. Nachdem Sie ein Event erstellt haben, müssen Sie Statistiken einrichten.

Statistiken einrichten

Nachdem Sie ein Event erstellt haben, müssen Sie Statistiken einrichten:

  1. Erstellen Sie die ZIP-Datei mit Statistiken, Lokalisierungen und Symboldateien. Richtlinien für ZIP-Dateien mit Statistiken
  2. Wählen Sie in der Google Play Console ein Spiel aus.
  3. Wählen Sie auf der Seite Play Games-Dienste – Spielstatistiken (Nutzer gewinnen > Play Games-Dienste > Einrichtung und Verwaltung > Spielstatistiken) die Option Statistiken einrichten aus.
  4. Ziehen Sie die ZIP-Datei auf der Seite Konfiguration der Spielstatistiken, um sie hochzuladen.
  5. Nachdem Sie alle Statistiken hochgeladen haben, können Sie Ihr Spiel veröffentlichen.

Testspielstatistiken

So testen Sie, ob die Spielstatistiken wie vorgesehen funktionieren:

  • Richten Sie einen internen Test-Track ein.
  • Füge Testkonten für Tester zu deinem Spielprojekt hinzu.
  • Erstellen Sie mit der Play Games App ein Play Games-Dienste-Profil für eines der Testkonten.
  • Öffnen Sie das Spiel mit demselben Testkonto, für das Sie das Play Games-Dienste-Profil erstellt haben.
  • Prüfen Sie, ob beim Start des Spiels der Play Games-Dienste-„Willkommens-Toast“ auf dem Bildschirm angezeigt wird. Dies ist ein Hinweis auf eine erfolgreiche automatische Authentifizierung.
  • Der Nutzer des Testkontos kann das Spiel spielen, um die Ereignisse auszulösen. Prüfen Sie die API-Antwort, um festzustellen, ob die Ereignisse aufgezeichnet wurden.

Spielstatistiken veröffentlichen

Nach dem Testen müssen Sie Ihr Spiel veröffentlichen. Alle Events und Statistiken Ihres Spiels werden damit veröffentlicht.

So veröffentlichen Sie:

  1. Wählen Sie in der Google Play Console ein Spiel aus.
  2. Klicken Sie auf der Seite Play Games-Dienste – Spielstatistiken (Nutzer gewinnen > Play Games-Dienste > Einrichtung und Verwaltung > Spielstatistiken) auf Überprüfen und veröffentlichen.
  3. Sehen Sie sich auf der Seite Play Games-Dienste – Veröffentlichung (Nutzer gewinnen > Play Games-Dienste > Einrichtung und Verwaltung > Veröffentlichung) die Aktionen an und beheben Sie die Probleme.
  4. Klicken Sie auf Veröffentlichen. Alle deine Spielstatistiken sind veröffentlicht.

Spielstatistiken löschen

Sobald die Spielstatistiken veröffentlicht wurden, können sie nicht mehr gelöscht werden.

Richtlinien für CSV-Dateien für Ereignisse

Die erste Zeile der CSV-Datei ist eine Kopfzeile. Sie müssen Ereignisse mit der CSV-Datei für Ereignisse importieren, z. B. PlayerGameEvent.csv.

Format „PlayerGameEvent.csv“

Die CSV-Datei enthält das deklarierte Ereignis und seine Attribute als kommagetrennte Werte in der folgenden Reihenfolge:

 Event Name,Property Name,Property Type

Wenn Sie das Ereignis progressUpdate für progressionStat senden, fügen Sie eine Zeile für dieses Ereignis hinzu. Dieses Ereignis muss mindestens eine currentProgress-Property vom Typ INT oder STRING sowie alle anderen Properties enthalten, die Sie senden möchten.

Die einzelnen Felder werden in der folgenden Tabelle beschrieben:

CSV-Spaltenüberschriften Erforderlich oder optional Gültige Werte
Ereignisname Erforderlich Maximal 50 Zeichen

Darf nur aus Buchstaben, Zahlen und Unterstrichen bestehen.

Wenn der Name des besonderen Ereignisses progressUpdate verwendet wird, muss er ein Attribut namens currentProgress vom Typ INT64 oder STRING enthalten.
Property-Name Erforderlich Maximal 50 Zeichen

Darf nur aus Buchstaben, Zahlen und Unterstrichen bestehen.

Eindeutig pro Ereignis:Attributnamen müssen innerhalb desselben Ereignisses eindeutig sein.

Verwenden Sie nicht die folgenden reservierten Keywords:id, count, key, value, where, from, and, or, true oder false.
Property-Typ Erforderlich Enum-String, bei dem die Groß- und Kleinschreibung berücksichtigt wird und der einem der unterstützten Datentypen entspricht: INT64, DOUBLE, STRING, BOOL

Anforderungen an die Datei „PlayerGameEvent.csv“:

  • Die Datei unterstützt maximal 20 eindeutige Ereignisnamen mit bis zu 20 Properties pro Ereignis.
  • Der Dateiinhalt darf nicht leer sein und muss mindestens eine Zeile enthalten.
Beispieltabelle
Ereignisname Property-Name Property-Typ
matchCompleted Dauer DOUBLE
matchCompleted tötet INT64
matchCompleted isWinner BOOL
matchCompleted matchType STRING
itemCollected coinsAmount INT64
itemCollected weaponType STRING
progressUpdate currentProgress INT64

Richtlinien für ZIP-Dateien für Statistiken

Sie können Statistiken gleichzeitig mithilfe einer ZIP-Datei importieren. Die Dateinamen, die Sie für Ihre ZIP-Datei verwenden müssen, finden Sie in der folgenden Tabelle:

Dateiname Erforderlich oder optional Gültige Werte
RepetitiveStatsConfig.csv Erforderlich Eine sich wiederholende Statistik stellt regelmäßig auftretende In-Game-Aktionen dar, die von Spielern ausgeführt werden.
ProgressionStatConfig.csv Erforderlich Eine Fortschrittsstatistik stellt den Fortschritt eines Spielers in einem Spiel dar.
StatLocalizations.csv Optional Übersetzungen der Namen und Beschreibungen von Spielstatistiken.
Symboldateien Erforderlich Symbole im PNG-, JPEG- oder JPG-Format mit einer Größe von 512 × 512 Pixel.

Die ZIP-Datei muss die folgenden Anforderungen erfüllen:

  • Größenbeschränkung für ZIP-Dateien:Die maximale unkomprimierte Gesamtgröße beträgt 10 MB.
  • Maximale Anzahl von Dateien:Das ZIP-Archiv darf maximal 53 Dateien enthalten (3 CSV-Dateien und 50 Symbole).
  • Maximales Limit für kombinierte Statistiken:Insgesamt maximal 50 Statistiken für ProgressionStatConfig.csv und RepetitiveStatsConfig.csv.
  • Unterstützte CSV-Dateien:ProgressionStatConfig.csv, RepetitiveStatsConfig.csv und StatLocalizations.csv (optional). Wenn Sie nur Fortschrittsstatistiken hochladen möchten, fügen Sie die CSV-Datei mit den sich wiederholenden Statistiken nicht in die ZIP-Datei ein. Andernfalls wird in der Konsole ein Fehler ausgegeben. Dasselbe gilt, wenn Sie nur sich wiederholende Statistiken hochladen möchten.
  • Symboldateien:PNG (.png) oder JPEG (.jpg, .jpeg).
    • Alle Symbole, auf die in den CSV-Dateien verwiesen wird, müssen sich im Stammverzeichnis der ZIP-Datei befinden.
    • Auf alle Bilddateien in der ZIP-Datei muss in mindestens einer Statistik verwiesen werden.
  • Verzeichnisstruktur:Alle Dateien müssen sich im Stammverzeichnis der ZIP-Datei befinden. Unterverzeichnisse sind nicht zulässig.

Format „RepetitiveStatsConfig.csv“

Die CSV-Datei enthält das deklarierte Ereignis und seine Attribute als kommagetrennte Werte in der folgenden Reihenfolge:

Stat Id,Event Name,Event Property Name,Aggregation Type,Stat Display Name,Stat Description,Filter Property,Filter Operator,Filter Value,Is Competitive,Min limit,Max limit,Icon File Name,Good value direction,Unit

Die einzelnen Felder werden in der folgenden Tabelle beschrieben:

CSV-Spaltenüberschriften Erforderlich oder optional Gültige Werte
Stat-ID Erforderlich Maximal 100 Zeichen

Darf nur aus Buchstaben, Zahlen und Unterstrichen bestehen. Muss für alle Statistiken im Spiel eindeutig sein.
Name der Ereignis-Property Erforderlich Maximal 50 Zeichen
Anzeigename der Statistik Erforderlich Maximal 50 Zeichen
Standard-Anzeigename für die Statistik (Standardsprache). Muss für alle Statistiken eindeutig sein.
Stat Description Erforderlich Maximal 500 Zeichen
Standardbeschreibung für die Statistik.
Zusammenfassungstyp Erforderlich Maximal 50 Zeichen
SUM, MAX, MIN, COUNT.
Filter Optional Maximal 50 Zeichen
Muss ein in PlayerGameEvent.csv definierter Eigenschaftsname sein.
Filteroperator Optional =, !=, >, <, >=, <=
Vergleichsoperatoren für Filter.
Filterwert Optional Im Vergleich zur Filter-Property. Der Filterwert muss INT64, DOUBLE, BOOL, STRING sein.
Wettbewerbsfähig Erforderlich true, false
Mindestlimit Erforderlich, wenn „Is Competitive“ auf „true“ gesetzt ist Zulässige Mindestpunktzahl für Statistiken zum Wettbewerb.
Limit Erforderlich, wenn „Is Competitive“ auf „true“ gesetzt ist Maximal zulässige Punktzahl für Wettbewerbsstatistiken.
Dateiname des Symbols Erforderlich Der Dateiname des Symbolbilds, das im Stammverzeichnis der ZIP-Datei enthalten ist. Darf nicht mit Symboldateinamen in sich wiederholenden Statistiken in Konflikt stehen.
Gute Wertrichtung Erforderlich Gibt an, ob höhere Werte INCREASING oder niedrigere Werte DECREASING besser sind.
Einheit Optional Maßeinheit für numerische Rohwerte oder Dauerwerte. Beispiele: KILOMETER, SECOND, PERCENTAGE, UNITLESS.

Wenn Sie die Filterbedingung nicht verwenden möchten, lassen Sie die Zelle leer.

Beispieltabelle
Stat-ID Ereignisname Property-Name Aggregation Anzeigename der Statistik Stat Description Filter (optional) Filteroperator (optional) Filterwert (optional) Wettbewerbsfähig minLimit maxLimit Dateiname des Symbols Sequenznummer Gute Wertrichtung Einheit
1 matchCompleted Dauer MAX Längstes Überleben in einem Match Dies gibt die Überlebenszeit eines Spielers in einem beliebigen Match an. isWinner = TRUE TRUE 0 50 stat1.png 1 Rückgang Sekunden
2 matchCompleted isWinner COUNT Gewonnene Spiele Gibt die Anzahl der Spiele an, die ein Spieler gewonnen hat. isWinner = TRUE TRUE 0 50 stat3.png 2 Steigerung
3 matchCompleted tötet SUM Kills im 1-gegen-1-Match Anzahl der Kills in 1-gegen-1-Matches matchType = „1-on-1“ FALSE stat4.png 4 Steigerung
4 itemCollected coinsAmount SUM Insgesamt gesammeltes Gold Spieler sammelt Münzen während eines Spiels weaponType = „sword“ FALSE stat2.png 3 Steigerung

Format „ProgressionStatConfig.csv“

Die CSV-Datei enthält das deklarierte Ereignis und seine Attribute als kommagetrennte Werte in der folgenden Reihenfolge:

Stat Id,Event Property Name,Stat Display Name,Stat Description,Icon File Name,Good value direction,Unit

Die Fortschrittsstatistik wird Spielern in ihrem Spielerprofil als erste Statistik angezeigt.

Die einzelnen Felder werden in der folgenden Tabelle beschrieben:

CSV-Spaltenüberschriften Erforderlich oder optional Gültige Werte
Stat-ID Erforderlich Maximal 100 Zeichen

Darf nur aus Buchstaben, Zahlen und Unterstrichen bestehen. Muss für alle Statistiken im Spiel eindeutig sein.
Ereignisname Erforderlich Maximal 50 Zeichen

Muss auf den im PlayerGameEvent.csv-Format definierten Ereignisnamen verweisen.
Name der Ereignis-Property Erforderlich Maximal 50 Zeichen

Muss ein in der Datei PlayerGameEvent.csv definierter Eigenschaftsname sein.
Anzeigename der Statistik Erforderlich Muss ein eindeutiger Name sein.
Stat Description Erforderlich Maximal 50 Zeichen
Standardbeschreibung für die Statistik.
Dateiname des Symbols Erforderlich Der Dateiname des Symbolbilds, das im Stammverzeichnis der ZIP-Datei enthalten ist. Darf nicht mit Symboldateinamen in sich wiederholenden Statistiken in Konflikt stehen.
Gute Wertrichtung Erforderlich Gibt an, ob höhere Werte INCREASING oder niedrigere Werte DECREASING besser sind.
Einheit Optional Maßeinheit für numerische Rohwerte oder Dauerwerte. Beispiele: KILOMETER, SECOND, PERCENTAGE, UNITLESS.
Beispieltabelle
Stat-ID Name der Ereigniseigenschaft Anzeigename des Statistiksatzes Stat Description (Beschreibung der Statistik) Dateiname des Symbols Gutes Preis-Leistungs-Verhältnis
5 currentProgress Level Spieler sammeln durch das Spielen von Matches EP und steigen im Level auf. Level.png steigend

Format „StatLocalizations.csv“

Die CSV-Datei enthält das deklarierte Ereignis und seine Attribute als kommagetrennte Werte in der folgenden Reihenfolge:

Stat Id,Stat Display Name,Locale,Localized Stat Display Name,Localized Stat Description

Die einzelnen Felder werden in der folgenden Tabelle beschrieben:

CSV-Spaltenüberschriften Erforderlich oder optional Gültige Werte
Stat-ID Erforderlich Maximal 100 Zeichen

Darf nur aus Buchstaben, Zahlen und Unterstrichen bestehen. Muss für alle Statistiken im Spiel eindeutig sein.
Anzeigename der Statistik Erforderlich Muss ein eindeutiger Name sein.
Sprache Erforderlich Der Sprachcode, z. B.: en-US.
Fügen Sie Übersetzungen für Ihr Spiel hinzu, bevor Sie eine Sprache angeben. Beachten Sie, dass Sie keine Standardsprache angeben können.

Die unterstützten Sprachcodes finden Sie in der Liste der unterstützten Sprachen.
Lokalisierter Anzeigename für Statistiken Optional Maximal 50 Zeichen. Der übersetzte Anzeigename der Statistik für das angegebene Gebietsschema.
Lokalisierte Beschreibung der Statistik Optional Maximal 500 Zeichen Übersetzte Statistikbeschreibung für die angegebene Sprache.
Beispieltabelle
Stat-ID Anzeigename des Statistiksatzes Language Code Localized Stat Name (UTF-8) Localized Stat Description (UTF-8) 1 Längstes Überleben in einem Match es Supervivencia más larga en partidos Esto denota el tiempo de supervivencia de una jugadora en cualquier partido. 1 Längstes Überleben in einem Match fr Überleben des längsten Spiels Cela indique la durée de survie d'un joueur dans n'importe quel match. 4 Insgesamt gesammeltes Gold es Insgesamt gesammeltes Gold La jugadora recoge monedas mientras juega en un partido 4 Insgesamt gesammeltes Gold fr Oder „total collecté“ Le joueur collecte des pièces en jouant un match

Symboldateien

Symbole, auf die Sie in der Datei .csv verweisen, müssen im aktuell importierten ZIP-Archiv vorhanden sein.

Für die Symbolvalidierung gelten folgende Regeln:

Validierungseigenschaft Erzwungene Einschränkung / Regel
Maximale Dateigröße Maximal 1 MB (1.048.576 Byte) pro Symboldatei.
Abmessungen Genau 512 × 512 Pixel (Breite = 512, Höhe = 512)
Seitenverhältnis Genau 1:1 (quadratisches Seitenverhältnis)
Zulässige Formate PNG (.png) und JPEG (.jpg, .jpeg)
Platzierung in ZIP-Datei Muss sich im Stammverzeichnis der ZIP-Datei befinden.
Referenzierte Prüfung Alle in den Spalten „Symboldateiname“ angegebenen Symboldateinamen müssen in der ZIP-Datei vorhanden sein.
Überprüfung auf verwaiste Inhalte Auf alle Bilddateien in der ZIP-Datei muss mindestens eine Statistik verweisen.
Konfliktprüfung Die Dateinamen der Symbole in ProgressionStatConfig.csv dürfen nicht mit RepetitiveStatsConfig.csv in Konflikt stehen.
Visuelle Duplikate Doppelte Symbole werden gekennzeichnet.

Symbolrichtlinien

Symbole sollten als PNG-, JPEG- oder JPG-Dateien im Format 512 × 512 erstellt werden.

Es wird für alle Gebietsschemas dasselbe Symbol verwendet. Deshalb raten wir davon ab, in Symbolen Text oder lokalisierte Inhalte zu verwenden.

Einheitsspezifikation

In den Spalten „Einheit“ wird festgelegt, wie Rohstatistiken für Spieler formatiert und lokalisiert werden.

Eigenschaften für numerische Statistiken (INT64, DOUBLE)

Zulässiger Einheitenwert Beispiel für Rohwert
(Leer) / UNITLESS / NONE 1234567
% / PROZENTSATZ / PROZENT 0,857
Entfernung/Länge: CENTIMETER, METER, KILOMETER, FOOT, INCH, MILE, YARD, MILLIMETER, NANOMETER 15 (KILOMETER)
Geschwindigkeit: KILOMETER_PER_HOUR, METER_PER_SECOND, MILE_PER_HOUR 60 (MILE_PER_HOUR)

Nicht numerische Statistikeigenschaften (STRING, BOOL)

Einheitenspalten müssen leer bleiben.