Defining products

Your application must provide a list of products for sale. This can either be done in your Application with code, or declaratively via the Analytics dashboard.

Product Types

Each product must be of one of the following Types:

Defining products directly in your App

You can declare your product list programmatically using the ConfigurationBuilder.

A unique cross-store identifier must be supplied for all products, and one of the aforementioned types.

using UnityEngine;
using UnityEngine.Purchasing;

public class MyIAPManager {
    public MyIAPManager () {
        var builder = ConfigurationBuilder.Instance(StandardPurchasingModule.Instance());
        builder.AddProduct("100_gold_coins", ProductType.Consumable);
        // Initialize Unity IAP...
    }
}

Store specific IDs

By default Unity IAP assumes that your product has the same identifier across all the App stores.

For example, in the previous example, Unity IAP would use an ID of “100_gold_coins” when communicating with every App store.

There are occasions when it is not possible to reuse the same product identifier across every store, such as when publishing to both iOS & Mac stores which prohibit developers from using the same product ID across both.

In these situations a mechanism is provided to tell Unity IAP the product’s correct identifier where it differs from the cross-platform ID.

using UnityEngine;
using UnityEngine.Purchasing;

public class MyIAPManager {
    public MyIAPManager () {
        var builder = ConfigurationBuilder.Instance(StandardPurchasingModule.Instance());
        builder.AddProduct("100_gold_coins", ProductType.Consumable, new IDs
        {
            {"100_gold_coins_google", GooglePlay.Name},
            {"100_gold_coins_mac", MacAppStore.Name}
        });
        // Initialize Unity IAP...
    }
}

In this example the product is known as “100_gold_coins_google” on Google Play and “100_gold_coins_mac” on the Mac App store.

It is recommended that you reuse the same product identifiers across all stores where possible.

Note that defining store-specific identifiers changes only the identifier Unity IAP uses when communicating with stores; you should continue to use the product’s cross-platform identifier when making API calls.

Defining products via the Analytics dashboard

Instead of defining your product catalog with code, you can use Unity IAP’s cloud catalog feature to declare your products via the Analytics dashboard.

By defining products via dashboard, you can change the contents of your catalog without needing to upload a new binary to each app store; the Unity Player will fetch the latest published product catalog during initialization.

On the Analytics dashboard:

1. Create your products taking care to set the correct identifiers & product types.
2. Click ‘publish’ to make your catalog of products publicly visible.
3. Set the ‘useCloudCatalog’ flag on the ConfigurationBuilder when initializing Unity IAP.

using UnityEngine;
using UnityEngine.Purchasing;

public class MyIAPManager {
    public MyIAPManager () {
        var builder = ConfigurationBuilder.Instance(StandardPurchasingModule.Instance());
        builder.useCloudCatalog = true;
        // Initialize Unity IAP...
    }
}