IAP Promo Product Catalogs

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.

Creating a Product Catalog

Adding Products in the IAP Catalog window

To build a Product Catalog, follow these steps:

1. 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 (currently, only Consumable Product Types are eligible for IAP Promo)
   • Price (you can specify price for Google and Apple stores independently, according to their respective tiers)
     
     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.

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

Adding Products manually

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:

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);

Configuring creative assets in the Developer Dashboard

From the IAP Promo section of the Developer Dashboard, select Product Catalog from the left navigation bar. Any existing Products appear here.

Uploading a catalog

To set up a new Product Catalog or update existing Products in the catalog:

1. Select UPLOAD JSON.
2. Select the JSON file you previously exported. A diff log then prompts you to approve changes. Verify the contents of the file, then select APPROVE CHANGES.

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).

Assigning creative assets

To add creative assets, follow these steps:

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.
   
   
   
   
   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 or JPG file format.
   • Each Product requires a creative asset for at least one configuration to be eligible for Promotions. For a better consumer experience, provide optimized creative assets for each device and orientation.
   • 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:
   
   
   • You must upload a purchase button to proceed.
   • Minimum file size for the button asset is 60 x 60 pixels.
   • You can click and drag the purchase button on the preview window to place it.
   • You can format the font, color, and size of the button text.
     
     

6. Select SAVE to proceed. Upon returning to the Product Catalog page, your Product is now Promotion Eligible.
   
   

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.

---

• 2018–03–01 Page published with editorial review