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 can also manually add Products to your catalog in the dashboard, as detailed below.
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:
Note: A Product Catalog must have at least one Product configured to export. For a complete walkthrough on setting up Products, see documentation on Codeless IAP.
You may already use a builder script to populate your Product Catalog for Unity IAP. For example:
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:
builder.AddProduct()code from your purchasing script.
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.
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 > In-App Purchases from the left navigation bar.
You can populate your Products manually, or bulk-populate them by importing a JSON file.
From the Product configuration menu of the dashboard (Monetization > In-App Purchases), click the ADD NEW PRODUCT button in the top-right corner, then enter the following details:
Click the SAVE button to store the Product in your catalog.
To set up a new Product Catalog or update existing Products in the catalog:
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).
To add creative assets, follow these steps:
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.
To specify unique creative assets for different regions, select ADD LANGUAGE, then check the languages to include.
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.
Select UPLOAD CREATIVE to upload a creative asset. A preview appears on the left.
Select SAVE to proceed. Upon returning to the Product Catalog page, your Product is now Promotion-eligible__, as indicated by the Creative Attached column.
Note: You must also 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.