Ereignisse

Mit dem Google Play Games-Ereignisdienst können Sie kumulative Daten erfassen, die von Ihren Spielern während des Spiels generiert werden, und sie auf den Servern von Google für die Spielanalyse speichern. Sie können flexibel festlegen, welche Spielerdaten Ihr Spiel erfassen soll. Dazu können Messwerte gehören, die angeben, wie oft:

  • Spieler einen bestimmten Gegenstand verwenden
  • Spieler ein bestimmtes Level erreichen
  • Spieler eine bestimmte Spielaktion ausführen

Sie können die Ereignisdaten als Feedback nutzen, um Ihr Spiel zu verbessern. Sie können beispielsweise den Schwierigkeitsgrad bestimmter Level in Ihrem Spiel anpassen, die Spieler als zu schwer empfinden.

Informationen zum Implementieren von Ereignissen auf Ihrer Plattform finden Sie unter Clientimplementierungen.

Ereignisse in Ihr Spiel einbinden

Der folgende Workflow beschreibt, wie Sie Ereignisse in Ihrem Spiel anwenden können:

  1. Ereignisse definieren So definieren Sie neue Ereignisse, die in Ihrem Spiel erfasst werden sollen:
    1. Rufen Sie in der Google Play Console die Seite Ereignisse für Ihr Spiel auf.
    2. Klicken Sie auf die Schaltfläche Neues Ereignis hinzufügen und konfigurieren Sie die Ereigniseigenschaften.
    3. Veröffentlichen Sie Ihre Ereignisdefinitionen. Folgen Sie dazu der Anleitung unter Änderungen an Ihrem Spiel veröffentlichen.

  2. Ereigniserfassung in Ihrem Spiel mithilfe der Ereignis-APIs implementieren Rufen Sie beispielsweise in Ihrem Android-Code die Methode increment für Ereignisse auf, wenn Ihr Spiel erkennt, dass ein relevantes Ereignis ausgelöst wurde.

  3. Ereignisdaten ansehen Rufen Sie in der Google Play Console die Seite Ereignisse für Ihr Spiel auf, um Statistiken zu den erfassten Ereignissen zu sehen.

Grundlagen zu Ereignissen

Mit den Ereignis-APIs können Sie interessante Spielmesswerte definieren und erfassen und diese Messwerte in das Play Games SDK hochladen.

Ein Play Games SDK-Ereignis enthält die folgenden wichtigen Eigenschaften:

Attribut Beschreibung
ID Eine eindeutige String, die von der Google Play Console für dieses Ereignis generiert wird. Verwenden Sie diese eindeutige ID, um in Ihren Spielclients auf das Ereignis zu verweisen.
Name Ein kurzer Name des Ereignisses. Der Name darf maximal 100 Zeichen lang sein. Dieser Wert wird von der Google Play Console verwendet und kann in Ihrem Spiel angezeigt werden.

Beispiele:

  • "Zombies getötet"
  • "Rote Edelsteine gesammelt"
Beschreibung Eine längere Beschreibung des Ereignisses, z. B. „Anzahl der Male, die ein Spieler einen Zombie getötet hat“ oder „Gesamtzahl der roten Edelsteine, die der Spieler entfernt und kombiniert hat“. Die Beschreibung darf maximal 500 Zeichen lang sein. Dieser Wert wird von der Google Play Console verwendet und kann in Ihrem Spiel angezeigt werden.
Ereignistyp

Ein Feld, in dem der Datentyp angegeben wird, der vom Ereignis erfasst wird. Dieser Wert wird von der Google Play Console für Berichte zur Spieler analyse verwendet.

Es werden zwei Ereignistypen unterstützt:

Quelle der Hauptwährung
Wählen Sie diesen Typ für Ereignisse aus, die Quellen einer Hauptwährung erfassen. Beispiel:
  • "Goldmünzen verdient"
  • "Smaragde gekauft"
Senke der Hauptwährung
Wählen Sie diesen Typ für Ereignisse aus, die Senken oder Verbrauch einer Hauptwährung erfassen. Beispiel:
  • "Goldmünzen ausgegeben"
  • "Smaragde verwendet"
Symbol Ein quadratisches Symbol, das mit Ihrem Ereignis verknüpft wird.

Ereignisse erstellen

So erstellen Sie ein neues Ereignis für Ihr Spiel:

  1. Klicken Sie in der Google Play Console, links auf das Symbol Spieldienste und wählen Sie den Eintrag für Ihr Spiel aus.
  2. Wählen Sie links den Tab Ereignisse aus und klicken Sie auf die Schaltfläche Ereignis hinzufügen.
  3. Geben Sie die Details für das Ereignis ein, das Sie erstellen möchten.
  4. Klicken Sie auf Speichern. Wenn keine Fehler auftreten, wird das Ereignis in den Status „Bereit zur Veröffentlichung“ versetzt. Sie können jetzt mit der Veröffentlichung der Änderungen an Ihrem Spiel fortfahren.

Ereignisse bearbeiten

So bearbeiten Sie ein Ereignis, das Sie erstellt haben:

  1. Öffnen Sie in der Google Play Console den Tab Ereignisse und wählen Sie den Eintrag für das Ereignis aus, das Sie bearbeiten möchten. Sie sollten dasselbe Formular sehen, das Sie beim Erstellen des Ereignisses verwendet haben.
  2. Nehmen Sie die gewünschten Änderungen vor.
  3. Wenn Sie mit der Bearbeitung des Ereignisses fertig sind, klicken Sie auf die Schaltfläche Speichern.
  4. Testen Sie Ihr Spiel, um das geänderte Ereignis zu überprüfen. Wenn alles richtig funktioniert, veröffentlichen Sie die Änderungen an Ihrem Spiel.

Ereignisse löschen

Sie können Ereignisse löschen, die sich im Entwurfsstatus befinden oder bereits veröffentlicht wurden. Wenn Sie ein Ereignis in der Google Play Console löschen möchten, klicken Sie unten im Formular für das betreffende Ereignis auf die Schaltfläche Löschen.

Ereignisdaten zurücksetzen

Sie können Daten zum Spielfortschritt für Tester Ihrer Ereignisse zurücksetzen.

  • Wenn Sie Entwurf-Ereignisse in der Google Play Console zurücksetzen möchten, klicken Sie unten im Formular für das betreffende Ereignis auf die Schaltfläche Ereignisfortschritt zurücksetzen.
  • Wenn Sie Ereignisdaten programmatisch zurücksetzen möchten, rufen Sie die Methoden für die EventsManagement APIauf.

Clientimplementierungen

Informationen zum Implementieren von Ereignissen auf Ihrer Plattform finden Sie in den folgenden Ressourcen: