IAP Promo 제품 카탈로그(IAP Promo Product Catalogs)

Unity IAP는 제품 카탈로그 를 빠르고 쉽게 생성하고 익스포트하는 툴을 제공합니다. Unity 에디터의 IAP Catalog 창에서 제품 메타데이터를 입력한 다음 카탈로그를 개발자 대시보드로 익스포트하여 각 제품의 크리에이티브 에셋을 설정할 수 있습니다.

제품 카탈로그 생성

IAP Catalog 창에서 제품 추가

제품 카탈로그 를 작성하려면 다음 절차를 따르십시오.

에디터에서 Window > UnityIAP > IAP Catalog를 선택하여 IAP Catalog 창을 엽니다. 이 GUI에는 이전에 설정된 제품 이 모두 나열되며, 각 제품에 대한 다음 속성을 정의하는 데 사용할 수 있습니다.
- Name
- Product ID
- Type(현재 Consumable 제품 타입만 IAP 프로모션에 사용 가능)
- Price(Google 및 Apple 스토어에서 각각의 가격대에 따라 가격을 서로 다르게 지정할 수 있음)
  
  참고: Product Catalog 에는 익스포트할 Product 가 하나 이상 설정되어 있어야 합니다. Products 설정에 대한 전체 설명은 코드리스 IAP 문서를 참조하십시오.
IAP Catalog 창에서 App Store Export > Cloud JSON을 선택하여 Product Catalog 의 로컬 복사본을 익스포트합니다.

수동으로 제품 추가

이미 빌더 스크립트를 사용하여 Unity IAP 제품 카탈로그 를 채우고 있는 사용자도 있을 것입니다. 예:

var builder = ConfigurationBuilder.Instance(StandardPurchasingModule.Instance());
builder.AddProduct(product_coins, ProductType.Consumable);
builder.AddProduct(product_hat, ProductType.NonConsumable);
builder.AddProduct(product_elite, ProductType.Subscription);

IAP Promo는 에디터 IAP Catalog* GUI에서 익스포트된 JSON만 지원하므로 작업 방법을 다음과 같이 변경하는 것이 좋습니다.

Products 를 복사하여 IAP Catalog GUI에 붙여넣습니다.
기존 builder.AddProduct() 코드를 구매 스크립트에서 제거하거나 설명과 함께 제외합니다.
IAP를 초기화하기 전에 다음 코드를 추가하여 제품 리스트를 IAP Catalog GUI에서 페치합니다.

StandardPurchasingModule module     = StandardPurchasingModule.Instance();
ProductCatalog catalog = ProductCatalog.LoadDefaultCatalog();
ConfigurationBuilder builder = ConfigurationBuilder.Instance(module);
IAPConfigurationHelper.PopulateConfigurationBuilder(ref builder, catalog);

UnityPurchasing.Initialize(this, builder);

개발자 대시보드에서 크리에이티브 에셋 설정

개발자 대시보드 IAP Promo 섹션의 왼쪽 탐색 표시줄에서 Product Catalog를 선택합니다. 모든 기존 제품 이 여기에 표시됩니다.

카탈로그 업로드

새 제품 카탈로그 를 설정하거나 카탈로그의 기존 제품 을 업데이트하는 방법:

UPLOAD JSON을 선택합니다.
이전에 익스포트한 JSON 파일을 선택합니다. 그러면 변경 사항을 승인해 달라는 diff 로그가 표시됩니다. 파일 콘텐츠를 확인한 다음 APPROVE CHANGES를 선택합니다.

임포트된 상품 이 상품 카탈로그(Product Catalog) 목록에 표시됩니다. 하지만 상품을 프로모션 에 사용하려면 각 상품 에 연관된 크리에이티브 에셋이 있어야 합니다. 그렇지 않으면 플레이스먼트 에 표시될 항목이 없습니다.

크리에이티브 에셋 할당

크리에이티브 에셋을 추가하려면 다음 절차를 따르십시오.

Product Catalog 리스트에서 Product 를 선택한 다음 Creative Uploads 섹션까지 아래로 스크롤합니다.

참고: 각 제품의 Product ID, Name, Price 및 Type이 대시보드에 표시되지만, 에디터의 IAP Catalog 창에서만 이 속성을 편집할 수 있습니다.
지역에 따라 고유한 크리에이티브 에셋을 지정하려면 ADD LANGUAGE를 선택한 후 포함할 언어를 지정합니다.

참고: 드롭다운에는 현재 편집 중인 언어가 표시됩니다. 포함된 언어에 크리에이티브 에셋이 없는 경우 기본적으로 English (United States) 크리에이티브 에셋이 사용됩니다.
다음 가이드라인에 따라 스마트폰 및 태블릿 기기용 세로(Portrait) 또는 가로(Landscape) 크리에이티브 에셋을 업로드합니다.
- PNG 또는 JPG 파일 포맷이어야 합니다.
- 각 제품 에 하나 이상의 설정에 해당하는 크리에이티브 에셋이 있어야만 제품을 프로모션 에 사용할 수 있습니다. 소비자 경험을 개선하기 위해 각 디바이스와 화면 방향에 최적화된 크리에이티브 에셋을 제공하십시오.
- 스마트폰(Phone) 크리에이티브 에셋 크기는 세로 방향의 경우 580 x 1035픽셀이고 가로 방향의 경우 1035 x 580픽셀입니다.
- 태블릿(Tablet) 크리에이티브 에셋 크기는 세로 방향의 경우 900 x 1200픽셀이고 가로 방향의 경우 1200 x 900픽셀입니다.
크리에이티브 업로드(UPLOAD CREATIVE)를 선택하여 크리에이티브 에셋을 업로드합니다. 왼쪽에 미리보기가 표시됩니다.
구매 버튼 업로드(UPLOAD PURCHASE BUTTON)를 선택하여 다음 가이드라인에 따라 인터랙티브 버튼을 크리에이티브 에셋에 배치합니다.
- 계속하려면 구매(Purchase) 버튼을 업로드해야 합니다.
- 버튼 에셋의 최소 파일 크기는 60 x 60픽셀입니다.
- 미리보기 창에서 구매 버튼을 클릭하고 드래그하여 배치할 수 있습니다.
- 버튼 텍스트의 글꼴, 컬러 및 크기 포맷을 지정할 수 있습니다.
SAVE를 선택하여 계속합니다. Product Catalog 페이지로 돌아가면 제품 이 이제 Promotion Eligible 상태로 바뀌어 있습니다.