Typemark Documentation

分析

ドキュメントが何人に読まれているか、どのページが最もよく読まれているか、そしてページが役に立ったかどうかを確認できます。Pro と Enterprise で利用できます。

2026年11月19日更新

分析では、ドキュメントがどれだけ読まれているかを確認できます。過去 30 日間の総ページビュー数と、最もよく見られたページ、読者が検索したものの見つけられなかった内容、そして「このページは役に立ちましたか?」への回答が表示されます。Pro と Enterprise で利用でき、インストールは不要です。

開く

プロジェクトのサイドバーで Analytics をクリックします。プロジェクトオーナーのプランに分析が含まれている場合に表示され、プロジェクトのメンバー全員が閲覧できます。その横の数字は、ドキュメントで答えられなかった質問の件数を示しています。

表示される内容

指標内容
総ビュー数過去 30 日間のサイト全体のページビュー数
最も見られたページ最もビュー数の多いページとそのビュー数
上位ページビュー数順に並べた最大 50 ページ

サイトが最初の訪問を受けるまでは、ページに「ビューはまだありません」と表示されます。

ドキュメントで答えられなかった質問

分析では、過去 30 日間に読者がサイト内で検索して結果が見つからなかった語句と、Ask AI に尋ねたもののどのページからも答えられなかった質問を、よく尋ねられた順に一覧表示します。同じ質問は、プロジェクトの概要の 要対応 や、エディターのアシスタントにも表示されます。

AI による執筆を使うと、質問の横にある 回答の下書きを作成 をクリックできます。エディターが開き、アシスタントの対象が すべてのページ に設定され、質問が入力された状態になります。送信するまで何も実行されず、保存する前にすべての変更を確認できます。

保存されるのは、検索語句または質問の本文と、1 日ごとの質問回数だけです。IP アドレスや読者の識別情報は保存されず、質問は 90 日後に削除されます。

ビューとしてカウントされるもの

  • ビューとは、公開済みページが 1 回読み込まれることです。
  • 同じ読者が同じページを 15 分以内に再訪問した場合は、1 回としてカウントされます。
  • AI ツールからの Markdown 版、llms.txt、MCP リクエストはカウントされません。

プライバシー

分析では、サイトにトラッキングスクリプトを追加しません。Typemark はサーバー側でビューをカウントします。独自の分析ツールも併用したい場合は、カスタムコードを参照してください。再訪問を区別するために、読者の IP アドレスとブラウザーをハッシュ化し、そのハッシュを 15 分間保持します。長期的に保存されるのは、ページごとの 1 日あたりのビュー数だけです。

読者のフィードバック

フィードバックウィジェットをオンにすると、すべてのページの末尾に「このページは役に立ちましたか?」と表示されます。読者は はい または いいえ で回答でき、最大 500 文字のコメントを追加できます。

  1. オンにする

    Settings > Reader features で Feedback widget をオンにします。または、typemark.json の features で "feedback_widget": true を設定します。

  2. 結果を確認する

    Analytics を開きます。Reader feedback の下に、次の内容が表示されます。

    • サイト全体で「役に立った」と回答された割合
    • ページごとの「役に立った」と「役に立たなかった」の回答数。「役に立たなかった」の多い順に並びます(列をクリックすると、その列で並べ替えられます)
    • 最新のコメント 20 件。それぞれ該当ページへのリンク付きです

読者はページごとに 1 回だけカウントされます。読者が回答を変更すると結果も更新され、古い回答に対して書かれたコメントは削除されます。

フィードバックはページに紐づいています。ページを削除するとそのフィードバックも削除され、名前を変更した場合も削除されます。新しいパスは新しいページとして扱われるためです。ウィジェットをオフにすると読者には表示されなくなりますが、結果は保持されます。

ウィジェットを使うには、プロジェクトオーナーのプランで分析が利用可能である必要があります。Free プランではこの設定は効果がありません。

プライバシー

フィードバックウィジェットは Cookie を設定せず、他のサイトからは何も読み込みません。Typemark は読者の IP アドレスを保存しません。ページごとに 1 回だけカウントするため、そのページ用に IP アドレスとブラウザーのキー付きハッシュを保持しますが、これを IP アドレスに戻すことも、別のページの情報と照合することもできません。コメントは読者が書いたままの内容で保存されます。