Ein Discord-Server-Analytics-Bot verwandelt rohe Beitritte, geöffnete Tickets und bezahlte Rechnungen in einen Bericht, den du auf einen Blick lesen kannst, entweder als Discord-Embed oder in einem Web-Dashboard. Noxyr macht das mit zwei Slash-Commands, /status und /sales, einer Übersichtsseite im Dashboard und einer schreibgeschützten Server-API, die dieselben Zahlen an deine eigene Website weitergibt. Diese Anleitung erklärt, was jede dieser Funktionen tatsächlich anzeigt.

An authenticated API request reaches the Noxyr server and returns JSON with a depleting rate limit. GET /api/v1/server Authorization: Bearer •••••• Noxyr API { "id": "48213" "prefix": "!" "premium": true } RateLimit 60 33 60

/status: Mitglieder-, Ticket- und Community-Statistiken

/status ist ein Befehl nur für Admins mit fünf Ansichten: all, invite, sales, tickets und community. Jede Ansicht akzeptiert eine Option days (7, 14 oder 30, Standard 30) und liefert ein Embed mit angehängtem Liniendiagramm zurück. Damit funktioniert er sowohl als schneller Zahlencheck als auch als Trendansicht.

  • /status invite: Beitritte und Austritte für heute, die letzten 7 Tage und den gewählten Zeitraum, als Nettoveränderung dargestellt, mit den rohen Plus- und Minus-Zahlen darunter.
  • /status tickets: geöffnete Tickets, geschlossene Tickets und wie viele gerade offen sind. Das ist die Ticket-Analyse, nach der Discord-Admins am häufigsten fragen: Stapeln sich die Tickets, oder kommt das Team hinterher?
  • /status sales: Anzahl der Rechnungen und Gesamtwert. Die Summe ist eine einfache Addition, keine Währungsumrechnung, denn Rechnungen können in mehreren Währungen gestellt werden, und das Umrechnen würde bedeuten, einen Wechselkurs zu raten.
  • /status community: Anzahl der Bewertungen und Nachrichtenaufkommen, für einen Blick auf die allgemeine Aktivität statt auf Support oder Umsatz.
  • /status all: jedes der obigen Felder in einem Embed, für die Zusammenfassung am Montagmorgen.

Das Diagramm wird serverseitig gezeichnet und als Bild angehängt. Wenn das Rendern des Diagramms aus irgendeinem Grund fehlschlägt, antwortet der Befehl trotzdem mit den Zahlen als Text, statt ganz abzubrechen. Mitglieder- und Nachrichtenzahlen beginnen erst ab dem Tag zu zählen, an dem Noxyr dem Server beigetreten ist. Ein Bot, der letzten Monat hinzugefügt wurde, zeigt also keine Jahre an Historie.

/sales: Umsatz, Top-Käufer und Berichtsgestaltung

/sales deckt die Verkaufsstatistiken ab, die ein Discord-Bot über eine einzige Summe hinaus braucht. Er hat drei Unterbefehle, alle nur für Admins, alle als private Antwort oder mit der Option post im Kanal veröffentlichbar.

  • /sales report: Umsatz für den Zeitraum, Anzahl bezahlter Bestellungen, verkaufte Einheiten, Anzahl der Rechnungen, eine Aufschlüsselung nach Status (Erfolgreich, Ausstehend, Fehlgeschlagen) und nach Zahlungsmethode sowie die Top-Produkte. Zur Auswahl stehen die letzten 7 Tage, die letzten 30 Tage, die letzten 90 Tage oder die gesamte Laufzeit.
  • /sales top: eine Käufer-Bestenliste, sortiert nach Anzahl der Bestellungen oder nach ausgegebenem Betrag, nach Währung filterbar, mit bis zu 25 Käufern.
  • /sales style: legt die Embed-Farbe, Banner- und Thumbnail-Bilder, eigene Titel für Bericht und Bestenliste, Fußzeilentext, die Standardgröße der Bestenliste, ob Käufernamen neben der Erwähnung angezeigt werden, und welche Rechnungsstatus als Umsatz zählen, fest. Alle drei Status gleichzeitig abzuschalten wird abgelehnt, denn ein Bericht, der nie etwas als Umsatz zählt, nützt niemandem.

Beide Befehle prüfen vor der Ausführung die Berechtigung Administrator oder eine eingerichtete Admin-Rolle, dieselbe Admin-Schranke, die auch das Dashboard verwendet.

Was die Übersicht im Dashboard zeigt

Die Übersichtsseite des Dashboards ist nicht derselbe Bericht wie /status. Sie ist die erste Seite, die du für einen Server öffnest, und fasst den Shop- und Support-Bereich zusammen: Anzahl der Kategorien, Produkte und aktiven Gutscheine, Gesamtzahl der Rechnungen, Gesamtzahl der Bewertungen, die fünf neuesten Rechnungen und die fünf neuesten Bewertungen sowie eine Einrichtungs-Checkliste für alles, was du aktiviert, aber noch nicht fertig konfiguriert hast. /status und /sales sind Momentaufnahmen, die du auf Abruf in Discord holst, die Übersicht dagegen ist die immer aktuelle Zusammenfassung, die du im Browser prüfst, ohne mitten in einer Unterhaltung an der Tastatur sitzen zu müssen.

Dieselben Zahlen auf deiner eigenen Website: die Server-API

Wenn du Discord-Serverstatistiken auf deiner eigenen Seite, einer Statusseite oder in einer Tabelle haben willst, ist die Server-API die Brücke. Sie ist schreibgeschützt, auf einen Server beschränkt und liefert JSON für dieselben Daten, die /status und das Dashboard bereits erfassen:

  • GET /api/v1/server: Name, Icon, Mitgliederzahl, Anzahl Online, Boosts.
  • GET /api/v1/tickets: Gesamtzahlen, Anzahl offener und geschlossener Tickets, Aufkommen der letzten 7 und 30 Tage, durchschnittliche Bewertung.
  • GET /api/v1/activity?days=30: tägliche Nachrichten, Beitritte und Austritte, bis zu 90 Tage zurück.
  • GET /api/v1/invoices: Rechnungsanzahl und Umsatz nach Währung und Status.
  • GET /api/v1/reviews: durchschnittliche Bewertung, Aufschlüsselung der Sterne und die neuesten öffentlichen Bewertungen.
  • GET /api/v1/giveaways: Anzahl aktiver und beendeter Gewinnspiele sowie Gesamtzahl der Teilnahmen.

Erzeuge einen Schlüssel auf der API-Seite des Servers im Dashboard, sende ihn als Bearer-Token, und jeder Endpunkt ist durch einen eigenen Scope geschützt. Du kannst einen Schlüssel also zum Beispiel nur für Tickets freigeben, ohne Rechnungsdaten offenzulegen. Schlüssel sind auf 60 Anfragen pro Minute begrenzt. Das reicht locker, denn Ticket- und Umsatzsummen müssen nicht öfter als einmal pro Minute abgefragt werden.

Häufige Fragen

Brauche ich die API, um Analytics zu sehen? Nein. /status und /sales funktionieren ohne jede Einrichtung, und die Übersichtsseite im Dashboard braucht nur eine Anmeldung. Die API ist dafür da, die Zahlen in etwas außerhalb von Discord zu übernehmen.

Kostet /status etwas? Nein. Noxyr hat keine Premium-Stufe, jede Ansicht von /status und /sales steht also jedem Server zur Verfügung.

Können Mitglieder diese Statistiken sehen? Beide Befehle erfordern Administrator oder eine eingerichtete Admin-Rolle, reguläre Mitglieder können sie also nicht ausführen.

Warum rechnet die Umsatzsumme keine Währungen um? Rechnungen können in USD, INR, EUR oder GBP gestellt werden, und der Bericht addiert die Währungen, in denen du tatsächlich verkauft hast, statt einen Wechselkurs zu erfinden.

Die vollständige Befehlsliste findest du unter /commands. Wie sich Aktionen über Discord im Vergleich zum Dashboard verhalten, erklärt Dashboard vs. Befehle. Füge Noxyr kostenlos hinzu, um Analytics, Tickets und einen Shop über einen einzigen Bot laufen zu lassen.