Erfolge

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Feedback geben

Erfolge können eine hervorragende Möglichkeit zum Steigern der Nutzerinteraktionen innerhalb Ihres Spiels sein. Sie können Erfolge in Ihrem Spiel implementieren, um Spieler dazu anzuregen, mit Funktionen zu experimentieren, die sie normalerweise nicht verwenden würden, oder Ihr Spiel mit völlig anderen Spielstilen anzugehen. Erfolge können auch eine unterhaltsame Möglichkeit für Spieler sein, ihren Fortschritt miteinander zu vergleichen und sich in lockerer Atmosphäre zu messen.

Informationen zur Implementierung von Erfolgen für Ihre Plattform finden Sie unter Implementierungen für Kunden.

Attribute

Damit Sie die Funktionsweise von Erfolgen besser nachvollziehen können, sollten Sie sich mit einigen der zugehörigen Attribute vertraut machen.

Die folgenden grundlegenden Elemente spielen bei allen Erfolgen eine Rolle:

• Id ist ein eindeutiger String, der von der Google Play Console generiert wird. Mithilfe dieser eindeutigen ID verweisen Sie auf den Erfolg in Ihren Spiel-Clients.
• Name ist ein kurzer Name für den Erfolg (z. B. „Pieman“). Der Wert kann bis zu 100 Zeichen lang sein.
• Die Beschreibung bietet eine kurze Beschreibung Ihres Erfolgs. Normalerweise wird hier beschrieben, wie der Spieler den Erfolg erzielen kann (z. B. „Baking a lemon meringue pie before sundown“). Die Beschreibung kann bis zu 500 Zeichen umfassen.
• Symbol: Ein quadratisches Symbol, das mit Ihrem Erfolg verknüpft ist. Best Practices zum Erstellen von Symbolen für Erfolge finden Sie im Abschnitt Symbolrichtlinien.
• Die Listenreihenfolge ist die Reihenfolge, in der die gesperrten Erfolge angezeigt werden, wenn ein Spieler sich die mit Ihrem Spiel verknüpften Erfolge ansieht. Die Reihenfolge ist dabei beliebig. Die freigeschalteten Erfolge werden oben in der Liste in der Reihenfolge angezeigt, in der sie erreicht wurden.

Bundesland

Erfolge können einen von drei verschiedenen Status haben:

• Bei einem ausgeblendeten Erfolg sind die Details für den Spieler nicht sichtbar. Die Play Spiele-Dienste stellen eine generische Platzhalterbeschreibung und ein Symbol für den Erfolg bereit, solange er ausgeblendet ist. Wir empfehlen, einen Erfolg auszublenden, wenn er einen Spoiler enthält, den Sie zu früh über Ihr Spiel preisgeben möchten (z. B. „Entdecken Sie, dass Sie schon immer ein Geist waren!“).
• Ein offengelegtes Achievement bedeutet, dass der Spieler von dem Achievement weiß, es aber noch nicht erhalten hat. Die meisten Erfolge sind zu Beginn sichtbar.
• Ein freigeschalteter Erfolg bedeutet, dass der Spieler den Erfolg bereits erreicht hat. Ein Erfolg kann offline freigeschaltet werden. Wenn das Spiel online geht, wird es mit den Play-Spieldiensten synchronisiert, um den Entsperrstatus des Erfolgs zu aktualisieren.

Inkrementelle Erfolge

Erfolge können als Standarderfolge oder inkrementelle Erfolge festgelegt werden. Bei einem inkrementellen Erfolg macht ein Spieler im Laufe der Zeit allmählich Fortschritte, um den Erfolg zu erhalten. Wenn der Spieler Fortschritte beim Erreichen des inkrementellen Erfolgs macht, können Sie den teilweisen Fortschritt des Spielers an die Play Spiele-Dienste melden.

Der Google Play-Dienst überwacht den Fortschritt, benachrichtigt das Spiel, wenn der Spieler die Kriterien für den Erhalt des Erfolgs erfüllt hat, und informiert den Spieler darüber, wie weit er mit dem Erreichen dieses Ziels fortgeschritten ist.

Zuwachsbasierte Erfolge werden über mehrere Spielsitzungen hinweg gesammelt. Der Fortschritt kann nicht im Spiel entfernt oder zurückgesetzt werden. Ein Beispiel für einen inkrementellen Erfolg wäre „Gewinne 50 Spiele“. „3 Spiele in Folge gewinnen“ ist nicht geeignet, da der Fortschritt des Spielers zurückgesetzt wird, wenn er ein Spiel verliert. „5.000 Pokerchips haben“ ist ebenfalls nicht zulässig, da ein Spieler während des Spiels Chips gewinnen und verlieren kann. Bei den beiden letzten Erfolgen müssen Sie den Status „Siege in Folge“ oder den Chipstand des Spielers im Auge behalten und Standarderfolge freischalten, sobald der Spieler sie erzielt.

Beim Erstellen eines inkrementellen Erfolgs müssen Sie die Gesamtanzahl der erforderlichen Schritte bis zum Freischalten des Erfolgs definieren. Dies muss eine Zahl zwischen 2 und 10.000 sein. Wenn der Nutzer Fortschritte beim Freischalten des Erfolgs macht, sollten Sie die Anzahl der zusätzlichen Schritte, die der Nutzer ausgeführt hat, an die Play-Spieldienste melden. Sobald die Gesamtzahl der Schritte den Wert zum Freischalten erreicht, wird der Erfolg freigeschaltet, auch wenn er ausgeblendet war. Sie müssen den kumulativen Fortschritt des Nutzers nicht speichern.

Punkte

Mit Erfolgen ist ein Punktwert verknüpft. Die Punktzahl des Spielers muss ein Vielfaches von 5 sein. Ein Spiel kann insgesamt nicht mehr als 1.000 Punkte für alle seine Erfolge haben (es kann aber weniger haben). Außerdem darf kein einzelnes Achievement mehr als 200 Punkte wert sein.

Erfahrungspunkte (XP) verfolgen

Spieler können in ihrem Spieleprofil Level aufsteigen, wenn sie in Spielen mit Play Spiele-Unterstützung Erfolge erzielen. Für jeden Punkt, der mit einem Erfolg verknüpft ist, erhält der Spieler 100 Erfahrungspunkte (XP), wenn er diesen Erfolg erzielt. Mit anderen Worten:

XP for an achievement = 100 * (point value for the achievement)

Die Play Spiele-Dienste erfassen die von jedem Spieler gesammelten Erfahrungspunkte und senden eine Benachrichtigung an die Google Play Spiele App, wenn der Spieler genügend Punkte gesammelt hat, um ein Level aufzusteigen. Spieler können ihr Level und ihren Erfahrungspunkteverlauf auf ihrer Profilseite in der Google Play Spiele App einsehen.

Mindestzahl von Erfolgen

Ein Spiel mit integrierten Erfolgen sollte vor der Veröffentlichung mindestens fünf Erfolge haben. Sie können auch mit weniger als fünf Erfolgen testen. Wir empfehlen jedoch, mindestens fünf Erfolge zu erstellen, bevor Sie Ihr Spiel veröffentlichen.

Maximale Erfolge

Die Anzahl der Erfolge ist durch die Limits und die Verteilung der Punkte begrenzt. Bei einer maximalen Punktzahl von 1.000 und 5 Punkten pro Leistung beträgt die maximale Anzahl von Erfolgen 200. Wenn jedoch mehr Punkte zugewiesen werden, verringert sich die Anzahl der verfügbaren Erfolge.

Erfolge hinzufügen

Es gibt zwei Möglichkeiten, in der Google Play Console zum ersten Mal Erfolge 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 und unveröffentlichtes Spiel:

1. Wählen Sie in der Google Play Console ein Spiel aus.
2. Wählen Sie auf der Seite Play-Spieldienste – Erfolge (Wachstum > Play-Spieldienste > Einrichtung und Verwaltung > Erfolge) die Option Erfolg erstellen aus.
3. Füllen Sie auf der Seite Erfolge hinzufügen das Formular aus.
4. Klicken Sie auf Als Entwurf speichern.
5. Nachdem Sie einen Erfolg erstellt haben, müssen Sie Ihr Spiel veröffentlichen.

Weitere Erfolge hinzufügen

Wenn Sie bereits Erfolge haben und weitere hinzufügen möchten, gehen Sie so vor:

1. Wählen Sie in der Google Play Console ein Spiel aus.
2. Wählen Sie auf der Seite Play-Spieldienste – Erfolge (Wachstum > Play-Spieldienste > Einrichtung und Verwaltung > Erfolge) die Option Erfolge hinzufügen aus.

Erfolge importieren

