utm-link-generator

UTMリンクジェネレーター

単一の命名管理システムのもとで、UTMタグ付きリンクを生成します。utm-registry.json により、標準的な命名規則を適用し、重複や命名の揺れを防ぎ、LinkedIn、メール、ソーシャルメディア、広告向けのプラットフォーム対応リンクを出力します。

内容

• references/naming-conventions.md -- 適用されるルール、UTMパラメーターのリファレンス、標準のソース／メディア一覧、キャンペーンの命名パターン。
• references/platform-variants.md -- プラットフォームごとのリンクテンプレート（LinkedIn、メール、ソーシャルメディア、有料広告）。
• references/registry-schema.md -- utm-registry.json の構造、検証レポートと出力概要のテンプレート。
• references/bulk-and-registry-ops.md -- 一括生成、レジストリーコマンド（監査／追加／レポート／エクスポート）、エラー処理、連携、ベストプラクティス。

機能

1. 検証済みの一貫したパラメーターで、UTMタグ付きURLを生成します。
2. すべてのリンクを追跡し、命名規則を適用する utm-registry.json を管理します。
3. 重複を防ぎます -- 類似したリンクがすでに存在する場合に警告します。
4. プラットフォーム固有のバリエーション（LinkedIn、メール、ソーシャルメディア、広告）を作成します。
5. A/Bテストやマルチチャネルキャンペーン向けに、バリエーションを一括生成します。
6. 検証します -- 不正な形式のURL、空のパラメーター、命名規則違反を拒否します。
7. レポートを作成します -- レジストリーからキャンペーン追跡の概要を生成します。

ワークフロー

1. 入力を受け付けます。 遷移先URL、ソース、メディア、キャンペーン（すべて必須）に加え、任意のターム、コンテンツ、対象プラットフォームを収集します。明示されていない場合は、自然言語の概要から抽出します。
2. 検証して正規化します。 小文字に変換し、スペースをハイフンに置き換え、[a-z0-9-] 以外の文字を除去し、既知の別名を自動修正します。不明なソース／メディア値は拒否し、最も近い候補を提案します。URL形式を検証し、50文字の上限を適用します。修正内容は references/registry-schema.md のテンプレートを使って報告します。ルールの詳細は references/naming-conventions.md を参照してください。
3. レジストリー内の重複を確認します。 utm-registry.json を読み込み（存在しない場合は作成します）。完全一致の重複には既存のリンクを返し、類似した重複は警告付きで許可し、命名の競合（同じキャンペーンで大文字・小文字またはハイフンの使い方が異なる場合）はブロックします。
4. リンクを生成します。 {base_url}?utm_source=&utm_medium=&utm_campaign=[&utm_term=][&utm_content=][&utm_id=] を組み立てます。ベースURLにすでにクエリパラメーターがある場合は & で追加し、値をURLエンコードして、既存のクエリパラメーターとフラグメントを保持します。
5. プラットフォーム別のバリエーションを生成します。 references/platform-variants.md を使って、指定されたプラットフォームごとに最適化されたリンクを作成します。
6. レジストリーを更新します。 references/registry-schema.md のスキーマに従って、生成したすべてのリンクを utm-registry.json に追加し、統計情報とタイムスタンプを更新します。
7. 概要を出力します。 references/registry-schema.md のテンプレートを使って、コピーしてすぐに使える概要を提示します。

一括処理、レジストリーコマンド（監査、ソース／メディアの追加、キャンペーンレポート、CSVエクスポート）、エラー処理、連携に関する注意事項については、references/bulk-and-registry-ops.md を参照してください。