파트너 가이드
파트너 콘솔(console.adit.now)에서 캠페인을 관리하고 정산받는 완전한 가이드입니다.
1. 파트너 콘솔 개요
콘솔 접속
- URL:
console.adit.now - 로그인: 이메일 + 비밀번호 (회원가입 시 생성)
- 비밀번호 찾기:
/forgot-password에서 재설정 링크 발송
사이드바 메뉴 구조
| 메뉴 | 경로 | 설명 |
|---|---|---|
| 대시보드 | /dashboard | KPI, 매출 추이, 최근 캠페인, 다가오는 일정 |
| 캠페인 관리 > 홈 | /reservations | 캠페인 목록 조회, 생성, 상태 관리 |
| 캠페인 관리 > 캘린더 | /reservations/calendar | 날짜별 캠페인 확인, 슬롯 관리 |
| 인사이트 | /insights | 인스타그램 채널 인사이트 (팔로워, 도달, 인구통계) |
| 광고 상품 | /products | 개별 상품 및 패키지 관리 |
| 정산 관리 | /settlements | 정산 요청, 세금계산서, 입금 확인 |
| 광고 프로필 | /channel-profile | 광고주에게 제공되는 채널 소개 정보 |
| 설정 > 내 회사 | /settings/organization | 사업자 정보, 정산 계좌 |
| 설정 > 채널 정보 | /settings/profile | 인스타그램 연동/해제 |
| 설정 > 팀 멤버 | /settings/users | 팀원 초대, 역할 관리 |
온보딩
계정이 비활성(INACTIVE) 상태이면 온보딩을 완료해야 합니다.
온보딩 미완료 시 사이드바에 "온보딩" 메뉴가 표시되며, 캠페인 생성 시 온보딩 페이지(/onboarding)로 리다이렉트됩니다.
도움말 및 지원
사이드바 하단에 두 가지 지원 메뉴가 있습니다.
| 메뉴 | 동작 |
|---|---|
| 도움말 | 도움말 페이지 링크 |
| 1:1 문의하기 | ChannelIO 채팅창 열기 |
2. 대시보드 (/dashboard)
경로: 사이드바 > 대시보드
대시보드는 채널의 광고 현황을 한눈에 확인할 수 있는 메인 페이지입니다.
KPI 카드 (4개)
| 카드 | 값 | 비고 |
|---|---|---|
| 기간별 수익 | 원(₩) 단위 | 선택 기간에 따라 라벨 변경: "오늘 수익", "어제 수익", "최근 7일 수익", "최근 30일 수익". 이전 기간 대비 변동률(트렌드) 표시 |
| 정산 예정 | 원(₩) 단위 | 아직 정산이 완료되지 않은 대기 금액 |
| 활성 상품 | N개 | 현재 판매 중인 광고 상품 수 |
| 이번 달 캠페인 | N건 | 이번 달에 등록/진행 중인 캠페인 수. 이전 기간 대비 변동률(트렌드) 표시 |
기간 선택 탭
대시보드 우측 상단의 기간 선택 탭으로 KPI 및 차트 기간을 변경합니다.
| 탭 | 기간 |
|---|---|
| 오늘 | 당일 데이터 |
| 어제 | 전일 데이터 |
| 7일 | 최근 7일 |
| 30일 | 최근 30일 (기본값) |
정산 수익 추이 차트
- 일별(
daily) 기준의 정산 완료 수익 추이를 라인 차트로 표시 - 메트릭 토글: 전체(
total), 피드(feed), 스토리(story), 릴스(reels) 개별 표시/숨기기 가능 - 데이터가 없을 경우 "정산 완료된 수익 데이터가 없습니다" 메시지 표시
최근 캠페인
- 취소(CANCELLED) 상태를 제외한 최근 4건의 캠페인 표시
- 각 캠페인별 광고주명, 상품명, 금액, 상태 뱃지 표시
- "전체 보기" 링크 클릭 시
/reservations로 이동
다가오는 일정
- 오늘부터 향후 5일간의 캠페인 일정
- 날짜별 캠페인 수를 막대형으로 시각화
- 캠페인 수에 따른 색상 구분:
- 0건: 연한 회색
- 1건: 밝은 회색
- 2~3건: 진한 회색
- 4건 이상: 검정
- "더보기" 클릭 시
/reservations/calendar로 이동
사용 API
| Hook | 용도 |
|---|---|
usePartnerDashboardKPI() | KPI 데이터 (매출, 정산, 상품수, 캠페인수) |
usePartnerRevenueTrend() | 기간별 수익 추이 데이터 |
usePartnerCampaigns() | 캠페인 목록 (최근 캠페인 + 일정) |
3. 캠페인 관리 (/reservations)
3-1. 캠페인 목록
경로: 사이드바 > 캠페인 관리 > 홈
검색
- 캠페인명, 광고주명으로 검색 가능
- 플레이스홀더: "캠페인을 검색해주세요"
상태 필터
| 필터 값 | 한국어 | 설명 |
|---|---|---|
all | 전체 상태 | 모든 캠페인 |
PENDING | 대기 | 확정 대기 중 |
CONFIRMED | 확정 | 캠페인 확정됨 |
IN_PROGRESS | 진행 중 | 콘텐츠 제작 중 |
UPLOADED | 업로드 완료 | 콘텐츠 업로드됨 |
COMPLETED | 완료 | 정산까지 완료 |
CANCELLED | 취소 | 캠페인 취소 |
기간 필터
| 옵션 | 기간 |
|---|---|
| 최근 7일 | 7일 |
| 최근 28일 | 28일 (기본값) |
| 최근 90일 | 90일 |
테이블 컬럼
| 컬럼 | 설명 |
|---|---|
| 캠페인 | 캠페인명 |
| 광고주 | 광고주명 |
| 상태 | 상태 뱃지 (색상 코드 적용) |
| 상품 / 패키지 | 패키지명 우선 표시, 없으면 상품명 |
| 업로드 일자 | 업로드 예정일 + 시간대 (오전/오후/저녁/상관없음) |
| 금액 | 캠페인 금액 (₩ 단위) |
| 등록시간 | 생성일시 (YYYY.MM.DD HH:MM) |
| 관리 | "캠페인 관리" 버튼 → 상세 모달 열기 |
상태 뱃지 색상표
| 상태 | 한국어 | 배경색 | 글자색 |
|---|---|---|---|
PENDING | 대기 | bg-yellow-100 (노랑) | text-yellow-800 |
CONFIRMED | 확정 | bg-blue-100 (파랑) | text-blue-800 |
IN_PROGRESS | 진행 중 | bg-green-100 (초록) | text-green-800 |
UPLOADED | 업로드 완료 | bg-purple-100 (보라) | text-purple-800 |
COMPLETED | 완료 | bg-gray-100 (회색) | text-gray-600 |
CANCELLED | 취소 | bg-red-100 (빨강) | text-red-800 |
REJECTED | 반려 | bg-red-100 (빨강) | text-red-800 |
페이지네이션
- 총 캠페인 수 표시: "총 N개 캠페인"
- 이전/다음 버튼으로 페이지 이동
- "페이지 N/M" 형태로 현재 페이지 표시
3-2. 캠페인 생성 모달
캠페인 관리 페이지 또는 캘린더 페이지에서 "캠페인 생성" 버튼 클릭 시 4단계 모달이 열립니다.
1단계: 기본 정보
| 필드 | 필수 | 설명 |
|---|---|---|
| 광고주명 | * | 기본값: 채널명으로 프리필. 자유 입력 가능 |
| 캠페인명 | * | 예: "2024 봄 신상품 런칭" |
| 담당자 전화번호 | 010-1234-5678 형식 (자동 포맷팅) | |
| 담당자 이메일 | contact@example.com | |
| 광고 상품 | * | 개별 상품 또는 패키지 중 1개 선택 (아래 참조) |
광고 상품 선택 UI:
- 개별 상품: 활성화(판매중)된 상품만 표시. 상품명, 유형(피드/스토리/릴스/커스텀), 가격 표시
- 패키지 상품: 활성화된 패키지만 표시. 패키지명, 포함 상품 수, 정가/할인가 표시
- 상품과 패키지는 상호 배타적 - 하나를 선택하면 나머지는 해제
2단계: 일정 설정
| 필드 | 필수 | 설명 |
|---|---|---|
| 업로드 예정일 | * | 캘린더에서 날짜 선택 (슬롯 상태 확인 가능) |
| 업로드 시간대 | * | 드롭다운 선택 |
업로드 시간대 옵션:
| 옵션 | 실제 시간 |
|---|---|
| 오전 (09:00) | 09:00 |
| 오후 (14:00) | 14:00 |
| 저녁 (19:00) | 19:00 |
| 협의 필요 | 별도 협의 |
| 상관 없음 | 기본값, 시간 미지정 |
3단계: 콘텐츠 가이드
| 필드 | 필수 | 설명 |
|---|---|---|
| 광고주 요청사항 | * | 필수 포함 내용, 촬영 가이드 등 |
| 해시태그 | * | 예: #광고 #협찬 #브랜드명 |
| 참고 자료 첨부 | 드래그 앤 드롭 또는 클릭으로 다중 파일 업로드 (PDF, DOC, 이미지 지원) |
- 선택한 상품에 **채널 안내사항(advertiserGuidance)**이 있으면 상단에 표시
- 참고 자료 파일은 파일명, 크기, 아이콘(이미지/PDF/기타) 구분 표시
- 파일별 개별 삭제(X 버튼) 가능
4단계: 계약 정보
| 필드 | 필수 | 설명 |
|---|---|---|
| 정산 유형 | * | Adit 정산 또는 직접 정산 선택 (아래 참조) |
| 정산 예정일 | * | 기본값: 업로드 예정일과 동일. 변경 가능 |
| 특별 조항 | 계약 관련 특별 조항 자유 입력 |
정산 유형 선택 규칙
비즈니스 규칙: 개인 파트너(allowDirectInvoice=false)는 "직접 정산(DIRECT_INVOICE)" 옵션이 표시되지 않습니다. Adit 정산만 선택 가능합니다.
| 유형 | 설명 | 수수료 |
|---|---|---|
Adit 정산 (ADIT_SETTLEMENT) | Adit이 광고주로부터 결제를 수금 후 수수료 차감하여 정산 | 있음 |
직접 정산 (DIRECT_INVOICE) | 광고주에게 직접 세금계산서 발급. Adit 수수료 없음 | 없음 |
유효성 검사
- 비활성 파트너(
INACTIVE)가 캠페인 생성 시도 시 "계정 활성화가 필요합니다" 확인 →/onboarding으로 이동 - 각 단계별 필수 필드 미입력 시 알림 표시 후 진행 불가
3-3. 캠페인 상세 모달
"캠페인 관리" 버튼 클릭 시 상세 모달이 열립니다.
모달 헤더
- 캠페인명 (제목)
- 상태 뱃지 + 광고주명 + 상품/패키지명 + 금액
진행 상황 Stepper
취소/거절 상태가 아닌 캠페인에서 다음 5단계 진행 상황을 시각적으로 표시합니다.
(1) 대기 → (2) 확정 → (3) 진행 중 → (4) 업로드 완료 → (5) 완료- 완료된 단계: 검정 배경 + 체크 아이콘
- 현재 단계: 검정 배경 + 숫자
- 미래 단계: 회색 배경 + 숫자
상태별 안내 메시지
| 상태 | 배경색 | 메시지 |
|---|---|---|
| PENDING | 노란색(bg-amber-50) | "[채널명]의 광고 승인을 기다리고 있습니다" |
| CONFIRMED | 파란색(bg-blue-50) | "캠페인이 확정되었습니다. 업로드 일정에 맞춰 콘텐츠를 준비해주세요." |
| IN_PROGRESS | 초록색(bg-emerald-50) | "콘텐츠 제작이 진행 중입니다." |
| UPLOADED | 보라색(bg-violet-50) | "콘텐츠 업로드가 완료되었습니다. 정산 처리를 기다리고 있습니다." + "정산 관리 바로가기" 링크 |
| COMPLETED | 초록색(bg-emerald-50) | "캠페인이 완료되었습니다." |
| REJECTED | 빨간색(bg-red-50) | "캠페인이 거절되었습니다." |
| CANCELLED | 빨간색(bg-red-50) | "캠페인이 취소되었습니다." |
탭 구성
기본 정보 탭 (info)
- 일정 정보: 업로드 예정일, 업로드 시간대
- 광고주 정보: 광고주명, 브랜드명
- 담당자 연락처 (CONFIRMED 이후 상태에서만 표시): 전화번호, 이메일
상태별 기본 탭 자동 선택:
| 상태 | 기본 탭 |
|---|---|
| PENDING | 기본 정보 탭 |
| CONFIRMED, IN_PROGRESS | 콘텐츠 가이드 탭 |
| UPLOADED, COMPLETED | 정산 및 계약 정보 탭 |
상태별 파트너 액션 버튼
| 현재 상태 | 버튼 | 동작 | 결과 상태 |
|---|---|---|---|
| PENDING | "캠페인 확정" | 캠페인 수락 | → CONFIRMED |
| PENDING | "거절" | 확인 다이얼로그 후 거절 | → REJECTED |
| CONFIRMED | "진행 시작" | 콘텐츠 제작 시작 | → IN_PROGRESS |
| CONFIRMED | "캠페인 취소" | 확인 다이얼로그 후 취소 | → CANCELLED |
| IN_PROGRESS | "업로드 완료" | 콘텐츠 URL 입력(선택) 후 완료 | → UPLOADED |
| IN_PROGRESS | "캠페인 취소" | 확인 다이얼로그 후 취소 | → CANCELLED |
| UPLOADED | (액션 없음) | 정산 관리 페이지에서 진행 | - |
| COMPLETED | (액션 없음) | - | - |
| CANCELLED | (액션 없음) | - | - |
| REJECTED | (액션 없음) | - | - |
업로드 완료 처리 시, IN_PROGRESS 상태의 모달 하단에 "업로드 URL (선택)" 입력 필드가 표시됩니다. 인스타그램 게시물 URL 등을 입력할 수 있으나 필수는 아닙니다.
3-4. 캘린더 뷰 (/reservations/calendar)
경로: 사이드바 > 캠페인 관리 > 캘린더
KPI 카드 (4개)
| 카드 | 설명 |
|---|---|
| 예상 매출 | 전체 캠페인 금액 합계 |
| 활성 캠페인 | CONFIRMED + IN_PROGRESS 상태 수 |
| 대기 캠페인 | PENDING 상태 수 |
| 부킹율 | (취소 제외 캠페인 / 전체 캠페인) x 100 |
캘린더 표시
- 월별 표시: "YYYY년 M월" + 좌우 화살표로 월 이동
- 날짜별 캠페인: 상태 뱃지 색상으로 최대 3건 표시, 초과분은 "+N개" 표시
- 오늘 날짜: 검정 원 배경으로 강조
- 캠페인 클릭: 캠페인 상세 모달 열기
범례
- 캠페인 상태: 대기(노랑), 확정(파랑), 진행 중(초록), 업로드 완료(보라), 완료(회색), 취소(빨강)
- 슬롯: 잠금 아이콘(비활성화), "마감" 뱃지(슬롯 마감)
4. 슬롯 관리
슬롯이란?
날짜별로 캠페인을 수용할 수 있는 자리입니다. 슬롯 설정을 통해 특정 날짜의 캠페인 수를 제한하거나, 아예 캠페인을 받지 않도록 닫을 수 있습니다.
슬롯 설정 방법
캘린더 뷰에서 날짜에 마우스를 올리면 톱니바퀴(설정) 아이콘이 나타납니다. 클릭하면 슬롯 설정 모달이 열립니다.
슬롯 설정 모달 필드
| 필드 | 설명 |
|---|---|
| 선택 날짜 | 현재 선택된 날짜 + 예약된 캠페인 수 표시 |
| 여러 날짜 일괄 설정 | 체크박스 활성화 시 시작일~종료일 범위 선택 가능 |
| 부킹 가능 | 토글 스위치 (켜기: 예약 가능, 끄기: 예약 불가) |
| 최대 캠페인 수 | 숫자 입력. 0 = 무제한 |
슬롯 상태 표시
| 표시 | 조건 | 캘린더 배경 |
|---|---|---|
| 정상 (표시 없음) | 슬롯 열림, 여유 있음 | 흰색 |
| 마감 (노란 뱃지) | currentCampaigns >= maxCampaigns | bg-yellow-50 |
| 잠금 (자물쇠 아이콘) | isAvailable = false | bg-gray-100 |
- 슬롯 제한이 설정된 날짜는 우하단에 "현재/최대" 형태로 표시 (예:
2/3)
슬롯 자동 반환
다음 상황에서 슬롯이 자동으로 반환되어 해당 날짜에 새 캠페인이 예약 가능해집니다.
- 캠페인 업로드 완료 (→ UPLOADED)
- 캠페인 완료 (→ COMPLETED)
- 캠페인 취소 (→ CANCELLED)
- 캠페인 거절 (→ REJECTED)
슬롯이 반환되면 해당 날짜에 다른 캠페인이 예약될 수 있습니다.
5. 상품 관리 (/products)
경로: 사이드바 > 광고 상품
5-1. KPI 카드 (4개)
| 카드 | 설명 |
|---|---|
| 개별 상품 | 등록된 총 개별 상품 수 |
| 패키지 상품 | 등록된 총 패키지 수 |
| 활성 상품 | 현재 판매중인 개별 상품 수 |
| 평균 단가 | 활성 상품의 평균 가격 (₩) |
5-2. 개별 상품 탭
탭 전환 버튼: "개별 상품 (N)" | "패키지 상품 (N)"
상품 유형
| 유형 코드 | 한국어 |
|---|---|
FEED | 피드 |
STORY | 스토리 |
REELS | 릴스 |
CUSTOM | 커스텀 |
상품 카드 표시
각 상품은 카드 형태로 표시됩니다.
| 영역 | 내용 |
|---|---|
| 헤더 | 상품명 + 유형 라벨 + 드롭다운 메뉴(수정/삭제) |
| 본문 | 설명, 슬롯 정보("주 1회"), 가격 |
| 하단 | 판매 상태 토글 (판매중/중지) |
상품 생성/수정 모달
"광고 상품 생성" 버튼 클릭 시 모달이 열립니다.
| 필드 | 설명 |
|---|---|
| 카테고리 | 피드, 스토리, 릴스, 애드온(커스텀) 중 선택 |
| 상품명 | 상품 이름 |
| 가격 | 원(₩) 단위 |
| 설명 | 상품 설명 |
| 광고주 가이드 | 광고주에게 전달되는 유의사항/안내 |
상품 액션
| 액션 | 버튼 | 설명 |
|---|---|---|
| 수정 | 드롭다운 > "상품 수정" | 기존 데이터로 모달 열기 |
| 삭제 | 드롭다운 > "상품 삭제" | 확인 다이얼로그 후 삭제 |
| 판매 상태 토글 | 하단 토글 스위치 | 판매중 ↔ 중지 전환 |
5-3. 패키지 탭
패키지 카드 표시
| 영역 | 내용 |
|---|---|
| 헤더 | 패키지 아이콘 + 패키지명 + "N개 상품 포함" + 드롭다운 메뉴(삭제) |
| 본문 | 설명, 포함 상품 목록(뱃지 형태), 가격 정보 |
| 가격 | 정가(취소선) + 패키지가 + 할인율(빨간색, 예: -20%) |
| 하단 | 판매 상태(판매중/중지) 표시 |
패키지 생성 모달
"패키지 생성" 버튼 클릭 시 모달이 열립니다.
| 필드 | 설명 |
|---|---|
| 패키지명 | 패키지 이름 |
| 설명 | 패키지 설명 |
| 포함 상품 | 기존 개별 상품 중 다중 선택 |
| 패키지 가격 | 원(₩) 단위 (총 가격 대비 할인 자동 계산) |
6. 정산 관리 (/settlements)
경로: 사이드바 > 정산 관리
정산 관리는 Adit 서비스의 핵심 기능입니다. 정산 유형(Adit 정산 vs 직접 정산)과 사업자 유형(개인 vs 법인/개인사업자)에 따라 플로우가 달라집니다. 아래 내용을 반드시 숙지해 주세요.
6-1. KPI 카드 (3개)
| 카드 | 설명 |
|---|---|
| 정산 대기 | SETTLEMENT_PENDING 상태의 정산 금액 합계 |
| 정산 처리 중 | AWAITING_ADVERTISER_PAYMENT + ADVERTISER_PAID + PARTNER_PAYOUT_PROCESSING 상태의 정산 금액 합계 |
| 정산 완료 | SETTLEMENT_COMPLETED 상태의 정산 금액 합계 |
6-2. 상태 필터
| 필터 | 설명 |
|---|---|
| 전체 상태 | 모든 정산 내역 |
| 정산 대기 | SETTLEMENT_PENDING |
| 광고주 결제 대기 | AWAITING_ADVERTISER_PAYMENT |
| 광고주 결제 완료 | ADVERTISER_PAID |
| 지급 처리 중 | PARTNER_PAYOUT_PROCESSING |
| 정산 완료 | SETTLEMENT_COMPLETED |
6-3. 테이블 컬럼
| 컬럼 | 설명 |
|---|---|
| 캠페인 | 캠페인명 |
| 광고주 | 광고주명 |
| 정산 방식 | 뱃지 표시 - "Adit 정산"(파랑-보라 그라데이션 뱃지) / "직접 정산"(회색 뱃지) |
| 정산 금액 | DIRECT_INVOICE: 캠페인 가격 / ADIT: 원천징수율 > 0이면 실지급액, 아니면 정산액. 원천징수 시 "원천징수" 뱃지 추가 |
| 수수료 | ADIT: 수수료 금액 / DIRECT: "-" |
| 상태 | 정산 상태 뱃지 |
| 요청일 | 정산 요청일 (없으면 "-") |
| 완료일 | 정산 완료일 (없으면 "-") |
| 관리 | 상태별 액션 버튼 |
6-4. ADIT 정산 워크플로우 (사업자 파트너)
법인사업자 또는 개인사업자 파트너의 ADIT_SETTLEMENT 정산 흐름입니다.
정산 요청
- 조건: 정산 상태가
SETTLEMENT_PENDING - "정산 요청" 버튼 클릭 → 정산 요청 확인 모달 열림
확인 모달에서 정보 확인
모달에 다음 정보가 표시됩니다:
세금계산서 발행 가이드:
- 공급가액:
정산금액 / 1.1(반올림) - 부가세 (10%):
정산금액 - 공급가액 - 합계: 정산금액
세금계산서 발행 정보 (공급받는자):
- 파트너명 (예: (주)르도드코퍼레이션)
- 사업자등록번호
- 대표자명
- "세금계산서는 영수로 발행해주세요"
"정산 요청 후 역발행 승인" 버튼 클릭
- 정산 요청 처리 후 → 역발행 승인 URL이 새 창으로 열립니다
- 공동인증서로 역발행 세금계산서를 승인해 주세요
역발행 승인 완료 → 상태 변경
- 상태:
SETTLEMENT_PENDING→AWAITING_ADVERTISER_PAYMENT - 역발행 승인 URL은 10분 유효. 만료 시 "역발행 승인하기" 버튼으로 재발급 가능
대행사가 광고주에게 세금계산서 발행 (Bolta 자동)
- 어드민이 정발행 세금계산서를 Bolta 통해 자동 발행
- 파트너는 별도 조치 불필요
광고주 입금 확인
- 광고주가 입금하면 상태:
AWAITING_ADVERTISER_PAYMENT→ADVERTISER_PAID
지급 처리
- 상태:
ADVERTISER_PAID→PARTNER_PAYOUT_PROCESSING
지급 완료
- 등록된 정산 계좌로 입금 완료
- 상태:
PARTNER_PAYOUT_PROCESSING→SETTLEMENT_COMPLETED
역발행 승인 완료 시 수령은 자동 반영되며, 별도 수령 확인은 필요 없습니다.
6-5. ADIT 정산 워크플로우 (개인 파트너)
개인(INDIVIDUAL) 파트너의 ADIT_SETTLEMENT 정산 흐름입니다. 역발행 프로세스가 없습니다.
정산 요청
- "정산 요청" 버튼 클릭 → 정산 요청 확인 모달 열림
확인 모달에서 정보 확인
지급 정보 확인 (설정 > 조직 정보에서 등록한 정보):
- 주민등록번호
- 예금주
- 은행
- 계좌번호
정산 금액 안내:
- 캠페인 금액
- 수수료 (수수료율%)
- 정산 금액 = 캠페인 금액 - 수수료
- 원천징수 (3.3%) = 정산 금액 x 3.3%
- 실지급액 = 정산 금액 - 원천징수
"정산 요청" 버튼 클릭
- 역발행 없이 바로 정산 요청 완료
- 상태:
SETTLEMENT_PENDING→AWAITING_ADVERTISER_PAYMENT
광고주 입금 ~ 지급 완료
- 이후 프로세스는 사업자 파트너와 동일
- 광고주 입금 → 지급 처리 → 정산 완료
- 실지급액 = 정산금 - 원천징수(3.3%)
개인 파트너는 세금계산서/역발행 프로세스가 없습니다. 대신 원천징수(3.3%)가 차감된 금액이 지급됩니다. 정보가 다르면 설정 > 내 회사에서 수정해 주세요.
6-6. DIRECT_INVOICE 워크플로우 (직접 정산)
파트너가 광고주에게 직접 세금계산서를 발급하고 입금을 확인하는 흐름입니다.
세금계산서 발급
- 조건:
SETTLEMENT_PENDING상태 + 세금계산서 미발급 - "세금계산서 발급" 버튼 클릭 → 세금계산서 발급 모달 열림
- 발급 정보 확인 후 "세금계산서 발급 완료" 버튼 클릭
입금 대기
- 세금계산서 발급 완료 표시
- 광고주의 입금을 기다립니다
입금 확인
- 광고주가 입금한 것을 확인했으면 "입금 확인" 버튼 클릭
- 확인 다이얼로그: "광고주로부터 입금을 확인하셨습니까?"
- 확인 클릭 → 캠페인 완료 처리
직접 정산에서는 파트너가 반드시 "입금 확인" 버튼을 눌러야 캠페인이 완료됩니다.
입금 확인을 하지 않으면 캠페인이 영구적으로 미완료 상태로 남습니다.
6-7. 정산 상태 전체 테이블
| 상태 | 한국어 | 의미 | 가능한 액션 |
|---|---|---|---|
SETTLEMENT_PENDING | 정산 대기 | 정산 요청 전 | ADIT: "정산 요청" / DIRECT: "세금계산서 발급" |
AWAITING_ADVERTISER_PAYMENT | 광고주 결제 대기 | 정산 요청됨, 광고주 입금 대기 | ADIT(사업자): "역발행 승인하기" (역발행 미승인 시) / ADIT: 처리 중 표시 |
ADVERTISER_PAID | 광고주 결제 완료 | 광고주가 입금함 | 없음 (자동 처리) |
PARTNER_PAYOUT_PROCESSING | 지급 처리 중 | 파트너에게 송금 진행 중 | 없음 (자동 처리) |
SETTLEMENT_COMPLETED | 정산 완료 | 정산금 입금 완료 | 다운로드 버튼 |
7. 인사이트 (/insights)
경로: 사이드바 > 인사이트
전제조건: 인스타그램 계정 연동이 필수입니다. 미연동 시 "인스타그램 연동이 필요합니다" 안내 페이지가 표시되며, "연동하러 가기" 버튼 클릭 시 /settings/profile로 이동합니다.
기간 선택
| 옵션 | 설명 |
|---|---|
오늘 (day) | 당일 데이터 |
최근 7일 (week) | 7일간 데이터 |
최근 28일 (days_28) | 28일간 데이터 (기본값) |
기간 설정 (custom) | 시작일 ~ 종료일 직접 지정 |
동기화 버튼
- 우측 상단 "동기화" 버튼 클릭 시 인스타그램 API에서 최신 데이터를 가져옵니다
- 동기화 중에는 로딩 스피너와 "동기화 중..." 텍스트 표시
핵심 지표 카드 (7개)
| 지표 | 설명 | 강조 표시 |
|---|---|---|
| 팔로워 | 현재 팔로워 수 | 강조(검정 테두리) |
| 인게이지먼트 | 참여율 (상호작용/팔로워) | 강조(검정 테두리) |
| 조회수 | 콘텐츠 조회수 | 일반 |
| 도달 | 콘텐츠 도달 수 | 일반 |
| 프로필 방문 | 프로필 방문 수 | 일반 |
| 상호작용 | 총 상호작용 수 | 일반 |
| 참여 계정 | 참여한 고유 계정 수 | 일반 |
상호작용 상세
| 항목 | 아이콘 | 설명 |
|---|---|---|
| 좋아요 | 하트 | 좋아요 수 |
| 댓글 | 말풍선 | 댓글 수 |
| 저장 | 북마크 | 저장 수 |
| 공유 | 공유 | 공유 수 |
| 답장 | 말풍선 | 스토리 답장 수 |
인구통계
3개의 카드로 구성됩니다.
국가별 팔로워 (상위 10개):
- 국기 이모지 + 국가명 + 비율 바 + 퍼센트
도시별 팔로워 (상위 10개):
- 도시명 + 비율 바 + 퍼센트
연령/성별 분포:
- 연령대별 비율 바 차트
- 성별 분포 파이 차트: 여성(핑크), 남성(파랑), 알 수 없음(회색)
사용 API
| Hook | 용도 |
|---|---|
usePartnerInstagramStatus() | 인스타그램 연동 상태 + 팔로워 수 |
usePartnerInstagramInsights() | 계정 인사이트 + 인구통계 데이터 |
useSyncInstagramInsights() | 인사이트 데이터 동기화 실행 |
8. 광고 프로필 (/channel-profile)
경로: 사이드바 > 광고 프로필
광고 프로필에 입력한 정보는 Adit팀이 광고 대행 영업을 진행할 때 광고주에게 제공됩니다.
읽기 전용 정보 (인스타그램에서 자동 가져옴)
| 필드 | 설명 |
|---|---|
| 프로필 사진 | 인스타그램 프로필 이미지 |
| 채널명 | 인스타그램 채널명 (수정 불가) |
| 팔로워 수 | 현재 팔로워 수 (수정 불가) |
편집 가능 필드
| 필드 | 필수 | 설명 |
|---|---|---|
| 채널 한줄 소개 | * | 채널을 한 줄로 소개 |
| 카테고리 | * | 드롭다운 선택 (라이프스타일, 패션, 뷰티, 푸드 등) |
| 업로드 주기 | * | 드롭다운 선택 (매일, 주 5-6회, 주 3-4회, 주 1-2회, 월 2-3회, 월 1회, 기타) |
| 키워드 | * | 쉼표 구분 입력 (예: 라이프스타일, 패션, 뷰티, 푸드) |
| 소개 내용 | * | 매체 소개 내용 상세 작성 |
| 주요 광고 진행 광고주명 | 기존 광고 경험 광고주 이름 |
광고 소개서 (미디어킷) 파일 관리
| 액션 | 설명 |
|---|---|
| 업로드 | PDF, PNG, JPG 파일 (최대 10MB). 드래그 앤 드롭 또는 클릭 |
| 다운로드 | 업로드된 파일 클릭 시 다운로드 URL 발급 후 새 창에서 다운로드 |
| 삭제 | X 버튼 클릭 → 확인 다이얼로그 → 삭제 |
저장
- 우측 상단 "저장" 버튼 클릭
- 필수 필드 검증: 한줄 소개, 카테고리, 업로드 주기, 키워드, 소개 내용 모두 입력해야 저장 가능
- 미입력 필드가 있으면 해당 필드 알림 표시
9. 요금제 (/billing)
경로: 사이드바 하단 > 요금제
플랜 카드 (2개)
Trial Plan (무료)
| 항목 | 내용 |
|---|---|
| 가격 | 무료 |
| 포함 기능 | 캠페인 관리, 광고 상품, 기본 리포트 |
| 현재 플랜 표시 | "현재" 뱃지(검정 배경) |
| 업그레이드 | "Partner Plan으로 업그레이드" → ChannelIO 채팅 오픈 |
결제수단 등록 및 결제 내역 기능은 현재 준비 중입니다. 업그레이드를 원하시면 ChannelIO를 통해 문의해 주세요.
10. 설정
10-1. 내 회사 (/settings/organization)
경로: 사이드바 > 설정 > 내 회사
사업자 유형 선택
| 유형 | 설명 |
|---|---|
법인사업자 (corporate_business) | 법인 사업자등록번호 보유 |
개인사업자 (individual_business) | 개인 사업자등록번호 보유 |
개인 (individual) | 사업자 없는 개인 |
사업자 정보 (법인/개인사업자)
| 필드 | 필수 | 설명 |
|---|---|---|
| 회사명/상호명 | * | |
| 사업자등록번호 | * | 000-00-00000 형식 (자동 포맷팅) |
| 대표자명 | * | |
| 업태 | * | 예: 도소매 |
| 종목 | * | 예: 인터넷쇼핑 |
| 사업자등록증 | * | PDF/PNG/JPG 업로드 |
개인 정보 (개인 유형)
| 필드 | 필수 | 설명 |
|---|---|---|
| 대표자명 | * | |
| 대표자 주민등록번호 | * | 000000-0000000 형식 (원천징수용) |
| 신분증 사본 | * | PDF/PNG/JPG 업로드 |
주소
| 필드 | 필수 | 설명 |
|---|---|---|
| 주소 | 법인/개인사업자 필수 | 예: 서울시 강남구 테헤란로 123 |
| 상세주소 | 법인/개인사업자 필수 | 예: 456동 789호 |
연락처
| 필드 | 필수 |
|---|---|
| 전화번호 | * |
| 대표 이메일 | * |
정산 계좌
| 필드 | 필수 | 설명 |
|---|---|---|
| 은행명 | * | 드롭다운 선택 |
| 계좌번호 | * | '-' 없이 입력 |
| 예금주명 | * | |
| 통장사본 | * | PDF/PNG/JPG 업로드 |
온보딩 완료를 위한 필수 서류:
- 법인/개인사업자: 사업자등록증 + 통장사본
- 개인: 신분증 사본 + 통장사본
10-2. 채널 정보 (/settings/profile)
경로: 사이드바 > 설정 > 채널 정보
- 인스타그램 계정 연동: 인스타그램 비즈니스 계정과 연결
- 연동 해제: 기존 연결 해제
- 콜백 URL:
/settings/profile/instagram/callback(인스타그램 OAuth 콜백)
10-3. 팀 멤버 (/settings/users)
경로: 사이드바 > 설정 > 팀 멤버
팀원 초대
"사용자 초대" 버튼 클릭 시 초대 모달이 열립니다.
| 필드 | 설명 |
|---|---|
| 이메일 | 초대할 사용자 이메일 |
| 역할 | ADMIN(관리자), MANAGER(매니저), VIEWER(뷰어) 중 선택 |
멤버 테이블 컬럼
| 컬럼 | 설명 |
|---|---|
| 사용자 | 이름 + 이메일 |
| 권한 | 역할 뱃지 (OWNER/ADMIN/MANAGER/VIEWER) |
| 상태 | 상태 뱃지 (ACTIVE/INACTIVE/INVITED/SUSPENDED) |
| 마지막 로그인 | 마지막 로그인 일시 (INVITED 상태면 "미접속") |
| 가입일 | 가입/초대 일시 |
| 작업 | 드롭다운 메뉴 (정지/활성화/삭제) |
역할 설명
| 역할 | 한국어 | 설명 |
|---|---|---|
OWNER | 소유자 | 모든 권한 (삭제 불가) |
ADMIN | 관리자 | 모든 기능 접근 가능 |
MANAGER | 매니저 | 캠페인/상품 관리 가능 |
VIEWER | 뷰어 | 조회만 가능 |
11. 비즈니스 룰 (파트너 관점)
사업자 유형별 차이
| 구분 | 개인 파트너 | 법인/개인사업자 파트너 |
|---|---|---|
| 역발행 | 불필요 | 필요 (공동인증서 승인) |
| 원천징수 | 3.3% 차감 | 없음 |
| DIRECT_INVOICE | 선택 불가 (allowDirectInvoice=false) | 선택 가능 |
| 정산 요청 모달 | 지급 정보 + 원천징수 계산 표시 | VAT 계산 + 대행사 정보 표시 |
수수료 계산 규칙
| 정산 유형 | 수수료 | 설명 |
|---|---|---|
ADIT_SETTLEMENT | 수수료율 적용 (기본 10%) | 대행사가 중개 |
DIRECT_INVOICE | 0% (수수료 없음) | 파트너 ↔ 광고주 직접 |
정산금 계산 공식
수수료 = 캠페인가격 x 수수료율
정산금 = 캠페인가격 - 수수료
원천징수(개인만) = 정산금 x 3.3%
실수령액 = 정산금 - 원천징수예시 (개인 파트너, 캠페인가격 100만원, 수수료율 10%):
수수료 = 1,000,000 x 10% = 100,000원
정산금 = 1,000,000 - 100,000 = 900,000원
원천징수 = 900,000 x 3.3% = 29,700원
실수령액 = 900,000 - 29,700 = 870,300원예시 (사업자 파트너, 캠페인가격 100만원, 수수료율 10%):
수수료 = 1,000,000 x 10% = 100,000원
정산금 = 1,000,000 - 100,000 = 900,000원
(세금계산서 기준) 공급가액 = 900,000 / 1.1 = 818,182원
(세금계산서 기준) 부가세 = 900,000 - 818,182 = 81,818원
실수령액 = 900,000원12. 파트너 액션 전체 요약
캠페인 관련 액션
| 액션 | 상태 조건 | 설명 |
|---|---|---|
| 캠페인 생성 | 언제든지 | 4단계 모달에서 직접 캠페인 등록 |
| 캠페인 확정 | PENDING | 광고주/어드민 요청 수락 |
| 캠페인 거절 | PENDING | 광고주/어드민 요청 거절 → REJECTED |
| 진행 시작 | CONFIRMED | 콘텐츠 제작 시작 → IN_PROGRESS |
| 업로드 완료 | IN_PROGRESS | 콘텐츠 업로드 완료 처리 (URL 선택 입력) → UPLOADED |
| 캠페인 취소 | CONFIRMED, IN_PROGRESS | 캠페인 취소 → CANCELLED |
| 캠페인 삭제 | 언제든지 | 드롭다운 메뉴에서 삭제 (확인 다이얼로그) |
정산 관련 액션
| 액션 | 조건 | 설명 |
|---|---|---|
| 정산 요청 | SETTLEMENT_PENDING + ADIT_SETTLEMENT | 정산 요청 모달 확인 후 실행 |
| 역발행 승인하기 | AWAITING_ADVERTISER_PAYMENT + 사업자 + 역발행 미승인 | 새 창에서 역발행 승인 |
| 세금계산서 발급 | SETTLEMENT_PENDING + DIRECT_INVOICE | 발급 모달에서 확인 |
| 입금 확인 | DIRECT_INVOICE + 발급 완료 | 광고주 입금 확인 처리 → 완료 |
슬롯 관련 액션
| 액션 | 설명 |
|---|---|
| 슬롯 열기/닫기 | 날짜별 예약 가능 여부 토글 |
| 최대 캠페인 수 설정 | 날짜별 제한 (0 = 무제한) |
| 일괄 설정 | 시작일~종료일 범위 선택하여 한 번에 설정 |
상품 관련 액션
| 액션 | 설명 |
|---|---|
| 상품 생성 | 개별 광고 상품 등록 (이름, 유형, 가격, 설명, 가이드) |
| 상품 수정 | 기존 상품 정보 수정 |
| 상품 삭제 | 확인 후 상품 삭제 |
| 판매 상태 토글 | 판매중 ↔ 중지 전환 |
| 패키지 생성 | 개별 상품을 묶어 패키지 구성 |
| 패키지 삭제 | 확인 후 패키지 삭제 |
13. 자주 묻는 질문
Q. 정산 요청 버튼이 안 보여요.
A. 다음 조건을 확인해 주세요:
- 캠페인 상태가 "업로드 완료(UPLOADED)" 이후인지 확인
- 정산 상태가 "정산 대기(SETTLEMENT_PENDING)"인지 확인
- 정산 유형에 맞는 버튼이 표시됩니다: ADIT 정산 → "정산 요청", DIRECT → "세금계산서 발급"
Q. 직정산에서 입금 확인을 안 하면?
A. 캠페인이 완료되지 않습니다. 광고주로부터 입금을 확인했으면 반드시 "입금 확인" 버튼을 눌러주세요. 입금 확인을 하지 않으면 캠페인이 영구적으로 미완료 상태로 남습니다.
Q. 슬롯이 마감되면?
A. 해당 날짜에 새 캠페인이 예약되지 않습니다. 기존 캠페인이 취소/완료/업로드 완료/거절되면 슬롯이 자동 반환되어 다시 예약 가능해집니다. 직접 슬롯 설정에서 최대 캠페인 수를 늘릴 수도 있습니다.
Q. 확정한 캠페인을 취소하고 싶어요.
A. CONFIRMED 또는 IN_PROGRESS 상태에서 "캠페인 취소" 버튼을 눌러주세요. 취소 확인 다이얼로그가 표시되며, 확인 시 캠페인 상태가 CANCELLED로 변경됩니다. 이 작업은 되돌릴 수 없습니다.
Q. 인스타그램 연결이 안 돼요.
A. 다음을 확인해 주세요:
- 인스타그램 비즈니스 계정인지 확인 (개인 계정은 연동 불가)
- Facebook 페이지와 인스타그램 비즈니스 계정이 연결되어 있는지 확인
- 브라우저 팝업 차단이 되어 있지 않은지 확인
- 문제가 지속되면 1:1 문의하기를 통해 지원팀에 문의해 주세요.
Q. 상품 가격 변경은?
A. 광고 상품 페이지에서 해당 상품의 드롭다운 메뉴 > "상품 수정"을 클릭하면 가격을 변경할 수 있습니다. 이미 진행 중인 캠페인의 가격에는 영향을 주지 않습니다.
Q. 미디어킷(광고 소개서)은 어떤 형식?
A. PDF, PNG, JPG 형식을 지원하며, 최대 파일 크기는 10MB입니다. PDF 형식으로 제작하시면 더욱 전문적으로 보입니다. 채널 정보, 팔로워 수, 주요 콘텐츠, 광고 상품 정보 등을 포함해주세요.
Q. 역발행 승인 URL이 만료되었어요.
A. 역발행 승인 URL은 10분간 유효합니다. 만료된 경우 정산 관리 페이지에서 해당 정산 건의 "역발행 승인하기" 버튼을 클릭하면 새로운 URL이 발급됩니다.
Q. 개인 파트너인데 직접 정산을 하고 싶어요.
A. 개인 파트너(allowDirectInvoice=false)는 직접 정산(DIRECT_INVOICE)을 선택할 수 없습니다. 사업자등록을 완료하고 사업자 유형을 변경하시면 직접 정산 옵션을 사용할 수 있습니다. 사업자 유형 변경은 설정 > 내 회사에서 가능합니다.