홈 › 기능
인앱 SKU 연동
📝 본 페이지는 참고용 번역(한국어)입니다. 일본어 원본과 차이가 있는 경우 일본어판을 우선합니다.
인앱 SKU 연동은 Apple App Store Connect / Google Play Console에 등록된 인앱 결제(IAP) 정보를 공식 API를 통해 Game8 Store로 가져와, Game8 Store의 판매 상품으로 게시・관리할 수 있는 기능입니다.
아이템을 하나씩 수동으로 입력할 필요 없이, 가져온 상품 데이터는 대시보드에서 개별적으로 편집하여 가격이나 증량 수 등을 Game8 Store에 맞게 조정해 판매할 수 있습니다.
본 기능으로 할 수 있는 것
- 간편한 상품 등록: 인증 정보를 한 번만 설정하면 Apple / Google의 IAP 정보를 한꺼번에 가져올 수 있습니다.
- 유연한 상품 운영: 가져온 상품은 대시보드에서 개별적으로 편집할 수 있습니다.가격 조정, 게재 여부 선택 등 상품별로 운영을 조정할 수 있습니다.
- 대상 플랫폼: Apple App Store Connect / Google Play Console
제공 범위에 대하여
본 기능은 단계적으로 제공됩니다.
| 제공 시기 | 내용 |
|---|---|
| 출시 초기 | Apple / Google에 등록된 IAP 정보(상품 ID·가격·명칭 등)를 대시보드로 가져올 수 있습니다. 가져온 상품은 대시보드에서 개별적으로 편집할 수 있으며, 게재 상태(공개 중·비공개) 전환도 가능합니다. |
| 향후 구현 예정 | Apple / Google 측에서 아이템을 추가·갱신했을 때 Game8 Store에 자동 반영하는 구조를 구현할 예정입니다. 최종적으로는 Apple / Google을 정본으로 삼고, Game8 Store 측은 유지보수 없이 자동으로 따라가는 형태를 목표로 하고 있습니다. |
이용 흐름
- 사전 준비: Apple / Google 각 콘솔에서 연동용 인증 정보를 취득합니다(다음 장 참조).
- 접속 등록: 「인앱 SKU 취득(In-app SKU Import)」 화면에서 신규 접속을 생성하고 인증 정보를 등록합니다.
- 동기화 실행: 등록한 접속으로 「동기화 실행」을 수행하여 Apple / Google에서 IAP 정보를 가져옵니다.
- 상품 게재: 「인앱 SKU 목록(In-app SKU Catalog)」 화면에서 가져온 아이템을 편집하여 Game8 Store의 상품으로 게재합니다. 「인앱 SKU 취득(In-app SKU Import)」 화면 오른쪽 상단의 【카탈로그 보기(View Catalog)】에서도 이동할 수 있습니다.
사전에 준비하실 것
연동 설정에는 각 플랫폼에서 발급한 인증 정보가 필요합니다.
Apple App Store Connect의 경우
| 항목 | 내용 | 취득·확인 위치 |
|---|---|---|
| API 키(.p8 파일) | Apple App Store Connect에서 발급하는 API 키입니다. 권한은 최소 권한인 「Read Only」를 선택해 주세요. | Users and Access → Integrations → App Store Connect API → 「＋」 버튼으로 발급 |
| Key ID | .p8 파일과 함께 표시되는 10자리 영숫자입니다. | API 키 발급 화면(위와 동일) |
| Issuer ID | 팀 공통 UUID입니다. | API 키 발급 화면 상단 |
| Bundle ID | 대상 앱의 Bundle ID입니다(신규 발급 불필요). | 해당 앱 → App Information |
Google Play Developer의 경우
| 항목 | 내용 | 취득·확인 위치 |
|---|---|---|
| Service Account JSON 키 | Google Cloud에서 생성한 서비스 계정의 JSON 키입니다. | Google Cloud Console → IAM 및 관리자 → 서비스 계정 → 키 탭에서 JSON 다운로드 |
| Package Name | 대상 앱의 Package Name입니다(신규 발급 불필요). | Google Play Console → 해당 앱 → 대시보드 |
아울러 아래 설정도 진행해 주세요.
- Google Play Developer API 활성화: 해당 GCP 프로젝트에서 「Google Play Android Developer API」가 enabled 상태인지 확인해 주세요.
- Play Console에서의 권한 부여: Google Play Console의 「사용자 및 권한」에서 위 서비스 계정의 이메일 주소를 초대하고,「앱 정보 보기」만을 부여해 주세요(쓰기 권한은 필요하지 않습니다).
인앱 SKU 취득(In-app SKU Import): 연동 접속 관리
Apple / Google과의 연동 접속을 등록하고 IAP 정보를 취득(동기화)하는 화면입니다.
주요 기능과 할 수 있는 것
- 연동 접속 관리 ◦ Apple / Google과의 접속을 신규 생성·편집·삭제할 수 있습니다.
- 동기화 실행 ◦ 등록한 접속에서 최신 IAP 정보를 가져옵니다.
- 동기화 상태 확인 ◦ 각 접속의 동기화 상태를 목록에서 확인할 수 있습니다.
화면 항목 설명(목록)
| 항목 | 설명 |
|---|---|
| 이름 (Name) | 접속을 식별하기 위한 명칭입니다. 등록 시 설정한 이름이 표시됩니다. |
| PF 종류 (Platform) | 접속 대상 플랫폼(Apple / Google)이 표시됩니다. |
| 앱 ID (App ID) | Apple은 Bundle ID, Google은 Package Name이 표시됩니다. |
| 인증 정보 (Credentials) | 인증 정보의 등록 상태를 「설정 완료」 「미설정」으로 표시합니다. |
| 동기화 상태 (Sync Status) | 동기화 상태를 표시합니다. 「대기 중」 「동기화 중」 「성공」 「오류」 중 하나입니다. |
| 조작 (Actions) | 「동기화 실행」 「편집」 「삭제」를 수행할 수 있습니다. |
신규 접속 등록
목록 우측 상단의 「＋ 신규 접속」에서 연동 접속을 등록합니다. 입력 항목은 다음과 같습니다.
| 항목 | 설명 |
|---|---|
| 접속명 (Connection Name) | 접속을 식별하기 위한 임의의 명칭을 입력합니다(예: iOS 프로덕션 환경). |
| PF 종류 (Platform) | 연동 대상 플랫폼(Apple App Store Connect / Google Play Developer)을 선택합니다. |
| Bundle ID / Package Name | 선택한 플랫폼에 따라 Apple은 Bundle ID, Google은 Package Name을 입력합니다. |
| 인증 정보 (Credentials) | Apple은 Key ID / Issuer ID / Private Key(.p8), Google은 Service Account JSON을 입력합니다. |
동기화 실행
목록의 「동기화 실행」을 누르면 Apple / Google에서 최신 IAP 정보를 취득합니다. 취득한 아이템은 「인앱 SKU 목록(In-app SKU Catalog)」 화면에 반영됩니다.
인앱 SKU 목록(In-app SKU Catalog): 가져온 상품 관리
Apple / Google에서 가져온 아이템 목록을 확인하고 Game8 Store의 상품으로 게재·관리하는 화면입니다.
주요 기능과 할 수 있는 것
- 가져온 아이템 열람 ◦ 동기화로 취득한 아이템을 목록으로 확인할 수 있습니다.
- 필터 기능 ◦ 「전체」 「게재 완료」 「미게재」로 필터링할 수 있습니다.
- Game8 Store에 게재 ◦ 미게재 아이템을 편집하여 Game8 Store의 상품으로 등록할 수 있습니다.
- 게재 상태 관리 ◦ 게재 중지·재공개·최신 값으로 재취득을 수행할 수 있습니다.
화면 항목 설명(목록)
| 항목 | 설명 |
|---|---|
| PF 종류 (Platform) | 아이템의 취득 출처 플랫폼(Apple / Google)이 배지로 표시됩니다. |
| 상품명 (Name) | Apple / Google에서 취득한 아이템 이름입니다. 게재 완료된 경우에는 Game8 Store의 상품 편집 화면으로 연결되는 링크가 됩니다. |
| PF 상품 ID (Platform Item ID) | Apple / Google 측에서 관리되는 상품 ID(프로덕트 ID)입니다. |
| 가격 (Price) | Apple / Google에서 취득한 가격입니다. |
| 게재 상태 (Status) | Game8 Store에서의 게재 상태를 표시합니다. 「미게재」 「공개 중」 「비공개」 중 하나입니다. |
| 최종 취득 (Last Fetched) | 해당 아이템을 마지막으로 취득한 일시입니다. |
| 조작 (Actions) | 게재 상태에 따라 「편집(Edit)」「게재 중지(Unpublish)」「공개(Publish)」「최신으로 갱신(Reimport)」을 실행할 수 있습니다. |
게재 상태에 대하여
| 상태 | 설명 |
|---|---|
| 미게재 (Not Published) | 가져오기는 완료되었으나 아직 Game8 Store의 상품으로 등록되지 않은 상태입니다. |
| 공개 중 (Live) | Game8 Store의 상품으로 등록되어 판매 중(표시·구매 가능)인 상태입니다. |
| 비공개 (Hidden) | Game8 Store의 상품으로 등록되어 있으나 판매를 중지한 상태입니다. |
각 조작에 대하여
| 조작 (Actions) | 설명 |
|---|---|
| 편집 (Edit) | 미게재 아이템을 편집하여 Game8 Store의 상품으로 등록(게재)합니다. 「Publish to Game8 Store」 화면이 열립니다. |
| 게재 중지 (Unpublish) | 공개 중인 상품의 판매를 중지하고 「비공개」로 전환합니다. 상품 데이터는 삭제되지 않습니다. |
| 공개 (Publish) | 비공개 상품을 다시 「공개 중」으로 전환합니다. |
| 최신으로 갱신 (Reimport) | Apple / Google의 최신 상품명·판매 가격을 가져와 게재 중인 상품에 반영합니다. 썸네일 등 이미 편집한 항목은 유지됩니다. |
Game8 Store에 게재 (Publish to Game8 Store・게재 편집 화면)
「편집(Edit)」을 누르면 「Publish to Game8 Store」 화면이 열립니다. 화면 상단의 「Source info from Apple / Google」에 PF 상품 ID (Platform Item ID) / PF 상품명 (PF Name) / PF 가격 (PF Price) 이 표시되며, 그 내용을 참고하여 Game8 Store의 상품 정보를 입력합니다.
입력 항목은 아이템 관리의 신규 작성(New Item)과 동일한 구성입니다(기본 정보 / 가격 설정 / 구매 상한·재고 / 구매 제한 인터벌 / 공개·스케줄 / 카테고리 / 태그 / 보너스 아이템 / 번들 아이템). 이 중 표시명, 상품 ID, 판매 가격에는 취득한 값이 초기값으로 들어갑니다.
입력 후 화면 하단의 「Publish to Game8 Store」를 누르면 게재됩니다.
| 항목 | 설명 |
|---|---|
| 표시명 (Display Name) | Game8 Store에서 표시할 상품명입니다(필수). 초기값에는 취득한 상품명이 입력됩니다. |
| 상품 ID (Item ID) | API 연동에 사용하는 ID입니다. 초기값으로 PF 상품 ID가 들어갑니다. |
| 썸네일 (Thumbnail) | 상품의 썸네일 이미지입니다(필수). |
| 판매 가격 (Sales Price) | Game8 Store에서의 판매 가격(엔)입니다(필수). JPY 아이템은 취득 가격이 초기값으로 입력됩니다. |
| 카테고리 (Category) | 상품을 분류할 카테고리를 선택합니다. 「Global」 배지가 붙은 카테고리는 모든 게임 공통입니다. 신규 카테고리 작성도 가능합니다. |
유의 사항
- 지원 통화: 가격의 자동 취득·자동 갱신은 일본 엔(JPY)만 지원합니다. 그 외 통화는 상품명만 반영됩니다.
- 동기화 소요 시간: 동기화는 아이템 건수에 따라 수십 초에서 수 분 정도 걸릴 수 있습니다. 처리 중에 접속이 끊기더라도 백엔드에서는 처리가 계속 진행되고 있는 경우가 있습니다. 잠시 기다린 후 목록을 다시 불러와 확인해 주세요.
- 권한에 대하여: 열람 전용 권한의 계정에서는 접속 등록·편집·삭제, 동기화 실행, 게재 등의 조작을 수행할 수 없습니다(목록 열람은 가능합니다).
- 인증 정보에 대하여: 연동에 필요한 권한은 열람 전용(읽기 전용)뿐입니다. 쓰기 권한은 부여하지 마세요.