Ereignisse

Mit dem Ereignisdienst von Google Play Spiele können Sie kumulative Daten erfassen, die von Ihren Spielern während des Spiels generiert werden, und sie für Spielanalysen auf Google-Servern speichern. Sie können flexibel definieren, welche Spielerdaten Ihr Spiel erfassen soll. Das kann Messwerte wie die Häufigkeit umfassen:

  • Spieler verwenden einen bestimmten Artikel
  • Ein Spieler erreicht ein bestimmtes Level.
  • Die Spieler führen eine bestimmte Spielaktion aus.

Die Ereignisdaten können Ihnen als Feedback zur Verbesserung Ihres Spiels dienen. Sie können beispielsweise den Schwierigkeitsgrad bestimmter Levels in Ihrem Spiel anpassen, die für Spieler zu schwer sind.

Informationen zum Implementieren von Ereignissen für Ihre Plattform finden Sie unter Clientimplementierungen.

Ereignisse in dein Spiel einbinden

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

  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 Spieländerungen veröffentlichen.

  2. Implementiere die Ereigniserfassung in deinem Spiel mithilfe der Ereignis-APIs. Rufe beispielsweise in deinem Android-Code die Methode increment für Ereignisse auf, wenn dein Spiel erkennt, dass ein für es 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 anzusehen.

Ereignisgrundlagen

Mit den Event-APIs kannst du interessante Spielmesswerte definieren und erfassen und in das Play Spiele SDK hochladen.

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

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 Spieleclients auf das Ereignis zu verweisen.
name Der Kurzname des Ereignisses. Der Name kann bis zu 100 Zeichen umfassen. Dieser Wert wird von der Google Play Console verwendet und kann in deinem Spiel angezeigt werden.

Beispiele:

  • „Zombies Killed“
  • „Gesammelte Rote Edelsteine“
Beschreibung Eine längere Beschreibung des Ereignisses, z. B. „Anzahl der Fälle, in denen ein Spieler einen Zombie getötet hat“ oder „Gesamtzahl der roten Edelsteine, die der Spieler beseitigt und abgeglichen hat“. Die Beschreibung darf bis zu 500 Zeichen lang sein. Dieser Wert wird von der Google Play Console verwendet und kann in deinem Spiel angezeigt werden.
Ereignistyp

Ein Feld, das den Datentyp angibt, den das Ereignis erfasst. Dieser Wert wird von der Google Play Console verwendet, um Berichte zu Spieleranalysen zu unterstützen.

Es werden zwei Ereignistypen unterstützt:

Quelle der Premiumwährung
Wählen Sie diesen Typ für Ereignisse aus, bei denen die Quellen einer Hauptwährung erfasst werden. Beispiele:
  • „Goldmünzen verdient“
  • „Smaragde gekauft“
Anlage für Premiumwährung
Wählen Sie diesen Typ für Ereignisse aus, die Senken oder Verbrauch einer Hauptwährung verfolgen. Beispiele:
  • „Goldmünzen ausgegeben“
  • „gebrauchte Smaragde“
Symbol Ein quadratisches Symbol, das mit Ihrem Termin verknüpft wird.

Termine erstellen

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

  1. Füge dein Spiel in der Google Play Console hinzu, falls noch nicht geschehen.
  2. Klicke in der Google Play Console links auf das Symbol für die Spieldienste und wähle den Eintrag für dein Spiel aus.
  3. Wählen Sie links den Tab Ereignisse aus und klicken Sie auf die Schaltfläche Ereignis hinzufügen.
  4. Geben Sie die Details für den Termin ein, den Sie erstellen möchten.
  5. Klicken Sie auf Speichern. Wenn keine Fehler vorhanden sind, wird das Ereignis in den Status „Bereit zur Veröffentlichung“ gesetzt. Sie können jetzt mit dem Veröffentlichen Ihrer Spieländerungen fortfahren.

Termin bearbeiten

So bearbeiten Sie ein selbst erstelltes Ereignis:

  1. Öffne in der Google Play Console den Tab Ereignisse und wähle den Eintrag für das Ereignis aus, das du bearbeiten möchtest. 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 es korrekt funktioniert, veröffentlichen Sie Ihre Spieländerungen noch einmal.

Termine löschen

Sie können Ereignisse im Entwurfsstatus oder veröffentlichte Ereignisse löschen. Wenn Sie ein Ereignis in der Google Play Console löschen möchten, klicken Sie unten im Formular für dieses Ereignis auf die Schaltfläche Löschen.

Ereignisdaten zurücksetzen

Sie können die Spielerfortschrittsdaten für Tester Ihrer Ereignisse zurücksetzen.

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

Clientimplementierungen

Informationen zum Implementieren von Ereignissen für Ihre Plattform finden Sie in den folgenden Ressourcen: