Discord सर्वर एनालिटिक्स बॉट सदस्यों के जॉइन, खोले गए टिकट और इनवॉइस भुगतानों को एक ऐसी रिपोर्ट में बदल देता है जिसे एक नज़र में पढ़ा जा सके, या तो Discord एम्बेड के रूप में या वेब डैशबोर्ड पर। Noxyr यह दो स्लैश कमांड, /status और /sales, एक डैशबोर्ड Overview पेज, और एक केवल-पढ़ने योग्य Server API के ज़रिए करता है, जो वही आँकड़े आपकी अपनी साइट तक पहुँचाता है। यह गाइड बताती है कि हर एक असल में क्या दिखाता है।
/status: सदस्य, टिकट और समुदाय के आँकड़े
/status एक सिर्फ़ एडमिन के लिए कमांड है जिसके पाँच व्यू हैं: all, invite, sales, tickets और community। हर व्यू में एक days विकल्प है (7, 14 या 30, डिफ़ॉल्ट 30), और वह एक लाइन चार्ट के साथ एम्बेड लौटाता है, इसलिए यह एक त्वरित संख्या-जाँच और रुझान दोनों का काम करता है।
- /status invite: आज, पिछले 7 दिन और चुनी हुई अवधि के जॉइन और लीव, नेट बदलाव के रूप में, नीचे कच्चे plus/minus गिनती के साथ।
- /status tickets: खोले गए टिकट, बंद टिकट, और अभी कितने खुले हैं। Discord एडमिन सबसे ज़्यादा यही एनालिटिक्स माँगते हैं: टिकट जमा हो रहे हैं, या टीम उनके साथ तालमेल रख पा रही है।
- /status sales: इनवॉइस की संख्या और कुल मूल्य। कुल योग एक सादा जोड़ है, मुद्रा रूपांतरण नहीं, क्योंकि इनवॉइस एक से ज़्यादा मुद्राओं में बनाए जा सकते हैं, और उन्हें बदलने का मतलब होगा एक्सचेंज रेट का अंदाज़ा लगाना।
- /status community: रिव्यू की संख्या और संदेशों की मात्रा, सपोर्ट या राजस्व के बजाय सामान्य गतिविधि पढ़ने के लिए।
- /status all: ऊपर के हर फ़ील्ड एक एम्बेड में, सोमवार सुबह के सारांश के लिए।
चार्ट सर्वर-साइड बनता है और इमेज के रूप में अटैच होता है। अगर किसी भी वजह से चार्ट रेंडर न हो, तो कमांड फिर भी आँकड़े टेक्स्ट में जवाब देता है, पूरी तरह विफल नहीं होता। सदस्य और संदेश गिनती उसी दिन से शुरू होती है जब Noxyr सर्वर में जुड़ा, इसलिए पिछले महीने जोड़ा गया बॉट सालों का इतिहास नहीं दिखाएगा।
/sales: राजस्व, शीर्ष खरीदार और रिपोर्ट स्टाइलिंग
/sales एक Discord बॉट को एक कुल योग से आगे की बिक्री के आँकड़े देता है। इसके तीन सबकमांड हैं, सभी सिर्फ़ एडमिन के लिए, और सभी निजी तौर पर जवाब दिए जा सकते हैं या post विकल्प से चैनल में पोस्ट किए जा सकते हैं।
- /sales report: अवधि का राजस्व, भुगतान किए गए ऑर्डर की संख्या, बेची गई यूनिट, इनवॉइस की संख्या, स्थिति (Successful, Pending, Failed) और भुगतान तरीके के अनुसार विभाजन, साथ में शीर्ष प्रोडक्ट। अवधि के विकल्प हैं: पिछले 7 दिन, पिछले 30 दिन, पिछले 90 दिन या सब समय।
- /sales top: खरीदारों की लीडरबोर्ड, ऑर्डर की संख्या या खर्च की गई राशि के हिसाब से क्रमबद्ध, मुद्रा से फ़िल्टर योग्य, अधिकतम 25 खरीदारों के साथ।
- /sales style: एम्बेड का रंग, बैनर और थंबनेल इमेज, रिपोर्ट और लीडरबोर्ड के कस्टम शीर्षक, फ़ुटर टेक्स्ट, लीडरबोर्ड का डिफ़ॉल्ट आकार, मेंशन के बगल में खरीदारों के नाम दिखें या नहीं, और कौन-सी इनवॉइस स्थितियाँ राजस्व में गिनी जाएँ। तीनों स्थितियाँ बंद करना अस्वीकार किया जाता है, क्योंकि जो रिपोर्ट कभी किसी चीज़ को राजस्व नहीं गिनती, वह किसी के काम की नहीं।
दोनों कमांड चलने से पहले Administrator अनुमति या कॉन्फ़िगर किए गए एडमिन रोल की जाँच करते हैं, वही एडमिन गेट जो डैशबोर्ड इस्तेमाल करता है।
डैशबोर्ड Overview में क्या दिखता है
डैशबोर्ड का Overview पेज /status जैसी रिपोर्ट नहीं है। यह किसी सर्वर के लिए वह पहला पेज है जो खुलता है, और यह दुकान और सपोर्ट के हिस्से का सार देता है: कैटेगरी, प्रोडक्ट और सक्रिय वाउचर की गिनती, कुल इनवॉइस, कुल रिव्यू, सबसे नए पाँच इनवॉइस और सबसे नई पाँच समीक्षाएँ, साथ ही उन चीज़ों की सेटअप चेकलिस्ट जिन्हें आपने चालू किया है पर पूरा कॉन्फ़िगर नहीं किया। जहाँ /status और /sales वे रिपोर्ट हैं जो आप Discord में माँगकर एक क्षण के आँकड़े लेते हैं, वहीं Overview हमेशा ताज़ा रहने वाला सार है जिसे आप ब्राउज़र में देखते हैं, बिना बातचीत के बीच में कीबोर्ड पर मौजूद रहे।
अपनी वेबसाइट से वही आँकड़े पढ़ना: Server API
अगर आप Discord सर्वर के आँकड़े अपनी साइट, स्टेटस पेज या स्प्रेडशीट पर चाहते हैं, तो Server API इसका पुल है। यह केवल-पढ़ने योग्य है, एक सर्वर तक सीमित है, और उन्हीं डेटा के लिए JSON लौटाता है जिन्हें /status और डैशबोर्ड पहले से ट्रैक करते हैं:
- GET /api/v1/server: नाम, आइकन, सदस्य संख्या, ऑनलाइन संख्या, बूस्ट।
- GET /api/v1/tickets: कुल, खुले और बंद टिकट, 7 और 30 दिन की मात्रा, औसत रेटिंग।
- GET /api/v1/activity?days=30: रोज़ाना संदेश, जॉइन और लीव, 90 दिन पीछे तक।
- GET /api/v1/invoices: इनवॉइस की संख्या और मुद्रा व स्थिति के अनुसार राजस्व।
- GET /api/v1/reviews: औसत रेटिंग, स्टार का विभाजन और ताज़ा सार्वजनिक समीक्षाएँ।
- GET /api/v1/giveaways: सक्रिय और खत्म हो चुके गिवअवे की गिनती और कुल एंट्री।
डैशबोर्ड पर सर्वर के API पेज से एक कुंजी बनाएं, उसे Bearer टोकन के रूप में भेजें, और हर एंडपॉइंट अपने अलग स्कोप से नियंत्रित होता है। इससे आप ऐसी कुंजी साझा कर सकते हैं जो, उदाहरण के लिए, सिर्फ़ टिकट पढ़ सके, इनवॉइस डेटा उजागर किए बिना। कुंजियों की सीमा 60 अनुरोध प्रति मिनट है, जो काफ़ी से ज़्यादा है, क्योंकि टिकट और बिक्री के कुल आँकड़े एक मिनट में एक बार से ज़्यादा बार पोल करने की ज़रूरत नहीं होती।
आम सवाल
क्या एनालिटिक्स देखने के लिए API चाहिए? नहीं। /status और /sales बिना किसी सेटअप के काम करते हैं, और डैशबोर्ड Overview सिर्फ़ लॉगिन माँगता है। API आँकड़ों को Discord के बाहर किसी चीज़ में खींचने के लिए है।
क्या /status का कोई खर्च है? नहीं। Noxyr में कोई प्रीमियम टियर नहीं है, इसलिए /status और /sales का हर व्यू हर सर्वर के लिए उपलब्ध है।
क्या सदस्य ये आँकड़े देख सकते हैं? दोनों कमांड के लिए Administrator या कॉन्फ़िगर किया गया एडमिन रोल चाहिए, इसलिए सामान्य सदस्य इन्हें नहीं चला सकते।
बिक्री का कुल योग मुद्रा रूपांतरित क्यों नहीं करता? इनवॉइस USD, INR, EUR या GBP में बनाए जा सकते हैं, और रिपोर्ट एक्सचेंज रेट गढ़ने के बजाय वही मुद्राएँ जोड़ती है जिनमें आपने असल में बेचा।
पूरी कमांड सूची /commands पर है, या Discord से चलाने बनाम डैशबोर्ड की तुलना डैशबोर्ड बनाम कमांड में देखें। एनालिटिक्स, टिकट और एक ही बॉट पर चलने वाली दुकान पाने के लिए Noxyr मुफ़्त जोड़ें।