lib_unity_purchase/Documentation~/UnityIAPDefiningProducts.md

IAP Catalog

To open the IAP Catalog GUI one of two ways:

• Select Services > In-App Purchasing > IAP Catalog.
• Or, with your IAP Button selected, locate its IAP Button (Script) component in the Inspector, then click IAP Catalog….

Populating Products in the IAP Catalog

Next, use the GUI to define the following attributes for each Product in your catalog.

• A Product ID with which to communicate to app stores (note that you can override this ID with unique store-specific IDs through the Advanced option).
• A Product Type (Consumable, Non-Consumable, or Subscription).

Note:

• The IAP Catalog GUI provides additional tools for configuring your Products. Before exporting a catalog for upload to its respective store, you must populate description and pricing information as well.
• The IAP Catalog acts as a Product catalog dictionary, not as an inventory manager. You must still implement the code that handles conveyance of the purchased content.

Advanced

This section defines the metadata associated with your Product for use in an in-game store.

Descriptions

This sections defines the descriptions of a product.

Add Translations for the Title and Description fields by clicking the plus (+) icon and selecting an additional locale. You can add as many translations as you like.

Payouts

This sections defines the payout of a product.

Store ID Overrides

This sections defines the Store ID overrides of a product.

Google Configuration (required for Google Play export)

Provide either a Product price, or an ID for a Pricing Template created in Google Play.

Apple Configuration (required for Apple export)

Select a Pricing Tier from the dropdown menu. Unity supports predefined Apple price points, but not arbitrary values.

Select a screenshot to upload.

For information on screenshot specs, see Apple’s publisher support documentation.

Exporting to an app store

In order for purchases to function, you must configure your catalog on the corresponding app store. To do so, you can export your Product Catalog as a CSV file to Google Play, or as an XML file through Apple’s Application Loader to the iTunes Store.

Google Play

To export your Product Catalog for Google Play:

1. In the IAP Catalog window (Services > In-App Purchasing > IAP Catalog), ensure that each Product has the following defined:
   * ID
   * Type
   * Title and Description
   * Price or Pricing Template ID
2. Scroll down, and select App Store Export.
3. Select Google Play CSV.
4. Choose a location in which to save the CSV file.

For complete guidance on uploading your exported catalog to Google Play, see the Google in-app billing documentation on the Android Developers website.

Apple App Store

To export your Product Catalog for Apple App Store:

1. In the IAP Catalog window (Services > In-App Purchasing > IAP Catalog), ensure that each Product has the following defined:
   * ID
   * Type
   * Title and Description
   * Price Tier and Screenshot path
   * Apple SKU (found in iTunes Connect)
   * Apple Team ID (found on Apple’s developer website)
2. Scroll down, and select App Store Export.
3. Select Apple XML Delivery.
4. Choose a location in which to save the XML file.

For complete guidance on importing through Apple’s Application Loader, see the Application Loader documentation on the iTunes Connect website.