creative-health

/digital-marketing-pro:creative-health

スクリプトの場所。 ホストが ${CLAUDE_PLUGIN_ROOT} を設定しない場合、スクリプトはこのプラグインの skills/ と同じ階層にある scripts/ フォルダーにあります。Python 3.10 以降で実行してください。python を使うか、python が見つからない場合は python3 を使います（macOS、多くの Linux システム）。

目的

有効なすべての広告のクリエイティブの状態を監視します。各クリエイティブの疲労リスクをスコア化し、疲労がパフォーマンスに影響する時期を予測して、具体的な変更案を含む刷新の推奨事項を作成し、疲労が見られるクリエイティブの A/B テスト計画を立てます。クリエイティブの疲労は、広告費を無駄にする最も早い原因の一つです。高い成果を上げている広告も長期間配信し続けると、CTR が低下し、CPM が上昇し、エンゲージメントが薄れて、気付かないうちに費用を消耗します。このコマンドは、疲労がコストにつながる前に検知し、変更すべき内容を具体的に示して、刷新の効果を検証するための体系的なテスト計画を提示します。ローンチから成熟期、衰退期まで、クリエイティブのライフサイクル全体を網羅するため、どのクリエイティブが費用に見合う成果を上げているか、どれに対応が必要かを常に把握できます。

必要な入力

ユーザーは以下を提供する必要があります（または入力を求められます）。

• パフォーマンスデータを含む有効なクリエイティブ：現在配信中のクリエイティブのリスト。各クリエイティブについて、クリエイティブ ID または名前、チャネル（有料ソーシャル、ディスプレイ、検索、メール、動画）、現在のパフォーマンス指標（配信インプレッション数、ユーザーあたりの頻度または平均表示回数、現在の CTR、現在の CPM または CPC、現在のエンゲージメント率）、クリエイティブの最初の 7～14 日間のベースライン指標（ベースライン CTR、ベースライン CPM、ベースラインのエンゲージメント率）、ローンチからの配信日数、クリエイティブを配信しているオーディエンスの規模、現在の日次または週次の広告費を含めてください。エクスポートしたデータを提供するか、接続済みの広告プラットフォーム MCP から取得できます
• チャネルのコンテキスト：クリエイティブを配信している広告チャネル（Meta Ads、Google Ads、TikTok Ads、LinkedIn Ads、ディスプレイネットワーク、プログラマティック、メール）。チャネルごとに疲労の特性が異なります（ソーシャルは検索よりも早く疲労し、動画は静止画とは異なる疲労の仕方をします）
• 刷新時の制約（任意）：ビジュアル変更を制限するブランドガイドライン、リードタイムが長くなる承認プロセス、制作能力（週に制作できる新しいクリエイティブの数）、クリエイティブ制作の予算など、クリエイティブ刷新に関する制約。これらの制約を考慮して、現実的な範囲で実行できる刷新案を提示します
• パフォーマンスのしきい値（任意）：クリエイティブが「疲労した」と見なされるタイミングを示す、ブランド固有のしきい値（例：「CTR がベースラインから 30％低下」「CPM がベースラインから 25％上昇」）。指定がない場合は、チャネルごとに業界標準のしきい値が適用されます

プロセス

1. ブランドのコンテキストを読み込む：~/.claude-marketing/brands/_active-brand.jsonを読み込み、アクティブなスラッグを確認してから、~/.claude-marketing/brands/{slug}/profile.jsonを読み込みます。ブランドのクリエイティブガイドライン、過去のクリエイティブの実績ベンチマーク、過去のキャンペーンで把握されている疲労パターン、制作能力の制約を適用します。また、~/.claude-marketing/brands/{slug}/guidelines/_manifest.jsonにガイドラインがないか確認します。存在する場合は、リフレッシュの選択肢を制限するビジュアルアイデンティティの制約とメッセージングのガードレールを読み込みます。~/.claude-marketing/sops/にエージェンシーのSOPがないか確認します。ブランドが存在しない場合は、「最初にブランドを設定しますか？（/digital-marketing-pro:brand-setup）」と尋ねるか、業界のデフォルト設定で進めます。
2. 各クリエイティブの健全度をスコア化する：各クリエイティブのパフォーマンスデータを使ってcreative-fatigue-predictor.pyを実行します。スコアリングモデルは、5つの疲労シグナルを評価します。CTR比（現在とベースラインの比較、重み30%）、CPM比（現在とベースラインの比較、重み20%）、エンゲージメント比（現在とベースラインの比較、重み20%）、フリークエンシーまたはインプレッションの飽和度（重み20%）、およびチャネルの標準値に対する配信期間（重み10%）です。各クリエイティブには、100が最も健全で0が完全に疲弊した状態を示す0～100の健全度スコアと、リスクレベルの分類が付与されます：健全（75～100）、注意（50～74）、疲労中（25～49）、危機的（0～24）。
3. 疲労のタイムラインを予測する：危機的リスクに達しておらず、日付付きの日次または週次の履歴がある各クリエイティブについて、次を実行します：

   python "${CLAUDE_PLUGIN_ROOT}/scripts/creative-fatigue-predictor.py" --action predict-fatigue --creative-id {id} --performance-history '[{"date":"2026-01-01","ctr":0.025,"cpm":9.0},{"date":"2026-01-08","ctr":0.022,"cpm":9.6},{"date":"2026-01-15","ctr":0.019,"cpm":10.4}]'
   

   3行以上を指定します。各行に1つの日付を含め、順序は任意です。dateはYYYY-MM-DD形式です（ISOタイムスタンプの場合は日付部分を使用します）。ctrは必須で、cpmは任意です。メール、またはCPCで購入した検索広告では省略します。その場合、予測にはCTRのみが使われます（使用したシグナルはsignals_usedに記載されます）。スクリプトは暦日単位の直線トレンドを当てはめ、最新の行から最初のしきい値到達までのdays_remainingを報告します。しきい値は、最も早い行を基準として、CTRが30%低下、またはCPMが30%上昇した時点です。0はしきい値にすでに達していることを示します。nullはトレンドがしきい値に達しないことを示しますが、クリエイティブが健全である証明ではありません。confidenceは行数に基づくラベルであり、統計的な範囲ではありません。スクリプトの数値とは分けた判断として、小規模なオーディエンスほど疲労が早いこと、フリークエンシー、チャネルの動向（ソーシャルは検索より疲労が早い）を考慮して解釈を調整します。日付付きの履歴がない場合は、健全度スコアのみを報告し、タイムラインは予測していないと伝えます。
4. 疲労中のクリエイティブ向けにリフレッシュブリーフを作成する：疲労中または危機的リスクの各クリエイティブについて、具体的なリフレッシュブリーフを作成します。維持する要素（初期のパフォーマンスを高めたフック、価値提案、ソーシャルプルーフ、今も響いているCTA）、変更する要素（ビジュアル表現、見出しの切り口、配色、フォーマット、動画の冒頭のフックなど、疲労の要因となっている要素）、テストする要素（競合クリエイティブのトレンドとブランドのポジショニングに基づき、試す価値のある新たな切り口やアプローチ）を明記します。すべてのリフレッシュ案がブランドガイドラインに準拠していることを確認します。
5. リフレッシュが必要な各クリエイティブのA/Bテスト計画を作成する：各リフレッシュブリーフについて、構成されたA/Bテスト計画を作成します。対照（現在のクリエイティブ）、変更案を反映したバリアント、バリアントが上回ると見込む理由の仮説、評価する主要指標（キャンペーンの目的に応じてCTR、CPC、コンバージョン率）、統計的有意性を得るために必要な最小サンプルサイズ、想定テスト期間、勝者を決定する基準を含めます。体系的にトラッキングできるテスト命名規則も含めます。
6. 広告費と影響度に基づいて優先順位を付ける：対応が必要なすべてのクリエイティブを、日次広告費（広告費が多いほど、疲労した場合の無駄が大きい）と疲労の深刻度（疲労が進んでいるほど、緊急度が高い）の組み合わせで順位付けします。疲労が深刻で多額の予算を消費しているクリエイティブを最上位にします。ベースラインのパフォーマンスを維持する新しいクリエイティブと比較した、疲労したクリエイティブの配信による増分コストとして、推定広告費の無駄を算出し、対応しない場合のコストを定量化します。

出力

以下を含む、クリエイティブの健全性レポートです。

• クリエイティブの健全性ダッシュボード：有効なクリエイティブをすべてスコア化して分類し、クリエイティブ名または ID、チャネル、健全性スコア（0～100）、リスクレベル（健全／要注意／疲弊中／危機的）、ベースラインと比較した主要指標（CTR 比、CPM 比、エンゲージメント比）、フリークエンシー、配信日数、日次消化額を表示します。
• 疲弊予測：日付付きの履歴がある危機的ではないクリエイティブについて、スクリプトの days_remaining と予測日、使用したシグナル、サンプル数に基づく信頼度ラベル、および予測される疲弊の主な要因（フリークエンシーの飽和、オーディエンスの消耗、クリエイティブの劣化）を判断して示します。
• 更新優先順位リスト：疲弊の深刻度と消化額を組み合わせてクリエイティブを緊急度順に並べ、どの更新が最も多くの予算を節約できるかを示します。また、疲弊した各クリエイティブについて、推定される日次の広告費の無駄も示します。
• クリエイティブごとの更新ブリーフ：疲弊中または疲弊した各クリエイティブについて、具体的で実行可能な更新案を提示します。ブランドガイドラインと制作上の制約を守りながら、何を維持し、何を変更し、何をテストするか、その理由を示します。
• A/B テスト計画：各クリエイティブ更新について、コントロールとバリアントの定義、仮説、主要指標、必要なサンプルサイズ、テスト期間の見積もり、統計的信頼度のしきい値を含む、体系的なテスト計画を作成します。
• クリエイティブのライフサイクルタイムライン：有効な各クリエイティブの配信開始日、現在のライフサイクル段階、予測される移行日をタイムラインで表示します。これにより、現行クリエイティブが疲弊する前に新しいクリエイティブを用意できるよう、先を見越した制作計画が可能になります。
• パフォーマンス回復の見積もり：疲弊したクリエイティブを更新した場合に見込まれる CTR、CPM、エンゲージメントの改善を予測し、クリエイティブ制作への投資に対する期待収益を定量化します。

使用エージェント

• content-creator — ブランドのトーンやポジショニングに基づく、新しいビジュアルの切り口、見出しのバリエーション、フックの代替案、フォーマットの実験など、クリエイティブ更新のアイデアを考案します。維持・変更・テストの具体的な提案を含む更新ブリーフを作成し、疲弊の診断に紐づく明確な仮説を立てて A/B テストのバリアントを設計します。
• media-buyer — 疲弊を考慮したベンチマークによるチャネル横断のパフォーマンス分析、疲弊したクリエイティブの広告費の無駄の算出、更新を見送るコストに基づく予算への影響を考慮した優先順位付け、およびプラットフォームの動向とオーディエンスの行動に基づくチャネル固有の疲弊しきい値の調整を行います。
• performance-monitor-agent — パフォーマンス指標の推移から疲弊のシグナルを検出し、複数のシグナルを重み付けして組み合わせたモデルで健全性スコアを算出します。減衰率の分析に基づいて疲弊のタイムラインを予測し、クリエイティブのライフサイクル段階を分類して移行を監視します。