Communitygithub.com

アナリティクスダッシュボードデザイン

Cloudflare風の落ち着いたレイアウトでプロダクトアナリティクスダッシュボードを構築、再設計、または批評します。KPI行(デルタ値とスパークライン付き)、メトリックタブ付きの単一チャート、ソート可能な国別テーブル、ウェブサイト→アプリ→有料ファネル、購入者ジャーニー、リテンションコホート、アプリ健全性、トラフィックソース、イベントログを備え、正直な数字、プライバシー重視のトラッキング、スクリーンショットQAを含みます。

アナリティクスダッシュボードデザイン とは?

このスキルは、プロダクトアナリティクスダッシュボードを設計、再設計、または批評するための包括的なガイドです。Cloudflareスタイルのクリーンで落ち着いたレイアウトを採用し、KPI行(デルタ値とスパークライン付き)、メトリックタブ付き単一チャート、ソート可能な国別テーブル、ファネル、購入者ジャーニー、リテンションコホートなど、主要な分析コンポーネントを提供します。特に、データの正直さとユーザープライバシーを重視しており、誤解を招く指標の表示を防ぎ、プライバシーファーストのトラッキング(Cookie不使用、IP非保存、ランダムIDベース)を徹底します。このスキルは、実際のMacアプリのアナリティクスダッシュボードの構築と運用から抽出されたベストプラクティスに基づいており、スクリーンショットQAプロセスを通じて数値の正確性を検証します。対応プラットフォームは具体的に限定されていませんが、Webアプリ、SaaS、インディーアプリ、管理画面など、あらゆるプロダクトのダッシュボードに適用可能な汎用的な設計原則を提供します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/boburjonmavlonov/analytics-dashboard-design-skill/tree/main/skills/analytics-dashboard-design

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

アナリティクスダッシュボードデザイン は何をしますか?

ひとつのプロダクトのためのダッシュボードは、一目でひとつの質問に答えます:成長しているか、どこで離脱が起きているか? ページ上のすべてはその質問に答えるために存在し、次にオーナーが理由を掘り下げられるようにします。

このスキルは、リリースされたMacアプリのアナリティクスダッシュボード(ウェブサイト→ダウンロード→インストール→トライアル→有料)を構築・運用し、そのオーナーがスクリーンショットで見つけたすべてのバグから抽出されました。実例は固定サンプルデータを用いたexamples/product-analytics.htmlです。

作業の進め方

以下の手順を順に実行します。各手順は、確認できる「完了条件」で終わります。

1. まずデータ契約を書く

UIの前に、ページに表示するすべての数値と、そのそれぞれについて以下をリストアップします:カウントするイベント、カウント期間、ユニーク数か総数か、タイムゾーン、および比較対象となる「前期」。これをUIコードではなく、APIレスポンスの形状で記述します。references/metrics.mdを参照。

完了条件:すべてのタイル、列、チャートが契約に1行ずつ対応し、「同じ」数値を表示する2つの場所が同じフィールドからその数値を読み取っていること。

2. ページをレイアウトする

セクションリンク付きのサイドバー、フレッシュネスステータスと期間切り替えのある固定トップバー、その後にジャーニー順のセクション:概要 → 国 → ファネル → 購入者 → アプリ → リテンション → ウェブサイト → イベント。1カラムのコンテンツ、最大幅1280px。references/layout.mdを参照。

完了条件:1440×900でスクロールせずに概要が一目でわかる質問に答えられること。

3. リファレンスからコンポーネントを構築する

references/components.mdのパターンとreferences/snippets.mdのコードを使用する:ヘアラインKPI行、「was」ベースライン付きデルタ、チャートウィンドウ上のスパークライン、単一チャート上のアンダーラインメトリックタブ(テーブルトグル付き)、ソート列にシェアバーがあるソート可能な国テーブル、ステップコンバージョン付きファネルバー、タイムライン付き拡張可能な購入者行、「未報告」スライスを明示したドーナツ、クラス階層化されたリテンションヒートマップ。

色はreferences/tokens.mdのトークンのみから取得します。ライトとダークの両方が必須です。

完了条件:トークンの外にある色、半径、フォントサイズをコンポーネントが使用していないこと。

4. 正直さチェック

references/metrics.mdをセクションごとに確認する。よくある問題:ベースが1のときの「-100%」、支払いプロバイダーより遅れる収益、$0の注文を顧客としてカウント、日次ユニーク数の合計をユニーク数とラベル付け、報告しなかった人を暗黙的に除外するドーナツシェア、推測を事実として表示する「ソース」。

