From e3e3b42c28df94df9d539ede342f493b9f188d58 Mon Sep 17 00:00:00 2001 From: king Date: Wed, 21 Oct 2026 16:34:01 +0900 Subject: [PATCH] =?UTF-8?q?fix(performance):=20=EB=A9=94=ED=83=80=20?= =?UTF-8?q?=EA=B4=91=EA=B3=A0=EB=B9=84=EA=B0=80=200=20=EC=9C=BC=EB=A1=9C?= =?UTF-8?q?=20=EB=93=A4=EC=96=B4=EC=98=A4=EB=8D=98=20=EB=AC=B8=EC=A0=9C=20?= =?UTF-8?q?=E2=80=94=20=EA=B8=B0=EA=B0=84=20=EC=A1=B0=ED=9A=8C=20=EC=9D=91?= =?UTF-8?q?=EB=8B=B5=EC=9D=98=200=20=EC=9D=B8=20=EB=82=A0=EC=9D=80=20?= =?UTF-8?q?=ED=95=98=EB=A3=A8=EC=94=A9=20=EB=8B=A4=EC=8B=9C=20=EC=A1=B0?= =?UTF-8?q?=ED=9A=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 메타가 기간(10/01~10/21)으로 물으면 지출·노출·클릭을 0 으로 주고(링크 클릭·구매는 정상), 하루만 물으면 정상 값을 준다(운영 진단 스크립트로 확인). 지출·노출 0 인데 링크 클릭·구매가 있는 날만 그날 하루를 다시 물어 바꾼다. 집행 없는 계정·진짜 0 인 날은 추가 호출 없음. Co-Authored-By: Claude Opus 5.5 --- app/modules/performance/CLAUDE.md | 3 ++ .../performance/ad_sources/meta_ads.py | 25 ++++++++++++++ .../performance/tests/test_meta_ads.py | 33 +++++++++++++++++++ 3 files changed, 61 insertions(+) diff --git a/app/modules/performance/CLAUDE.md b/app/modules/performance/CLAUDE.md index de677c4..6a74367 100644 --- a/app/modules/performance/CLAUDE.md +++ b/app/modules/performance/CLAUDE.md @@ -76,3 +76,6 @@ 자동 업데이트 회차(`auto_sync.run_once`)는 매출과 광고비를 **동시에** 각각 진행 창 작업으로, 이미 돌고 있는 종류만 그 회차 건너뜀. 결과는 `perf_ad_spend` `source='api'`(초록 숫자, API 가 안 준 날은 예전 API 값만 지움). - **구글 = Google Ads API**(2026-10-15) — 고객 ID·(MCC)·서비스 계정 JSON·API 버전(기본 v26). 개발자 토큰은 2026-09-09 구글 폐지 — 접근 등급은 서비스 계정의 Cloud 프로젝트, 머리글 안 보냄. [광고비 업데이트]·자동 업데이트. 광고비 = 비용 × 1.1(부가세 포함)·ROAS(전환 가치 ÷ 비용, 구글 값 그대로)·항목. - **메타 = 메타 마케팅 API**(2026-10-16, `ad_sources/meta_ads.py`, 새 마이그레이션 없음) — 광고 계정 ID(여러 개, 날짜별 합산)·액세스 토큰(ads_read, 시스템 사용자 토큰 권장)·앱 시크릿(선택)·API 버전(기본 v26.0). 광고비 = 지출 금액 그대로(메타는 이미 부가세 포함 — × 1.1 은 구글만)·ROAS = 구매 전환값 ÷ 지출 금액(광고 관리자 구매 ROAS). USD 등 외화 계정은 그날 환율로 원화 환산(`fx.py`, Frankfurter 중앙은행 고시 환율 종합, 키 없음). 상세보기 [합계 | 계정별] 탭, [광고비 업데이트]·자동 업데이트 회차. + **기간으로 물으면 메타가 지출·노출·클릭을 0 으로 주는 문제**(2026-10-21 운영 확인, v26.0 — 링크 클릭·구매는 정상, 하루만 물으면 정상) → + "지출·노출 0 인데 링크 클릭·구매가 있는" 날만 하루씩 다시 물어 바꾼다(`meta_ads._refetch_suspect_days`). 원본 진단: `scripts/meta_insights_raw.py` + (`docker exec -i dbx-main python - 시작일 [종료일] < scripts/meta_insights_raw.py`, 읽기 전용). diff --git a/app/modules/performance/ad_sources/meta_ads.py b/app/modules/performance/ad_sources/meta_ads.py index 6b0adf3..7556579 100644 --- a/app/modules/performance/ad_sources/meta_ads.py +++ b/app/modules/performance/ad_sources/meta_ads.py @@ -19,6 +19,10 @@ 부가세를 더하는(× 1.1) 것은 비용이 부가세 별도인 구글만이다. - ROAS(%) = 구매 전환값 ÷ 지출 금액 × 100 — 광고 관리자 "구매 ROAS" 와 같은 값, 지출 0 이면 없음. - 나머지 항목(노출수·클릭수·클릭률·링크 클릭·구매수·구매 전환값)은 광고비 탭 메타 머리글 → 일자별 표. + - **기간으로 물으면 지출·노출·클릭이 0 으로 오는 메타 응답(2026-10-21 운영 확인, v26.0)** — 10/01~10/21 을 한 번에 물으면 날마다 + spend='0'·impressions='0'·clicks='0' 인데 링크 클릭·구매는 들어오고, 같은 날을 하루만 물으면 정상(10/20 지출 817,212원). 그래서 기간 응답에서 + "지출·노출 0 인데 링크 클릭·구매가 있는" 날(실제로는 있을 수 없는 조합)은 그날 하루만 다시 물어 그 값으로 바꾼다(_refetch_suspect_days). + 집행이 없는 계정·날은 행이 없거나 다 0 이라 다시 묻지 않는다. 진단: scripts/meta_insights_raw.py. API 버전은 설정 칸(기본 DEFAULT_VERSION) — 메타는 버전을 약 2년 뒤 종료하므로 종료 안내가 오면 설정에서 올린다. """ @@ -291,6 +295,20 @@ class MetaAdsSource(AdSource): msg += f" (원화가 아닌 계정은 날마다 그날 환율로 원화로 바꿔 넣습니다 — {fx.SOURCE_LABEL})" return msg + def _refetch_suspect_days(self, ctx: AdapterContext, client: httpx.Client, version: str, params: dict[str, Any], + raw: list[tuple[str, date, str, dict[str, Any]]]) -> list[tuple[str, date, str, dict[str, Any]]]: + """_suspect 줄은 그 계정·그날 하루만 다시 물어 바꾼다(하루 조회는 지출·노출·클릭이 정상). 하루 조회도 같으면 그대로 둔다.""" + out = [] + for acc, day, cur, r in raw: + if _suspect(r): + one = {**params, "time_range": json.dumps({"since": day.isoformat(), "until": day.isoformat()})} + rows = self._get(ctx, client, f"{API_BASE}/{version}/act_{acc}/insights", one).get("data") or [] + fresh = next((x for x in rows if str(x.get("date_start")) == day.isoformat()), None) + if fresh is not None: + r, cur = fresh, str(fresh.get("account_currency") or cur).upper() + out.append((acc, day, cur, r)) + return out + def fetch_days(self, ctx: AdapterContext, start: date, end: date) -> list[AdDay]: if end < start: start, end = end, start @@ -323,6 +341,7 @@ class MetaAdsSource(AdSource): url, page_params = nxt, None # next 주소에 매개변수(토큰 포함)가 다 들어 있다 else: raise ApiError("메타 API 응답 쪽수가 너무 많습니다. 기간을 줄여 다시 시도하세요.") + raw = self._refetch_suspect_days(ctx, client, version, params, raw) # 원화가 아닌 계정(USD 등) — 그날 환율로 원화 환산(2026-10-16). 통화마다 기간 환율을 한 번에. rates: dict[str, dict[date, Decimal]] = {} for cur in sorted({c for _a, _d, c, _r in raw if c != "KRW"}): @@ -358,6 +377,12 @@ class MetaAdsSource(AdSource): return out +def _suspect(r: dict[str, Any]) -> bool: + """기간 응답에서 지출·노출이 0 인데 링크 클릭·구매가 있는 줄 — 메타 기간 조회가 핵심 칸을 0 으로 준 경우(2026-10-21).""" + return (_num(r.get("spend")) == 0 and _num(r.get("impressions")) == 0 + and (_num(r.get("inline_link_clicks")) > 0 or _purchase(r.get("actions")) > 0)) + + def _zero() -> dict[str, Decimal]: return {k: Decimal(0) for k in ("spend", "impr", "clicks", "link", "purchases", "value")} diff --git a/app/modules/performance/tests/test_meta_ads.py b/app/modules/performance/tests/test_meta_ads.py index 70dc4ea..c1cebb7 100644 --- a/app/modules/performance/tests/test_meta_ads.py +++ b/app/modules/performance/tests/test_meta_ads.py @@ -499,3 +499,36 @@ def test_connection_mentions_conversion(monkeypatch): "account_status": 1})) msg = ma.MetaAdsSource().test_connection(_ctx(account_ids="333333")) assert "그날 환율로 원화로 바꿔 넣습니다" in msg and "가져올 수 없습니다" not in msg + + +def test_period_zero_spend_refetches_single_days(monkeypatch): + """2026-10-21 운영 — 기간으로 물으면 메타가 지출·노출·클릭을 0 으로(링크 클릭·구매는 정상) 주고, 하루만 물으면 정상. + 그런 날만 하루씩 다시 물어 바꾼다. 집행 없는 계정(행 없음)·진짜 0 인 날(링크 클릭·구매도 0)은 다시 묻지 않는다.""" + real = {"2026-10-19": ("700000", "25000", "900"), "2026-10-20": ("817212", "29103", "983")} + + def handler(request: httpx.Request) -> httpx.Response: + tr = json.loads(request.url.params["time_range"]) + if "1111111111" not in str(request.url): + return httpx.Response(200, json={"data": []}) # 집행 없는 계정 + if tr["since"] == tr["until"]: # 하루 조회 = 정상 값 + spend, impr, clicks = real[tr["since"]] + return httpx.Response(200, json={"data": [_row(tr["since"], spend, impressions=impr, clicks=clicks, + inline_link_clicks="941", + actions=[{"action_type": "omni_purchase", "value": "50"}], + action_values=[{"action_type": "omni_purchase", "value": "2713820"}])]}) + rows = [_row(d, "0", impressions="0", clicks="0", inline_link_clicks="941", # 기간 조회 = 핵심 칸 0 + actions=[{"action_type": "omni_purchase", "value": "50"}], + action_values=[{"action_type": "omni_purchase", "value": "2713820"}]) for d in real] + rows.append(_row("2026-10-21", "0", impressions="0", clicks="0", inline_link_clicks="0")) # 진짜 0 인 날 + return httpx.Response(200, json={"data": rows}) + + seen = _install(monkeypatch, handler) + days = {d.day.isoformat(): d for d in ma.MetaAdsSource().fetch_days(_ctx(), date(2026, 10, 19), date(2026, 10, 21))} + assert days["2026-10-20"].amount == 817212 and days["2026-10-20"].metrics["노출수"] == 29103 + assert days["2026-10-20"].metrics["클릭수"] == 983 and days["2026-10-20"].roas == Decimal("332.08") + assert days["2026-10-19"].amount == 700000 + assert days["2026-10-21"].amount == 0 + singles = [json.loads(r.url.params["time_range"]) for r in seen] + singles = [t["since"] for t in singles if t["since"] == t["until"]] + assert sorted(singles) == ["2026-10-19", "2026-10-20"] # 이상한 날만, 계정 1 에만 + assert len(seen) == 2 + 2 # 기간 2(계정 2개) + 하루 2