원격 카탈로그 생성

제품 카탈로그를 정의하고 Remote Catalog 서비스에 업로드합니다.

읽는 시간 6분

최근 업데이트: 2달 전

제품 카탈로그를 구성하고 새 버전을 설치하지 않고도 사용자가 최신 제품에 액세스할 수 있도록 Remote Catalog 서비스에 업로드할 수 있습니다.

제품 카탈로그를 원격 카탈로그에 업로드하면 Unity IAP SDK가

RemoteCatalogProvider

클래스에서 제품 카탈로그를 가져와 사용자에게 제품을 표시할 수 있습니다. 이는 다음과 같은 이점을 제공합니다.

사용자가 애플리케이션을 업데이트할 필요 없이 제품과 가격을 실시간으로 배포할 수 있습니다.
여러 결제 제공업체에서 제품 정보를 구성할 필요는 없습니다.

제품 및 카탈로그 목록

Unity IAP는 두 가지 관련 개념으로 카탈로그를 나타냅니다.

제품은 사용자에게 부여하는 것입니다. 각 제품에는
```
productId
```
라고도 하는 SKU가 있습니다.
카탈로그 목록은 제품의 구매 가능한 버전으로,
```
catalogListingId
```
에 의해 식별됩니다. 제품에는 여러 개의 카탈로그 리스트가 있을 수 있으므로 동일한 제품을 두 가지 방법 이상으로 판매할 수 있습니다.

제품을 구매하려면 사용자가 해당 카탈로그 목록 중 하나를 구매합니다. 구매를 시작하거나 특정 리스팅을 타게팅할 때는

productId

가 아닌

catalogListingId

를 사용하십시오. 제품에 대해 두 개 이상의 리스트를 정의하지 않으면 Unity IAP는

catalogListingId

가 SKU와 일치하는 단일 카탈로그 리스트를 만듭니다. 기존 단일 목록 카탈로그는 계속 변경 없이 작동합니다.

참고

제품 카탈로그를 배포하려면 먼저 배포 패키지를 설치해야 합니다.

경고

D2C(Direct-to-Consumer) 결제 제공업체의 경우 IAP Catalog 창을 사용하여 상품을 생성하지 마십시오. IAP 카탈로그 항목으로 상품을 생성해야 합니다. 마찬가지로 카탈로그 에디터의 Auto-initialize 옵션은 D2C 결제 제공업체에서 작동하지 않으므로 코드리스 IAP 경로를 사용하지 마십시오.

제품 카탈로그 정의

다음 메서드를 사용하여 원격 제품 카탈로그에서 제품에 대한 정보를 정의할 수 있습니다.

Unity 에디터(권장)
앱 스토어 또는 Google Play에서 기존 카탈로그 임포트
API 사용
커스텀 연동 사용

Unity Cloud 대시보드의 인앱 구매 > 카탈로그에서 카탈로그를 직접 작성할 수도 있습니다.

Unity 에디터 사용하여 제품을 추가하는 경우 Unity IAP(인앱 구매)는 구매 이행 프로세스에 필요한 일부 백엔드 로직을 자동으로 처리합니다. 특히 백엔드 API를 통해 구매를 수행하려는 경우에 유용합니다.

참고

Unity 에디터 UI에서 제품 카탈로그를 생성하려면 Unity 에디터 버전 6.0 이상을 사용해야 합니다. 이전 버전을 사용하는 경우 API를 사용하여 대신 제품 카탈로그를 생성할 수 있습니다.

Unity 에디터 제품 카탈로그 생성

Unity 에디터에서 제품을 정의하는 경우 에디터는 제품 설정을 파일에 저장하므로, 컨피그인 코드 워크플로를 사용하여 관리할 수 있습니다.

Unity 에디터 제품을 생성하려면 다음 단계를 따르십시오.

카탈로그 항목을 만들려면 디렉토리를 마우스 오른쪽 버튼으로 클릭하고 Create > Services > IAP Catalog item을 선택합니다.
카탈로그 항목 이름을 지정합니다. 그러면 카탈로그 아이템 에셋이 생성되고 인스펙터 창 에셋이 열립니다.
카탈로그 항목의 세부 정보를 입력합니다. 자세한 내용은 카탈로그 항목 자산 인스펙터 레퍼런스를 참조하십시오.
Apply를 선택합니다.

