홈 메인 배너 빈 화면 대응 — 대체 노출과 차단 측정

01세 줄 요약과 결정 요청

02배경 — 왜 지금 해야 하나

크롬에서 홈 메인 배너가 하얗게 비어 보이는 현상을 발견해 원인을 격리했습니다. 시크릿 모드에서 재현(캐시 원인 배제) → 엣지에서 정상(서버·데이터 원인 배제) → 개발자 도구에서 배너 이미지 경로의 ad-image 네이밍이 광고 차단 목록에 걸리는 것으로 특정.

방치할 수 없는 이유는 두 가지입니다.

• 신뢰 문제 — 홈 최상단에 빈 화면만 노출되면 사용자가 서비스의 현재 상태를 인지하기 어렵고, 이탈로 이어질 가능성이 있습니다. 차단당한 것보다 고장 나 보이는 게 문제입니다
• 깜깜이 문제 — 영향받는 유저 규모를 측정하는 장치가 없어, 이 문제가 사소한지 심각한지 아무도 답할 수 없습니다. 배너 클릭 지표가 이미 과소 집계되고 있을 가능성도 있습니다

03하기로 한 것, 하지 않기로 한 것

하기로 한 것

• 대체 노출(폴백) — 배너 로드 실패를 감지하면 빈 화면 대신 대체 콘텐츠를 노출. 대체 콘텐츠도 차단당하지 않도록 2중 구조(04 참고)
• 차단 측정 — 발생 시점·환경·규모를 로깅해 대시보드 지표로. 이 숫자가 3단계 의사결정의 근거

하지 않기로 한 것 (Non-goals)

04동작 정의

• 지금 — 광고 차단 유저가 홈 진입 → 최상단이 하얗게 빔 → "사이트가 깨졌나?"
• 변경 후 — 같은 유저가 홈 진입 → 배너 자리에 기획전 콘텐츠가 같은 크기로 노출 → 유저는 차단이 있었는지도 모름

폴백 2중 구조 — 설계의 고정 조건 1개

고정 대체 콘텐츠는 차단 패턴이 없는 별도 경로에서 서빙해야 합니다. 원본과 같은 ad-image 경로에 두면 대체 콘텐츠까지 함께 차단되어 이 기능 전체가 무의미해집니다. 이 한 가지를 제외한 구현 방식은 개발 재량입니다.

05요구사항 — 인수 기준 포함

각 항목의 인수 기준은 QA가 이 문서만으로 TC를 쓸 수 있는 수준을 목표로 했습니다. 고정은 바꾸면 목적이 깨지는 조건, 재량은 더 나은 구현이 있으면 제안 환영이라는 뜻입니다.

5.1 차단 감지

5.2 폴백 노출

5.3 측정

06엣지 케이스와 확인 필요 사항

정의된 엣지 케이스

시니어 개발자님께 확인을 요청하는 것 — 모르는 것은 모른다고 적었습니다

• 일부 차단 확장은 이미지가 아니라 배너 영역 DOM 자체를 숨깁니다. R1(이미지 실패)로는 감지되지 않는데, 영역 가시성 체크를 감지 로직에 포함할지 — 구현 난이도 대비 판단을 요청드립니다
• ad-image 경로를 참조하는 시스템 목록 — 3단계(경로 변경) 규모 산정에 필요합니다. 대략의 범위만이라도
• 기존 배너 클릭 트래킹 스크립트도 차단 대상인지 — 맞다면 현재 클릭 지표가 과소 집계되고 있다는 뜻이라, 데이터팀 보정 논의로 연결하겠습니다
• 모바일 웹 크롬에서의 재현 여부 — PC 한정이라는 현재 가정의 검증 (QA에서 재현 테스트 지원 가능합니다)

07진행 계획과 성공 판정

실패의 정의도 적어둡니다 — 2주 측정에서 차단 발생 비율이 기준값 미만이면 3단계는 하지 않는 것이 성공입니다. 폴백과 지표는 남고, 큰 공사는 근거 없이 시작하지 않은 것이 되므로.

08검토했지만 선택하지 않은 대안