完了条件:すべての数値がその期間を明記し、すべての推定値が推定値であると明記していること。

5. プライバシーチェック

人々が信頼するプロダクトのためのアナリティクスは、人々が不信感を抱くものになってはいけません。references/privacy.mdに従う:ウェブサイトにCookieなし、IPを保存しない、イベント内にユーザーコンテンツを含めない、インストールごとのランダムID、アプリ内のオプトアウト、およびジャーニーは日次ソルトハッシュで結合し、IDでは決して結合しない。

完了条件:イベントスキーマを編集せずにプロダクトのプライバシーポリシーに貼り付けられること。

6. スクリーンショットQA

references/qa.mdを実行する:1440、1024、390pxでの実際のスクリーンショット、ライトとダーク、すべての期間、合計がページ外で計算された数値と照合されていることを確認。コードではなく画像を見る。

完了条件:すべてのスクリーンショットがクリーンで、既知の合計が一致すること。

常に適用されるルール

  • ジャーニー順。 セクションは顧客のたどる経路に従うため、離脱は上から下へと読み取れます。
  • 数値ごとにひとつの期間を明記。 「期間」、「今日」、「過去30日間」を列の下またはタイルのヒントに記載します。
  • 同種のもの同士を比較する。 前期は現在の期間と同じ長さで、現在の期間が始まるところで終わります。
  • 小さなベースで大げさにしない。 0 → 3は「新規」であり、「+∞%」ではありません。1 → 2のデルタは表示しますが、控えめにします。
  • 不明は穴ではなく行として表示する。 不明な国、報告されていない権限、マッチしないソースは表示され、最後にソートされ、合計にカウントされます。
  • フレッシュネスを表示する。 ヘッダーに「更新 09:00 UTC」「支払い同期 08:57」と表示。読み込みに失敗した場合は赤いドットと平易な言葉のエラー。
  • テーブルは常にワンクリックで表示できる。 すべてのチャートには、正確な日次値が「テーブル」トグルの裏にあります。
  • キーボードとスクリーンリーダー対応。 チャートはフォーカスを受け取り、← →でポイントをステップ移動。ソート可能なヘッダーは aria-sort 付きのボタン。拡張可能な行は role="button" と aria-expanded 付き。
  • 依存関係なし。 SVG、CSS conic gradients、および Intl でここのすべてのチャートをカバー。サンプルは1つのHTMLファイル。

ハウススタイル

ニュートラルグレー、ひとつのブルー系シリーズ色、良い/悪いには緑と赤のみ、ブランドマークにはオレンジのみ。ベーステキスト13.5px、KPI値24px、数値と見出しはウェイト600、数値が変化する場所ではすべてtabular figuresを使用。影ではなくヘアライン。カード半径8px、コントロール6px、バー4px。references/tokens.mdを参照。

批評フォーマット

ダッシュボード(コード、URL、スクリーンショット)のレビューを依頼された場合、以下の順序で回答します:

  1. 判定 一文で:一目でわかる質問に答えているか?
  2. 矛盾する数値 — 同じ指標が2つの値、合計が合わない、期間が一致しないなど。これらが最初に来ます。なぜなら信頼を損なうからです。
  3. 正直さの問題 references/metrics.mdから。
  4. プライバシーの問題 references/privacy.mdから。
  5. レイアウトとコンポーネントの問題、オーナーの作業をどの程度遅らせるかで順位付け。
  6. うまくいっている点 — 簡潔に述べますが、再設計で失われないように必ず言及します。

各問題:何を見たか、なぜ誤解を招くか/遅くなるか、修正方法。

リファレンス

ファイル内容
metrics.mdデータ契約、カウント期間、デルタ、収益、アトリビューション、ファネル、コホート
layout.mdサイドバー、トップバー、セクション順序、グリッド、ブレークポイント、スマホレイアウト
components.mdページ上のすべてのコンポーネント、その状態、アクセシビリティ
tokens.mdライト/ダークのカラートークン、タイポグラフィとスペーシングのスケール
snippets.mdデルタ、適切な軸目盛、バケット、スパークライン、ドーナツ、バーリスト、ヒートマップ階層、複数形
privacy.mdCookieなし訪問、ハッシュ化ネットワーク、インストールID、オプトアウト、決して収集してはいけないもの
qa.mdスクリーンショットプロトコル、既知の合計、スメルテーブル
case-study-typecorrect.mdこのスキルの元となった実際のダッシュボードと、各ルールが修正したバグ

関連スキル