Деньги на рекламу уходят, люди на сервер приходят — а какая площадка их привела, знает только Discord, и он об этом молчит. В событии о входе нет ни слова о том, по какой ссылке человек зашёл, поэтому обычно всё сводится к ощущению «вроде после того поста стало людно». А ведь важна не только цифра прихода: половина рекламных заходов уходит в первый же вечер, и сто человек с одной площадки могут стоить меньше, чем двадцать с другой. Этот модуль закрывает вопрос: бот держит счётчики всех приглашений сервера и при каждом входе видит, у какой ссылки счётчик вырос, — так и получается источник. Дальше он следит, кто остался, а кто ушёл и через сколько, и складывает это в отчёт по каждой ссылке: пришло, осталось, дожило до недели, дожило до месяца. Отдельно ведётся таблица тех, кто приводит людей, — с ролями за пороги, где засчитываются только оставшиеся, поэтому нагнать ботов и забрать награду не получится. Одно условие: роли бота нужно выдать право «Управлять сервером» — без него Discord вообще не отдаёт список приглашений, и посчитать источники невозможно ни одному боту. Это делается один раз в настройках сервера, и бот сам напомнит об этом, если права не окажется.
Весь путь целиком, шаг за шагом. Справа — то, что реально увидят на вашем сервере.
Discord не сообщает, по какой ссылке вошёл человек, — такого поля в событии просто нет. Единственный рабочий способ такой: бот держит снимок счётчиков всех приглашений сервера и при каждом входе перечитывает их заново, глядя, у какой ссылки счётчик вырос. Выросла ровно одна — это и есть источник. Выросло сразу несколько или ни одной — источник записывается как неизвестный, а не приписывается первой попавшейся ссылке: неверная цифра хуже честного пробела. Снимок живёт в памяти и перечитывается после перезапуска, а сами факты — кто вошёл, откуда, когда и с каким возрастом аккаунта — сразу ложатся в базу.
В настройках каждой ссылке можно дать понятное имя: код приглашения и то, как называть его в отчёте. Тогда вместо «kR7xQ2» вы читаете «Реклама у блогера». Вставить можно и ссылку целиком, вместе с хвостом из параметров, — лишнее бот отрежет сам, а регистр сохранит: коды приглашений регистрозависимы. Ссылки без метки не пропадают из отчёта: они идут под своим кодом и с именем того, кто их создал, — так видно и то, что вы не размечали.
При входе бот записывает, кто пришёл, по какому приглашению, кто это приглашение создал, когда это было и сколько дней аккаунту. Тут же решается, засчитывать ли вход приглашающему: слишком свежий аккаунт, повторный вход того же человека и приглашение самого себя не засчитываются. Важно, что незачтённый вход всё равно записывается и виден в отчёте — владелец должен видеть картину целиком, а не только удобную её часть. Если включить одну настройку, о каждом новичке в канал отчётов будет уходить короткая строка.
Команда «источники ссылки» показывает по каждому источнику четыре числа: сколько человек пришло, сколько из них на сервере прямо сейчас, сколько дожило до недели и сколько до месяца. Последние два считаются честно: в знаменатель попадают только те, у кого этот срок уже наступил, иначе вчерашние новички портили бы картину, ничего плохого ещё не сделав. Все сроки считает база, а не бот: база живёт по Москве, процесс по UTC, и арифметика времени в коде уже подводила соседние модули. Длинный список листается кнопками, а ответ видит только тот, кто спросил — цифры по рекламе не то, что показывают всему серверу.
Вторая таблица — про людей, а не про ссылки: кто сколько привёл и сколько из приведённых осталось. По порогам можно выдавать роли, и засчитываются в них ТОЛЬКО оставшиеся. Это принципиально: если считать всех вошедших, роль забирается за вечер накруткой, а наутро приведённые расходятся. Здесь же счёт падает вместе с уходами, и роль снимается обратно, если это не выключено настройкой. Перед выдачей бот проверяет свои права и положение роли: роль выше его собственной, служебную роль или @everyone Discord выдать не даст, и об этом честно пишется в журнал, а не глотается молча.
Раз в неделю, в выбранный день и час по Москве, отчёт сам уходит в канал отчётов. Отметка о выполнении ставится в базе одним атомарным запросом до отправки, поэтому два одновременных прохода не пришлют отчёт дважды, а перезапуск бота не заставит его повториться. Если бот пролежал свой час, отчёт догонит при первой возможности, а не потеряется. Отдельная команда «проверка-источников» проходит по всем настройкам и правам и говорит прямым текстом, что мешает учёту: чаще всего это отсутствие права «Управлять сервером», без которого Discord не отдаёт список приглашений вообще.
Всё это меняется в личном кабинете в любой момент — каналы и роли выбираются списками с вашего сервера, вводить ID руками не нужно. Бот подхватывает изменения сам.
Учёт приглашений
Награды за приведённых
Кто видит
Отчёты
Объявления о входах
Оформление
Что вводят на сервере, когда модуль подключён. Команды набираются со слэша — Discord подсказывает список сам, наизусть помнить ничего не нужно.
/источники
Отчёт о том, откуда приходят люди и сколько из них остаётся на сервере.
/кто-привёл
Показывает, кто пригласил участника, когда это было и был ли вход зачтён.
/приглашения
Личная сводка: сколько людей пришло по вашим ссылкам и сколько из них осталось.
/проверка-источников
проверка настроек Проверяет права бота, метки, пороги ролей и канал отчётов и говорит, что именно мешает учёту.
Команды для администрации Discord показывает только тем, у кого есть нужное право сервера. Чтобы ими пользовалась ваша модерация без прав администратора, откройте доступ её ролям: Настройки сервера → Интеграции → ваш бот → нужная команда.
Бот разворачивается за пару минут: выбираете модули, вставляете токен, приглашаете на сервер.