이 단계를 반복하여 모든 제품의 카탈로그 항목을 생성합니다.

Unity 에디터 인스펙터 창 열려 있는 카탈로그 아이템 에셋 스크린샷. 이 이미지는 카탈로그 나열 ID, Sku, 제품 타입, 제품 세부 정보, 가격 세부 정보, 이미지 URL, 스토어 ID 오버라이드에 대한 필드를 보여줍니다.

제품을 추가한 후 View in Deployment 창을 선택하여 Deployment 창에서 제품 카탈로그를 열고 원격 카탈로그에 업로드합니다.

Unity 에디터 아닌 파일에서 직접 제품 세부 정보를 편집할 수도 있습니다. 파일의 프로퍼티는 카탈로그 항목 에셋 인스펙터 레퍼런스에 나열된 프로퍼티에 매핑됩니다.

카탈로그 아이템 에셋 인스펙터 레퍼런스

다음 프로퍼티를 참고하여 IAP 카탈로그 항목을 정의합니다.

프로퍼티	설명
--script	기본적으로 채워짐
카탈로그 리스팅 ID	기본값으로 채워짐(파일 경로 사용) 구매를 시작할 때 이 리스트를 타게팅하는 데 사용하는 ID입니다.
SKU	기본값으로 채워짐(파일 이름 사용)
제품 유형	IAP 상품의 유형을 선택합니다.
제품 상세 정보	다음을 포함하여 제품에 대한 정보를 입력합니다. 제목 설명 Language 자막 배지(텍스트 및 이미지 URL)
가격 세부 정보	다음을 포함하여 제품 가격 정보를 입력합니다. 통화 코드 금액
이미지 URL	이미지 URL을 입력하여 제품에 표시할 이미지를 지정합니다.
스토어 ID 오버라이드	선택 사항입니다. 서로 다른 명명 요구 사항이 있는 앱 스토어 Google Play에 리스트를 매핑합니다. SKU가 스토어의 요구 사항을 충족하지 않는 경우에만 다음 필드를 사용하십시오. Apple 오버라이드 Google 오버라이드

기존 카탈로그 임포트

이미 앱 스토어 또는 Google Play에서 카탈로그를 설정한 경우 제품을 다시 생성하지 않고 Unity 에디터 임포트할 수 있습니다.

Unity 에디터에서 서비스 > 인앱 구매 > 카탈로그 임포트를 선택합니다.
가져올 스토어의 앱 스토어 또는 Google Play 스토어 탭을 선택합니다.
단계 1: 카탈로그 데이터 가져오기, 스토어 자격 증명을 입력한 다음 카탈로그 가져오기를 선택합니다.
- 비밀 키
- 비밀 범위
2단계에서: Import 또는 Export를 선택하고, 생성된 카탈로그 항목의 Import New 대상 경로를 설정한 다음 Apply를 선택합니다.

참고

수정된 SKU는 기존의

.ucat

파일만 업데이트하는 반면 새 SKU는 임포트 대상에 새

.ucat

파일을 생성합니다.

카탈로그를 가져온 후 원격 카탈로그 서비스에 업로드합니다.

API 사용하여 제품 카탈로그 생성

Unity 에디터 UI를 사용하는 대신 에디터 스크립트를 통해 제품 카탈로그를 관리하려는 경우 이 방법을 사용합니다.

먼저 필요한 모든 종속성을 포함하는

.asmdef

파일을 생성해야 합니다. 다음 예제를 참고하여

.asmdef

파일을 만듭니다.


{    "name": "MyIAPProject.Authoring",    "rootNamespace": "MyIAPProject.Authoring",    "references": [        Unity.Services.Core        "Unity.Services.Core.Editor",        "Unity.Services.Core.Internal",        "Unity.Services.DeploymentApi",        "Unity.Services.Core.Environments.Editor",        "UnityEditor.Purchasing.Authoring",        "UnityEditor.Purchasing.Editor.Authoring.Core",        "Unity.Purchasing.Editor.Shared",        "Unity.Purchasing"    ],    "includePlatforms": [        "Editor"    ]}

