기술 자료

Unity Engine

User Manual

Script Reference

Unity Engine

IAP 제품 구현

Learn how in-app purchase products were implemented for the Unity Distribution Portal, which shut down in February 2025.
읽는 시간 7분최근 업데이트: 한 달 전

중요

UDP(유니티 퍼블리싱 포털)는 2025년 2월 17일에 종료됩니다. UDP 웹 콘솔 및 서비스에 대한 액세스는 이 날짜에 영구적으로 비활성화됩니다. 키스토어를 다운로드하고 게임을 앱 스토어에 직접 다시 퍼블리시하는 방법에 대한 지침을 보려면 UDP 개요 페이지를 참조하십시오. 계정에 대한 질문이 있으면 Unity 고객 지원 팀에 티켓을 제출하십시오.
권장되는 베스트 프랙티스는 UDP 콘솔에서 IAP 제품을 추가하고 관리하는 것입니다. UDP 콘솔의 IAP 카탈로그는 스토어의 백엔드 시스템에 제출되는 요소의 진정한 소스입니다. 또한 UDP 콘솔을 사용하면 다음을 수행할 수 있습니다.
참고: 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 아이템을 생성하려면 다음 단계를 따르십시오.
  1. Game Information 페이지에서 EDIT INFO를 선택합니다.
  2. Add Item을 선택하여 새 아이템을 생성합니다.
  3. 제품 정보를 입력하고 저장합니다.
    1. 앱 스토어에 적합하도록 제품 ID 요구 사항을 준수합니다.
    2. 게임에서 정의한 IAP 제품이 IAP 카탈로그에 설정된 것과 동일한 제품 ID를 사용하는지 확인합니다.
  4. Manage amounts and currencies를 선택하여 다음을 수행합니다.
    1. IAP 가격을 USD에서 외국 통화로 전환합니다.
    2. 이 통화로 된 가격을 조정합니다.
  5. SAVE를 선택하여 변경 사항을 저장합니다.
참고: 생성할 IAP 아이템이 많은 경우 일괄 IAP 임포트 기능을 사용하여 현지화된 설명, 여러 통화로 된 가격 등을 비롯하여 모든 IAP 아이템을 한 번에 생성하는 것이 좋습니다.
UDP 패키지를 사용하는 경우 콘솔에 추가하는 모든 새 IAP 아이템은 Unity 프로젝트와 동기화됩니다. 새 IAP 아이템을 포함하기 위해 게임을 다시 빌드하지 않아도 됩니다.

IAP 설명 편집

IAP 설명을 편집하려면 다음 단계를 따르십시오.
  1. Game Information 페이지에서 EDIT INFO를 선택합니다.
  2. 드롭다운 언어 선택자를 통해 설명을 편집할 언어를 선택합니다.
  3. In-App Purchases 섹션에서 연필 아이콘을 선택하여 기존 IAP 아이템을 편집합니다.
  4. 다음과 같은 IAP 아이템 정보를 편집할 수 있습니다.
    1. Product Name - IAP 아이템의 이름
    2. Description - IAP 아이템에 대한 간략한 설명
  5. SAVE를 선택하여 변경 사항을 저장합니다.
참고: 위 단계에서는 선택한 언어에 대한 IAP 아이템 정보만 편집합니다. 지원할 IAP 아이템과 언어가 많은 경우 이 정보를 임포트하려면 일괄 IAP 임포트를 사용하는 것이 좋습니다.

IAP 가격 및 통화 편집

  1. Game Information 페이지에서 EDIT INFO를 선택합니다.
  2. Manage amounts and currencies를 선택하여 IAP 아이템에 다음 작업을 수행합니다.
    1. IAP 가격을 변경합니다.
    2. 가격을 USD에서 외국 통화로 전환합니다.
    3. 이 통화로 된 가격을 조정합니다.
  3. SAVE를 선택하여 변경 사항을 저장합니다.
힌트: 통화를 즐겨 찾는 통화로 설정하려면 해당 통화 코드 옆의 별표 아이콘을 선택합니다. 그러면 통화가 리스트 상단에 고정됩니다. 별을 선택 해제하면 고정이 해제됩니다.
참고: 지원할 IAP 아이템과 통화가 많은 경우 Convert 기능을 사용하면 각 IAP 아이템에 설정된 USD 금액을 기준으로 모든 IAP 가격을 글로벌 통화로 자동 전환할 수 있습니다. 이렇게 하면 이전에 설정된 모든 현지 가격이 오버라이드됩니다.
또는 일괄 IAP 임포트 기능으로 이러한 모든 정보를 한 번에 임포트할 수도 있습니다.

IAP 아이템 삭제

  1. Game Information 페이지에서 EDIT INFO를 선택합니다.
  2. 휴지통 아이콘을 선택하여 IAP 아이템을 삭제합니다.
  3. SAVE를 선택하여 변경 사항을 저장합니다.

