mcpField
S
statistik

statistik

github.com/dischen87その他09 回インストール今日更新
リポジトリ

statistik について

statistik は、ウェブサイトに PostHog のアクセス解析を設計して組み込む Agent 向けスキルです。重要な行動を測定したい運営者向けに、イベントを絞り、処理の成功後にのみ記録し、訪問者データの収集を抑える方法を案内します。

主な機能

  1. 01明確なイベントを少数計画
  2. 02PostHog の EU プロジェクト設定
  3. 03Cookie を使わない設定で解析を追加
  4. 04処理の成功後にイベントを記録
  5. 05内部アクセスの除外とデータ検証

活用シーン

  1. 01ウェブサイトのページビュー計測
  2. 02問い合わせフォーム送信成功の測定
  3. 03解析イベントと実際の問い合わせ数の照合

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/dischen87/albatros-skills --skill statistik

インストール後、Claude Code で/statistikを入力して読み込まれたか確認します。

詳細

統計：店の入口にある正の字

イメージ

店主は入口で正の字をつけています。あらかじめリストにあるものだけを数え、本当に起きたときに初めて一本加えます。お客さんが財布を取り出しただけではなく、支払いが済んだときです。顔は覚えません。

あなたのウェブサイトの統計も、まさにこのように扱います。名前が明確な項目を少数だけ用意し、適切なタイミングで数え、訪問者について必要以上の情報を保存しません。統計における一本の線をイベントと呼びます。

このイメージの使い方： 質問したりコマンドを示したりする前に、最初の返答で相手に伝えてください。すぐに解決策を求められた場合も同様です。

話し方

  • 質問だけで終わらせない： プロジェクトや情報が不足していても、具体的な手順を示すか、仮定を明記した草案（[仮定：…]）としてファイルを作成してください。不足していることについては、最後に質問してください。
  • 「あなた」を使い、専門用語は避けます。正の字のイメージを伝えるまでは「イベント」という言葉を使いません。
  • プライバシー保護は付け足しではありません。人についてより多くの情報を保存する設定には、それぞれ理由とプライバシーポリシーへの記載が必要です（スキル recht-ch）。
  • PostHog アカウントは本人がブラウザーで作成します。プロジェクトキー（phc_ で始まります）はウェブサイト用で公開されるため、受け取ってもかまいません。個人用 API キー（phx_）をコードに入れることは絶対に避けてください。

手順

1. リストを作ってから導入する

本人と一緒に docs/statistik.md を作成します。最初は目標イベントを一つ用意すれば十分です。本人にとって重要な行動を選びます（docs/plan.md の「成功をどう判断するか」を参照）。

# Ereignis-Plan

| Ereignis | zählt wenn | Pflicht-Angaben |
|---|---|---|
| `$pageview` | automatisch bei jedem Seitenaufruf | – |
| `generate_lead` | Formular erfolgreich abgeschickt (Server hat bestätigt) | `form` (welches Formular) |
| `sign_up` | Newsletter-Anmeldung bestätigt | `location` (wo auf der Seite) |

Eigene Besuche: herausgefiltert seit <Datum>
Änderungen: <Datum> – <was umbenannt, warum>

命名規則：小文字とアンダースコアを使います（generate_lead）。一般的な標準名を優先します（purchase、sign_up、generate_lead）。行動ごとにイベントを一つ用意し、バリエーションは属性で表します（form: "kontakt"）。位置を名前に使うことは避けてください（schritt_2）。

2. PostHog プロジェクトを作成する

本人が PostHog に登録し、EU のロケーションを選んでプロジェクトを作成します。その後、プロジェクトキーを渡してもらいます。

3. 導入する

PostHog のガイドにある最新の導入スニペット（「Web snippet」）を、次の設定で各ページの <head> に追加します。

posthog.init('phc_…', {
  api_host: 'https://eu.i.posthog.com',
  persistence: 'memory',              // keine Cookies, kein Banner nötig
  person_profiles: 'identified_only', // keine Profile von anonymen Besuchern
})

persistence: 'memory' を指定すると、ページビューはそれぞれカウントされますが、PostHog は Cookie を使って訪問者を識別しません。そのため、「ユニーク訪問者」の数は正確さが下がります。Cookie を使わない、より優れた設定が現在の PostHog のガイドに掲載されているか確認してください。

4. 目標イベントを適切なタイミングで記録する

成功した後に記録し、フォームを開いたときには記録しません。

// nachdem der Server das Formular bestätigt hat:
posthog.capture('generate_lead', { form: 'kontakt' })

名前、メールアドレス、電話番号、自由記述の内容を属性として送ることは絶対に避けてください。

5. 自分の訪問を除外する

PostHog のプロジェクト設定で「内部ユーザーとテストユーザーを除外」を有効にし、フィルターを設定します（例：自分の IP アドレス）。日付を docs/statistik.md に記録してください。

6. 確認する
  1. ログとパイプライン（スキル git-logbuch、pipeline）。
  2. ページを開き、テストとしてフォームを一度送信します。
  3. PostHog の「Activity」または「Live events」で、$pageview と generate_lead が属性 form とともに表示されるか確認します。
  4. 1 週間後、generate_lead の数が受信トレイに届いた実際の問い合わせ数とおおむね一致しているか確認します。一致しない場合、成功時ではなくフォームを開いたときにイベントが記録されていないか、テストもカウントされていないか確認します。

注意点

  • 成功時ではなくページの読み込み時にイベントを記録すると、試行が成功としてカウントされます。
  • 一度にイベントを増やしすぎると、誰も確認しなくなります。正確なイベントを三つに絞る方がよいでしょう。
  • 名前を変更したのに集計を更新していないと、数値が急落したように見えます。
  • プライバシーポリシーへの記載を忘れないでください。PostHog の目的とロケーションを明記する必要があります（スキル recht-ch）。

ミッションを確認する

webseite-07-statistik を使って mission_pruefen を実行します。確認では ~/projekt/docs/statistik.md が存在することと、ページに PostHog の導入が含まれていることを調べます。

締めくくりのメッセージ

このステップでの最後のメッセージは、「店のドアにある正の字」というイメージに触れ、その要点をもう一度伝える一文から始めます。その後に、達成したこと、結果の保存場所、未対応のこと、次に行うことを示します。

コメント

Markdown 対応