---
title: "인앱 SKU 연동"
site: "Game8 Store – Developer Center"
lang: "ko"
category: "기능"
canonical: "https://developers.store.game8.jp/ko/store-linkage/"
---

# 인앱 SKU 연동

📝 본 페이지는 참고용 번역(한국어)입니다. 일본어 원본과 차이가 있는 경우 일본어판을 우선합니다.

인앱 SKU 연동은 Apple App Store Connect / Google Play Console에 등록된 인앱 결제(IAP) 정보를 공식 API를 통해 Game8 Store로 가져와, Game8 Store의 판매 상품으로 게시・관리할 수 있는 기능입니다.

아이템을 하나씩 수동으로 입력할 필요 없이, 가져온 상품 데이터는 대시보드에서 개별적으로 편집하여 가격이나 증량 수 등을 Game8 Store에 맞게 조정해 판매할 수 있습니다.

> 본 기능은 관리 화면의 **「인앱 SKU 취득(In-app SKU Import)」** 과 **「인앱 SKU 목록(In-app SKU Catalog)」** 의 두 화면에서 조작합니다.

## 본 기능으로 할 수 있는 것

- **간편한 상품 등록**: 인증 정보를 한 번만 설정하면 Apple / Google의 IAP 정보를 한꺼번에 가져올 수 있습니다.
- **유연한 상품 운영**: 가져온 상품은 대시보드에서 개별적으로 편집할 수 있습니다.가격 조정, 게재 여부 선택 등 상품별로 운영을 조정할 수 있습니다.
- **대상 플랫폼**: Apple App Store Connect / Google Play Console

### 제공 범위에 대하여

본 기능은 단계적으로 제공됩니다.

| 제공 시기 | 내용 |
| --- | --- |
| 출시 초기 | Apple / Google에 등록된 IAP 정보(상품 ID·가격·명칭 등)를 대시보드로 가져올 수 있습니다. 가져온 상품은 대시보드에서 개별적으로 편집할 수 있으며, 게재 상태(공개 중·비공개) 전환도 가능합니다. |
| 향후 구현 예정 | Apple / Google 측에서 아이템을 추가·갱신했을 때 Game8 Store에 자동 반영하는 구조를 구현할 예정입니다. 최종적으로는 Apple / Google을 정본으로 삼고, Game8 Store 측은 유지보수 없이 자동으로 따라가는 형태를 목표로 하고 있습니다. |

## 이용 흐름

1. **사전 준비**: Apple / Google 각 콘솔에서 연동용 인증 정보를 취득합니다(다음 장 참조).
2. **접속 등록**: 「인앱 SKU 취득(In-app SKU Import)」 화면에서 신규 접속을 생성하고 인증 정보를 등록합니다.
3. **동기화 실행**: 등록한 접속으로 「동기화 실행」을 수행하여 Apple / Google에서 IAP 정보를 가져옵니다.
4. **상품 게재**: 「인앱 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 |

> .p8 파일 다운로드는**발급 시 1회만**가능합니다. 다운로드한 파일은 소중히 보관해 주세요.

### 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을 입력합니다. |

> 접속명(Connection Name), Bundle ID / Package Name, 인증 정보(Credentials)는 모두 필수 항목입니다. 인증 정보를 로테이션(갱신)하는 경우에는 접속의 「편집(Edit)」에서 다시 입력해 주세요.

### 동기화 실행

목록의 「동기화 실행」을 누르면 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의 최신 상품명·판매 가격을 가져와 게재 중인 상품에 반영합니다. 썸네일 등 이미 편집한 항목은 유지됩니다. |

> 「최신으로 갱신(Reimport)」에 의한 가격 자동 반영은**일본 엔(JPY)만**지원합니다. USD 등 JPY 이외 통화의 아이템은 상품명만 갱신되며 가격은 반영되지 않습니다. 엔으로 환산한 가격은 수동으로 확인·입력해 주세요.

### 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」 배지가 붙은 카테고리는 모든 게임 공통입니다. 신규 카테고리 작성도 가능합니다. |

> PF 통화가 JPY 이외인 경우 판매 가격의 초기값은 0엔이 됩니다. 수동으로 엔 환산한 가격을 반드시 입력해 주세요.

## 유의 사항

- **지원 통화**: 가격의 자동 취득·자동 갱신은 일본 엔(JPY)만 지원합니다. 그 외 통화는 상품명만 반영됩니다.
- **동기화 소요 시간**: 동기화는 아이템 건수에 따라 수십 초에서 수 분 정도 걸릴 수 있습니다. 처리 중에 접속이 끊기더라도 백엔드에서는 처리가 계속 진행되고 있는 경우가 있습니다. 잠시 기다린 후 목록을 다시 불러와 확인해 주세요.
- **권한에 대하여**: 열람 전용 권한의 계정에서는 접속 등록·편집·삭제, 동기화 실행, 게재 등의 조작을 수행할 수 없습니다(목록 열람은 가능합니다).
- **인증 정보에 대하여**: 연동에 필요한 권한은 열람 전용(읽기 전용)뿐입니다. 쓰기 권한은 부여하지 마세요.

> 궁금하신 점은[파트너 문의 양식（Partner Inquiry）](https://developers.store.game8.jp/ko/inquiry/)을 통해 연락해 주세요.