이 방식이 적합한 경우
- 크리에이터 선택 UI를 게임 스타일로 직접 구현하고 싶을 때
- 게임 UX 흐름에 자연스럽게 통합하고 싶을 때
- 부스트 등록/해제 타이밍을 게임 로직으로 제어하고 싶을 때
전체 흐름
게임사 개발 작업
| # | 작업 | 담당 | 설명 |
|---|---|---|---|
| 1 | 크리에이터 검색/선택 UI | 게임 클라이언트 | 크리에이터 목록, 검색, 선택 화면 |
| 2 | 크리에이터 조회 API 연동 | 게임 서버 | 크리에이터/캠페인 데이터 조회 |
| 3 | 부스트 등록 API 연동 | 게임 서버 | 유저-크리에이터 매칭 |
| 4 | 결제 등록 API 연동 | 게임 서버 | 인게임 결제 발생 시 전송 |
| 5 | (선택) 웹훅 수신 | 게임 서버 | 외부 변경사항 수신 |
Step 1: 크리에이터 조회 (게임 서버)
게임 서버에서 크리에이터 정보를 조회하여 게임 클라이언트에 표시합니다.크리에이터 검색
- cURL
- Node SDK
- Go SDK
캠페인 크리에이터 목록
특정 캠페인에 참여 중인 크리에이터만 조회할 수도 있습니다.- cURL
- Node SDK
- Go SDK
상세: API 레퍼런스 - 조회 엔드포인트
Step 2: 부스트 등록 (게임 서버)
유저가 크리에이터를 선택하면 게임 서버에서 부스트를 등록합니다.- cURL
- Node SDK
- Go SDK
부스트 변경 규칙
POST /sponsors는 upsert 방식으로 동작합니다:
| 현재 상태 | 동작 |
|---|---|
| 부스트 없음 | 신규 생성 |
| 같은 크리에이터 부스트 중 | 현재 상태 반환 |
| 다른 크리에이터 부스트 중 | 30일 쿨다운 후 변경 |
| 부스트 종료됨 | 다시 활성화 |
상세: 크리에이터 부스트
Step 3: 결제 등록 (게임 서버)
인게임 결제가 발생하면 PlayCamp로 결제 정보를 전송합니다. 부스트 중인 크리에이터에게 자동 귀속됩니다.- cURL
- Node SDK
- Go SDK
상세: 결제 등록
Step 4: (선택) 웹훅 수신
Server API 직접 연동 방식에서는 부스트 등록/해제를 게임 서버가 직접 호출하므로, 결과를 이미 알고 있습니다. 하지만 다음 경우에 웹훅이 유용합니다:- PlayCamp 관리자가 부스트를 수동 변경한 경우
- 결제 등록 결과를 비동기로 확인하고 싶은 경우
- 쿠폰 사용 이벤트를 수신하고 싶은 경우
상세: 웹훅 이벤트
Step 5: 정산
결제 데이터를 기반으로 월 단위 정산이 진행됩니다.- 매출 마감 — 매월 말 기준으로 결제 데이터 집계
- 매출 대사 — PlayCamp에서 제공하는 정산 내역과 게임사 내부 데이터 대사
- 정산 입금 — 대사 확인 후 정산 금액 입금
- 크리에이터 정산 — PlayCamp가 크리에이터에게 수익 분배
상세: 정산