Ereignisse

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

  • Spieler verwenden einen bestimmten Artikel
  • Spieler erreichen ein bestimmtes Level
  • Spieler führen eine bestimmte Spielaktion aus

Anhand der Ereignisdaten können Sie Ihr Spiel optimieren. Du könntest beispielsweise den Schwierigkeitsgrad bestimmter Level in deinem Spiel anpassen, die nach Meinung der Spieler zu schwer zu absolvieren sind.

Informationen zur Implementierung von Ereignissen für Ihre Plattform finden Sie unter Clientimplementierungen.

Ereignisse in Ihr Spiel einbinden

Im folgenden Workflow wird beschrieben, wie Sie Ereignisse in Ihrem Spiel anwenden können:

  1. Definieren Sie Ereignisse. 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 Spielen veröffentlichen.

  2. Implementieren Sie die Ereigniserfassung in Ihrem Spiel mithilfe der Ereignis-APIs. Rufen Sie beispielsweise in Ihrem Android-Code die Methode „events increment“ auf, wenn Ihr Spiel erkennt, dass ein wichtiges 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 aufzurufen.

Grundlagen zu Ereignissen

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

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

Attribut Beschreibung
ID Ein eindeutiger String, der von der Google Play Console für dieses Ereignis generiert wird. Verwende diese eindeutige ID, um in deinen Game-Clients auf das Ereignis zu verweisen.
Name Ein kurzer Name für das Ereignis. Der Name kann bis zu 100 Zeichen umfassen. Dieser Wert wird von der Google Play Console verwendet und kann in Ihrem Spiel angezeigt werden.

Beispiele:

  • „Zombies getötet“
  • „Gesammelte rote Edelsteine“
Beschreibung Eine längere Beschreibung des Ereignisses (z. B. „Anzahl der Male, in denen ein Spieler einen Zombie getötet hat“ oder „Die Gesamtzahl der roten Edelsteine, die der Spieler entfernt und kombiniert hat“). Die Beschreibung kann bis zu 500 Zeichen umfassen. Dieser Wert wird von der Google Play Console verwendet und kann in Ihrem Spiel angezeigt werden.
Ereignistyp

Ein Feld, das den Datentyp angibt, der für das Ereignis erfasst wird. Dieser Wert wird von der Google Play Console für Player Analytics-Berichte verwendet.

Es werden zwei Ereignistypen unterstützt:

Quelle der Hauptwährung
Wählen Sie diesen Typ für Ereignisse aus, mit denen die Quellen einer Hauptwährung erfasst werden. Beispiel:
  • „Erforderliche Goldmünzen“
  • „Emeralds bought“
Senke der Hauptwährung
Wählen Sie diesen Typ für Ereignisse aus, mit denen Senken oder der Verbrauch einer Hauptwährung erfasst werden. Beispiel:
  • „Ausgegebene Goldmünzen“
  • „Verwendete Smaragde“
Symbol Ein quadratisches Symbol, das mit Ihrem Ereignis verknüpft wird.

Termine erstellen

So erstellst du ein neues Ereignis für dein 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 vorliegen, erhält das Ereignis den Status „Bereit zur Veröffentlichung“. Sie können jetzt Ihre Spieländerungen veröffentlichen.

Termin bearbeiten

So bearbeiten Sie ein von Ihnen erstelltes Ereignis:

  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. Es sollte dasselbe Formular angezeigt werden, das Sie beim Erstellen der Veranstaltung 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 es richtig funktioniert, veröffentlichen Sie die Spieländerungen noch einmal.

Termine löschen

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

Ereignisdaten zurücksetzen

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

  • Wenn Sie den Fortschritt von Entwurfsereignissen in der Google Play Console zurücksetzen möchten, klicken Sie unten im Formular für das Ereignis auf die Schaltfläche Ereignisfortschritt zurücksetzen.
  • Wenn Sie Ereignisdaten programmatisch zurücksetzen möchten, rufen Sie die Methoden der Management API Events auf.

Clientimplementierungen

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