> For the complete documentation index, see [llms.txt](https://guide.hypercape.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.hypercape.com/brand-guide/form-events/undefined-6.md).
# 신청자 관리
## Part 7 · 신청자 관리
이벤트 상세 페이지의 **신청자** 탭에서는 응모자를 검색·심사·일괄 처리합니다. 캠페인을 만들고 나면 가장 자주 들어가는 화면이며, 일반 운영의 90%가 여기서 진행됩니다.
### 7-1. 표 위 영역 — 검색·필터·컬럼 설정
신청자 표 위쪽에는 두 줄에 걸쳐 도구가 배치됩니다.
#### 7-1-1. 국가 필터
좌측의 **모든 국가 ▾** 드롭다운으로 응모자가 입력한 국가 코드(BR, US, ES 등)별로 좁힐 수 있습니다.
#### 7-1-2. 통합 검색
검색창에 입력하면 **이름·이메일·운송장번호** 세 가지를 동시에 검색합니다. 플레이스홀더에도 "이름, 이메일 또는 운송장번호 검색..." 으로 표시됩니다.
> 💡 **운송장번호도 검색에 포함되는 이유** "어제 발송한 DHL 운송장 1234... 의 응모자가 누구였지?" 같은 역추적이 자주 필요해서 검색 대상에 포함되었습니다.
#### 7-1-3. 컬럼 설정 ⚙️
검색창 바로 옆의 **⚙️(슬라이더 아이콘)** 버튼을 누르면 응모자 표에 어떤 컬럼을 보여줄지 선택할 수 있습니다 (자세한 내용은 7-3-2 참고).
### 7-2. 상태 필터 — 9개 가로 탭
검색 줄 아래에 **9개 필터 버튼**이 가로로 나열되며, 각 탭 옆에 카운트가 함께 표시됩니다.
| 탭 라벨 | 색상 | 의미 | 표시 조건 |
| ---------- | ---- | ------------------------------ | ------------------ |
| **전체** | — | 모든 응모자 (총합) | 항상 |
| **대기중** | 노랑 | 아직 심사 안 한 응모자 | 항상 |
| **확정** | 파랑 | 확정 마킹된 응모자 (배송 우선 등) | 항상 |
| **선정** | 초록 | 선정 처리된 응모자 | 항상 |
| **미선정** | 빨강 | 미선정 처리된 응모자 | 항상 |
| **제출완료** | 에메랄드 | 콘텐츠 URL을 제출한 응모자 | "콘텐츠 제출 필요" On일 때만 |
| **미제출자** | 주황 | 콘텐츠를 아직 제출하지 않은 응모자 | "콘텐츠 제출 필요" On일 때만 |
| **데이터 이상** | 빨강 | 필수 정보(이름·이메일·주소 등) 누락 또는 형식 오류 | 항상 |
| **데이터 정상** | 초록 | 데이터 검증을 통과한 응모자 | 항상 |
#### 7-2-1. 우측 끝 — BlackList / Suspicious 드롭다운
탭 줄의 가장 오른쪽에 **두 개의 드롭다운**이 있습니다.
| 드롭다운 | 옵션 | 용도 |
| --------------------- | ------------------------------------ | ------------- |
| ⚠️ **BlackList (N명)** | 전체 / 블랙리스트만 / 블랙리스트 제외 | 차단된 응모자 필터링 |
| ⓘ **Suspicious (N)** | 전체 / Suspicious only / Suspicious 제외 | 부정 응모 의심자 필터링 |
> 💡 **Suspicious 자동 표시** 같은 IP·전화번호·주소 등으로 다중 응모한 경우 시스템이 자동으로 Suspicious로 마킹합니다. 이 드롭다운으로 의심 응모자만 빠르게 추려 검토할 수 있습니다.
### 7-3. 응모자 표
응모자 표는 **항상 보이는 시스템 컬럼 5개 + 기본으로 켜져 있는 컬럼 2개 + 컬럼 설정 ⚙️로 켜고 끌 수 있는 토글 컬럼 6그룹**으로 나뉩니다.
#### 7-3-1. 기본 컬럼 — 처음 진입했을 때 보이는 7개
| # | 컬럼 | 분류 | 표시되는 정보 |
| - | ------------- | -------- | ----------------------------------- |
| 1 | **선택** (체크박스) | 시스템 (항상) | 일괄 처리용 다중 선택 |
| 2 | **상태** | 시스템 (항상) | 동그라미 점 — 대기중(회색) / 선정(초록) / 미선정(빨강) |
| 3 | **국가** | 시스템 (항상) | 응모자가 입력한 국가 코드 (BR, US, ES…) |
| 4 | **이름** | 시스템 (항상) | 응모자 이름 |
| 5 | **이메일** | 기본 ON | 연락처 이메일 (정렬 가능) |
| 6 | **신청일** | 기본 ON | 응모 시각 (예: "4월 27일 09:47", 정렬 가능) |
| 7 | **작업** | 시스템 (항상) | 우측 끝의 👁 (상세 보기) 버튼 |
> 💡 **시스템 컬럼은 끌 수 없습니다** 선택·상태·국가·이름·작업 5개는 항상 표시되며 컬럼 설정에서도 토글 옵션으로 노출되지 않습니다.
#### 7-3-2. 컬럼 설정 ⚙️ — 더 많은 컬럼 켜고 끄기
검색창 옆 **⚙️** 버튼을 누르면 컬럼 설정 패널이 열립니다. 그룹별로 묶여 있어 필요한 정보만 빠르게 켤 수 있습니다.
| 그룹 | 컬럼 |
| --------- | -------------------------------------- |
| **기본 정보** | 이메일, 전화번호, Tax ID, 신청일 |
| **주소** | 수령인, 주소1, 주소2, Zipcode, 도시, 시/도, 도/군/구 |
| **선정/확정** | 선정일 |
| **배송** | 배송 상태, 배송사, 운송장번호, 로컬배송사, 로컬운송장 |
| **콘텐츠** | 콘텐츠, 제출 날짜 ("콘텐츠 제출 필요" On일 때만) |
| **SNS** | IG ID, TT ID, FB, X, YT, IG, TT |
**패널 상단의 두 가지 동작**
* **모두 선택** — 모든 토글 컬럼을 한 번에 ON
* **🔄 초기화** — 시스템 기본값(이메일·신청일만 ON)으로 되돌리기
> 💡 **설정은 브라우저에 저장됩니다** 한 번 컬럼을 켜두면 같은 브라우저·기기에서 다음 방문 시에도 그대로 유지됩니다. 다른 PC에서 접속하면 다시 설정해야 합니다.
> 🟡 **컬럼이 너무 많으면 가로 스크롤이 생깁니다** 모니터 폭에 따라 한 번에 보이는 컬럼 수가 제한됩니다. 가장 자주 보는 컬럼만 켜두는 것을 권장합니다 (예: 배송 운영 중에는 "배송 상태 + 운송장번호"만, 콘텐츠 검수 중에는 "콘텐츠 + 제출 날짜"만).
### 7-4. 단일 처리 — 응모자 한 명 다루기
응모자 표의 **우측 끝 👁(눈) 아이콘** 버튼을 누르면 **신청자 상세 정보** 다이얼로그가 열립니다.
> 🟡 **행 자체를 클릭해도 다이얼로그는 열리지 않습니다** 반드시 우측 끝의 작은 눈 아이콘(제목 "상세 보기")을 클릭해야 합니다.
#### 7-4-1. 다이얼로그 헤더의 액션 버튼
| 버튼 | 노출 조건 | 동작 |
| ------------ | ------------- | ------------------------ |
| **메일 발송** ✉️ | **선정** 상태일 때만 | 이 응모자에게 메일 발송 흐름 시작 |
| **정보 수정** ✏️ | 항상 | 본문을 편집 모드로 전환 (다음 항목 참고) |
#### 7-4-2. 다이얼로그 본문에서 보이는 정보
* **기본 정보**: 이름, 이메일, 전화번호, Tax ID, 신청일
* **배송 주소**: 주소1·주소2·국가·주/지역·도/광역시·시/군/구·우편번호
* **폼 응답**: 폼 빌더로 만든 모든 필드의 응답값
* **콘텐츠 URL** (콘텐츠 제출 필요 캠페인): 제출된 외부 링크 + **삭제 요청 / 삭제 거절** 배지
* **이메일 발송 이력**: **선정 상태일 때 자동 노출** — 발송된 템플릿, 시각, 도달 상태 (별도 버튼 없이 패널이 펼쳐져 있음)
* **미선정 사유**: 미선정 상태일 때만 표시 (운영자가 입력한 사유가 빨간 박스로 노출)
#### 7-4-3. 정보 수정 모드
헤더의 **정보 수정** 버튼을 누르면 다음 필드를 편집할 수 있습니다.
* 신청자 이름
* 배송 주소 (주소1·주소2·국가·주/지역·도/광역시·시/군/구·우편번호)
* 전화번호
* 세금식별번호 (Tax ID)
**\[변경사항 저장]** / **\[취소]** 버튼으로 마무리합니다.
#### 7-4-4. 본문 하단 — 선정 / 미선정 결정
응모자가 **대기중** 상태일 때만 다이얼로그 본문 맨 아래에 두 개의 큰 버튼이 노출됩니다.
| 버튼 | 색상 | 동작 |
| --------- | -- | ----------------------------------------------------------- |
| **선정** ✅ | 초록 | 즉시 선정 처리, 선정 안내 메일 발송 흐름 가능 |
| **미선정** ❌ | 빨강 | 별도 확인 다이얼로그 → **미선정 사유** 입력(필수) → 처리. 이 사유는 응모자에게 메일로 안내됩니다 |
> 🟡 **미선정 사유는 응모자에게 그대로 발송됩니다** 별도 확인 다이얼로그에 "심사 메모" 칸이 따로 있어 내부용 메모를 분리해서 남길 수 있습니다.
### 7-5. 일괄 처리 — 여러 명 한 번에
응모자 표의 체크박스로 여러 응모자를 선택하면 **화면 하단 가운데**에 알약 모양의 일괄 액션 팝업이 떠오릅니다 (`N명 선택됨` 카운트와 함께).
| 버튼 | 노출 조건 | 동작 |
| -------------- | ------- | ----------------------------------------- |
| **엑셀 다운로드** 📥 | 항상 | 선택한 응모자만 엑셀로 내보내기 (옵션 다이얼로그는 7-8과 동일) |
| **일괄 선정** ✅ | 권한 있을 때 | 선택한 응모자를 즉시 선정 처리 (초록) |
| **일괄 미선정** ❌ | 권한 있을 때 | 선택한 응모자를 즉시 미선정 처리 (빨강) — 사유 입력은 별도 다이얼로그 |
> 💡 **인라인 일괄 액션은 즉시 처리됩니다** 단일 처리(7-4)와 마찬가지로 별도 미리보기 단계 없이 클릭 즉시 동작합니다.
> 💡 **다른 일괄 작업이 필요하면?** 배송정보 일괄 업데이트, 신청자/당첨자 일괄 등록, 콘텐츠 일괄 확인 등은 **헤더의 \[일괄 작업] 버튼**(엑셀 기반 통합 다이얼로그)에서 처리합니다 (7-7 참고). 일괄 메일 발송은 별도 화면(Part 10)에서 진행합니다.
### 7-6. 선정자 추가 — 1명 직접 등록 (이벤트 상세 헤더)
이벤트 상세 페이지의 탭 메뉴 줄 우측에 있는 **\[선정자 추가]** 버튼(Part 6-6 참고)을 누르면 다이얼로그가 열려 응모를 거치지 않고 선정자(winner) 1명을 직접 등록할 수 있습니다.
* **용도**: 응모를 거치지 않고 선정자 1명을 바로 등록
* **입력**: 이메일 + 이름 등 기본 정보
* **결과**: 등록 즉시 **선정** 상태로 추가됨
> 💡 일반 응모자(대기중 상태)를 추가하는 게 아니라 **이미 선정된 사람**을 추가하는 기능입니다. 응모 단계 없이 곧장 선정 상태로 만듭니다.
### 7-7. 일괄 작업 — 6가지 작업을 한 다이얼로그에서
이벤트 상세 페이지의 탭 메뉴 줄 우측 **\[일괄 작업]** 버튼을 누르면 통합 다이얼로그가 열립니다.
* 다이얼로그 제목: **일괄 작업**
* 부제: "엑셀 파일로 등록·선정·배송정보·참가자 정보를 한 번에 처리합니다."
다이얼로그는 두 카테고리 중 하나를 고른 뒤 **6가지 세부 작업** 중 원하는 것을 선택하는 흐름입니다.
#### 7-7-1. 새로 추가 — 엑셀로 일괄 등록
응모자·당첨자·확정자를 엑셀 파일로 한 번에 등록합니다.
| 작업 | 의미 |
| ------------- | --------------------------------------- |
| **신청자 일괄 등록** | 엑셀로 다수 신청자를 한 번에 등록 (상태: **대기중**으로 들어감) |
| **당첨자 일괄 등록** | 엑셀로 다수 당첨자(winner)를 한 번에 등록 |
| **확정자 일괄 등록** | 엑셀로 다수 확정자를 한 번에 등록 |
#### 7-7-2. 정보 갱신 — 기존 응모자 정보 일괄 갱신
이미 등록된 응모자의 상태·정보를 엑셀로 일괄 업데이트합니다.
| 작업 | 의미 |
| ---------------- | ------------------------------------------- |
| **당첨자 일괄 선정** | 이미 신청한 참여자 중 내부적으로 선정한 인원을 엑셀로 **일괄 선정 처리** |
| **배송정보 일괄 업데이트** | 여러 응모자의 배송사·운송장·발송일을 한 번에 입력 (Part 8 참고) |
| **참가자 정보 일괄 갱신** | 이름·전화번호·주소·세금식별번호·배송정보·SNS URL 등 한 번에 갱신 |
#### 7-7-3. 공통 처리 흐름 (3단계)
각 세부 작업은 일반적으로 다음 3단계로 진행됩니다.
1. **템플릿 다운로드 + 엑셀 작성·업로드**
2. **미리보기** — 처리될 결과를 사전 확인
3. **결과 리포트** — 성공/실패 항목 표시
> 🟡 **이메일 발송 옵션** 신청자·당첨자·확정자 일괄 등록 시 추가된 응모자에게 안내 메일을 보낼지 여부를 선택할 수 있습니다.
>
> 🟡 **중복 처리** 이미 등록된 이메일이 엑셀에 있는 경우 **건너뛰기(Skip) / 업데이트(Update)** 중 선택할 수 있습니다.
### 7-8. 응모자 내보내기 — 엑셀 다운로드
이 캠페인의 응모자 데이터를 엑셀(.xlsx)로 내보내는 기능입니다.
#### 7-8-1. 두 가지 진입 경로
| 진입점 | 위치 | 대상 응모자 |
| ----------------------------- | ------------------------- | ---------------------- |
| **엑셀 다운로드** 버튼 (이벤트 상세 헤더 영역) | 탭 메뉴 줄 우측 (Part 6-6) | 이벤트 전체 (다이얼로그에서 범위 선택) |
| **엑셀 다운로드** 버튼 (일괄 액션 팝업) | 표에서 응모자 N명 선택 시 화면 가운데 팝업 | **선택한 응모자만** |
#### 7-8-2. 다운로드 다이얼로그 옵션
다이얼로그 제목은 **엑셀 다운로드** 입니다. 두 영역으로 구성됩니다.
**A. 다운로드 범위 (라디오, 1개 선택)**
| 옵션 | 의미 |
| ----------- | ---------------------- |
| **전체** | 모든 응모자 (대기중·선정·미선정 포함) |
| **선정자만** | 선정 상태인 응모자만 |
| **컨텐츠 확정만** | 콘텐츠 URL이 모두 승인된 응모자만 |
**B. 제외 옵션 (체크박스, 0\~3개 동시 선택)**
| 체크박스 | 부가 설명 | 효과 |
| -------------- | ------------- | --------------------- |
| **의심자 제외** | (중복 신청 등) | Suspicious 마킹된 응모자 제외 |
| **데이터 이상자 제외** | (전화/우편번호 오류) | 데이터 검증 실패 응모자 제외 |
| **차단 이메일 제외** | (banned list) | BlackList에 등록된 이메일 제외 |
> 💡 **운영 보고용 데이터를 깔끔하게** 의심자·이상자·차단자를 모두 제외하면 정상 응모자만 추린 깨끗한 명단이 나옵니다. 광고주·외부 보고용에 활용하세요.
#### 7-8-3. 내보내기 파일에 포함되는 정보
엑셀 파일에는 다음이 모두 포함됩니다.
* 응모 정보 (이름, 이메일, 전화, 주소, Tax ID, 신청일)
* 폼 응답 (브랜드가 폼 빌더로 만든 모든 커스텀 필드)
* 배송 정보 (배송사, 운송장번호, 발송일, 로컬 배송사·운송장)
* 콘텐츠 상태 (제출 URL, 승인/거절, 메모)
* 선정/미선정 여부 (status), 미선정 사유, 선정일
* 부정 응모(Suspicious)·차단 여부