Einladungs-Tracking: Wer hat wen eingeladen?

Das Einladungs-Tracking zeigt, wer wen eingeladen hat. Es läuft automatisch im Hintergrund, sobald Kage auf dem Server ist, und unterscheidet echte, gefälschte und verlassene Einladungen. Daraus entsteht eine Rangliste der Einlader, die du im Dashboard und per Befehl siehst. Auf den Zahlen baut das Empfehlungsprogramm auf.

Eine kurze Anleitung findest du im Ratgeber Einladungs-Tracking.

Voraussetzungen

• Recht von Kage: Kage braucht Server verwalten, um die Einladungen des Servers lesen zu können. Fehlt es, bleibt das Tracking still inaktiv, ohne dass der Rest des Bots betroffen ist. Das Recht ist in der Standard-Einladung enthalten.
• Zugriff auf das Dashboard: Du meldest dich mit Discord an und brauchst Server verwalten (oder einen für dieses Modul freigegebenen Zugriff).
• Einladungslinks: Das Tracking erkennt nur Beitritte über Einladungen, die Kage lesen kann.

So ordnet Kage einen Beitritt zu

Discord verrät bei einem Beitritt nicht, welche Einladung benutzt wurde. Kage geht deshalb so vor:

1. Kage merkt sich die Nutzungszahlen aller Einladungen des Servers und die Person, die jede erstellt hat.
2. Tritt jemand bei, liest Kage die Einladungen noch einmal und sucht die, deren Nutzungszahl gestiegen ist. Deren Ersteller gilt als einladende Person.
3. Findet Kage keine solche Einladung, aber genau eine Einladung ist verschwunden, ordnet er den Beitritt dem Ersteller dieser Einladung zu. So werden auch Einmal-Einladungen erkannt, die Discord nach der Benutzung löscht.
4. Beim Start des Bots und beim Hinzufügen zu einem Server liest Kage alle Einladungen ein. Konnte er sie nicht lesen (zum Beispiel wegen fehlender Rechte), ist der Zwischenspeicher leer: Der erste Beitritt danach kann nicht zugeordnet werden, alle folgenden schon.

Kann Kage keine einladende Person bestimmen, wird der Beitritt trotzdem erfasst, aber keiner Person gutgeschrieben.

Echt, gefälscht, verlassen

Kage erfasst für jeden Beitritt eine Zeile und klassifiziert ihn:

Das Mindest-Kontoalter stellst du im Empfehlungsprogramm ein (Feld „Mindest-Accountalter der eingeladenen Person (Tage)“, 0 bis 365). Es gilt für das Tracking auch dann, wenn du keine Belohnungen eingerichtet hast.

Verlässt ein Mitglied den Server, markiert Kage seinen Eintrag als verlassen, die Zahl „Netto“ der einladenden Person sinkt entsprechend.

Befehle

Beide Befehle kann jedes Mitglied nutzen.

Das Dashboard

Im Dashboard zeigt die Seite Einladungen vier Kennzahlen: Echte Einladungen, Gefälscht, Verlassen und Beitritte gesamt. Darunter steht die Rangliste Top-Einlader, sortiert nach Netto, mit der Aufschlüsselung „N echt · N gefälscht · N verlassen“. Eine Erklärung der Begriffe steht ebenfalls dort. Das Tracking selbst hat keinen Ein-/Ausschalter, es läuft ab dem Moment, in dem Kage die Einladungen lesen darf. Beitritte, die vor der Einrichtung passierten, erscheinen nicht.

Ergebnis überprüfen

1. Einladung erstellen: Erstelle in Discord eine Einladung mit einem Testkonto als Ersteller.
2. Beitreten: Tritt mit einem zweiten Konto darüber bei.
3. Befehl: /invites für das erste Konto zeigt eine echte oder, bei einem neuen Konto, eine gefälschte Einladung.
4. Dashboard: Die Kennzahlen und die Rangliste aktualisieren sich.

Fehlerbehebung

Beitritte werden nicht zugeordnet

Kage braucht das Recht Server verwalten, um die Einladungen zu lesen. Ohne dieses Recht bleibt das Tracking inaktiv. Beitritte über Wege, bei denen Discord keine passende Einladung liefert, kann Kage nicht zuordnen.

Neue Mitglieder zählen als „gefälscht“

Der Account ist jünger als das Mindest-Kontoalter, oder das Mitglied war schon einmal auf dem Server. Senke das Mindest-Kontoalter im Empfehlungsprogramm, wenn dir 7 Tage zu streng sind. Bereits erfasste Beitritte ändern sich dadurch nicht rückwirkend.

Die Zahlen sinken

Mitglieder, die den Server verlassen, werden von den echten Einladungen abgezogen. Das ist beabsichtigt.

Die Rangliste ist leer

/invites-leaderboard zeigt nur Einlader mit mindestens einer Netto-Einladung. Im Dashboard erscheinen Daten erst ab dem ersten erfassten Beitritt.

Weiterführend

Belohnungen für Einladungen: Empfehlungsprogramm. Weitere Beitrittsfunktionen: Willkommens- und Abschiedsnachrichten.