메인 콘텐츠로 건너뛰기
게임 내 자체 UI로 크리에이터 검색/선택/부스트를 구현하고, Server API를 직접 호출하는 방식입니다. 게임 UX에 완벽히 맞출 수 있지만 UI 개발이 필요합니다.

이 방식이 적합한 경우

  • 크리에이터 선택 UI를 게임 스타일로 직접 구현하고 싶을 때
  • 게임 UX 흐름에 자연스럽게 통합하고 싶을 때
  • 부스트 등록/해제 타이밍을 게임 로직으로 제어하고 싶을 때

전체 흐름

게임사 개발 작업

#작업담당설명
1크리에이터 검색/선택 UI게임 클라이언트크리에이터 목록, 검색, 선택 화면
2크리에이터 조회 API 연동게임 서버크리에이터/캠페인 데이터 조회
3부스트 등록 API 연동게임 서버유저-크리에이터 매칭
4결제 등록 API 연동게임 서버인게임 결제 발생 시 전송
5(선택) 웹훅 수신게임 서버외부 변경사항 수신

Step 1: 크리에이터 조회 (게임 서버)

게임 서버에서 크리에이터 정보를 조회하여 게임 클라이언트에 표시합니다.

크리에이터 검색

# 키워드로 검색
curl "https://sandbox-sdk-api.playcamp.io/v1/server/creators/search?q=크리에이터이름" \
  -H "Authorization: Bearer ak_server_xxx:secret"

# 특정 크리에이터 상세 조회
curl "https://sandbox-sdk-api.playcamp.io/v1/server/creators/ABC12" \
  -H "Authorization: Bearer ak_server_xxx:secret"

캠페인 크리에이터 목록

특정 캠페인에 참여 중인 크리에이터만 조회할 수도 있습니다.
curl "https://sandbox-sdk-api.playcamp.io/v1/server/campaigns/campaign_001" \
  -H "Authorization: Bearer ak_server_xxx:secret"
상세: API 레퍼런스 - 조회 엔드포인트

Step 2: 부스트 등록 (게임 서버)

유저가 크리에이터를 선택하면 게임 서버에서 부스트를 등록합니다.
curl -X POST "https://sandbox-sdk-api.playcamp.io/v1/server/sponsors" \
  -H "Authorization: Bearer ak_server_xxx:secret" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "게임_유저_고유번호",
    "creatorKey": "ABC12"
  }'
응답
{
  "data": {
    "userId": "게임_유저_고유번호",
    "campaignId": "campaign_001",
    "creatorKey": "ABC12",
    "isActive": true,
    "sponsoredAt": "2024-01-15T10:30:00.000Z"
  }
}

부스트 변경 규칙

POST /sponsors는 upsert 방식으로 동작합니다:
현재 상태동작
부스트 없음신규 생성
같은 크리에이터 부스트 중현재 상태 반환
다른 크리에이터 부스트 중30일 쿨다운 후 변경
부스트 종료됨다시 활성화
상세: 크리에이터 부스트

Step 3: 결제 등록 (게임 서버)

인게임 결제가 발생하면 PlayCamp로 결제 정보를 전송합니다. 부스트 중인 크리에이터에게 자동 귀속됩니다.
curl -X POST "https://sandbox-sdk-api.playcamp.io/v1/server/payments" \
  -H "Authorization: Bearer ak_server_xxx:secret" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "게임_유저_고유번호",
    "transactionId": "txn_abc123",
    "productId": "gem_pack_100",
    "productName": "100 보석 팩",
    "amount": 9900,
    "currency": "KRW",
    "platform": "Android",
    "distributionType": "MOBILE_STORE",
    "purchasedAt": "2024-01-15T10:30:00.000Z"
  }'
상세: 결제 등록

Step 4: (선택) 웹훅 수신

Server API 직접 연동 방식에서는 부스트 등록/해제를 게임 서버가 직접 호출하므로, 결과를 이미 알고 있습니다. 하지만 다음 경우에 웹훅이 유용합니다:
  • PlayCamp 관리자가 부스트를 수동 변경한 경우
  • 결제 등록 결과를 비동기로 확인하고 싶은 경우
  • 쿠폰 사용 이벤트를 수신하고 싶은 경우
상세: 웹훅 이벤트

Step 5: 정산

결제 데이터를 기반으로 월 단위 정산이 진행됩니다.
  1. 매출 마감 — 매월 말 기준으로 결제 데이터 집계
  2. 매출 대사 — PlayCamp에서 제공하는 정산 내역과 게임사 내부 데이터 대사
  3. 정산 입금 — 대사 확인 후 정산 금액 입금
  4. 크리에이터 정산 — PlayCamp가 크리에이터에게 수익 분배
상세: 정산