So fügen Sie Ihrem Spiel mehrere Erfolge gleichzeitig hinzu:

1. Erstellen Sie eine ZIP-Datei mit Ihren Erfolgen.
2. Lade die Datei hoch.

Weitere Informationen zur ZIP-Datei finden Sie in den Richtlinien für ZIP-Dateien.

So importieren Sie Erfolge:

1. Wählen Sie in der Google Play Console ein Spiel aus.
2. Wählen Sie auf der Seite Play-Spieldienste – Erfolge (Wachstum > Play-Spieldienste > Einrichtung und Verwaltung > Erfolge) die Option Erfolge importieren aus.
3. Klicken Sie auf der Seite Erfolge importieren auf Hochladen.
4. Wählen Sie die ZIP-Datei aus, die Sie hochladen möchten.
5. Klicken Sie auf Als Entwurf speichern.
6. Nachdem Sie die Erfolge importiert haben, müssen Sie Ihr Spiel veröffentlichen.

Spiel veröffentlichen

Sobald Sie Ihr Spiel getestet und veröffentlicht haben, werden alle Erfolge Ihres Spiels mit veröffentlicht.

Erfolg bearbeiten

Wenn Sie einen bereits erstellten Erfolg bearbeiten möchten, wählen Sie ihn in der Google Play Console auf dem Tab Erfolge aus. Nun wird dasselbe Formular angezeigt, das Sie beim Erstellen des Erfolgs zuerst verwendet haben. Sie können alle Felder nach Bedarf bearbeiten.

Klicken Sie nach dem Bearbeiten eines Erfolgs auf die Schaltfläche Als Entwurf speichern. Die neu bearbeitete Leistung befindet sich dann in der Phase „Testbereit“ und Sie können sie testen. Wenn alles in Ordnung ist, wählen Sie in der Drop-down-Liste Neu veröffentlichen aus. Dadurch wird Ihr Spiel zusammen mit allen aktualisierten Erfolgen öffentlich veröffentlicht.

Änderungen rückgängig machen

Wenn Ihnen Ihr aktueller Erfolg nicht gefällt und Sie ihn wiederherstellen möchten, wählen Sie in der Google Play Console im Drop-down-Menü die Option Zurücksetzen aus. Alle Ihre Erfolge werden dann auf die zuvor veröffentlichte Version zurückgesetzt.

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, indem Sie unten im Formular für den entsprechenden Erfolg auf die Schaltfläche Löschen klicken.

Erfolg zurücksetzen

Sie können die Daten zum Spielerfortschritt nur für Ihre Entwurfserfolge zurücksetzen.

• Wenn Sie in der Google Play Console Erfolge zurücksetzen möchten, klicken Sie unten im Formular für das betreffende Ereignis auf die Schaltfläche Fortschritt bei Erfolgen zurücksetzen.
• Wenn du deine Leistungsdaten programmatisch zurücksetzen möchtest, rufe die Achievements-Methoden der Management API auf.

Symbolrichtlinien

Symbole sollten als PNG-, JPEG- oder JPG-Dateien mit einer Größe von 512 x 512 Pixeln erstellt werden. Sie müssen uns nur das Symbol für den freigeschalteten Erfolg senden. Wir generieren automatisch eine Graustufenversion des angezeigten Symbols. Wir empfehlen daher, dass Ihre Symbole für Erfolge farbenfrohe Elemente enthalten, damit Nutzer zwischen freigeschalteten und noch nicht freigeschalteten Erfolgen unterscheiden können.

Wenn ein Erfolg in einem Android-Toast angezeigt wird, wird das Symbol von einem Kreis überlagert und die äußeren Ecken sind ausgeblendet. Achten Sie darauf, dass Ihr Symbol auch unter diesen Umständen gut aussieht.

Dasselbe Symbol wird in allen Sprachen verwendet. Wir empfehlen daher, in einem Symbol keinen Text oder lokalisierten Inhalt zu verwenden.

Richtlinien für ZIP-Dateien

Sie können mehrere Erfolge gleichzeitig mit einer ZIP-Datei importieren. In der Tabelle finden Sie die genauen Dateinamen, die Sie in Ihrer ZIP-Datei verwenden müssen:

Anforderungen an ZIP-Dateien:

• Es dürfen keine Unterverzeichnisse vorhanden sein.
• 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 AchievementsMetadata.csv-Datei enthält die Metadaten für jeden Erfolg. Die Informationen sollten als durch Kommas getrennte Werte in der folgenden Reihenfolge enthalten sein:

    Name,Description,Incremental value,Steps Needed,Initial State,Points,List Order

Diese Felder werden in der folgenden Tabelle beschrieben:

Anforderungen an AchievementsMetadata.csv-Dateien:

• Jede Zeile muss sieben Werte enthalten. Wenn Sie einen Wert weglassen möchten, lassen Sie das Feld leer.
• Die Felder Name und Description werden als Standard-LCID verwendet.
• Das Feld Name muss für alle Erfolge eindeutig sein.
• Die folgenden Felder dürfen keine Kommas enthalten: Name und Description.

Beispiel für eine AchievementsMetadata.csv-Datei:

  Achievement1,Achievement One,True,100,Hidden,5,20
  Achievement2,Achievement Two,False,,Revealed,10,30

Format „AchievementsLocalizations.csv“

Die Datei AchievementsLocalizations.csv ist eine optionale Datei, in der alle Daten eingerichtet werden, die erforderlich sind, um die einzelnen Erfolge für Nutzer in verschiedenen Sprachen zu beschreiben. Erfolge werden gemäß den für das Spiel angegebenen Gebietsschemacodes übersetzt.

Die Informationen sollten als durch Kommas getrennte Werte in der folgenden Reihenfolge enthalten sein:

   Name, Localized name, Localized description, locale

Diese Felder werden in der folgenden Tabelle beschrieben:

Anforderungen an AchievementsLocalizations.csv-Dateien:

• Namen von Erfolgen in einem Spiel müssen pro Sprache eindeutig sein. Wenn ein Spiel beispielsweise sowohl en-US als auch fr-FR unterstützt, kann ein Erfolg, der für en-US „Achievement1“ heißt, auch für fr-FR „Achievement1“ 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.

Beispiel für eine AchievementsLocalizations.csv-Datei:

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 AchievementsIconMappings.csv-Datei ist eine optionale Datei, mit der Ihre Erfolge dem angegebenen Symbol zugeordnet werden. Die Informationen müssen als durch Kommas getrennte Werte in der folgenden Reihenfolge enthalten sein:

Name, icon filename

Diese Felder werden in der folgenden Tabelle beschrieben:

Anforderungen an AchievementsIconMappings.csv-Dateien:

• Jede Zeile sollte zwei Werte haben.
• Symboldateien können nur im PNG- oder JPEG-Format vorliegen.

BeispielAchievementsIconMappings.csv-Datei:

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

Symboldateien

Symbole, auf die Sie in der AchievementsIconMappings.csv-Datei verweisen, müssen im aktuellen ZIP-Archiv vorhanden sein, das Sie importieren. Weitere Informationen finden Sie in den Richtlinien für Symbole.

Übersetzungen für Erfolge hinzufügen

Sie können eigene Übersetzungen für Erfolge angeben, die mit Ihrem Spiel verknüpft sind. Führen Sie dazu zuerst die Schritte unter Übersetzungen für Ihr Spiel hinzufügen aus.

Es gibt zwei Möglichkeiten, Übersetzungen für Ihr Spiel hinzuzufügen:

• Mit der Option Erfolge importieren können Sie Übersetzungen für viele neue Erfolge gleichzeitig hochladen. Mit dieser Option können Sie keine Übersetzungen für bereits vorhandene Erfolge hochladen.

• Sie können Übersetzungen für jeden Erfolg in Ihrem Spiel hinzufügen. So fügen Sie für jedes Achievement eine eigene Übersetzung hinzu:

  1. Öffnen Sie in der Google Play Console den Tab Erfolge für Ihr Spiel und wählen Sie einen vorhandenen Erfolg aus.
  2. Wählen Sie auf der Detailseite für Erfolge den Tab für eine Sprache aus, die Sie zuvor auf dem Tab Spieldetails hinzugefügt haben.
  3. Bearbeiten Sie auf der Seite mit den Details zu diesem Erfolg für die entsprechende Sprache das Formular mit Ihren Übersetzungen für diesen Erfolg.
  4. Klicken Sie auf Speichern, um die Übersetzung der Details zum Erfolg zu speichern.

Clientimplementierungen

Weitere Informationen zur Implementierung von Erfolgen für Ihre Plattform finden Sie in den folgenden Ressourcen:

• Android
• Unity
• Web
• Best Practices für die Implementierung von Erfolgen