Руководство по плагину Shop Analytics

Shop Analytics — три отчёта по истории продаж. Тепловая карта показывает, в какие дни и часы покупают и пишут чаще всего, — под неё удобно подстроить онлайн и поднятия. Топ покупателей показывает, кто принёс больше всего денег. Отчёт о залежавшихся лотах находит то, что не продаётся месяцами, и выключает такие лоты одной кнопкой.

🎯 Для чего это нужно

1. Понятно, когда быть онлайн: тепловая карта показывает пиковые дни и часы покупателей.
2. Видно лучших клиентов: топ-10 по сумме — кому дать скидку или бонус.
3. Витрина без мусора: лоты, которые не продаются месяцами, легко найти и снять.

✨ Что умеет плагин

• Тепловая карта /activity: дни недели × блоки по 6 часов по Москве, лучший день и пиковый час.
• Заказы и сообщения: на карте учитываются и заказы, и сообщения покупателей.
• Топ покупателей /top_buyers: 10 по сумме выполненных заказов, доллары и евро — в рубли по курсу ЦБ.
• Залежавшиеся лоты /stale_lots: активные лоты без продаж дольше N дней (по умолчанию 60) с отметкой давности.
• «🔴 Выключить все»: снять с продажи все лоты из отчёта одной кнопкой.
• Исключения: /stale_keep ID — лот больше не попадёт в отчёт.
• История один раз: продажи читаются при первом запуске (до 60 страниц), дальше новые заказы дописываются сами.

⚡ Быстрый старт

1. Включите плагин и перезапустите бота (шаг 1 ниже).
2. Запустите любой отчёт — первый раз бот прочитает историю продаж.
3. Смотрите /activity, /top_buyers и /stale_lots.

🛠️ Пошаговая настройка

ШАГ 1. Включите плагин (обязательно перед настройкой)

1. Отправьте своему боту команду /menu.
2. Откройте 🔧 Система и Конфиги → 🧩 Плагины и найдите Shop Analytics.
3. Нажмите «Включить».
4. ‼️ Перезапустите бота командой /restart — без перезапуска плагин не заработает.

ШАГ 2. Первый запуск

1. Любая команда плагина в первый раз читает историю продаж (до 60 страниц) — бот напишет «⏳ Читаю историю продаж — первый раз это может занять пару минут…».
2. Дальше история дополняется сама: новые заказы и смены статусов плагин записывает сразу.

ШАГ 3. Тепловая карта

1. /activity — дни недели × блоки по 6 часов по Москве: ⚪ тишина, 🟢 низкая, 🟡 средняя, 🟠 высокая, 🔴 пик.
2. Учитываются заказы из истории и сообщения покупателей с момента включения плагина.
3. Внизу — 🏆 лучший день и ⏰ пиковый час.

ШАГ 4. Топ покупателей

1. /top_buyers — 10 покупателей с наибольшей суммой выполненных заказов, ник — ссылка на профиль.
2. Внизу — выручка за всю историю и курс $ и €.

ШАГ 5. Залежавшиеся лоты

1. /stale_lots 90 — активные лоты без продаж дольше 90 дней (без числа — 60).
2. Отметки: 💀 не продавался, 🔴 180+ дн., 🟠 90+, 🟡 больше порога. Лоты игровой валюты в отчёт не попадают.
3. «🔴 Выключить все N» — выключить на FunPay все лоты из отчёта.
4. /stale_keep 12345678 — этот лот в отчёт больше не попадёт.

💡 Каждый лот в отчёте — ссылка на его редактирование: так удобно включить лот обратно вручную.

🕹️ Меню и кнопки

Под отчётом /stale_lots

• 🔴 Выключить все N — выключить на FunPay все лоты из отчёта; в конце бот пришлёт, сколько выключено и что не удалось

🔄 Как это работает

1. При первом отчёте плагин читает историю продаж FunPay (до 60 страниц) и сохраняет её.
2. Потом сам дописывает каждый новый заказ и смену статуса, а также считает сообщения покупателей по дням и часам.
3. Перед каждым отчётом дочитывает историю до уже известных заказов.
4. Залежавшиеся лоты определяет по названию: ищет последнюю невозвращённую продажу с таким же названием.

💬 Как это выглядит

Тепловая карта

📊 Активность покупателей (МСК)
0-6 6-12 12-18 18-24
Пн ⚪ 🟢 🟡 🟠
Сб 🟢 🟡 🟠 🔴

🏆 Лучший день: Сб
⏰ Пиковый час: 20:00–21:00

Топ покупателей

👑 Топ покупателей

🥇 Ник — 12 400 ₽ (18 зак.)
🥈 Ник2 — 8 150 ₽ (9 зак.)

⌨️ Команды

• /activity — тепловая карта активности покупателей
• /top_buyers — топ-10 покупателей по сумме
• /stale_lots — лоты без продаж: /stale_lots 60
• /stale_keep — не показывать лот в /stale_lots

💡 Важно знать

• Если курс ЦБ не загрузился, топ считается по запасному курсу: $ = 90 ₽, € = 100 ₽.
• Переименовали лот — старые продажи к нему не привяжутся: плагин сравнивает названия.

❓ Частые вопросы

Почему лот «не продавался», хотя продажи были?

Плагин сопоставляет продажи с лотом по названию. Если вы переименовали лот, старые продажи к нему не привяжутся.

Сообщения на карте — за какое время?

С момента включения плагина: прошлые сообщения FunPay историей не отдаёт. Заказы на карте — из всей прочитанной истории.

Выключил лоты кнопкой — как включить обратно?

Вручную на FunPay: в отчёте у каждого лота ссылка на его редактирование.

Почему в топе нет недавнего покупателя?

В топ попадают только выполненные (подтверждённые) заказы. Неподтверждённые и возвращённые не считаются.