Getting started with monetization in Unity

• How to enable in-app purchases (IAP) in the Developer Dashboard.
• How to set up an IAP in your Unity app.

• Meta Horizon developer account: Register a Meta account

• Unity Editor 2022.3.15f1 or later (6.1 or later recommended)
• Meta Quest Developer Hub

• Supported Meta Quest headsets:
  • Quest 2
  • Quest Pro
  • Quest 3
  • Quest 3S and 3S Xbox Edition

• Set up Unity for VR development
• Install the Interaction SDK
• Set up for Platform development with Unity
• Set up your device for development

1. Open your project in the Unity Editor.
2. In the Hierarchy tab, right-click on the default Main Camera and click Delete.
   
3. Right-click in the Hierarchy tab. Go to Interaction SDK > Add UnityXR Interaction Rig.
   
4. In the Unity XR Comprehensive Rig Wizard, click Fix All.
   
5. Click Create to add the UnityXRCameraRig to your scene.
   

1. Right-click in the Hierarchy tab. Go to GameObject > UI > Canvas. A Canvas is added to your project’s Hierarchy.
   
2. In the Hierarchy, select the Canvas. In the Inspector tab, set Render Mode to World Space.
   
3. Under Rect Transform, set the following values:
   • Rect Transform > PosX: 0
   • Rect Transform > PosY: 1.15
   • Rect Transform > PosZ: 1.5
   • Rect Transform > Width: 480
   • Rect Transform > Height: 720
   • Rect Transform > Scale: [0.0005, 0.0005, 0.0005]
   
4. Right-click the Canvas in the Hierarchy tab. Go to UI (Canvas) > Panel. A Panel is added to your project’s Hierarchy.
   
5. Right-click the Panel. Go to UI (Canvas) > Button - TextMeshPro. A Button is added to your project’s Hierarchy.
   
6. Click on Button in the Hierarchy tab. On the Inspector tab, under Rect Transform, set the following settings:
   • Width: 300
   • Height: 100
   
7. Under Button in the Hierarchy tab, click Text (TMP).
8. Under the Inspector tab for Text, under Text Input, enter Buy IAP.
   

1. In the Hierarchy tab, right-click on the Canvas. Go to Interaction SDK > Add Ray Interaction to Canvas.
   
2. In the Ray Canvas Wizard window, click Create.
   

1. In the Project window, right-click on the Assets folder.
   
2. In the menu, navigate to Create > Scripting > Empty C# Script. This creates a new C# script called NewEmptyCSharpScript.cs in the Assets folder.
   
3. Rename the script IAPManager.cs.
4. Double-click the script in the Assets folder to open it in your code editor.
   
5. Replace the content with the following code snippet:

    using UnityEngine;
    using Oculus.Platform;
    using Oculus.Platform.Models;
   
    public class IAPManager : MonoBehaviour
    {
        private const string APP_ID = "YOUR_APP_ID";
        private const string IAP_SKU = "YOUR_IAP_SKU";
   
        void Start()
        {
            Core.Initialize(APP_ID);
   
            // Recommended: on startup, also reconcile any unconsumed purchases:
            // IAP.GetViewerPurchases().OnComplete(OnViewerPurchases);
        }
   
        public void OnClickButton()
        {
            BuyItem(IAP_SKU);
        }
   
        // Launch the checkout flow for a given SKU
        public void BuyItem(string sku)
        {
            IAP.LaunchCheckoutFlow(sku).OnComplete(OnPurchaseComplete);
        }
   
        // callback for purchase
        private void OnPurchaseComplete(Message<Purchase> msg)
        {
            if (msg.IsError)
            {
                Debug.LogError(msg.GetError().Message);
                return;
            }
   
            Purchase purchase = msg.Data;
            Debug.Log($"Purchased: {purchase.Sku}");
   
            // 1) First, grant the item/currency to the game user
            GrantConsumableToPlayer(purchase.Sku);
   
            // 2) Then, consume the item/currency
            IAP.ConsumePurchase(purchase.Sku).OnComplete(consumeMsg =>
            {
                if (consumeMsg.IsError)
                {
                    Debug.LogError($"Consume failed for {purchase.Sku}: {consumeMsg.GetError().Message}");
                    return;
                }
   
                Debug.Log($"Consumed: {purchase.Sku}");
            });
        }
   
        private void GrantConsumableToPlayer(string sku)
        {
            // Example: add currency / increment count locally (or via your backend).
            Debug.Log($"Granting consumable to player for sku={sku}");
        }
    }
   
6. Replace the placeholder values in the code with your app’s credentials from the Developer Dashboard:
   • Set APP_ID to your App ID. For example, if your App ID is 12345:

    private const string APP_ID = "12345";
   
   • Set IAP_SKU to the SKU of the add-on you created. For example, if your IAP’s SKU is 678910:

    private const string IAP_SKU = "678910";
   

1. Drag and drop the script from the Project window onto the Canvas in the Hierarchy window.
   
   The Inspector window now shows the script attached to the Canvas.
   
2. Click Button in the Hierarchy window to open the Inspector window.
3. In the Inspector window, under the On Click() section, click the Select Object button.
   
4. In the Select Object window, switch to the Scene tab and select Canvas. To filter the list, type Canvas in the search field.
   
5. In the Function dropdown, select IAPManager > OnClickButton().
   

1. In the top menu bar, go to File > Build Profiles.
2. In the Build Profiles window, under Platforms in the left nav menu, make sure Meta Quest is active.
   
3. If your scene is not already in the Scene List, click Open Scene List to add it to the build. Deselect and remove any other scenes from the selection window.
   
4. Click Build.
   
5. In the Build Android window that appears, select a location to save your APK. Remember the location of the APK.
6. Click Save.
   

1. Ensure your headset is connected to your computer and recognized by the Meta Quest Developer Hub. For setup instructions, see Device Setup.
2. In the Meta Quest Developer Hub, navigate to your app’s distribution page. On the ALPHA Release Channel, click the menu button.
   
3. Click Install build on device and select your headset.
   

1. Put on your headset.
2. Press the Meta button on your right Quest controller.
3. Click the Library icon.
   
4. Find your app in the Library and click on it.
   
5. When the app launches, click Buy IAP.
6. Since the add-on you created is a free consumable, the menu appears and then quickly disappears because the transaction automatically completes.
   

1. While your headset is connected to your computer, open the Meta Quest Developer Hub.
2. In the left nav menu, click Device Manager.
   
3. In the Device Manager window, click Device Logs for your connected headset.
   
4. In the Device Logs window, switch the dropdown to Debug.
   
5. In the search bar, enter Purchased.
   
6. With the Device Logs window still open, launch the app on your headset.
7. Click the Buy IAP button.
8. Look at the Device Logs window for a log line confirming that the purchase was successful.
   

• Integrate with add-ons: Find more Platform SDK methods to reference your IAP in your Unity app.
• Add-ons Server APIs: Create IAP flows in your Unity app using S2S REST APIs.
• Testing In-App Purchases: Test your IAP payment flow using test users and test credit cards.
• Implement webhooks event tracking: Set up real-time notifications for your IAP and other add-ons.