# Meta 광고 캠페인 실제 세팅

## 작업 개요
Meta Marketing API를 사용하여 리쿠르팅 광고 캠페인 2개를 생성한다.
모든 캠페인은 **일시중지(PAUSED) 상태**로 생성 → 제이회장님 확인 후 활성화.

## 사전 작업 — 토큰 확인
- `.env.keys`에서 `META_ACCESS_TOKEN` 로드
- `curl "https://graph.facebook.com/v25.0/me?access_token=$TOKEN"` 으로 유효성 확인
- 만료 시: 제이회장님께 재발급 요청 필요 → 보고서에 명시
- ⚠️ 토큰/키를 로그나 보고서에 직접 노출 금지

## 캠페인 구조

### 캠페인 1: 리쿠르팅_리드_2026Q2
- **목표**: OUTCOME_LEADS (리드/상담신청 전환)
- **일 예산**: ₩15,000 (캠페인 레벨)
- **상태**: PAUSED

### 캠페인 2: 리쿠르팅_잠재고객_2026Q2
- **목표**: OUTCOME_TRAFFIC (랜딩페이지 트래픽)
- **일 예산**: ₩15,000 (캠페인 레벨)
- **상태**: PAUSED

## 광고세트 (각 캠페인에 3개씩, 총 6개)

### 공통 타겟팅
- **지역**: 서울, 경기도, 충청도 (대전, 세종, 충북, 충남 포함)
- **연령**: 30~55세
- **성별**: 전체
- **관심사**: 보험, 이직, 보험설계사, 영업
- **노출 위치**: 자동배치 (automatic_placements)
- **일 예산**: ₩5,000/세트

### 세트 구성
| 광고세트 | 브랜드 | 셀 | 배너 버전 |
|---|---|---|---|
| 인카금융서비스 | Incar | Cell 1, 2, 3 | v-round2 |
| GA | GA | Cell 4, 5, 6 | v1460 |
| 서울대보험쌤 | SNU | Cell 7, 8, 9 | v-round2 |

## 광고 (각 광고세트에 3개씩, 총 18개)

### 배너 이미지
- **크기**: 1080x1080 (meta-feed) 만 사용
- **경로**: `/home/jay/workspace/output/banners/versions/{version}/{cell-dir}/meta-feed-1080x1080.png`
- 각 셀의 선택된 버전에서 1080x1080 PNG를 업로드

### 이미지 업로드 → 크리에이티브 생성 → 광고 생성
1. `meta_ads_client.py`의 `upload_image()` → image_hash 획득
2. `create_creative()` → creative_id 획득  
3. 광고 생성 시 creative_id + 랜딩 URL 연결

### 랜딩 URL
- **전 셀 공통**: `https://incar-top1.tistory.com`

### 픽셀 + 전환 이벤트
- **픽셀 ID**: `.env.keys`의 `META_PIXEL_ID` (1461062562329883)
- **전환 이벤트**: `Lead` (상담신청 완료)
- 캠페인 1(리드)에 픽셀 + Lead 전환 최적화 연결
- 캠페인 2(잠재고객)에 픽셀 연결 (전환 최적화 없이 트래픽 최적화)

## 사용할 도구
- `/home/jay/workspace/utils/meta_ads_client.py` — MetaAdsClient 클래스
- `/home/jay/workspace/scripts/meta_ads_cli.py` — CLI (필요 시)
- `.env.keys` — 인증 정보 (os.environ으로 로드)

## 실행 순서
1. 토큰 유효성 확인
2. 계정 정보 조회 (account_status 확인)
3. 배너 이미지 9장 업로드 (1080x1080)
4. 캠페인 2개 생성 (PAUSED)
5. 광고세트 6개 생성 (타겟팅 + 예산)
6. 크리에이티브 9개 생성
7. 광고 18개 생성 (각 광고세트에 3개)
8. 전체 구조 검증 (캠페인 → 광고세트 → 광고 계층 확인)

## 산출물
- 보고서에 생성된 모든 ID 포함 (campaign_id, adset_id, ad_id, creative_id)
- `/home/jay/workspace/memory/reports/task-{id}.md`

## 완료 기준
- 캠페인 2개 + 광고세트 6개 + 광고 18개 생성 완료
- 모두 PAUSED 상태
- 배너 이미지 9장 업로드 완료
- 픽셀 연결 완료
- 보고서에 전체 구조 + ID 목록 포함

## 주의사항
- **절대 ACTIVE 상태로 생성하지 말 것** — 반드시 PAUSED
- 토큰/키 값을 로그나 보고서에 직접 출력 금지
- 예산 단위: KRW (한국 원). Meta API에서 currency 확인 후 변환 필요할 수 있음 (현재 계정 currency=USD)
- USD 계정이므로 ₩5,000 ≈ $3.7 정도. API에는 USD 금액으로 입력해야 할 수 있음. 계정 currency 확인 후 적절히 변환.