---
name: meta-ads-analyzer
description: |
  [책임 경계] 메타 광고관리자 .xlsx 보고서 1-6개 업로드 → 상품 관여도·운영 철학 반영 진단 + 강도별 액션 옵션 (🟢🟡🔴) 전담. 페어 스킬 pixel-audit(인프라 진단)·landing-page-conversion-audit(랜딩 진단)과 명확히 구분 — 본 스킬은 광고관리자 데이터 사후 분석.
  다음과 같은 요청 시 반드시 이 스킬을 사용하세요:
  "메타 광고 보고서 분석", "광고 성과 진단", "ROAS 낮은 이유", "지면별 분석", "Audience Network 진단", "연령 성별 분해", "케어밀 보고서 분석", "광고 소재 노후화 점검", "예산 적정성 진단", "캠페인 비교 분석", "광고 누수 점검", "다중 월 추세".
  9 분석 모듈 (퍼널·KPI·차원·매트릭스·누수·라이프사이클·학습·예산·시뮬레이션) + 4D 교차 (광고×지면×연령×성별) + 3 사용자 그룹 톤 + 4 출력 형식 (HTML/DOCX/PPTX/MD) + 강도별 액션 (🟢🟡🔴 보수/중도/적극).
  ai-slop-reviewer 자동 체이닝 (DOCX/PPTX/MD 텍스트 산출물).
  v2.5.0 신규. Methodology adapted from agricidaniel/claude-ads v1.5.1 (MIT) — see NOTICE.md.
user-invocable: true
version: 2.13.0
---

# 메타 광고 보고서 분석기 (Meta Ads Analyzer)

## 개요

메타 광고관리자에서 추출한 `.xlsx` 보고서를 업로드받아, 상품 관여도와 운영 철학을 반영한 진단 결과와 강도별 액션 옵션을 제시하는 분석 도구.

**핵심 차별점 5가지** (SPEC-META-ADS-001 §1.1):

1. **상품 관여도 반영 해석** — 저관여(식품/뷰티)와 고관여(교육/B2B)의 ROAS 기준·해석 방식이 다름
2. **운영 철학별 권장안** — 자동 신뢰형(알고리즘 우선)과 적극 통제형(수동 조정 선호)으로 분기
3. **강도별 액션 옵션 (🟢🟡🔴)** — 단정적 명령 없이, 보수/중도/적극 3옵션 + 양면 해석 제공
4. **가독성 우선 출력** — 7-Level 계층형 구조로 요약부터 시뮬레이션까지 단계적 공개
5. **인구통계 차원 통합 분석** — 노출지면 × 연령 × 성별 4차원 교차 분석 지원

> **Attribution**: Methodology adapted from agricidaniel/claude-ads v1.5.1 (MIT). 50-check audit matrix, weighted scoring, Quick Wins logic → 한국 시장 적용 (Korean market adaptation). 상세: `NOTICE.md §agricidaniel/claude-ads`.

---

## 트리거

다음 발화 시 반드시 이 스킬을 호출합니다:

- "메타 광고 보고서 분석해줘", "광고 성과 진단해줘", "ROAS가 왜 낮은지 분석해줘"
- "지면별 성과 어떤지 봐줘", "Audience Network 끊어야 하나", "AN 지면 진단"
- "연령대별·성별로 분해해줘", "인구통계 분석 해줘", "페르소나별 효율 보고 싶어"
- "케어밀 보고서 분석해줘", "광고 소재 노후화됐는지 봐줘", "소재 피로도 진단"
- "예산이 적정한지 봐줘", "광고비 낭비 찾아줘", "누수 광고 찾기"
- "캠페인 두 개 비교해줘", "이번 달 vs 지난 달 추세 봐줘", "다중 월 비교"
- "광고 보고서 올릴게요", "xlsx 분석해줘", "메타 광고관리자 데이터 분석"

---

## 워크플로우

```
[Step 1] 사용자 그룹 명시 선택 (인하우스 / 대행사 / 소규모)
   ↓
[Step 2] .xlsx 보고서 1~6개 업로드 + 사용자 입력 6종 확인
   ↓
[Step 3] 전처리 — 컬럼 자동 매핑 · 통합/분리 보고서 판단 · 정합성 검증 6종
   ↓
[Step 4] 5 자동 모드 판단 — 단일/통합/분리/다중월/다중캠페인 분기
   ↓
[Step 5] 9 분석 모듈 자동 실행 (인구통계 컬럼 유무에 따라 모듈 3·4 일부 분기)
   ↓
[Step 6] 7-Level 계층 출력 생성 (Level 1~6 필수, Level 7 선택)
   ↓
[Step 7] 강도별 액션 옵션 (🟢🟡🔴) 표준 템플릿으로 권장안 정리
   ↓
[Step 8] 선택 출력 형식 (HTML / DOCX / PPTX / MD) 생성
   ↓
[Step 9] DOCX/PPTX/MD → ai-slop-reviewer 자동 체이닝
   ↓
[Step 10] 면책 문구 포함하여 최종 산출물 제공
```

---

## 사용자 그룹 입력 (명시)

첫 호출 시 **반드시 명시 입력**으로 3개 그룹 중 1개를 선택합니다 (자동 추정 X).

| 그룹 | 정의 | 핵심 니즈 |
|------|------|-----------|
| 🏢 **인하우스** | 광고주 사내 마케터 | 정확성·일관성, 사내 보고 |
| 🤝 **대행사** | 광고 대행사 AE | 효율성·시각화, 클라이언트 보고 |
| 👤 **소규모** | 1인 운영자, 대표 | 친절함·실행성, 쉬운 해설 |

그룹별 출력 차별화 매트릭스 (분석 깊이·톤·액션 강조·용어 설명 수준 포함) → [references/A.md](references/A.md)

---

## 사용자 입력 6종

보고서 업로드 후 다음 6개 항목을 입력합니다:

| 항목 | 유형 | 선택지 |
|------|------|--------|
| **상품 카테고리** | 필수 | 8 프리셋 (식품/음료 · 패션/뷰티 · 건강기능식품 · IT/디지털 · 가정용품 · 교육/지식 · 서비스/B2B · 기타) |
| **상품 단가 구간** | 필수 | 저가(약 3만원) · 중가(3-10만원) · 고가(10-30만원) · 프리미엄(30만원+) · 직접 입력 |
| **관여도** | 자동 추정+수동 변경 가능 | 카테고리·단가·목표 조합 기반 자동 추정 → 사용자가 저/중/고로 수동 변경 가능 |
| **캠페인 목표** | 필수 | 구매(Sales) · 리드 수집(Lead) · 트래픽(Traffic) · 인지도(Awareness) · 앱 설치 |
| **운영 기간** | 필수 | 신규(1개월 미만) · 초기(1-3개월) · 안정(3-12개월) · 장기(12개월 이상) |
| **운영 철학** | 필수 | 자동 신뢰형 · 적극 통제형 · 양쪽 모두 제시(기본값) |

입력 6종 상세 (카테고리 8 프리셋 기본 관여도 · 관여도 자동 추정 로직 · 운영 철학 출력 분기) → [references/C.md](references/C.md)

---

## 5 자동 모드 판단

업로드 파일 수·기간·차원을 분석해 5개 모드 중 하나를 자동 선택합니다:

```
파일 1개 + 노출지면만          → 단일 캠페인 진단 모드 (기본)
파일 1개 + 노출지면 + 인구통계 → 통합 분석 모드

파일 2개 + 같은 기간 + 다른 차원 → 분리 보고서 통합 모드
  (노출지면 보고서 + 인구통계 보고서)

파일 2~6개 + 다른 기간         → 다중 월 비교 모드
  (추세 분석 + 소재 라이프사이클 활성화)

파일 2~6개 + 같은 기간 + 다른 캠페인 → 다중 캠페인 일괄 모드
  (대행사용)

그 외                          → 사용자 확인 요청
```

5 모드 상세 분기 로직 + 모드별 활성화 분석 항목 → [references/E.md](references/E.md)

---

## 9 분석 모듈

보고서 업로드 시 다음 9개 모듈이 자동 실행됩니다 (SPEC §3.1):

| # | 모듈 | 핵심 산출 |
|---|------|----------|
| **1** | **퍼널 분해** | 노출→클릭→구매 깔때기, 단계별 전환율, 관여도별 벤치마크 비교 |
| **2** | **KPI 분해** | 절대값(지출·노출·클릭·구매·매출) + 효율 지표(CTR·CPC·CVR·ROAS·AOV·CPA) + 다중 월 추세·증감률 |
| **3** | **차원별 분해** (v1.1 확장) | 플랫폼·지면·소재·컨셉·연령·성별 단일 분해 + 4차원 교차 (광고×지면×연령×성별) |
| **4** | **범용 매트릭스** (v1.1 확장) | 사용자 선택 축 기반 등급 매트릭스 (S/A/B/C/D/F) |
| **5** | **누수·파레토** | 구매 0 지출 절대값·비중, 매출 80% 기여 조합 파레토 분석 |
| **6** | **소재 라이프사이클** | 광고명 패턴 기반 노후화 진단 (다중 월 데이터 시 활성화) |
| **7** | **학습 단계 진입** | 주 50건 전환 기준 달성 가능성 평가, 광고 세트 구조 권장 방향 |
| **8** | **예산 적정성** | 제품가 × 3 권장 일일 예산 대비 현재 적정성 (월 광고 예산 입력 시 활성화) |
| **9** | **시나리오 시뮬레이션** | 액션별 예상 매출·ROAS 변화 + 낙관/현실/비관 신뢰 구간 (선택) |

> 인구통계 컬럼(연령·성별) 부재 시 모듈 3·4의 인구통계 차원만 비활성화 — 나머지 분석은 정상 진행.

9 모듈 상세 명세 (D.1-D.9 직접 인용, 등급 기준·노후화 판정 공식 포함) → [references/D.md](references/D.md)

---

## 7-Level 출력 계층

모든 출력 형식은 다음 7단계 계층을 따릅니다 (SPEC §3.2):

```
Level 1: 한 줄 요약
Level 2: 핵심 발견 3가지 (카드형)
Level 3: KPI 대시보드 (차트)
Level 4: 영역별 진단 (지면·소재·연령·성별 등)
Level 5: 누수·기회 분석
Level 6: 강도별 액션 옵션 (🟢🟡🔴)
Level 7: 시뮬레이션 (선택)
```

Level 1-6: **모든 출력 형식 필수** / Level 7: 사용자 선택

---

## 강도별 액션 옵션 (🟢🟡🔴)

모든 권장안은 단정적 명령 없이 다음 표준 템플릿 5요소를 갖춥니다 (SPEC §3.6):

```
### [발견] {제목}

**사실**: {데이터로 확인된 내용}

**해석 (양면)**:
- A 입장 (자동 신뢰): {해석}
- B 입장 (적극 통제): {해석}

**권장 옵션**:
🟢 보수안: {액션} | {효과} | {리스크}
🟡 중도안: {액션} | {효과} | {리스크}
🔴 적극안: {액션} | {효과} | {리스크}

**의사결정 가이드**: 예산 규모·운영 기간·운영 철학별 권장
```

액션 권장안 표준 템플릿 전문 + 그룹별 톤 조정 예시 → [references/F.md](references/F.md)

---

## 4 출력 형식

| 형식 | 우선순위 | 주 활용 | 특징 |
|------|---------|--------|------|
| **HTML** | 1순위 | 즉시 확인·발표·시연 | React+Recharts 단일 파일, 인터랙티브 차트 |
| **DOCX** | 2순위 | 클라이언트·사내 보고 | 8섹션 구조, 표·차트 포함 |
| **PPTX** | 3순위 | 발표·강의 | 10-15 슬라이드 |
| **MD** | 보조 | 실무 체크 | 체크박스+우선순위, Notion·Slack 최적화 |

**HTML 디자인 토큰** (`moai-content:html-report` 공용 팔레트 — SSOT):

| 토큰 | 헥스 | 용도 |
|------|------|------|
| `--ivory` | `#FAF9F5` | 페이지 배경 |
| `--paper` | `#FFFFFF` | 카드·패널 배경 |
| `--slate` | `#141413` | 본문 텍스트 |
| `--clay` | `#D97757` | 강조·링크 |
| `--clay-d` | `#B85C3E` | 고위험 표시 (🔴 적극안) |
| `--oat` | `#E3DACC` | 보조 배경·차트 기본 막대 |
| `--olive` | `#788C5D` | 긍정 신호 (🟢 보수안) |
| `--g300` | `#D1CFC5` | 테두리·구분선 |

4 출력 형식 상세 명세 (HTML CSS 변수 전문 · DOCX 8섹션 · PPTX 슬라이드 구성 · MD 포맷) → [references/G.md](references/G.md)

---

## 표현 원칙 ✓/✗

| ✓ 권장 | ✗ 금지 |
|--------|--------|
| 사실 제시 → 양면 해석 → 강도별 선택지 (방향성 수준) | 단정적 명령 ("OFF하라") |
| 신호등 시스템 (🟢🟡🔴) | 메타 광고관리자 조작 단계 가이드 ("광고 세트 편집 → 노출 위치 → ...") |
| 지면·소재·인구통계별 개선 방향 제시 | 메타 UI 캡처·스크린샷 |
| 구체적 액션 권장 (예: "AN 지면 노출 OFF 검토") | 편향된 일반화 |
| 사용자 그룹별 톤 조정 | 검증 안 된 벤치마크 (출처 미명시) |
| 벤치마크 수치 인용 시 출처 명시 (SPEC §3.6 / 케어밀 reference) | 운영 철학 강요 |

