IAP Promo 플레이스먼트

IAP Promo 제품 카탈로그

Unity IAP provides quick and easy tools to create and export Product Catalogs. Use the Unity Editor’s IAP Catalog window to populate Product metadata, then export the catalog to the Developer Dashboard to configure each Product’s creative assets. Note that you must use the IAP Catalog function to export Products to the dashboard.

제품 카탈로그 생성

IAP 카탈로그(IAP Catalog) 창에서 제품 추가

In the Editor, select Window > UnityIAP > IAP Catalog to open the IAP Catalog window. This GUI lists all of your previously configured Products, and allows you to define the following attributes for each:

  • Name
  • Product ID
  • Type (IAP Promo now supports both Consumable and Non-consumable Product Types)
  • Price (Unity recommends specifying price points for Google and Apple stores independently if your app supports both)

참고: 제품 카탈로그(Product Catalog) 에는 익스포트할 제품(Product) 이 하나 이상 설정되어 있어야 합니다. 제품(Products) 설정에 대한 전체 설명은 코드리스 IAP 문서를 참조하십시오.

이미 빌더 스크립트를 사용하여 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);

Because IAP Promo only supports JSON exports from the Editor IAP Catalog GUI, we recommend modifying your approach as follows:

  1. Copy-paste your Products into the IAP Catalog GUI.
  2. Remove or comment out existing builder.AddProduct() code from your purchasing script.
  3. Add the following code before initializing IAP to fetch your Product list from the 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);

제품 카탈로그 익스포트

In the IAP Catalog window, select App Store Export > Cloud JSON to export a local copy of the Product Catalog.

제품 카탈로그를 JSON으로 익스포트
제품 카탈로그를 JSON으로 익스포트

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

Manage your Product Catalog on the Operate page of the Developer Dashboard. Your active Project appears in the top-left corner. To manage Products, select Monetization > Define In-App Purchases from the left navigation bar.

You can populate your Products manually, or bulk-populate them by importing a JSON file.

Creating a Product manually

Click the ADD NEW PRODUCT button in the top-right corner to view the Product configuration window, then enter the following details:

  • Product ID (for reference in your IAP code)
  • Name
  • Consumable or Non-Consumable
  • Apple App Store Price (USD)
  • Google Play Store Price (USD)
Adding a new IAP Product manually on the Developer Dashboard
Adding a new IAP Product manually on the Developer Dashboard

Click the SAVE button to store the Product in your catalog.

Importing a Product Catalog

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

  1. Select UPLOAD JSON.
  2. Select the JSON file you exported from the Unity Editor. A diff log then prompts you to approve changes. Check the contents of the file, then select APPROVE CHANGES.
개발자 대시보드로 IAP 제품 카탈로그 임포트
개발자 대시보드로 IAP 제품 카탈로그 임포트

The imported Products appear in the Product Catalog list. However, in order to be eligible for Promotions, each Product must have an associated creative asset (otherwise there is nothing for the Placement to display).

크리에이티브 에셋 할당

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

  1. Select a Product from the Product Catalog list, then scroll down to the Creative Uploads section.

    Note: While each Product’s Product ID, Name, Price, and Type appear in the dashboard, you can only edit these attributes from the Editor’s IAP Catalog window.

  2. To specify unique creative assets for different regions, select ADD LANGUAGE, then check the languages to include.

    Incorporating unique creative assets for different languages in the Developer Dashboard
    Note: The drop-down indicates the current language you are editing. If an included language has no creative assets, it defaults to using its English (United States) creative assets.

  3. Upload Portrait or Landscape creative assets for phone and tablet devices, with the following guidelines:

    • PNG 또는 JPG 파일 포맷이어야 합니다.
    • 제품 에 하나 이상의 설정에 해당하는 크리에이티브 에셋이 있어야만 제품을 프로모션 에 사용할 수 있습니다. 소비자 경험을 개선하기 위해 각 기기와 방향에 최적화된 크리에이티브 에셋을 제공하십시오.
    • Phone creative asset dimensions are 580 x 1035 pixels for portrait orientation, and 1035 x 580 pixels for landscape orientation.
    • Tablet creative asset dimensions are 900 x 1200 pixels for portrait orientation, and 1200 x 900 pixels for landscape orientation.
  4. Select UPLOAD CREATIVE to upload a creative asset. A preview appears on the left.

  5. Select UPLOAD PURCHASE BUTTON to place an interactive button on the creative asset, with the following guidelines:

    • 계속하려면 구매(Purchase) 버튼을 업로드해야 합니다.
    • 버튼 에셋의 최소 파일 크기는 60 x 60픽셀입니다.
    • 미리보기(Preview) 창에서 구매 버튼을 클릭하고 드래그하여 배치할 수 있습니다.
    • 버튼 텍스트의 글꼴, 컬러 및 크기 포맷을 지정할 수 있습니다.

      개발자 대시보드의 크리에이티브 에셋 업로드 인터페이스 개요
  6. Select SAVE to proceed. Upon returning to the Product Catalog page, your Product is now Promotion Eligible.

    A Product that is now eligible for use in Promotions in the Developer Dashboard

Note: You must export and submit your Product Catalog to the appropriate Google Play or iTunes store for the purchase flow to work. Please see the Export section in the documentation on Codeless IAP.

IAP Promo 플레이스먼트