화면 모드
게임 등록과 키
게임 등록 요청
웹젠케이 운영 담당자에게 게임 등록을 요청하면 세 가지 키를 받아요.
| 키 | 어디에 쓰나요 | 넣는 곳 |
|---|---|---|
| App Key | 게임 식별 | 앱·웹 (공개돼도 괜찮아요) |
| App Secret | 앱 요청 서명 | 모바일·PC 앱 (웹에는 넣지 않아요) |
| Server Secret | 개발사 서버 요청 서명 | 개발사 서버에만 |
Server Secret은 절대 앱·웹에 넣지 마세요
Server Secret이 있으면 지표·결제 내역 조회와 유저 제재를 할 수 있어요. 개발사 서버에서만 쓰고, 저장소에 커밋하지 마세요.
Secret은 등록할 때 한 번만 전달돼요. 비밀번호 관리 도구에 보관하세요. 잃어버렸거나 유출됐다면 운영 담당자에게 재발급을 요청하세요. 재발급하면 기존 값은 즉시 쓸 수 없게 되니, App Secret은 앱 업데이트 일정과 맞춰서 요청하는 게 좋아요.
쓰는 기능의 연동 정보 전달
쓰려는 기능에 맞춰 아래 정보를 운영 담당자에게 전달하면 서버에 등록해 드려요.
| 기능 | 전달할 정보 |
|---|---|
| Google 로그인 | OAuth 클라이언트 ID 전부 (Android·iOS·Web). Play Games를 쓰면 서버용 클라이언트 ID·Secret |
| Apple 로그인 | 번들 ID (웹 로그인은 Services ID도) |
| Google Play 결제 | 패키지명, 서비스 계정 JSON 키 — Play Console → 사용자 및 권한에서 재무 데이터 보기·주문 관리 권한 |
| App Store 결제 | 번들 ID, Issuer ID, Key ID, 앱 내 구입 키(.p8) |
| AppLovin MAX 보상 | MAX 대시보드의 S2S 보상 이벤트 키 |
| HTML5 (웹) | 게임이 열리는 주소(허용 도메인). 예: https://game.example.com, https://*.example.com |
| 삼성 Instant Plays | 삼성 파트너십 담당자에게 받은 로그인 서명 공개키, 결제 Seller key |
등록이 끝나면 운영 담당자가 스토어·광고사 콘솔에 넣을 주소를 알려 드려요.
| 넣을 곳 | 주소 |
|---|---|
| Google Play 실시간 개발자 알림 (Pub/Sub 푸시) | https://game-api.webzenk.kr/v1/webhooks/google |
| App Store 서버 알림 V2 (운영·샌드박스) | https://game-api.webzenk.kr/v1/webhooks/apple |
| AppLovin MAX Server Side Callback | 게임별 주소 — 보상형 광고 참고 |