In diesem Dokument wird beschrieben, wie Sie Erfolge in Ihr Spiel einbinden. Dazu können Sie die Google Play Console oder API-Aufrufe verwenden. Darin werden die wichtigsten Elemente und Status von Erfolgen beschrieben und es wird erläutert, wie Sie sie erstellen, importieren und verwalten.
Hinweis
Erläuterungen zu diesen Begriffen finden Sie unter Grundlagen für Erfolge.
Neue Erfolge erstellen oder importieren
So implementieren Sie Erfolge von Grund auf:
Erfolge hinzufügen
Es gibt zwei Möglichkeiten, in der Google Play Console Erfolge erstmalig zu erstellen:
- Erfolg erstellen: Sie können Definitionen und Metadaten für jeden Erfolg einzeln hinzufügen.
- Erfolge importieren: Sie können Definitionen und andere Metadaten für mehrere Erfolge in einem einzigen Schritt importieren.
Erfolg erstellen
So erstellen Sie einen Erfolg für ein neues, unveröffentlichtes Spiel:
- Wählen Sie in der Google Play Console ein Spiel aus.
- Wählen Sie auf der Seite Play-Spieldienste – Erfolge (Wachstum > Play-Spieldienste > Einrichtung und Verwaltung > Erfolge) die Option Erfolg erstellen aus.
- Füllen Sie das Formular auf der Seite Erfolge hinzufügen aus.
- Klicken Sie auf Als Entwurf speichern.
- Nachdem Sie einen Erfolg erstellt haben, müssen Sie Ihre Erfolge veröffentlichen.
Erfolge importieren
So fügen Sie Ihrem Spiel mehrere Erfolge gleichzeitig hinzu:
- Erstellen Sie eine ZIP-Datei mit Ihren Erfolgen.
- Lade die Datei hoch.
Weitere Informationen zur ZIP-Datei finden Sie in den Richtlinien für ZIP-Dateien.
So importieren Sie Erfolge:
- Wählen Sie in der Google Play Console ein Spiel aus.
- Wählen Sie auf der Seite Play-Spieldienste – Erfolge (Wachstum > Play-Spieldienste > Einrichtung und Verwaltung > Erfolge) die Option Erfolge importieren aus.
- Klicken Sie auf der Seite Erfolge importieren auf Hochladen.
- Wählen Sie die ZIP-Datei aus, die Sie hochladen möchten.
- Klicken Sie auf Als Entwurf speichern.
- Nachdem Sie die Erfolge importiert haben, müssen Sie Ihr Spiel veröffentlichen.
Richtlinien für ZIP-Dateien
Sie können mehrere Erfolge gleichzeitig in 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 |
|---|---|---|
AchievementsMetadata.csv
|
Erforderlich | Metadaten für jeden der Erfolge. Weitere Informationen finden Sie unter Attribute. |
AchievementsLocalizations.csv
|
Optional | Übersetzungen der Namen und Beschreibungen von Erfolgen. |
AchievementsIconMappings.csv
|
Optional | Ordnet Erfolge ihren Symboldateien zu. |
| Symboldateien | Optional | Symbole im PNG-, JPEG- oder JPG-Format. |
Anforderungen an ZIP-Dateien:
- Keine Unterverzeichnisse.
- Eindeutige Dateinamen.
- Nur CSV-, PNG-, JPEG- oder JPG-Dateien.
- Die CSV-Dateien dürfen keine Kopfzeile enthalten.
- Jede Datei muss kleiner als 1 MB sein.
- Die ZIP-Datei darf nicht mehr als 203 Dateien enthalten.
- Die Gesamtgröße der ZIP-Datei darf 200 MB nicht überschreiten.
Format „AchievementsMetadata.csv“
Die Datei AchievementsMetadata.csv enthält die Metadaten für jeden Erfolg. Die Daten müssen als kommagetrennte Werte in der folgenden Reihenfolge enthalten sein:
Name,Description,Incremental value,Steps Needed,Initial State,Points,List Order
Die einzelnen Felder werden in der folgenden Tabelle beschrieben:
| CSV-Spaltenüberschriften | Erforderlich oder optional | Gültige Werte |
|---|---|---|
| Name | Erforderlich | Maximal 100 Zeichen |
| Beschreibung | Optional | Maximal 500 Zeichen |
| Inkrementeller Wert | Optional | True oder False
|
| Erforderliche Schritte | Erforderlich, wenn Incremental Value True. ist
|
Zahl (keine Brüche oder Dezimalstellen) |
| Ausgangsstatus | Erforderlich | Hidden oder Revealed
|
| Punkte | Erforderlich | Die Zahl muss ein Vielfaches von 5 sein und der Wert muss zwischen 5 und 200 liegen |
| Reihenfolge der Listen | Optional | Zahl (ohne Brüche oder Dezimalstellen und größer als null) |
Anforderungen an die Datei „AchievementsMetadata.csv“:
- Jede Zeile muss sieben Werte enthalten. Wenn Sie einen Wert weglassen möchten, lassen Sie das Feld leer.
- Die Felder
NameundDescriptionwerden als Standardsprache verwendet. - Der Inhalt im Feld
Namesollte für alle Erfolge einzigartig sein. - Die folgenden Felder dürfen keine Kommas enthalten:
NameundDescription.
Beispieldatei AchievementsMetadata.csv:
Achievement1,Achievement One,True,100,Hidden,5,20 Achievement2,Achievement Two,False,,Revealed,10,30
Format „AchievementsLocalizations.csv“
In der optionalen Datei AchievementsLocalizations.csv werden alle erforderlichen Daten festgelegt, um die einzelnen Erfolge für Nutzer in verschiedenen Sprachen zu beschreiben. Erfolge werden gemäß den für das Spiel angegebenen Sprachcodes übersetzt.
Die Daten müssen als kommagetrennte Werte in der folgenden Reihenfolge enthalten sein:
Name, Localized name, Localized description, locale
Die einzelnen Felder werden in der folgenden Tabelle beschrieben:
| CSV-Spaltenüberschriften | Erforderlich oder optional | Beschreibung | Gültige Werte |
|---|---|---|---|
| Name | Erforderlich | Muss mit der Spalte Name aus AchievementsMetadata.csv übereinstimmen.
|
Maximal 100 Zeichen. |
| Lokalisierter Name | Erforderlich | Der lokalisierte Name für den Erfolg. | Maximal 100 Zeichen. |
| Lokalisierte Beschreibung | Optional | Die lokalisierte Beschreibung des Erfolgs in der angegebenen Sprache. | Maximal 500 Zeichen. |
| 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. |
Anforderungen an AchievementsLocalizations.csv-Dateien:
- Die Namen von Erfolgen in einem Spiel müssen für jede Sprache eindeutig sein.
Wenn ein Spiel beispielsweise sowohl en-US als auch fr-FR unterstützt, kann ein Erfolg mit dem Namen „Achievement1“ für en-US auch „Achievement1“ für fr-FR heißen.
- Jede Zeile sollte vier Werte haben. Wenn Sie den Wert für die lokalisierte Beschreibung weglassen möchten, lassen Sie das Feld leer.
Beispieldatei AchievementsLocalizations.csv:
Achievement1,Achievement One,This is the description of achievement one in English.,en-US Achievement1,Achievement Un,Voici la description de l'achievement un en français.,fr-FR Achievement2,Achievement Two,Description of achievement two.,en-US Achievement2,Logro Dos,Descripción del logro dos.,es-ES Achievement3,Achievement Three,,en-US Achievement3,Erfolg Drei,,de-DE
Format „AchievementsIconMappings.csv“
Die Datei AchievementsIconMappings.csv ist eine optionale Datei, die Ihre Erfolge dem angegebenen Symbol zuordnet. Die Daten müssen als kommagetrennte Werte in der folgenden Reihenfolge enthalten sein:
Name, icon filename
Diese Felder werden in der folgenden Tabelle beschrieben.
| CSV-Spaltenüberschriften | Erforderlich oder optional | Beschreibung |
|---|---|---|
| Name | Erforderlich | Muss mit der Spalte Name aus AchievementsMetadata.csv übereinstimmen.
|
| Dateiname des Symbols | Erforderlich | Der Name Ihrer Symboldatei. |
Anforderungen an AchievementsIconMappings.csv-Dateien:
- Jede Zeile sollte zwei Werte haben.
- Symboldateien müssen das Format PNG oder JPEG haben.
Beispieldatei AchievementsIconMappings.csv:
Valid Achievement,valid-achievement-icon.png Incremental Achievement,incremental-achievement-icon.jpeg No Description,no-description-icon.png Hidden Initial State,hidden-initial-state-icon.png Large Point Value,large-point-value-icon.jpeg
Symbolrichtlinien
Symbole sollten als PNG-, JPEG- oder JPG-Dateien im Format 512 × 512 erstellt werden. Sie brauchen uns nur das Symbol für den freigeschalteten Erfolg bereitzustellen. Wir erzeugen automatisch eine Graustufenversion für das Symbol „Sichtbar“. Deshalb sollten Ihre Erfolgssymbole farbenfrohe Elemente enthalten, damit Ihre Nutzer zwischen sichtbaren und freigeschalteten Erfolgen unterscheiden können.
Wenn ein Erfolg-Symbol in einem Android-[Toast][a] angezeigt wird, ist dieses von einem Kreis überlagert und die äußeren Ecken sind ausgeblendet. Achten Sie darauf, dass Ihr Symbol auch in diesem Format gut aussieht.
Es wird für alle Gebietsschemas dasselbe Symbol verwendet. Deshalb raten wir davon ab, in Symbolen Text oder lokalisierte Inhalte zu verwenden.
Symboldateien
Symbole, auf die Sie in der Datei AchievementsIconMappings.csv verweisen, müssen im aktuell importierten ZIP-Archiv vorhanden sein.
Spiele mit vorhandenen Erfolgen aktualisieren
Sie können einem Spiel in der Google Play Console weitere Erfolge hinzufügen und vorhandene Erfolge aktualisieren.
Weitere Erfolge hinzufügen
Wenn Sie bereits Erfolge haben und weitere hinzufügen möchten:
- Wählen Sie in der Google Play Console ein Spiel aus.
- Wählen Sie auf der Seite Play-Spieldienste – Erfolge (Wachstum > Play-Spieldienste > Einrichtung und Verwaltung > Erfolge) die Option Erfolge hinzufügen aus.
Erfolge bearbeiten
Wenn Sie bereits Erfolge haben und diese bearbeiten möchten:
- Wählen Sie in der Google Play Console ein Spiel aus.
- Wählen Sie auf der Seite Play-Spieldienste – Erfolge (Wachstum > Play-Spieldienste > Einrichtung und Verwaltung > Erfolge) einen Erfolg aus.
- Sie können alle Felder bearbeiten.
- Klicken Sie auf Als Entwurf speichern.
- Auf der Seite Play-Spieldienste – Erfolge hat der bearbeitete Erfolg den Status „Für Tester verfügbar“.
- Nachdem Sie das Achievement getestet haben, klicken Sie auf Überprüfen und veröffentlichen.
Dadurch wird Ihr Spiel zusammen mit allen aktualisierten Erfolgen noch einmal veröffentlicht.
Erfolg löschen
Sobald Ihr Erfolg veröffentlicht wurde, kann er nicht mehr gelöscht werden. Sie können nur unveröffentlichte Erfolge löschen
- Wählen Sie auf der Seite Play-Spieldienste – Erfolge einen Erfolg aus.
- Wenn Sie die Auszeichnung löschen möchten, klicken Sie auf Auszeichnung löschen.
Erfolg zurücksetzen
Daten zum Spielfortschritt können Sie nur für Erfolge zurücksetzen, die sich noch im Entwurfsstatus befinden.
- Wählen Sie auf der Seite Play-Spieldienste – Erfolge einen Erfolg aus.
- Wenn Sie die Erfolge zurücksetzen möchten, klicken Sie auf Fortschritt zurücksetzen.
- Wenn Sie Ihre Erfolgsdaten programmatisch zurücksetzen möchten, rufen Sie die
Achievements-Methoden der Management API auf.
Übersetzungen für Erfolge hinzufügen
Sie können eigene Übersetzungen für die zu Ihrem Spiel gehörigen Erfolge angeben. Führen Sie zuvor die unter Übersetzungen für Ihr Spiel hinzufügen beschriebenen Schritte aus.
Es gibt zwei Möglichkeiten, Ihrem Spiel Übersetzungen hinzuzufügen:
Mit der Option Erfolge importieren können Sie Übersetzungen für viele neue Erfolge gleichzeitig hochladen. Mit dieser Option können Sie jedoch keine Übersetzungen für bereits vorhandene Erfolge hochladen.
Sie können für jeden Erfolg in Ihrem Spiel Übersetzungen hinzufügen. So fügen Sie für jeden Erfolg eine eigene Übersetzung hinzu:
- Öffnen Sie in der Google Play Console für Ihr Spiel den Tab Erfolge und wählen Sie dann einen vorhandenen Erfolg aus.
- Wählen Sie auf der Detailseite des Erfolgs den Tab für eine Sprache aus, die Sie zuvor auf dem Tab Infos zum Spiel hinzugefügt haben.
- Bearbeiten Sie auf der Detailseite für die jeweilige Sprache das Formular mit Ihren Übersetzungen für diesen Erfolg.
- Klicken Sie zum Speichern Ihrer übersetzten Erfolgsdetails auf Speichern.
Clientimplementierungen
Informationen zum Implementieren von Erfolgen für Ihre Plattform finden Sie in den folgenden Ressourcen:
Erfolge testen
So testen Sie, ob die Erfolge 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 Spiele App ein Play Spiele-Profil für eines der Testkonten.
- Öffnen Sie das Spiel mit demselben Testkonto, für das Sie das Play Spiele-Profil erstellt haben.
- Prüfen Sie, ob beim Start des Spiels der „Willkommen“-Toast der Play-Spieldienste auf dem Bildschirm angezeigt wird. Dies ist ein Hinweis auf eine erfolgreiche automatische Authentifizierung.
- Spiele das Spiel und führe die erforderlichen Schritte aus, um die Erfolge freizuschalten.
So überprüfen Sie Erfolge:
Prüfe, ob das Pop-up „Erfolg freigeschaltet“ auf dem Bildschirm angezeigt wird, wenn der Erfolg abgeschlossen ist.
Öffne die Play Store App und prüfe, ob im Bereich „Erfolge“ auf dem Tab „Ich“ abgeschlossene und laufende Erfolge (mit Fortschrittsdetails) angezeigt werden.
Leistung von Erfolgen in der Play Console im Blick behalten
So erhalten Sie Schnellstatistiken für einzelne Erfolge:
- In der Google Play Console
- Rufen Sie Einstellungen> Spielprojekte auf.
- Wählen Sie ein Spiel aus.
- Klicke im Menü auf der linken Seite auf Erfolge.
- Auf der Seite Erfolge finden Sie Statistiken, mit denen Sie nachvollziehen können, ob Ihre Spieler die Erfolge freischalten. Bei Nutzern, deren Erfolge nicht ausgeblendet sind, können Sie sehen, wie viel Prozent der Nutzer sie freischalten. Bei Erfolgen in der Anfangsphase liegt der Prozentsatz der Freischaltungen in der Regel näher bei 100%.
Sie können die Zeitreihenleistung von Erfolgen auch auf der Seite Wachstum > Play-Spieldienste > Spielstatistiken verfolgen.
Erfolge veröffentlichen
Nach dem Testen müssen Sie Ihr Spiel veröffentlichen. Damit werden auch alle Erfolge Ihres Spiels veröffentlicht. Das Veröffentlichen von Erfolgen ist erforderlich, damit sie richtig funktionieren.
So veröffentlichen Sie:
- Wählen Sie in der Google Play Console ein Spiel aus.
- Klicken Sie auf der Seite Play-Spieldienste – Erfolge (Wachstum > Play-Spieldienste > Einrichtung und Verwaltung > Erfolge) auf Überprüfen und veröffentlichen.
- Sehen Sie sich auf der Seite Play-Spieldienste – Veröffentlichung (Wachstum > Play-Spieldienste > Einrichtung und Verwaltung > Veröffentlichung) die erforderlichen Aktionen an und beheben Sie die Probleme.
- Klicke auf Veröffentlichen.
Alle Erfolge Ihres Spiels werden veröffentlicht.
Häufige Fehler, die du vermeiden solltest
Hier finden Sie häufige Fehler, die Sie bei der Implementierung von Erfolgen in einem Spiel vermeiden sollten. Dabei wird die Bedeutung der folgenden Punkte hervorgehoben:
Rufen Sie in der Play Console Wachstum > Play-Spieldienste > Einrichtung und Verwaltung > Erfolge auf.
- Prüfen Sie vor der Veröffentlichung, ob die in der Play Console konfigurierten Erfolge nicht den Status „Entwurf“ haben.
- Fügen Sie dem Spielcode keine Achievement-ID-Werte aus der Play Console hinzu. Verwenden Sie stattdessen die Clientimplementierungen.
Achten Sie darauf, dass Sie die Entsperrlogik auch in Ihrem Client implementiert haben.
- Nutzer können den Triggerschritt, in dem die Unlock API aufgerufen wird, nicht überspringen. Das Abschließen des Tutorials ist beispielsweise ein Erfolg, aber die Spieler können das Tutorial selbst überspringen.