> ## Documentation Index
> Fetch the complete documentation index at: https://playcamp.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 연동 사례 가이드

> 게임사 연동 패턴별 실전 가이드

실제 게임사의 연동 사례를 바탕으로, 연동 방식별 전체 흐름과 개발 작업을 안내합니다.

## 공통 준비사항

모든 연동 방식에 공통으로 필요한 사항입니다. 상세 내용은 [개요](/ko/guides/developers/game-integration/overview)를 참고하세요.

<Steps>
  <Step title="API 키 발급">
    PlayCamp 플랫폼에서 프로젝트 생성 후 **Server Key**를 발급받습니다.

    | 환경          | URL                                   |
    | ----------- | ------------------------------------- |
    | **Sandbox** | `https://sandbox-sdk-api.playcamp.io` |
    | **Live**    | `https://sdk-api.playcamp.io`         |
  </Step>

  <Step title="웹훅 URL 등록">
    PlayCamp에서 이벤트 발생 시 게임 서버로 알림을 받을 웹훅 URL을 등록합니다. [웹훅 이벤트](/ko/guides/developers/game-integration/webhook) 페이지를 참고하세요.
  </Step>

  <Step title="연동 검증">
    캠페인 게시를 위해 필수 API 3개(`POST /sponsors`, `POST /coupons/validate`, `POST /payments`)를 각각 **Live** 환경에서 최소 1번 호출해야 합니다. `isTest: true`로 호출해도 검증이 인정됩니다.
  </Step>
</Steps>

## 연동 방식 선택

<CardGroup cols={2}>
  <Card title="WebView + 웹훅" icon="browser" href="/ko/guides/developers/game-integration/cases/webview-webhook">
    PlayCamp가 제공하는 WebView UI를 사용하여 빠르게 연동합니다. 별도 UI 개발이 필요 없어 가장 빠른 방식입니다.

    **적합한 경우**: 빠르게 크리에이터 부스트를 제공하고 싶을 때
  </Card>

  <Card title="Server API 직접 연동" icon="code" href="/ko/guides/developers/game-integration/cases/server-api-direct">
    게임 자체 UI로 크리에이터 선택/부스트를 구현합니다. 게임 UX에 완벽히 맞출 수 있습니다.

    **적합한 경우**: 크리에이터 선택 UI를 게임 스타일로 직접 구현하고 싶을 때
  </Card>

  <Card title="Partner Gateway 연동" icon="rotate" href="/ko/guides/developers/game-integration/cases/partner-gateway">
    Partner Gateway가 인증, 웹훅 변환, 결제 동기화를 중계합니다. 기존 시스템 변경을 최소화할 수 있습니다.

    **적합한 경우**: 기존 API 규격을 유지하면서 연동하고 싶을 때 (사전 협의 필요)
  </Card>
</CardGroup>

<Info>
  두 방식은 동시에 사용할 수 있습니다. 예를 들어 부스트는 WebView로, 결제 등록은 Server API로 처리할 수 있습니다.
</Info>

## FAQ

### 게임 내 PlayCamp 진입 아이콘은 어떻게 하나요?

게임 내 PlayCamp 진입점(아이콘/버튼)은 게임사에서 자유롭게 디자인할 수 있습니다. 별도의 크기/위치 가이드라인은 없으며, 게임 UI에 자연스러운 위치에 배치하시면 됩니다. 공식 에셋이 필요한 경우 PlayCamp 담당자에게 문의하세요.

### Sandbox에서 먼저 테스트할 수 있나요?

네. 모든 API는 Sandbox 환경(`https://sandbox-sdk-api.playcamp.io`)에서 먼저 테스트할 수 있습니다. Sandbox는 Live와 완전히 격리되어 있습니다. 또한 `isTest: true` 파라미터를 사용하면 실제 데이터 없이 연동 검증이 가능합니다. [테스트 모드](/ko/guides/developers/game-integration/test-mode)를 참고하세요.

### 캠페인이 여러 개인 경우 어떻게 하나요?

한 게임에서 여러 캠페인을 운영하는 경우, API 호출 시 `campaignId`를 명시하여 캠페인을 구분해야 합니다. `campaignId`를 지정하지 않으면 현재 활성화된 캠페인으로 자동 귀속됩니다.