IAP 상품 구현
Unity는 UDP 콘솔에서 IAP 상품을 추가하고 관리할 것을 권장합니다. UDP 콘솔의 IAP 카탈로그는 스토어의 백엔드 시스템에 제출되는 요소의 진실 공급원(Source of Truth)입니다. 또한 UDP 콘솔을 사용하여 다음을 수행할 수 있습니다.
- 여러 개의 IAP 가격 및 통화 관리
- 여러 언어로 된 설명 추가
- CSV 파일을 통해 아이템을 대량으로 업로드(여러 개의 통화 및 언어 지원)
참고: UDP 패키지만 사용하는 경우에도 Unity 에디터에서 IAP 아이템을 하나 이상 생성하여 UDP 콘솔과 올바르게 동기화되는지 테스트해야 합니다. Unity IAP 패키지(코드리스 구현)를 사용하는 경우 Unity 에디터에서 각 IAP 아이템을 추가한 후 모두 UDP 콘솔에 업로드해야 합니다. Unity IAP 패키지를 사용 중이고 코드로 IAP를 구현한 경우 UDP 콘솔에서 IAP 아이템을 생성하십시오.
게임 클라이언트에 IAP 카탈로그를 유지하는 경우 UDP는 Unity 에디터와 UDP 콘솔 간에 동기화된 상태를 유지합니다.
UDP 콘솔에서 인앱 구매 관리
UDP 콘솔에서 My Games 페이지를 통해 게임으로 이동합니다. Game Info 페이지에서 EDIT INFO 버튼을 선택하여 편집 모드를 시작합니다. 변경 사항을 저장하려면 SAVE를 선택합니다. 변경 사항을 폐기하려면 CANCEL을 선택합니다. 이 섹션에서는 UDP 콘솔에서 IAP 상품을 편집, 생성 및 삭제하는 방법을 설명합니다.
새 IAP 아이템 생성
UDP 콘솔에서 새 IAP 아이템을 생성하려면 다음 단계를 따르십시오.
- Game Information 페이지에서 EDIT INFO를 선택합니다.
- Add Item을 선택하여 새 아이템을 생성합니다.
-
상품 정보를 지정하고 저장합니다.
- 앱 스토어에 유효하도록 상품 ID에 대한 요구 사항을 준수합니다.
- 게임에서 정의한 IAP 상품이 IAP 카탈로그에 설정된 것과 동일한 Product ID를 사용하는지 확인합니다.
-
Manage amounts and currencies를 선택하여 다음을 수행합니다.
- IAP 가격을 USD에서 외국 통화로 변환합니다.
- 이 통화로 된 가격을 조정합니다.
- SAVE를 선택하여 변경 사항을 저장합니다.
참고: 생성할 IAP 아이템이 많은 경우 일괄 IAP 임포트 기능을 사용하여 현지화된 설명, 여러 통화로 된 가격 등을 비롯하여 모든 IAP 아이템을 한 번에 생성하는 것을 고려하십시오.
UDP 패키지를 사용하는 경우 콘솔에 추가하는 모든 새 IAP 아이템은 Unity 프로젝트와 동기화됩니다. 새 IAP 아이템을 포함하기 위해 게임을 다시 빌드하지 않아도 됩니다.
IAP 설명 편집
IAP 설명을 편집하려면 다음 단계를 따르십시오.
- Game Information 페이지에서 EDIT INFO를 선택합니다.
- 드롭다운 언어 선택자를 통해 설명을 편집할 언어를 선택합니다.
- In-App Purchases 섹션에서 연필 아이콘을 선택하여 기존 IAP 아이템을 편집합니다.
- 다음과 같은 IAP 아이템 정보를 편집할 수 있습니다.
- Product Name - IAP 아이템의 이름
- Description - IAP 아이템에 대한 간략한 설명
- SAVE를 선택하여 변경 사항을 저장합니다.
참고: 위 단계는 선택한 언어에 대한 IAP 아이템 정보만 편집합니다. 지원할 IAP 아이템과 언어가 많은 경우 일괄 IAP 임포트를 사용하여 이러한 정보를 임포트하는 것이 좋습니다.
IAP 가격 및 통화 편집
- Game Information 페이지에서 EDIT INFO를 선택합니다.
-
Manage amounts and currencies를 선택하여 IAP 아이템에 대해 다음을 수행합니다.
- IAP 가격을 변경합니다.
- 가격을 USD에서 외국 통화로 변환합니다.
- 이 통화로 된 가격을 조정합니다.
- SAVE를 선택하여 변경 사항을 저장합니다.
힌트: 통화를 즐겨찾기 통화로 설정하려면 해당 통화 코드 옆의 별 아이콘을 선택하십시오. 그러면 해당 통화가 리스트 상단에 고정됩니다. 별 아이콘을 선택 해제하면 고정이 취소됩니다.
참고: 지원할 IAP 아이템과 통화가 많은 경우 Convert 기능을 사용하면 각 IAP 아이템에 대해 설정된 USD 금액에 기반하여 모든 IAP 가격을 글로벌 통화로 자동 변환할 수 있습니다. 이렇게 하면 이전에 설정된 모든 로컬 가격이 오버라이드됩니다.
또는 일괄 IAP 임포트 기능으로 이러한 모든 정보를 한 번에 임포트할 수도 있습니다.
IAP 아이템 삭제
- Game Information 페이지에서 EDIT INFO를 선택합니다.
- 휴지통 아이콘을 선택하여 IAP 아이템을 삭제합니다.
- SAVE를 선택하여 변경 사항을 저장합니다.
IAP 아이템을 일괄적으로 임포트
- Game Information 페이지에서 EDIT INFO를 선택합니다.
- In-App Purchases 패널의 오른쪽 상단에서 IMPORT CATALOG를 선택합니다.
이 기능에 대한 자세한 내용은 일괄 IAP 임포트를 참조하십시오. - SAVE를 선택하여 변경 사항을 저장합니다.
Google Play에서 게임 정보 임포트
Google Play에 게임을 이미 퍼블리시한 경우 게임의 Google Play URL을 사용하여 기본 정보를 임포트할 수 있습니다.
- Import from Google Play를 선택합니다.
- 게임의 Google Play URL을 입력 상자에 붙여넣습니다.
- 구체적으로 임포트할 언어를 지정하려면 언어 접미사가 포함된 Google Play URL을 사용합니다. 예를 들어 이탈리아어는
&hl=it를 사용합니다.
Google Play URL에 언어 접미사가 포함되지 않으면 UDP는 UDP 콘솔에서 현재 편집 중인 언어의 정보를 페치합니다(Google Play에 설정된 경우). - Import를 선택합니다.
- 경우에 따라 컴퓨터의 IP 주소가 제공되는 언어를 결정할 수 있으므로 결과를 다시 확인합니다.
일괄 IAP 임포트
IAP 아이템이 많은 경우 일괄 IAP 임포트 기능을 사용하면 IAP 카탈로그를 더욱 쉽게 관리할 수 있습니다. 또한 여러 통화로 된 가격, 여러 언어로 된 설명 등을 비롯한 모든 IAP 상품 세부 정보가 포함된 CSV 파일을 일반 UDP 포맷과 Google Play 포맷으로 UDP 콘솔에 업로드할 수 있습니다.
Unity는 샌드박스 환경에서 IAP 아이템을 구매할 수 있는지 확인하기 위한 테스트 목적으로 Unity 에디터에 IAP 아이템을 추가할 것을 권장합니다.
참고: CSV 파일에 여러 언어가 포함된 경우 지원 언어를 추가한 후 CSV 파일을 임포트하십시오.
이 섹션에서는 CSV를 통해 IAP 아이템을 일괄적으로 임포트하는 방법을 설명합니다.
구현 요구 사항
새 IAP 상품 추가
다음을 사용하여 UDP를 구현한 경우 일괄 IAP 임포트 기능만 사용하여 새 IAP 상품을 추가해야 합니다.
- UDP 패키지 사용
- Unity IAP 사용(코드 구현)
Unity는 샌드박스 환경에서 IAP 아이템을 구매할 수 있는지 확인하기 위한 테스트 목적으로 Unity 에디터에 IAP 아이템을 추가할 것을 권장합니다.
현지화된 설명 및 가격 추가
모든 구현 작업 시 일괄 IAP 임포트를 사용하여 더 많은 언어로 된 설명과 더 많은 통화로 된 가격을 기존 IAP 상품에 할당할 수 있습니다.
UDP 패키지 사용
일괄 IAP 임포트 기능을 사용하면 게임을 다시 빌드하지 않고도 게임의 IAP 카탈로그를 완전히 다시 정의할 수 있습니다.
제대로 작동하는 UDP 구현만 있으면 됩니다.
Unity IAP 사용(코드 구현)
Unity IAP를 사용하면 에디터에서 UDP 콘솔로만 IAP 카탈로그를 동기화할 수 있습니다.
일괄 IAP 업로드 기능을 통해 게임의 IAP 카탈로그를 UDP 콘솔에 업로드하는 경우 게임이 게임 클라이언트의 기본 IAP 카탈로그가 아니라 UDP 콘솔에서 IAP 상품 정보를 페치하도록 게임을 준비시켜야 합니다.
게임이 UDP 콘솔에서 IAP 카탈로그를 페치하도록 허용하려면 코드에서 IAP 상품 검색 메서드를 호출하지 마십시오.
자세한 내용은 IAP 인벤토리 쿼리를 참조하십시오.
CSV 템플릿 다운로드
UDP는 IAP 상품을 일괄적으로 임포트할 때 사용할 수 있는 CSV 템플릿을 제공합니다. 템플릿은 CSV 파일을 위한 일반 UDP 포맷입니다.
- Game Information 페이지에서 EDIT INFO를 선택합니다.
- In-App Purchases 패널로 이동합니다.
- IMPORT CATALOG를 선택합니다.
- Download Template을 선택합니다.
CSV 파일 채우기
CSV 파일은 쉼표(,)와 세미콜론(;)을 사용하여 데이터 값을 구분합니다. 쉼표는 기본 데이터 값을 구분하고 세미콜론은 하위 값을 구분합니다.
각 IAP 아이템은 CSV 파일 내에서 한 줄에 완전히 표시되어야 합니다.
제공된 템플릿의 정확한 포맷으로 데이터를 입력해야 합니다. 잘못된 가격 구문이나 언어 누락 등 오류가 포함된 파일을 업로드하면 UDP 콘솔에 오류 메시지가 표시됩니다.
CSV 파일 업로드
- Game Information 페이지에서 EDIT INFO를 선택합니다.
- In-App Purchases 섹션으로 이동합니다.
- IMPORT CATALOG를 선택합니다.
- Upload CSV를 선택하거나 CSV 파일을 지정된 상자 안으로 끌어다 놓습니다.
- IMPORT를 선택하여 IAP 카탈로그를 UDP 콘솔에 업로드합니다.
참고: CSV 파일을 업로드하면 이 리비전의 IAP 카탈로그를 완전히 덮어씁니다. UDP 콘솔은 CSV 파일에 포함된 정보만 사용하며, 이전에 UDP 콘솔을 통해 입력한 다른 IAP 정보는 모두 사라집니다.
CSV 파일 익스포트
기존 IAP 카탈로그를 다시 사용하거나 수정하려면 다음 단계를 따르십시오.
- Game Information 페이지에서 EDIT INFO를 선택합니다.
- In-App Purchases 섹션으로 이동합니다.
-
EXPORT CATALOG를 선택합니다.
그러면 기존 IAP 카탈로그를 일반 UDP 포맷의 CSV 파일로 익스포트합니다. - CSV 파일을 수정합니다.
- CSV 파일을 업로드합니다.
EXPORT CATALOG 버튼은 IAP 카탈로그에 IAP 상품이 있는 경우에만 보이고, 편집 모드에서만 나타납니다. 아래 이미지는 In-App Purchases 섹션에 있는 이 버튼을 보여줍니다.
Google Play 포맷으로 IAP 상품 임포트
또한 UDP는 Google Play 포맷의 CSV 파일도 지원합니다.
Google Play CSV 파일을 사용하여 IAP 상품을 임포트하려면 다음 단계를 따르십시오.
- Game Information 페이지에서 EDIT INFO를 선택합니다.
- In-App Purchases 섹션으로 이동합니다.
- IMPORT CATALOG를 클릭합니다.
- CSV file in Google Play format 체크박스를 선택합니다.
- Upload CSV를 선택하거나 CSV 파일을 지정된 상자로 안으로 끌어다 놓습니다.
- Google Play default currency 필드에서 게임에 대한 기본 통화를 선택합니다.
- Import를 선택하여 IAP 카탈로그를 UDP 콘솔에 업로드합니다.
가격
Google Play는 국가별로 가격을 설정하고, UDP는 통화별로 가격을 설정합니다. 따라서 임포트 시 국가는 통화에 매핑됩니다. 동일한 통화(예: 유럽 국가의 EUR)를 사용하는 국가 간에 IAP 상품의 가격을 서로 다르게 설정한 경우 UDP는 리스트의 첫 번째 국가를 통화에 사용합니다. USD를 사용하는 여러 국가가 나열되어 있으면 미국 로케일이 사용됩니다.
UDP는 Google Play의 가격 템플릿을 지원하지 않습니다. 이 설정은 무시됩니다. UDP는 CSV 파일에 제공된 로컬 가격만 사용합니다.
기본 통화
UDP는 USD를 기본 통화로 사용합니다. Google Play에 USD 가격이 없으면 UDP는 Google Play 기본 가격 및 통화를 USD로 변환한 후 이를 UDP 기본 가격으로 사용합니다.
CSV 파일에 설정된 로컬 가격은 해당 통화로 유지됩니다.
CSV 파일에 명시적으로 설정되지 않은 국가의 경우 UDP는 Google Play 기본 가격 및 통화를 해당 통화로 변환합니다.
IAP 상품
IAP 상품 타입(소비성/비소비성)은 CSV 파일에서 확인할 수 없으며, UDP에 각 IAP 상품의 타입을 알려야 합니다.
UDP는 자동 번역을 지원하지 않습니다. 이 설정은 무시됩니다. UDP는 CSV 파일에 제공된 현지화된 설명만 사용합니다.