공통 준비사항
모든 연동 방식에 공통으로 필요한 사항입니다. 상세 내용은 개요를 참고하세요.API 키 발급
PlayCamp 플랫폼에서 프로젝트 생성 후 Server Key를 발급받습니다.
| 환경 | URL |
|---|---|
| Sandbox | https://sandbox-sdk-api.playcamp.io |
| Live | https://sdk-api.playcamp.io |
웹훅 URL 등록
PlayCamp에서 이벤트 발생 시 게임 서버로 알림을 받을 웹훅 URL을 등록합니다. 웹훅 이벤트 페이지를 참고하세요.
연동 방식 선택
WebView + 웹훅
PlayCamp가 제공하는 WebView UI를 사용하여 빠르게 연동합니다. 별도 UI 개발이 필요 없어 가장 빠른 방식입니다.적합한 경우: 빠르게 크리에이터 부스트를 제공하고 싶을 때
Server API 직접 연동
게임 자체 UI로 크리에이터 선택/부스트를 구현합니다. 게임 UX에 완벽히 맞출 수 있습니다.적합한 경우: 크리에이터 선택 UI를 게임 스타일로 직접 구현하고 싶을 때
Partner Gateway 연동
Partner Gateway가 인증, 웹훅 변환, 결제 동기화를 중계합니다. 기존 시스템 변경을 최소화할 수 있습니다.적합한 경우: 기존 API 규격을 유지하면서 연동하고 싶을 때 (사전 협의 필요)
두 방식은 동시에 사용할 수 있습니다. 예를 들어 부스트는 WebView로, 결제 등록은 Server API로 처리할 수 있습니다.
FAQ
게임 내 PlayCamp 진입 아이콘은 어떻게 하나요?
게임 내 PlayCamp 진입점(아이콘/버튼)은 게임사에서 자유롭게 디자인할 수 있습니다. 별도의 크기/위치 가이드라인은 없으며, 게임 UI에 자연스러운 위치에 배치하시면 됩니다. 공식 에셋이 필요한 경우 PlayCamp 담당자에게 문의하세요.Sandbox에서 먼저 테스트할 수 있나요?
네. 모든 API는 Sandbox 환경(https://sandbox-sdk-api.playcamp.io)에서 먼저 테스트할 수 있습니다. Sandbox는 Live와 완전히 격리되어 있습니다. 또한 isTest: true 파라미터를 사용하면 실제 데이터 없이 연동 검증이 가능합니다. 테스트 모드를 참고하세요.
캠페인이 여러 개인 경우 어떻게 하나요?
한 게임에서 여러 캠페인을 운영하는 경우, API 호출 시campaignId를 명시하여 캠페인을 구분해야 합니다. campaignId를 지정하지 않으면 현재 활성화된 캠페인으로 자동 귀속됩니다.