IAP 아이템을 일괄적으로 임포트

  1. Game Information 페이지에서 EDIT INFO를 선택합니다.
  2. In-App Purchases 패널의 오른쪽 상단 모서리에 있는 IMPORT CATALOG를 선택합니다.
    이 함수의 전체 범위는 일괄 IAP 임포트를 참조하십시오.
  3. SAVE를 선택하여 변경 사항을 저장합니다.

Google Play에서 게임 정보 임포트

Google Play에 게임을 이미 퍼블리시한 경우 게임의 Google Play URL을 사용하여 기본 정보를 임포트할 수 있습니다.
  1. Import from Google Play를 선택합니다.
  2. 게임의 Google Play URL을 입력 상자에 붙여 넣습니다.
  3. 임포트할 언어를 구체적으로 지정하려면 언어 접미사를 포함하는 Google Play URL을 사용합니다(예: 이탈리아어의 경우 
    &hl=it
    사용).
    Google Play URL에 언어 접미사가 포함되어 있지 않으면 UDP는 UDP 콘솔에서 현재 편집 중인 언어에 대한 정보를 가져옵니다(Google Play에서 설정된 경우).
  4. Import를 선택합니다.
  5. 경우에 따라 컴퓨터의 IP 주소가 제공되는 언어를 결정할 수 있으므로 결과를 다시 확인합니다.

일괄 IAP 임포트

IAP 아이템이 많은 경우 Bulk IAP Import 기능을 사용하면 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 포맷입니다.
  1. Game Information 페이지에서 EDIT INFO를 선택합니다.
  2. In-App Purchases 패널로 이동합니다.
  3. IMPORT CATALOG를 선택합니다.
  4. Download Template을 선택합니다.

CSV 파일 채우기

CSV 파일은 쉼표(,)와 세미콜론(;)을 사용하여 데이터 값을 구분합니다. 쉼표는 기본 데이터 값을 구분하고 세미콜론은 하위 값을 구분합니다.
각 IAP 아이템은 CSV 파일 내에서 한 줄에 완전히 표시되어야 합니다.
제공된 템플릿의 정확한 포맷으로 데이터를 입력해야 합니다. 잘못된 가격 구문이나 언어 누락 등 오류가 포함된 파일을 업로드하면 UDP 콘솔에 오류 메시지가 표시됩니다.

CSV 파일 업로드

  1. Game Information 페이지에서 EDIT INFO를 선택합니다.
  2. In-App Purchases 섹션으로 이동합니다.
  3. IMPORT CATALOG를 선택합니다.
  4. Upload CSV를 선택하거나 CSV 파일을 지정된 상자 안에 끌어다 놓습니다.
  5. IMPORT를 선택하여 IAP 카탈로그를 UDP 콘솔에 업로드합니다.
참고: CSV 파일을 업로드하면 이 리비전의 IAP 카탈로그를 완전히 덮어씁니다. UDP 콘솔은 CSV 파일에 포함된 정보만 사용하며, 이전에 UDP 콘솔을 통해 입력한 다른 IAP 정보는 모두 사라집니다.

CSV 파일 익스포트

기존 IAP 카탈로그를 다시 사용하거나 수정하려면 다음 단계를 따르십시오.
  1. Game Information 페이지에서 EDIT INFO를 선택합니다.
  2. In-App Purchases 섹션으로 이동합니다.
  3. EXPORT CATALOG를 선택합니다.
    기존 IAP 카탈로그를 일반 UDP 포맷의 CSV 파일로 익스포트합니다.
  4. CSV 파일을 수정합니다.
  5. CSV 파일 업로드
EXPORT CATALOG 버튼은 IAP 카탈로그에 IAP 제품이 있는 경우에만 표시되고, 편집 모드에서만 표시됩니다. 아래 이미지는 In-App Purchases 섹션에 있는 이 버튼을 보여 줍니다.

Google Play 포맷으로 IAP 제품 임포트

또한 UDP는 Google Play 포맷의 CSV 파일도 지원합니다.
Google Play CSV 파일을 사용하여 IAP 제품을 임포트하려면 다음 단계를 따르십시오.
  1. Game Information 페이지에서 EDIT INFO를 선택합니다.
  2. In-App Purchases 섹션으로 이동합니다.
  3. IMPORT CATALOG를 클릭합니다.
  4. CSV file in Google Play format 체크박스를 선택합니다.
  5. Upload CSV를 선택하거나 CSV 파일을 지정된 상자 안에 끌어다 놓습니다.
    1. Google Play default currency 필드에서 게임의 기본 통화를 선택합니다.
  6. Import를 선택하여 IAP 카탈로그를 UDP 콘솔에 업로드합니다.

가격

Google Play는 국가별로 가격을 설정하고, UDP는 통화별로 가격을 설정합니다. 따라서 임포트는 국가를 통화에 매핑합니다. IAP 제품의 경우 동일한 통화(예: 유럽 국가의 EUR)를 사용하여 국가별로 다른 가격을 설정하면 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 파일에 제공된 현지화된 설명만 사용합니다.