Spielanalyse für Godot
Godot-Spielanalyse, mit einem Prompt eingerichtet
Bitte Ziva, deinem Spiel Analytics hinzuzufügen. Ziva installiert ein kleines GDScript-SDK, ergänzt Tracking für die Events, die dich interessieren, und sendet sie an ein Live-Dashboard auf ziva.sh. Kein Server zu bauen, keine Schlüssel zu kopieren.
So funktioniert es
Vom Prompt zum Live-Dashboard
Analytics bedeutet meist: einen Dienst auswählen, ein Projekt anlegen, einen Schlüssel kopieren und ein SDK einbinden. Ziva erledigt diese Schritte für dich im Godot-Editor.
- 01
Frag Ziva
Sag, was du wissen willst, zum Beispiel: „Füge meinem Spiel Analytics hinzu. Erfasse, wann ein Spieler eine Münze einsammelt oder das erste Level abschließt.“
- 02
Ziva installiert das SDK
Ziva legt ein Analytics-Projekt in deinem Ziva-Konto an, fügt das Autoload ZivaAnalytics hinzu und speichert seine Einstellungen in project.godot. Danach ergänzt Ziva Tracking-Aufrufe für deine Events.
- 03
Spielen und prüfen
Starte das Spiel und bitte Ziva dann, die Analytics zu prüfen („check analytics“), um zu bestätigen, dass Events angekommen sind. Events erscheinen meist nach 5-15 Sekunden im Dashboard.
ZivaAnalytics.track("level_complete", {"level": 3, "time_s": 41.2})
ZivaAnalytics.identify("Bobby")Das Dashboard
Sieh, wer spielt und was passiert
Öffne es in Ziva unter Settings → Pro Features → Game Analytics oder auf ziva.sh unter Account → Analytics.
Spieler gerade jetzt
Aktive Sitzungen der letzten 2 Minuten, täglich aktive Spieler von heute und einzelne Spieler im gewählten Zeitraum.
Aktivität im Zeitverlauf
Event-Zahlen für die letzte Stunde, 24 Stunden, 7 Tage oder 30 Tage, dazu täglich aktive Spieler der letzten 30 Tage.
Häufigste Events
Die häufigsten Events im gewählten Zeitraum, damit du vergleichen kannst, wie oft jedes Level gestartet und abgeschlossen wird.
Live-Feed
Die neuesten Events, alle paar Sekunden aktualisiert und durchsuchbar nach Event-Name, Spielername oder Event-Details.
Spielersuche
Finde einen Spieler per Name oder ID und verfolge seine Events. Namen erscheinen nur, wenn dein Spiel sie mitsendet.
Testläufe ausblenden
Filtere nach Quelle, um exportierte Builds ohne deine eigenen Editor-Starts oder Zivas Testläufe zu sehen. So verfälschen Tests deine Zahlen nicht.
Automatisch erfasst
Nützliche Daten, bevor du ein einziges Event hinzufügst
Sobald das SDK installiert ist, erfasst es diese Events ohne zusätzlichen Code:
- session_start
- Beim Start des Spiels, mit Godot-Version und Sprache.
- scene_changed
- Wenn die aktuelle Szene wechselt, mit dem Szenennamen.
- heartbeat
- Alle 60 Sekunden, mit der bisherigen Spielzeit.
- session_end
- Beim Schließen des Fensters, mit der gesamten Spielzeit. Nach bestem Bemühen.
Jedes Event enthält außerdem eine Sitzungs-ID, eine zufällige Spieler-ID, die Plattform und die Version deines Spiels, sofern gesetzt.
Analytics funktioniert im Editor, in Zivas Playtests und in exportierten Spielen, auch in Web-Builds. Das SDK sendet Events im Hintergrund und blockiert dein Spiel nie. Lehnt der Server Events ab, schaltet sich Analytics für diese Sitzung ab, statt das Spiel anzuhalten.
Im Vergleich
Weniger Einrichtung als ein eigenständiges Analytics-Plugin
Spezialisierte Analytics-Dienste bieten tiefere Berichte. Ziva Analytics ist für Godot-Entwickler, die Antworten wollen, ohne die Pipeline selbst zu bauen.
| Funktion | Eigenständiges Analytics-Plugin | Ziva Analytics |
|---|---|---|
| Projekt und Schlüssel werden für dich angelegt | Registrieren und Schlüssel kopieren | Ein Prompt |
| Tracking-Code für deine Events wird geschrieben | Du schreibst jeden Aufruf | In eigenen Worten beschreiben |
| Prüft, ob Events angekommen sind | Dashboard öffnen und nachsehen | Ziva die Analytics prüfen lassen |
| Trennt deine Testläufe von exportierten Builds | Unterschiedlich | Quellen Editor, Agent und Spieler |
| Funnels, Kohorten und Retention-Berichte | Oft enthalten | Live-Feed, tägliche Spieler und häufigste Events |
| Kostenloser Tarif | Oft verfügbar | Benötigt Pro |
Datenschutz und Grenzen
Was gesendet wird
- Analytics sendet Events, grundlegende Spieldetails, eine zufällige Spieler-ID sowie Event-Details oder Spielernamen, die dein Spiel mitsendet.
- Das SDK liest keine Hardware-Kennungen, keine IP-Geolokalisierung und keine Dateipfade. Sende keine personenbezogenen Daten, außer die Datenschutzerklärung deines Spiels deckt das ab.
- Der in deinem Projekt gespeicherte Schlüssel kann deinem Projekt nur Events hinzufügen. Er kann nichts lesen und darf daher in Exporten enthalten sein.
- Rohdaten von Events werden 90 Tage gespeichert.