**표현 수준 예시**:
- ✓ "AN 지면 ROAS가 두 달 연속 0이므로 노출 OFF 검토 권장"
- ✗ "메타 광고관리자에서 광고 세트 편집 → 노출 위치 → 수동 선택 → Audience Network 체크 해제"

---

## 면책 문구

모든 출력물에 다음 문구를 포함합니다 (SPEC §3.9):

> 본 분석 결과는 데이터 기반 진단입니다.
> 최종 운영 의사결정은 사용자의 경험·맥락·전략에 따라 다를 수 있으며,
> 스킬은 정답이 아닌 의사결정 옵션을 제공합니다.
>
> 메타 광고관리자에서의 실제 적용 방법은 사용자가 직접 확인하시기 바랍니다.

면책 문구 전문 + 명시적 한계 목록 + 시간 예측 금지 예외 사항 → [references/I.md](references/I.md)

---

## 자동 체이닝

```
meta-ads-analyzer (보고서 분석)
       ↓ DOCX/PPTX/MD 텍스트 산출물
moai-core:ai-slop-reviewer (AI 슬롭 검수 — CLAUDE.local.md §3-2 HARD)
       ↓ 인프라 문제 발견 시
pixel-audit (픽셀·1st Party 데이터 인프라 진단)
       ↓ 랜딩 문제 발견 시
landing-page-conversion-audit (랜딩 6섹션 전환율 진단)
```

> HTML 대시보드는 React 컴포넌트+차트가 주 산출물이므로 ai-slop-reviewer 체이닝 대상에서 제외 (본문 카피·해석 텍스트는 해당).

---

## 페어 스킬 경계

| 페어 스킬 | 책임 | 본 스킬과의 경계 |
|----------|------|-----------------|
| `pixel-audit` | 메타 픽셀·인프라 진단 | 픽셀 설치·CAPI·Lookalike 씨앗 → pixel-audit, 보고서 결과 분석 → 본 스킬 |
| `landing-page-conversion-audit` | 랜딩 6섹션 전환율 진단 | 광고 클릭 후 랜딩 UX → 페어, 광고 시스템 KPI(노출/클릭/구매/매출/ROAS) → 본 스킬 |
| `campaign-planner` | 캠페인 사전 기획 | 사전 기획(목표·타겟·소재 컨셉) → campaign-planner, 집행 후 사후 진단·액션 → 본 스킬 |

(SPEC-META-ADS-001 §8.2 페어 분리 원칙)

---

## 참고 부록

| 부록 | 내용 | 링크 |
|------|------|------|
| A | 사용자 그룹 차별화 매트릭스 (A.4 출력 차별화 6항목) + 명시 입력 UX 가이드 | [references/A.md](references/A.md) |
| B | 12 필수 컬럼 자동 매핑 + 컬럼 누락 처리 4룰 | [references/B.md](references/B.md) |
| C | 사용자 입력 6종 상세 (카테고리 8 프리셋·단가·관여도·목표·운영 기간·운영 철학) | [references/C.md](references/C.md) |
| D | 9 분석 모듈 상세 명세 (D.1-D.9 직접 인용) | [references/D.md](references/D.md) |
| E | 5 자동 모드 판단 로직 (E.1-E.5 분기 상세) | [references/E.md](references/E.md) |
| F | 액션 권장안 표준 템플릿 (F.1 5요소 + F.2 ✓/✗ 예시 + F.3 그룹별 톤) | [references/F.md](references/F.md) |
| G | 4 출력 형식 명세 (HTML 디자인 토큰 · DOCX 8섹션 · PPTX 슬라이드 · MD 체크박스) | [references/G.md](references/G.md) |
| H | 정합성 검증 6종 + Layer 2 MCP 호출 가이드 | [references/H.md](references/H.md) |
| I | 면책 문구 전문 + 명시적 한계 + 시간 예측 금지 예외 | [references/I.md](references/I.md) |
| J | 자매 스킬 후보 (creative-generator·budget-planner·curriculum-builder) | [references/J.md](references/J.md) |
| K | 케어밀 보고서 fixture 가이드 + 테스트 예시 | [references/K.md](references/K.md) |

---

## 변경 이력

| 버전 | 날짜 | 내용 |
|------|------|------|
| 2.5.0 | 2026-05-13 | v2.5.0 신규 출시 — SPEC-META-ADS-001 v0.2.0 기반. 9 분석 모듈 + 4D 교차 + 5 자동 모드 + 3 사용자 그룹 + 4 출력 형식. Methodology adapted from agricidaniel/claude-ads v1.5.1 (MIT). |
