Bot analitik server Discord mengubah data mentah berupa member yang bergabung, tiket yang dibuka, dan invoice yang dibayar menjadi laporan yang bisa dibaca sekilas, baik sebagai embed Discord maupun di dashboard web. Noxyr melakukannya dengan dua slash command, /status dan /sales, halaman Overview di dashboard, dan Server API baca-saja yang menampilkan angka yang sama ke situs Anda sendiri. Panduan ini membahas apa yang sebenarnya ditampilkan masing-masing.
/status: statistik member, tiket, dan komunitas
/status adalah perintah khusus admin dengan lima tampilan: all, invite, sales, tickets, dan community. Setiap tampilan memiliki opsi days (7, 14, atau 30, default 30) dan mengembalikan embed dengan grafik garis terlampir, sehingga berfungsi sebagai pengecekan angka cepat sekaligus tampilan tren.
- /status invite: join dan leave hari ini, 7 hari terakhir, dan jendela yang dipilih, ditampilkan sebagai perubahan bersih dengan jumlah plus/minus mentah di bawahnya.
- /status tickets: tiket yang dibuka, tiket yang ditutup, dan berapa yang sedang terbuka saat ini. Ini adalah analitik tiket yang paling sering diminta admin Discord: apakah tiket menumpuk, atau tim masih bisa mengimbanginya.
- /status sales: jumlah invoice dan total nilainya. Totalnya adalah penjumlahan biasa, bukan konversi mata uang, karena invoice bisa dibuat dalam lebih dari satu mata uang dan mengonversinya berarti menebak nilai tukar.
- /status community: jumlah ulasan dan volume pesan, untuk melihat aktivitas umum, bukan dukungan atau pendapatan.
- /status all: setiap field di atas dalam satu embed, untuk ringkasan hari Senin pagi.
Grafik digambar di sisi server dan dilampirkan sebagai gambar. Jika rendering grafik gagal karena alasan apa pun, perintah tetap membalas dengan angka dalam bentuk teks alih-alih gagal total. Hitungan member dan pesan mulai dihitung sejak hari Noxyr bergabung ke server, jadi bot yang ditambahkan bulan lalu tidak akan menampilkan riwayat bertahun-tahun.
/sales: pendapatan, pembeli teratas, dan gaya laporan
/sales mencakup statistik penjualan yang dibutuhkan bot Discord selain satu total. Ada tiga subperintah, semuanya khusus admin, dan semuanya bisa dibalas secara privat atau diposting ke channel dengan opsi post.
- /sales report: pendapatan untuk periode itu, jumlah pesanan yang dibayar, unit terjual, jumlah invoice, rincian per status (Successful, Pending, Failed) dan per metode pembayaran, serta produk teratas. Pilihan periodenya: 7 hari terakhir, 30 hari terakhir, 90 hari terakhir, atau sepanjang waktu.
- /sales top: papan peringkat pembeli, diurutkan berdasarkan jumlah pesanan atau jumlah yang dibelanjakan, bisa difilter per mata uang, menampilkan hingga 25 pembeli.
- /sales style: mengatur warna embed, gambar banner dan thumbnail, judul kustom untuk laporan dan papan peringkat, teks footer, ukuran default papan peringkat, apakah nama pembeli ditampilkan di samping mention, dan status invoice mana yang dihitung sebagai pendapatan. Mematikan ketiga status sekaligus akan ditolak, karena laporan yang tidak pernah menghitung apa pun sebagai pendapatan tidak berguna bagi siapa pun.
Kedua perintah memeriksa izin Administrator atau role admin yang sudah diatur sebelum dijalankan. Ini gerbang admin yang sama dengan yang dipakai dashboard.
Isi halaman Overview dashboard
Halaman Overview pada dashboard bukan laporan yang sama dengan /status. Ini adalah halaman pertama yang Anda lihat untuk sebuah server, dan merangkum sisi toko dan dukungan: jumlah kategori, produk, dan voucher aktif, total invoice, total ulasan, lima invoice dan lima ulasan terbaru, serta daftar pengaturan untuk fitur yang sudah Anda aktifkan tetapi belum selesai dikonfigurasi. Jika /status dan /sales adalah laporan sesaat yang Anda tarik sesuai kebutuhan di Discord, Overview adalah ringkasan yang selalu mutakhir yang Anda cek di browser tanpa harus duduk di depan keyboard di tengah percakapan.
Membaca angka yang sama dari situs web Anda: Server API
Jika Anda ingin statistik server Discord di situs Anda sendiri, halaman status, atau spreadsheet, Server API adalah jembatannya. API ini hanya baca, dibatasi untuk satu server, dan mengembalikan JSON untuk data yang sama dengan yang sudah dilacak /status dan dashboard:
- GET /api/v1/server: nama, ikon, jumlah member, jumlah online, boost.
- GET /api/v1/tickets: total, jumlah terbuka dan tertutup, volume 7 dan 30 hari, rating rata-rata.
- GET /api/v1/activity?days=30: pesan harian, join dan leave, hingga 90 hari ke belakang.
- GET /api/v1/invoices: jumlah invoice dan pendapatan per mata uang dan status.
- GET /api/v1/reviews: rating rata-rata, rincian bintang, dan ulasan publik terbaru.
- GET /api/v1/giveaways: jumlah giveaway aktif dan yang sudah berakhir, serta total entri.
Buat kunci dari halaman API server di dashboard, kirim sebagai Bearer token, dan setiap endpoint dibatasi oleh scope-nya sendiri. Dengan begitu, Anda bisa membagikan kunci yang hanya membaca tiket, misalnya, tanpa membocorkan data invoice. Kunci dibatasi 60 permintaan per menit, dan itu lebih dari cukup karena total tiket dan penjualan tidak perlu di-polling lebih sering dari sekali per menit.
Pertanyaan umum
Apakah saya perlu API untuk melihat analitik? Tidak. /status dan /sales berfungsi tanpa pengaturan apa pun, dan halaman Overview dashboard hanya butuh login. API untuk menarik angka ke sesuatu di luar Discord.
Apakah /status berbayar? Tidak. Noxyr tidak memiliki paket premium, jadi setiap tampilan /status dan /sales tersedia untuk setiap server.
Bisakah member melihat statistik ini? Kedua perintah membutuhkan Administrator atau role admin yang sudah diatur, jadi member biasa tidak bisa menjalankannya.
Mengapa total penjualan tidak mengonversi mata uang? Invoice bisa dibuat dalam USD, INR, EUR, atau GBP, dan laporan menjumlahkan mata uang apa pun yang benar-benar Anda jual, alih-alih mengarang nilai tukar.
Lihat daftar perintah lengkap di /commands, atau bandingkan menjalankan sesuatu dari Discord versus dashboard di Dashboard vs. perintah. Tambahkan Noxyr gratis untuk mendapatkan analitik, tiket, dan toko dalam satu bot.