# 메타광고현황 대시보드 분석 기능 구현

## 작업 개요
캠페인뷰 > 메타광고현황 섹션(MetaAdsSection.js)에 실제 데이터 + 프로 수준 분석 기능을 구현한다.
현재 플레이스홀더 UI만 있는 상태 → 실 데이터 연동 + 분석 기능 완성.

## 사용할 API 모듈
- `/home/jay/workspace/utils/meta_ads_client.py` — MetaAdsClient (17개 메서드)
- `.env.keys`에서 META_* 환경변수 로드
- ⚠️ 토큰/키 값 프론트엔드 코드에 노출 금지 → server.py 백엔드 API 경유

## 백엔드 API 엔드포인트 추가 (server.py)
- `GET /api/meta-ads/campaigns` — 캠페인 목록 + 기본 인사이트
- `GET /api/meta-ads/campaigns/<id>/adsets` — 광고세트 목록 + 인사이트
- `GET /api/meta-ads/adsets/<id>/ads` — 광고 목록 + 인사이트
- `GET /api/meta-ads/insights?object_id=<id>&days=<n>` — 상세 인사이트
- `GET /api/meta-ads/account` — 계정 정보 (잔액, 지출 등)
- 모든 엔드포인트에서 MetaAdsClient 사용, 토큰 만료 시 에러 메시지 반환

## 프론트엔드 구현 (MetaAdsSection.js)

### 1. 계층형 드릴다운 뷰
- **캠페인 레벨**: 캠페인 이름, 목표(리드/트래픽 구분 표시), 상태, 일예산, 총지출
- **광고세트 레벨**: 클릭하면 펼쳐짐 — 브랜드명, 타겟팅 요약, 예산, 성과 지표
- **광고 레벨**: 클릭하면 펼쳐짐 — 배너 썸네일, 개별 성과

### 2. 핵심 성과 지표 카드 (상단)
- 총 지출 (₩)
- 총 도달 수
- 총 클릭 수
- 평균 CTR (%)
- 평균 CPC (₩)
- 전환 수 (Lead)
- 전환당 비용 CPL (₩)

### 3. 업종 벤치마크 비교 (보험/금융 업종)
벤치마크 데이터를 config에서 관리 (하드코딩 금지):
```json
// dashboard/data/ad-benchmarks.json
{
  "industry": "보험/금융",
  "source": "WordStream 2025-2026 Industry Benchmarks",
  "metrics": {
    "ctr_avg": 0.9,
    "cpc_avg_usd": 1.70,
    "cpl_avg_usd": 21.00,
    "cpm_avg_usd": 15.00,
    "conversion_rate_avg": 3.5
  }
}
```
- 각 지표 옆에 벤치마크 대비 표시: ✅ 평균 이상 / ⚠️ 평균 이하 / 🔴 심각 저조
- 예: "CTR 1.2% ✅ (업종 평균 0.9%)"

### 4. 프로 마케팅 분석 섹션
- **광고 피로도 경고**: 빈도(frequency) 3+ 시 "크리에이티브 교체 권고" 경고
- **예산 소진 분석**: 일예산 대비 현재 소진율
- **셀별 성과 순위**: 9개 셀 중 CTR/전환 기준 상위/하위 표시
- **브랜드별 비교**: 인카 vs GA vs 서울대보험쌤 성과 비교 차트
- **최적화 제안**: 규칙 기반 자동 제안
  - "Cell 3이 CTR 2배 높음 → 예산 집중 권고"
  - "GA 광고세트 전환 0건 → 타겟팅 조정 필요"
  - "빈도 4.2 → 크리에이티브 교체 시점"

### 5. 기간 필터
- 오늘 / 어제 / 최근 7일 / 최근 14일 / 최근 30일 / 전체 기간
- 날짜 범위 직접 선택

## 모듈화 요구사항 (★ 필수)
- 벤치마크 데이터: `dashboard/data/ad-benchmarks.json` (하드코딩 금지)
- 분석 규칙: config 기반 (피로도 임계값, 최적화 제안 규칙)
- MetaAdsSection.js 내부를 서브 컴포넌트로 분리:
  - `MetaAdsOverview.js` — 상단 요약 카드
  - `MetaAdsDrilldown.js` — 계층형 드릴다운
  - `MetaAdsBenchmark.js` — 벤치마크 비교
  - `MetaAdsAnalysis.js` — 프로 분석/제안

## 파일 목록
- `/home/jay/workspace/dashboard/components/campaign/MetaAdsSection.js` — 수정
- `/home/jay/workspace/dashboard/server.py` — API 엔드포인트 추가
- `/home/jay/workspace/utils/meta_ads_client.py` — 참고 (수정 불필요)
- `/home/jay/workspace/dashboard/data/ad-benchmarks.json` — 신규
- `/home/jay/workspace/config/module-registry.json` — 컴포넌트 등록

## 완료 기준
- 캠페인/광고세트/광고 드릴다운 동작
- 성과 지표 카드 표시
- 업종 벤치마크 비교 표시
- 프로 분석/최적화 제안 동작
- 기간 필터 동작
- 토큰 만료 시 안내 메시지 표시
- 모든 벤치마크/규칙 config 기반 관리