# 네이버 SA 성과 데이터 자동 수집 (2026-08-24 정기)

## S (상황)
매일 02:00 정기 스케줄 — 네이버 검색광고 SA 성과 데이터 자동 수집.
`python3 /home/jay/workspace/tools/naver-ads/collect_sa_stats.py --days 7` 실행 후
`/home/jay/workspace/dashboard/data/naver-sa-stats.json` 저장 확인 요청.

## C (복잡성)
본 수집기는 2026-07-16부터 전 지표 0을 출력해 왔으며, 근본원인이 2026-08-13에
확정(보고서 `memory/reports/naver-sa-collect-260813.md`)되어 있다.
따라서 "0 = 실패"로 오판하지 않기 위해, 이번 회차도 **실행 성공 여부와 0의 성격**을
분리해 검증했다.

## Q (질문)
1. 스크립트가 정상 실행되어 파일이 실제로 갱신되었는가?
2. 0이 API 장애/예외 삼킴 때문인가, 아니면 기존 확정 원인 그대로인가?

## A (답변)

### 1. 실행 및 저장 — 정상
- exit code: `0`
- 로그: `naver-sa-stats.json 저장 완료: /home/jay/workspace/dashboard/data/naver-sa-stats.json`
- 파일 mtime: `2026-08-24 02:00:22 +0900` (직전 회차 `2026-08-23 02:00` 에서 갱신)
- md5 변화: `e5bd71c791633beb4d50f9e15c98832d` → `f5a482acbd8bf608876f3c7346fa4e95`
- 파일 크기: 2126 bytes
- `last_collected`: `2026-08-24T02:00:22+09:00`
- JSON 파싱 정상, 최상위 키 6종(`last_collected` / `summary` / `keyword_groups` /
  `daily_trend` / `budget` / `campaigns`) 모두 존재
- `daily_trend` 7일치(2026-08-18 ~ 2026-08-24) — `--days 7` 인자 반영 확인
  (직전 회차 대비 창이 하루 전진: `08-17` 제거, `08-24` 추가. diff 로 실증)

### 2. 0의 성격 — 기존 확정 원인, 신규 장애 아님
- 실행 로그 3줄 전량이 DEBUG/INFO. **error/warning 0건** → 예외 삼킴 없음.
  (수집기의 모든 예외 경로는 `logger.error`/`logger.warning`을 남기는 구조)
- `.env.keys` 79개 변수 로드 성공, `NaverSAClient` 초기화 성공(customer_id=1419414).
- `campaigns` 배열이 실시간 응답으로 채워짐 → 인증·API 연결 경로는 살아 있다.
  - `cmp-a001-01-000000001647137` 전국민 꿀잠 프로젝트! "나이스드림" — ELIGIBLE
  - `cmp-a001-02-000000001684254` 나이스드림 쇼핑검색#1 — ELIGIBLE
- 계정 `NAVER_SEARCHAD_CUSTOMER_ID=1419414`에는 여전히 나이스드림 캠페인 2건뿐이고,
  수집기 `_GROUP_RULES`가 기대하는 리쿠르팅 광고그룹(보험영업 / 개인사업·지점장 /
  무자본창업)은 0건. → `keyword_groups` 3종 전부 0.
- `get_stats()`가 `breakdown` 없이 호출되어 응답에 `date` 필드가 없는데
  `record.get("date","")`로 분기하는 구조적 결함도 그대로 존재.
  → `daily_trend` / `today` / `yesterday`는 구조상 채워질 수 없음.
- `budget.daily = 21000` 은 설정값이며, `spent_today = 0` / `burn_rate = 0.0`.

## 수정 파일별 검증 상태

| 파일 | 변경 | 상태 |
|---|---|---|
| /home/jay/workspace/dashboard/data/naver-sa-stats.json | 수집 결과 갱신(코드 변경 아님) | verified |

코드 변경 없음. 데이터 수집 실행 건.

## 미해소 사항 (재조사 불요, 회장님 결정 대기)
1. **API 계정 교체** — 1419414는 나이스드림 계정. 리쿠르팅 광고 계정으로 교체 필요.
2. **수집기 결함 2건 수정 위임** — `group_agg` 미갱신, `breakdown="day"` 누락.

위 두 건이 해소되기 전까지는 **0이 정상 출력**이며, 매 회차 재조사는 불필요하다.
(2026-07-16 이후 40일째 동일 상태 — 12회차 연속 동일 판정)

## 레벨: 코드 수정 없음