Ereignisse

Mit dem Ereignisdienst von Google Play Spiele können Sie kumulative Daten erfassen, die Ihre Spieler während des Spiels generiert haben, und sie für Spieleanalysen auf den Google-Servern speichern. Sie können flexibel definieren, welche Spielerdaten Ihr Spiel erfassen soll. Dazu können Sie beispielsweise Messwerte wie die folgenden zählen:

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

Du kannst die Ereignisdaten als Feedback dazu nutzen, wie du dein Spiel verbessern kannst. Sie können beispielsweise den Schwierigkeitsgrad bestimmter Levels in Ihrem Spiel anpassen, die für Spieler als schwer zu bewerkstelligen gelten.

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

Ereignisse in dein Spiel integrieren

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 die Ereignisdefinitionen gemäß der Anleitung unter Spieländerungen veröffentlichen.

  2. Ereignis-Tracking mithilfe der Ereignis-APIs in Ihrem Spiel implementieren Rufen Sie in Ihrem Android-Code beispielsweise die Methode 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 die Statistiken für die erfassten Ereignisse aufzurufen.

Veranstaltungsgrundlagen

Mit den Event-APIs kannst du interessante Spielmesswerte definieren und erfassen und diese Messwerte dann in die Google Play-Spieldienste hochladen.

Ereignisse für Google Play-Spieldienste enthalten die folgenden wichtigen Eigenschaften:

Attribut Beschreibung
ID Ein eindeutiger String, der von der Google Play Console für dieses Ereignis generiert wird. Verwenden Sie diese eindeutige ID, um in Ihren Spieleclients auf das Ereignis zu verweisen.
Name Ein Kurzname für das Ereignis. Der Name kann bis zu 100 Zeichen enthalten. Dieser Wert wird von der Google Play Console verwendet und kann in deinem Spiel angezeigt werden.

Beispiele:

  • „Zombies getötet“
  • „Red Gems gesammelt“
Beschreibung Eine längere Beschreibung des Ereignisses (z. B. „Häufigkeit, mit der ein Spieler einen Zombie getötet hat“ oder „Die Gesamtzahl der roten Edelsteine, die der Spieler entfernt und abgeglichen hat“). Die Beschreibung kann 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 Typ der Daten deklariert, die mit dem Ereignis erfasst werden. Dieser Wert wird von der Google Play Console zur Unterstützung der Spieleranalyse verwendet.

Es werden zwei Ereignistypen unterstützt:

Quelle der Hauptwährung
Wählen Sie diesen Typ für Ereignisse aus, die Quellen einer Premiumwährung erfassen. Beispiel:
  • „Goldmünzen verdient“
  • „Smaragde gekauft“
Senke der Hauptwährung
Wählen Sie diesen Typ für Ereignisse aus, die Senken oder den Verbrauch einer Premiumwährung erfassen. Beispiel:
  • „Goldmünzen ausgegeben“
  • „Smaragde verwendet“
Symbol Ein quadratisches Symbol, das Ihrem Termin zugewiesen wird.

Erstellen von Terminen

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

  1. Fügen Sie Ihr Spiel in der Google Play Console hinzu, falls Sie dies noch nicht getan haben.
  2. Klicken Sie in der Google Play Console links auf das Symbol der Spieldienste und wählen Sie den Eintrag für Ihr 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 vorliegen, wird Ihr Ereignis in den Status „Bereit zur Veröffentlichung“ gesetzt. Sie können jetzt mit der Veröffentlichung Ihrer Spieländerungen fortfahren.

Bearbeiten von Terminen

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. 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 Termins fertig sind, klicken Sie auf Speichern.
  4. Testen Sie Ihr Spiel, um das geänderte Ereignis zu bestätigen. Wenn es ordnungsgemäß funktioniert, veröffentlichen Sie Ihre Spieländerungen.

Löschen von Terminen

Sie können Ereignisse löschen, die sich im Entwurfszustand 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 Ereignis auf die Schaltfläche Löschen.

Ereignisdaten zurücksetzen

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

  • Klicken Sie zum Zurücksetzen eines Ereignisentwurfs in der Google Play Console unten im Formular auf die Schaltfläche Ereignisfortschritt zurücksetzen.
  • Rufen Sie die Events-Methoden der Management API auf, um Ereignisdaten programmatisch zurückzusetzen.

Clientimplementierungen

Informationen zur Implementierung von Ereignissen für Ihre Plattform finden Sie hier: