> 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)·차단 여부
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://guide.hypercape.com/brand-guide/form-events/undefined-6.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.