광고 개요

광고 모듈은 대시보드 여러 위치(향후 홈, 사이드 패널 등)에 노출할 프로모션성 배너/이미지/영상/텍스트를 중앙에서 생성·관리하는 기능입니다. 현재는 배너(이미지) 타입을 우선 지원하며 추후 다른 타입(텍스트, 비디오 등)이 추가될 예정입니다.

핵심 개념

• 광고(Advertisement): 하나의 노출 단위. 제목, 설명, 타입, 콘텐츠(이미지/텍스트 등), 링크 URL, 일정(시작/종료일), 타겟팅(언어, 디바이스, 국가), 표시 순서, 상태로 구성됨.
• 광고 타입: 현재 UI 기본값은 배너. 타입에 따라 필요한 필드(예: 이미지, 영상 URL 등)가 달라짐. 미지원 타입 선택 UX는 향후 확장 예정.
• 상태: 활성(현재 노출 대상), 비활성(중지 상태). 종료일이 경과한 광고는 자동으로 비노출 처리(구현 시점에 따라 상태/필터에서 확인 가능)될 수 있음.
• 표시 순서(order): 동일한 영역에 여러 광고가 있을 때 우선순위 결정. 숫자가 낮을수록 먼저 노출(일반적 패턴, 실제 로딩 로직은 향후 변동 가능).
• 타겟팅: 언어, 디바이스 타입, 국가(다중 선택 가능)로 제한하여 특정 사용자 집단에만 노출.

화면 구성

1. 리스트 페이지 (/advertisement)
   • 상단: 제목/설명 검색, 타입 필터, 상태 필터, 새로고침, "새 광고" 버튼
   • 테이블 컬럼: 제목, 광고 타입, 시작일, 종료일, 상태, 언어, 디바이스 타입, 국가, 순서, 생성일, 작업
   • 빈 상태: "광고가 없습니다" 메시지와 페이지네이션(페이지 크기 10/20/50/100)
2. 생성 페이지 (/advertisement/create)
   • 섹션: 기본 정보, 콘텐츠 설정, 일정 설정, 타겟팅 설정, 하단 생성 버튼
3. 상세 페이지 (/advertisement/[id])
   • (데이터 로딩 후) 기본/콘텐츠/일정/타겟팅 요약 + 수정 및 삭제 액션 예정
4. 수정 페이지 (/advertisement/[id]/edit)
   • 생성과 동일한 폼 구조 + 기존 데이터 로딩 후 편집

현재 상세/수정 페이지는 데이터가 없으면 "데이터를 불러오는 중" 로딩 상태가 보입니다. 실제 운영 환경에서는 유효한 ID를 통해 정보가 표시됩니다.

주요 동작 흐름

1. 새 광고 생성 (필수 필드 충족)
2. 리스트에서 상태/기간/타입으로 관리
3. 필요 시 편집(일정 연장, 이미지 교체 등)
4. 노출 종료 후 비활성 처리 또는 재활성화

사용 시나리오 예시

• 신기능 알림 배너: 특정 국가/언어 사용자에게만 2주간 노출
• 시즌 이벤트 배너: 시작/종료일을 명확히 설정 후 자동 종료
• 멀티 디바이스 캠페인: 데스크톱/모바일 각각 다른 배너 세트 운용

향후 확장 예정(로드맵)

• 추가 광고 타입(텍스트, 비디오)
• 노출/클릭 통계 대시보드
• A/B 테스트(순서/콘텐츠 자동 로테이션)
• 퍼널/세그먼트 기반 고급 타겟팅 연동