그런 다음

ILiveContentConfigClient

API를 사용하여 원격 카탈로그를 직접 수정할 수 있습니다.

PurchasingAuthoringServiceProvider

를 통해 관련 서비스를 얻으십시오.

```
ILiveContentConfigClient
```

IEnvironmentsApi

PurchasingAuthoringServiceProvider.GetService<ILiveContentConfigClient>()

필요한 정보로
```
ILiveContentConfigClient
```
인터페이스를 초기화합니다.
카탈로그를 읽거나 업데이트하기 위한 호출을 생성합니다. 호출은 현재 로그인된 사용자 권한으로 이루어집니다.

경고

이 작업은 파괴적입니다. 아이템을 전송하지 않으면 카탈로그에 포함되지 않습니다. 또한 배포 프로세스에서 일반적으로 확인하는 확인을 건너뛰기도 합니다.

다음 코드 샘플을 참고하십시오.


[MenuItem("IAP/배포/카탈로그 가져오기 및 출력")]public static async void Select(){    var lcc = PurchasingAuthoringServiceProvider.GetService<ILiveContentConfigClient>();    var env = PurchasingAuthoringServiceProvider.GetService<IEnvironmentsApi>();    await lcc.Initialize(        env.ActiveEnvironmentId.ToString(),        CloudProjectSettings.projectId,        CancellationToken.None);    var items = await lcc.List(CancellationToken.None);    Debug.Log(string.Join("\n", items.Select(i => $"{i.uSku} - {i.ProductDetails[0].Description}")));}

맞춤형 Deployment 창 통합을 사용하여 제품 카탈로그를 생성합니다.

Deployment 창을 사용하여 커스텀 통합을 호스팅할 수 있습니다. 따라서 CSV와 같은 간단한 커스텀 배포를 만들거나 원격 카탈로그로 직접 익스클럽할 수 있습니다.

간단한 Deployment 창을 만드는 방법에 대한 자세한 내용은 Deployment 패키지 기술 자료를 참조하십시오.

제품 카탈로그를 Remote Catalog 서비스에 업로드합니다.

Deployment 창을 사용하여 제품을 Remote Catalog에 업로드합니다.

Unity 에디터에서 서비스 > 배포를 선택하여 배포 창을 엽니다.
원격 카탈로그에 추가할 제품을 선택하고 선택 배포를 선택합니다.

Unity 에디터 Deployment 창 스크린샷. .ucat 카탈로그 항목 리스트가 표시됩니다.

중요

구매 시 IAP는 원격 카탈로그 정의를 사용하여 D2C 결제 공급자 체크아웃 데이터를 구성합니다. IAP는 스트라이프나 코다에 직접 추가한 제품을 사용하지 않습니다.

원격 카탈로그에서 상품 삭제

Unity 에디터 원격 카탈로그에서 항목을 삭제하는 방법에는 여러 가지가 있습니다.

인스펙터 창에서 카탈로그 항목을 열고 Remote Delete를 선택합니다.
Deployment 창을 열고 카탈로그 항목을 마우스 오른쪽 버튼으로 클릭하고 Delete Remote를 선택합니다.

참고

원격 카탈로그에서 이름이 변경된 카탈로그 항목을 삭제하려면 먼저 원본 SKU를 사용하여 임시 항목을 다시 생성합니다. 그런 다음 Deployment 창을 통해 해당 항목을 삭제하여 제거를 성공적으로 동기화할 수 있습니다.

다음 단계

이 페이지는 IAP를 사용하여 D2C 결제 제공업체를 설정하는 워크플로의 일부입니다. 이 워크플로를 계속 진행하려면 다음 옵션 중 하나를 선택합니다.

Integrate D2C payment providers

Integrate D2C payment providers with IAP 워크플로 페이지로 돌아갑니다.

Initialize services to handle the startup sequence

워크플로의 다음 단계로 이동하여 D2C 결제 제공업체를 설정합니다.

기술 자료

Development

User Acquisition

Monetization

산업 분야