Discordのサーバー分析ボットは、メンバーの参加、チケットの作成、インボイスの支払いといった生のデータを、Discordの埋め込みか、Webダッシュボードで一目で読めるレポートに変えます。Noxyrでは、2つのスラッシュコマンド（/status と /sales）、ダッシュボードの概要ページ、そして同じ数字を自分のサイトに公開する読み取り専用のサーバーAPIでこれを行います。このガイドでは、それぞれが実際に何を表示するかを説明します。
/status：メンバー、チケット、コミュニティの統計
/status は管理者専用のコマンドで、5つの表示があります。all、invite、sales、tickets、community です。どの表示も days オプション（7、14、30のいずれか。既定は30）を受け付け、折れ線グラフを添えた埋め込みを返します。そのため、すぐに数字を確認することにも、推移を見ることにも使えます。
- /status invite：今日、直近7日間、選んだ期間の参加と退出。純増として表示され、その下に参加と退出の生の数が並びます。
- /status tickets：開かれたチケット、閉じられたチケット、現在開いているチケットの数。Discordの管理者が最も求める、チケットの分析です。チケットが溜まっているのか、チームが対応できているのかがわかります。
- /status sales：インボイスの件数と合計金額。合計は単純な合算で、通貨換算はしていません。インボイスは複数の通貨で発行される場合があり、換算すると為替レートを推測することになるためです。
- /status community：レビューの件数とメッセージの量。サポートや売上ではなく、全体的な活動を見るためのものです。
- /status all：上のすべての項目を1つの埋め込みにまとめたもの。月曜日の朝の要約に使えます。
グラフはサーバー側で描画され、画像として添付されます。何らかの理由でグラフの描画に失敗しても、コマンドは完全に失敗することなく、数字をテキストで返信します。メンバーとメッセージの件数は、Noxyrがサーバーに参加した日からのみカウントされるため、先月追加されたボットには何年分もの履歴は表示されません。
/sales：売上、上位の購入者、レポートのスタイル
/sales は、Discordボットに必要な単一の合計を超えた売上の統計を扱います。3つのサブコマンドがあり、すべて管理者専用です。非公開で返信することも、post オプションでチャンネルに投稿することもできます。
- /sales report：期間の売上、支払い済みの注文件数、販売した数量、インボイスの件数。ステータス（Successful、Pending、Failed）別と支払い方法別の内訳、そして上位の商品。期間は、直近7日、直近30日、直近90日、全期間から選べます。
- /sales top：購入者のリーダーボード。注文件数または支払った金額で順位を付け、通貨で絞り込めます。最大25人まで表示されます。
- /sales style：埋め込みの色、バナーとサムネイルの画像、レポートとリーダーボードのカスタムタイトル、フッターのテキスト、リーダーボードの既定の人数、メンションの横に購入者名を表示するかどうか、そして売上としてカウントするインボイスのステータスを設定します。3つのステータスをすべてオフにすることは拒否されます。何も売上としてカウントしないレポートは、誰の役にも立たないからです。
どちらのコマンドも、実行前に管理者権限または設定された管理ロールを確認します。ダッシュボードが使っているのと同じ管理者の制限です。
ダッシュボードの概要に表示される内容
ダッシュボードの概要ページは、/status と同じレポートではありません。サーバーを開いて最初に表示されるページで、ショップとサポートの側面をまとめます。カテゴリ、商品、有効なバウチャーの件数、インボイスの合計、レビューの合計、最新のインボイス5件と最新のレビュー5件、そして有効にしたものの設定が終わっていない項目のセットアップ一覧が表示されます。/status と /sales が、Discordで必要に応じて取り出す時点のレポートなのに対し、概要は、会話の途中でキーボードの前にいなくてもブラウザで確認できる、常に最新の要約です。
自分のWebサイトから同じ数字を読む：サーバーAPI
Discordサーバーの統計を自分のサイト、ステータスページ、スプレッドシートに表示したい場合は、サーバーAPIが橋渡しをします。読み取り専用で、1つのサーバーに限定されており、/status とダッシュボードがすでに追跡しているのと同じデータをJSONで返します。
- 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トークンとして送信します。各エンドポイントは独自のスコープで制限されているので、たとえばインボイスのデータを公開せずに、チケットだけを読めるキーを共有できます。キーは1分あたり60リクエストに制限されています。チケットと売上の合計は1分に1回より速くポーリングする必要がないので、十分な数です。
よくある質問
分析を見るのにAPIが必要ですか？いいえ。/status と /sales は設定なしで動き、ダッシュボードの概要ページはログインするだけで見られます。APIは、Discordの外のものに数字を取り込むためのものです。
/status に費用はかかりますか？いいえ。Noxyrには有料プランがないので、/status と /sales のすべての表示は、どのサーバーでも利用できます。
メンバーもこれらの統計を見られますか？どちらのコマンドも管理者または設定された管理ロールが必要なので、一般のメンバーは実行できません。
売上の合計で通貨換算しないのはなぜですか？インボイスはUSD、INR、EUR、GBPのいずれでも発行できます。レポートは、架空の為替レートを作るのではなく、実際に販売した通貨をそのまま合計します。
コマンドの全一覧は/commandsをご覧ください。Discordからの操作とダッシュボードからの操作の比較はダッシュボードとコマンドの比較にあります。分析、チケット、ストアを1つのボットで運用するには、Noxyrを無料で追加してください。