launch-analytics

このスキルは、流入元を特定するための計測を設定します。以下のルールは必ず守ってください。

1. リンクやイベントに個人を特定できる情報を含めないでください。メールアドレス、氏名、識別子をUTMパラメーターやイベントパラメーターに決して含めないでください。 プロジェクトの同意／Cookie／GDPRの設定を尊重し、同意による制御がある場合は回避しないでください。
2. 一貫した方式を1つだけ使用してください。UTMの規約を一度定義し（小文字で記述し、文書化します）、掲載ページ、アウトリーチ、ソーシャルのすべてのローンチリンクに適用してください。タグに一貫性がないと、レポートが分断されます。
3. 既存のアナリティクスを壊さないでください。まずプロジェクトで現在使われているスタックを検出し、タグマネージャーを重複して設置したり、page_viewを二重に発火させたりせず、既存の設定を拡張してください。GA4が導入されていない場合は、追加を提案してください。導入済みだと決めつけないでください。
4. 長期的な成果を計測してください。訪問数やアップボート数だけでなく、登録とアクティベーションまでのファネルを追跡してください。ローンチの価値は、見せかけの一時的な急増ではなく、獲得したメールアドレスとアクティベーションしたユーザーにあります。
5. スニペットは最新のドキュメントに照らして確認してください。GA4／gtagの仕様は変更されるため、コードを貼り付ける前に最新のGoogleドキュメントでイベント構文を確認し（docs／find-docsスキルを使用）、実際のスタックに合わせてください。
6. 数値を捏造しないでください。計測を設定し、ツールで実際に確認できた内容だけを報告してください。
7. .ulpi/launch/<channel>/analytics.mdにキットをファイルとして保存してください（必要に応じてディレクトリを作成します）。後からスクロールして見失うアドバイスではなく、そのまま貼り付けられる永続的な成果物にしてください。

launch-analytics

Inputs

• $request：ローンチの流入元とサイト／スタック。ローンチスキルから呼び出された場合、呼び出し元からchannel（ディスク上のハイフン区切りのローンチスラッグ。例：product-hunt。これが出力先ディレクトリになります）、GAの**utm_source**値（例：producthunt。ハイフンなし）、および対象リンクが渡されます。単独で実行する場合は、流入元、サイトURL、現在のアナリティクススタックを確認してください（流入元からchannelスラッグを設定します）。

Goal

.ulpi/launch/<channel>/analytics.mdに作成するローンチ流入元計測キットです。一貫したUTM方式、リンクごとのUTMマップ、コンバージョンファネルに対応するGA4（または既存スタック）のイベント計画、計測用スニペット、検証と結果確認の計画を含みます。

Step 0: Resolve source & stack

channel（出力先ディレクトリのスラッグ。例：product-hunt）とGAの**utm_source**値（例：producthunt）を特定し、両者を区別してください。現在のアナリティクスも検出してください。GA4／gtag.js、Google Tag Manager、Plausible／Fathom／PostHog、または何もない状態を確認します。成功条件：channel、utm_source、実際のアナリティクススタックが判明していること。

Step 1: Define the UTM scheme & link map

references/utm-and-events.mdを読み込みます。規約を1つだけ設定し（小文字、ハイフン区切り）、ローンチリンクを掲載場所ごとに分類したUTMマップを作成してください。

• utm_source = プラットフォーム（例：producthunt）
• utm_medium = 掲載場所（例：launch、maker-comment、email、social）
• utm_campaign = ローンチ（例：ph-launch-2026-06）
• utm_content = 個別のリンク（例：x-thread、wave1-email、gallery-cta）

ローンチスキルから呼び出された場合は、タグ付けしたリンクを呼び出し元（掲載ページ／アウトリーチ）に返し、すべてのリンクの流入元を特定できるようにしてください。単独で実行する場合は、作成した成果物に含めるタグ付きリンクマップを、ユーザーが利用するための納品物とします。成功条件：規約が1つに統一され、リンクを掲載するすべての場所にタグ付きリンクがあること。

Step 2: Map the funnel & events

コンバージョンファネルと、各ステップを示すイベントを定義します。通常は、page_view（自動）→ sign_up → 重要なアクティベーションイベント（最初に実際の価値を得る瞬間）です。GA4でsign_upとアクティベーションをコンバージョン／キーイベントとして設定してください。成功条件：ファネルの各ステップにイベント名があり、重要なイベントがコンバージョンとして指定されていること。

Step 3: Wire it

実際のスタックに対応した計測スニペット（GA4のgtag('event', …)または同等のもの）と、その追加場所を提示してください。最新のドキュメントに照らして検証し、最小限の構成とし、同意を尊重してください。 成功条件：スタックに適合し、二重発火を起こさない、コピー＆ペーストで使える設定があること。

Step 4: 検証と結果の確認

検証手順（GA4 の DebugView／Realtime で、適切なパラメーターとともにイベントが発火することを確認）と、簡単な結果確認計画を示します。utm_source ごとのローンチ当日のトラフィック、ソース別の登録数、ファネルのコンバージョンを確認できる場所を記載してください。成功基準：ユーザーがローンチ前にトラッキングの動作を確認でき、ローンチ後に結果を把握できます。

Step 5: キットを保存する

上記のすべてを .ulpi/launch/<channel>/analytics.md に書き込みます（必要に応じてディレクトリを作成します）。内容には、UTM スキームとタグ付きリンクの一覧、ファネル／イベント計画、接続用スニペット、検証／結果確認の手順を含めます。<channel> は、呼び出し元から渡されるハイフン区切りのローンチスラッグです（例：product-hunt）。utm_source とは別のものです。成功基準：そのまま貼り付けて使える analytics.md がディスク上に永続的に保存されています。

ガードレール

• UTM やイベントパラメーターに個人を特定できる情報（PII）を含めないでください。ユーザーの同意と GDPR を遵守してください。
• ドキュメント化したスキームは 1 つだけにし、小文字で統一して、すべてのリンクで再利用してください。
• 既存のスタックを拡張してください。計測を二重に追加したり、同意による制御を壊したりしないでください。
• 訪問だけでなく、登録／アクティベーションを追跡してください。見栄えだけの指標より、持続的な成果を重視してください。
• GA4／gtag の構文は最新のドキュメントに照らして確認し、実際のスタックに合わせてください。
• 実際の数値のみを報告してください。決して捏造しないでください。

参照資料を読み込むタイミング

• references/utm-and-events.md — UTM の規約とリンクごとの一覧、GA4 イベントの分類とコンバージョンの設定、接続用スニペットのパターン、検証手順（Step 1〜4）。

出力要件

.ulpi/launch/<channel>/analytics.md を書き込む／返します。

1. UTM スキームと、ローンチリンクすべてのタグ付きリンク一覧
2. ファネルとそのイベント。sign_up／アクティベーションにはコンバージョンのフラグを設定
3. 実際のスタック向けの接続用スニペット（最新のドキュメントに照らして検証済み）
4. 検証手順（DebugView／Realtime）と結果確認計画（ソース別のトラフィック／登録数）