Jump to content

Want to Publish Games on Galaxy Store using UDP?

Recommended Posts


Unity Distribution Portal (UDP) lets you distribute your games to multiple app stores through a single hub. UDP repacks your Android build with each store’s dedicated In-App Purchase SDK to make your game compatible with the separate app stores (Android alternative app stores). In this tutorial, you will learn the procedure for publishing a game on Galaxy Store using the UDP console. All you need to do is implement in-app purchases (IAP) using UDP. UDP then automatically repacks your game into store-specific builds. Follow the tutorial to integrate UDP into your game and publish it on Galaxy Store.

Before you start

We recommend that you implement UDP in your game towards the end of the development cycle. It is easier to implement UDP at this stage as you have already decided what your game’s IAP items are. Make sure you have completed your game before diving into the UDP implementation. We have developed a sample coin collecting game (see Figure 1) in Unity and we’ll show you how we implemented UDP into this game.

2021-06-07-01-01.jpgFigure 1: Preview of the sample game developed in Unity.

Note that there are three types of Samsung IAP items: consumable (single use, re-purchasable), non-consumable (unlimited use, not re-purchasable), and subscription (unlimited use while active). Since UDP does not support subscriptions, there is no guidance for implementing subscription items in this post.

Now that you know when to implement UDP and which Samsung IAP items are supported, we’re ready to begin with the development procedure.

Create a game in the UDP console

After signing in to UDP, please follow the steps below:

  1. Go to My Games -> ADD GAME, enter the game title, and click on CREATE. After that, you are automatically moved to the Game Info tab.
  2. In the Game Description tab, provide some basic information (metadata, description, visual assets, and ratings).
  3. Click on SAVE. You are not required to complete all sections at this time.

Integrate UDP in Unity and link it to the UDP console

There are two ways to integrate UDP in Unity: using the UDP package or Unity IAP. We used the UDP package for this blog. To do this, follow the steps below:

  1. In the Unity editor, go to Window -> Package Manager, select All packages -> Unity Distribution Portal -> Install.
  2. To enable UDP in your project, access Window -> Unity Distribution Portal -> Settings.
  3. Create a new Unity project ID (if required, or else use an existing one) in the Services Window. To do this, click on Go to the Services Window, select your organization, and then click Create.
  4. Obtain the client ID from the UDP console: go to the Game Info tab of the UDP console, scroll down to Integration Information, and copy your Client ID using the COPY button.
  5. Now, go back to Window -> Unity Distribution Portal -> Settings, paste the client ID into the relevant field, and finally click on Link Project to this UDP game.

Now you have successfully linked your Unity project to the game created on the UDP console. If you’re having problems, go here to try some troubleshooting methods before jumping into the next section.

Register IAP items in UDP

There are two IAP products in our sample game: “Super Jump” (consumable) and “Upgraded Player” (non-consumable). We need to add these products in the UDP console so they can be purchased inside the game. We can register the items directly either on the UDP console or in the Unity editor.

Follow the steps below for the UDP console:

  1. Go to the Game Info tab of the UDP console, scroll down to In-App Purchases, and select Add Item. Do not forget to click on EDIT INFO, if required.
  2. Provide a valid product ID, product name, price (USD), and description. Select if the item is consumable or non-consumable, then click SAVE. You can add as many products as you have in your game. For our sample game, we have added a consumable and a non-consumable item with the product IDs “superjump1” and “upgradeplayer1” respectively. Please remember the IDs you choose as these are required while initiating purchases.
  3. You can manage the prices in different currencies for each product individually by clicking on Manage amounts and currencies. You can also automatically convert your base price (USD) to different currencies for all your products at once by clicking Convert.
  4. Select SAVE in the top right corner to save your changes.
  5. In Unity, go to Window -> Unity Distribution Portal -> Settings, and click on Pull to retrieve your saved IAP items from the UDP server. Now, you can see all the items are added to the IAP Catalog.

You can also add IAP items in Unity directly in the IAP Catalog by clicking on Add New IAP Product, and then selecting Push to save your products to the UDP server (see Figure 2). In addition, there are many manipulation processes for adding IAP items (for example, bulk import and CSV template). Click here to learn more.

2021-06-07-01-02.jpgFigure 2: IAP Catalog under UDP Settings in Unity.

Initialize the UDP SDK in Unity

To access the UDP SDK, we need to declare the UDP namespace inside the game manager script. Please note that “player.cs” is the manager script in our sample project and is attached to the main player game object in the editor as a component. Hence, from now on we continue editing the codes into this script to enable all the UDP functionalities. Follow the steps below:

  1. Add the following line at the beginning to access the UDP libraries.

    using UnityEngine.UDP; 
  2. Make the manager code (player.cs) inherit from the IInitListener interface.

    public class player : MonoBehaviour, IInitListener
  3. In the Start() function of the manager (player.cs) class, call the Initialize() method.

  4. The IInitListener then returns a success or failure message to inform your game if the initialization was successful. Implement the following methods in the same class to obtain this message: if it is successfully initialized, the OnInitialized() method is invoked with the user information; if it was not initialized, the OnInitializeFailed() is called with an error message.

    public void OnInitialized(UserInfo userInfo){
          Debug.Log("Initialization succeeded");
         // You can call the QueryInventory method here to check whether there are purchases that haven’t been consumed.  
    public void OnInitializeFailed(string message){
         Debug.Log("Initialization failed: " + message);

If you’d like more guidance, check out Initialize the UDP SDK in the Unity documentation for more detailed information. Otherwise, continue to the next section.

Query the purchased IAP items

After the initialization is successful, we need to retrieve the previously purchased non-consumable and unconsumed products when the user launches the game. Call the QueryInventory() method of the UDP SDK to get the product information (product name, ID, description) for non-consumable purchases and consumable purchases that have not yet been consumed. Follow the steps below:

  1. It is necessary for the manager script (player.cs) to inherit the IPurchaseListener interface along with the IInitListener to implement the QueryInventory() method.

    public class player : MonoBehaviour, IInitListener, IPurchaseListener
  2. After that, we need to override all the required methods for the IPurchaseListener interface in our class. Although we show only the OnQueryInventory() and OnQueryInventoryFailed() methods here, we gradually complete the others in subsequent sections.

    public void OnQueryInventory(Inventory inventory){
          //Query inventory succeeded
          Debug.Log("Query inventory succeeded");
          IList<ProductInfo> productList = inventory.GetProductList();
          if(productList != null){
              for(int i=0; i<productList.Count;i++){
                       playerMaterial = Resources.Load<Material>("UDPMaterial");
                       MeshRenderer meshRenderer = GetComponent<MeshRenderer>();
                       meshRenderer.material = playerMaterial;
    public void OnQueryInventoryFailed(string message){
          Debug.Log("Query Inventory failed");

    As you can see, a few actions have been taken inside the method depending on the product ID. Similarly, you can build some logic here (for example, check for unconsumed products and purchased products that have not been delivered) based on your game design.

  3. Finally, call the QueryInventory() method on a successful initialization inside the OnInitialized() method that was implemented in the previous section.

    public void OnInitialized(UserInfo userInfo){
           Debug.Log("Initialization succeeded");
           // You can call the QueryInventory method here to check if there are purchases that haven’t been consumed.  

For further information about query inventory in UDP, go here.

Purchase IAP products

In our sample game, there are two UI buttons (see Figure 1), the “Buy Super Jump” and the “Upgrade Player.” These buttons allow users to purchase consumable and non-consumable items respectively inside the game. Please follow the steps below to accomplish these button actions:

  1. Declare two button variables in the beginning of the player class (player.cs).

    public Button buySuperJumpButton;
    public Button upgradePlayerButton;
  2. Add two listener methods, OnBuySuperJumpButton and OnUpgradePlayerButton, at the end of the Start() method of the player class (player.cs).

  3. Implement two listener methods in the same class for the button listeners in the previous section. These enable the “Buy Super Jump” and “Upgrade Player” buttons to initiate purchasing the respective IAP items through invoking the Purchase() method of the UDP SDK. Please note, we have used the item IDs we registered in the “Register IAP items in UDP” section.

    void OnBuySuperJumpButton(){
           //initiate purchasing a super jump item
           StoreService.Purchase("superjump1", "", this);     
    void OnUpgradePlayerButton(){
           //initiate purchasing an upgraded player item
           StoreService.Purchase("upgradeplayer1", "", this);
  4. The overriding method OnPurchase() is triggered if the purchase is successful. In other cases, the OnPurchaseFailed() method is invoked with an error message. If the item is consumable, consume the product here. Otherwise, deliver the product.

    public void OnPurchase(PurchaseInfo purchaseInfo){
                // The purchase has succeeded.
                // If the purchased product is consumable, you should consume it here.
                // Otherwise, deliver the product.
                if (purchaseInfo.ProductId == "upgradeplayer1"){
                     playerMaterial = Resources.Load<Material>("UDPMaterial");
                     MeshRenderer meshRenderer = GetComponent<MeshRenderer>();
                     meshRenderer.material = playerMaterial;
                else if(purchaseInfo.ProductId == "superjump1"){
                            StoreService.ConsumePurchase(purchaseInfo, this);
    public void OnPurchaseFailed(string message, PurchaseInfo purchaseInfo){
                Debug.Log("Purchase Failed: " + message);
  5. Save the script and go back to the Unity editor to add references for the UI buttons to the variables of the “player.cs” script that we declared in step 1.

We have completed purchasing IAP items inside our game. However, notice that in step 4, we only delivered the non-consumable item and invoked the ConsumePurchase() method for the consumable item.

Consume IAP products

We need to implement the overriding OnPurchaseConsume() and the OnPurchaseConsumeFailed() methods in the IPurchaseListener interface to consume and deliver the consumable IAP items. See the implementation below:

 public void OnPurchaseConsume(PurchaseInfo purchaseInfo){
            // The consumption succeeded.
            // You should deliver the product here. 
            if (purchaseInfo.ProductId == "superjump1"){

public void OnPurchaseConsumeFailed(string message, PurchaseInfo purchaseInfo){
            // The consumption failed.

We have delivered the “Super Jump” item by increasing the counting value. You can implement your game logic here according to your game design. Look here to find out more about consuming IAP products.

Validate in-app purchases

UDP performs client-side validation automatically. When a user purchases an IAP product, Galaxy Store returns the payload and signature. The UDP SDK then validates the signature. If validation fails, the purchase fails accordingly. You can also validate purchases on the server-side. See validating purchases on the server side to implement this functionality.

Build and test your game

Before building your game, add a UDP sandbox tester to verify that your IAP implementation is working. Go to Window -> Unity Distribution Portal -> Settings -> UDP Sandbox Test Accounts -> Add new test account, provide a tester’s email and password, and finally, don’t forget to click Push to save the update to the UDP server.

Now build an APK by going to File -> Build Settings -> Android -> Build and providing all the necessary basic information in Player Settings (File -> Build Settings -> Player Settings). For more information on building for Android, see Building apps for Android. After successfully building the APK, deploy it to the tester’s Galaxy device and assess the IAP functionality. Next, check the test status in the UDP console by going to the Game Info tab and then scrolling down to Sandbox Testing.

Publish your game on the UDP console

Once you have finished building and testing your game, upload the binary to the UDP console (Game Info -> Binary). Finalize all the game information (Game Description, Ads, Premium Price, App Signature) and then release the game by clicking RELEASE before publishing.

Go to the Publish tab on the UDP console, sign in to Galaxy Store with your commercial account, and then publish your game after UDP has successfully repacked it. You can later check the submission status in the Status tab of the UDP console. See details about publishing games on the UDP console here.


This tutorial demonstrates the entire process of publishing a game on Galaxy Store through the UDP console. It also uses the UDP package instead of Samsung IAP for integrating IAP into the game for Galaxy Store. UDP then repacks the game with the Samsung IAP automatically before it is submitted to Galaxy Store. Therefore, we hope this tutorial encourages you to develop games in Unity and publish on Galaxy Store easily through UDP Console.

Additional resources on the Samsung Developers site

This site has many resources for developers looking to build for and integrate with Samsung devices and services. Stay in touch with the latest news by creating a free account or by subscribing to our monthly newsletter. Visit the Marketing Resources page for information on promoting and distributing your apps. Finally, our developer forum is an excellent way to stay up-to-date on all things related to the Galaxy ecosystem.

View the full blog at its source

Link to comment
Share on other sites

  • Replies 0
  • Created
  • Last Reply

Top Posters In This Topic

Popular Days

Top Posters In This Topic

Popular Days

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Reply to this topic...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

  • Similar Topics

    • By Samsung Newsroom
      The Galaxy Store is one of the top app stores to sell your Android games in many different countries. You can also sell various in-app purchase (IAP) items inside your games using the Samsung IAP SDK. As many of you now use the Unity engine to develop your games, Samsung has introduced a Unity plugin for the Samsung IAP SDK that enables you to implement IAP features. Follow the steps outlined in this blog to easily implement the Unity plugin into your project and utilize the Samsung IAP functionalities.
      It is assumed you are already familiar with the Samsung IAP procedure. If not, please read the IAP Helper programming guide carefully before proceeding further. After that, download the Samsung IAP Unity plugin package and go through its documentation. To avoid compatibility issues, make sure you meet the system requirements.
      There are three types of IAP items:
      Consumable: can be used only one time and re-purchasable Non-consumable: can be used any number of times and not re-purchasable Subscription: can be used any number of times while it is active For this example, we have developed a basic coin collecting game in Unity for Android and added UI buttons that allow users to buy IAP items (consumable and non-consumable), and a subscription. The “Buy Super Jump” button initiates purchasing a super jump item from the Galaxy Store using the Samsung IAP SDK. Super jump is a consumable item which enables the player to jump higher than normal. Similarly, the “Upgrade Player” button initiates purchasing a player upgrade, which is a non-consumable item. This blog only covers consumable and non-consumable purchases, we’ll discuss subscriptions in a future blog.

      Figure 1: Preview of the sample game developed in Unity.

      Note: You are required to develop your game/application in Unity beforehand to integrate the IAP Unity plugin into it.
      Integrate the Samsung IAP Unity plugin
      After creating the game in Unity, you need to enable Samsung IAP functionalities in your project. Follow the steps below:
      Import the Samsung IAP Unity plugin package into the project. In Unity, click Assets -> Import Package -> Custom Package and select the downloaded plugin package. You can now see the Plugins folder under your Assets folder and the “SamsungIAP.cs” script at Assets/Plugins/Script. Copy or move the “SamsungIAP.cs” script into the default scripts folder (where all the scripts are kept together) of your project so that other scripts can access it easily. If you don’t already have a scripts folder, create a new one and keep all your project scripts together along with “SamsungIAP.cs”. Create an empty game object in the Hierarchy tab and drag-and-drop the “SamsungIAP.cs” script onto it. In our sample project, we have renamed the game object as “SamsungIAP”. Click on the “SamsungIAP” game object and check whether the IAP functionality is enabled in the Inspector, as shown below:
      Figure 2: Samsung IAP is enabled for the project.

      Set the IAP operation mode
      IAP supports three operational modes. The production mode is for enabling billing for item purchases and the other two are for testing IAP functions without billing the game users for item purchases. The default operation mode is set to OPERATION_MODE_TEST with the return value as Success, but you can set the return value to Failure instead, or switch to OPERATION_MODE_PRODUCTION by checking (√) the Production Build checkbox in the Inspector as shown in figure 2. You can learn more about the IAP operation modes and how they work from here.
      Register the game and IAP items in the Seller Portal
      To process/test the Samsung IAP operations, both your game and any IAP items need to be registered in the Seller Portal. Follow the steps below:
      Ensure you have switched the platform of your game to Android and the package name is different from the apps registered in other app stores. You can rename the package name of your project from Player Settings -> Other Settings. Save your Unity project and build the APK file. In Unity, go to File -> Build Settings and then click the Build button. Follow the steps listed in Register an app and in-app items in Seller Portal and complete the registration of your game and IAP items accordingly. For our sample game, we have registered a consumable and a non-consumable item with the IDs “BuySuperJump” and “BuyUpgradedPlayer” respectively. Keep the item IDs in mind as they will be required when initiating the purchases. You can add testers (non-licensed and licensed) in the Binary tab of the Seller Portal while registering your game in the manner covered in the previous step. Licensed testers are not be charged for purchasing any IAP items. You can register the licensed testers in your Seller Portal profile. See IAP Testing for more information. Get previously purchased items
      Make sure to retrieve any previously purchased non-consumable and unconsumed items every time the user starts the game. Use the GetOwnedList() method of the IAP plugin to get information about the items the user has already purchased. However, please note there is a script “player.cs” in our project which is added to the main player game object as a component. From now on we will be editing the codes into this “player.cs” script to enable all the Samsung IAP functions for this project. Follow the steps below:
      Add the following line at the beginning to access the Samsung IAP libraries in this script.using Samsung; Call the GetOwnedList() method whenever the game launches, by adding the following line at the beginning of the Start() method. Learn more about the GetOwnedList() method here. After the processing of the GetOwnedList() method is completed, the OnGetOwnedList callback is triggered, which receives information about the specified purchased items and API call processing. We need to implement this callback method under the same class as in the following;void OnGetOwnedList(OwnedProductList _ownedProductList){ if(_ownedProductList.errorInfo != null){ if(_ownedProductList.errorInfo.errorCode == 0){// 0 means no error if(_ownedProductList.results != null){ foreach(OwnedProductVo item in _ownedProductList.results){ if(item.mConsumableYN == "Y"){ //consume the consumable items and OnConsume callback is triggered afterwards SamsungIAP.Instance.ConsumePurchasedItems(item.mPurchaseId, OnConsume); } if(item.mItemId == "BuySuperJump"){ superJump++; } else if(item.mItemId == "BuyUpgradedPlayer"){ playerMaterial = Resources.Load<Material>("playerMaterial"); MeshRenderer meshRenderer = GetComponent<MeshRenderer>(); meshRenderer.material = playerMaterial; } } } } } } As you can see, some actions have been taken inside the game depending on the respective item IDs. For example, the super jump counter has been increased and the material of the player gets changed. If there is any consumable item which has not been reported as consumed, then the ConsumePurchasedItems() method is invoked. We describe this method in the next section.
      Consume purchased consumable items
      Use the ConsumePurchasedItems() method to report the purchased consumable item as consumed, which enables the item to be purchased again. See Acknowledge a purchased consumable item to understand this process better. When the process of the ConsumePurchasedItems() method in the previous section is finished, the item data and processing results are returned to the OnConsume callback method. We need to implement this method in the same way under the same class as we implemented the OnGetOwnedList method earlier.
      void OnConsume(ConsumedList _consumedList){ if(_consumedList.errorInfo != null){ if(_consumedList.errorInfo.errorCode == 0){ if(_consumedList.results != null){ foreach(ConsumeVo item in _consumedList.results){ if(item.mStatusCode == 0){ //successfully consumed and ready to be purchased again. } } } } } } Get purchasable IAP items
      The users may want to see details of the available IAP items in the store for the game. The GetProductsDetails() method helps to retrieve detailed information (for example, item name, price, ID, etc.) about the IAP items registered in your game that are available for users to purchase. There is a UI button “Available Items” in our sample game for querying the purchasable items. After clicking this button, brief information for each item is presented in a simple dropdown list next to the button (see figure 3). To get the list of available items:
      Declare a button variable and a dropdown variable in the beginning of the “player.cs” script.public Button getProductsButton; public Dropdown itemList; Add a listener method for the “Available Items” button at the end of the Start() method.getProductsButton.onClick.AddListener(OnGetProductsButton); To initiate the GetProductsDetails() method, we need to implement the listener OnGetProductsButton() method.void OnGetProductsButton(){ //get all the product details SamsungIAP.Instance.GetProductsDetails("", OnGetProductsDetails); } After the processing is completed on the server side, the OnGetProductsDetails callback is triggered, which contains information about the available IAP items. Implement this callback method and add information of each item to the dropdown method so that the users can see them easily. In the example, we show only the item name and price.void OnGetProductsDetails(ProductInfoList _productList){ if (_productList.errorInfo != null){ if (_productList.errorInfo.errorCode == 0){// 0 means no error if (_productList.results != null){ itemList.ClearOptions(); List<string> optionItems = new List<string>(); int i = 1; foreach (ProductVo item in _productList.results){ string temp = i+ ". " + item.mItemName + ": $ " + item.mItemPrice; optionItems.Add(temp); i++; } itemList.AddOptions(optionItems); } } } }
      Figure 3: Showing the available IAP items in the game.

      The information of all IAP items is shown in the dropdown menu as a list. You can show only one specific item or more items by specifying their IDs in the GetProductsDetails() method if you want. Learn more about the method here.
      View the full blog at its source
    • By Samsung Newsroom
      View the full blog at its source
    • By Samsung Newsroom
      View the full blog at its source
    • By Samsung Newsroom
      More improvements to Seller Portal were released at the end of September. This past month, the Seller Portal team made some changes based on requests from you. Also, learn more about two upcoming events in October that will give you the opportunity to provide us additional feedback.
      Settlement and financial reports include local currency information
      New local currency information has been added to the settlement and financial reports. The type of currency is defined in the Payment Currency column (for example, USD) and reflects where the sales occurred. There are new local currency columns for sales, commission, transaction fee, and VAT.
      Seller Portal timeout
      After you log in to Seller Portal, an inactive session remains open for up to 24 hours. That means you only have to log in to Seller Portal once a day and won’t see the login pop-up notification every 20 minutes. If your session is idle for 24 hours, you are automatically logged out and you will receive a pop-up notification 10 minutes prior to being logged out. For security purposes, remember to log out of Seller Portal when you have completed your tasks.
      Requirements for Samsung IAP and Android R
      If your app is integrated with Samsung In-App Purchase (IAP) version 6.0 or earlier with target API level 30 (Android R) or higher, an Android policy change requires an update to the manifest file. Without this update, Android R (or higher) users may not be able to make a payment.
      To the https://developer.android.com/training/basics/intents/package-visibility manifest file, add the following:
      <queries> <package android:name="com.sec.android.app.samsungapps" /> </queries> IAP subscriptions and your customers in India
      The Reserve Bank of India issued a regulation that, starting October 1, 2021, customers in India must consent to renew a subscription at the end of a subscription period. Auto-recurring (automatically renewed) subscriptions are no longer allowed.
      If you are using Samsung IAP, your subscription customers in India will automatically receive an email notification to renew their subscription. If you are using another payment service provider for your subscription items, you must consult with this payment service provider about the changes you need to make to comply with this regulation.
      See this Seller Portal notice and the IAP Subscription Guide for more information.
      IAP beta testing
      The Samsung In-App Purchase (IAP) team needs your help! If you have published an app or game integrated with Samsung IAP, you may be eligible to participate in an upcoming beta test to review and provide feedback on the following features:
      Manage item prices and information separately from app information Change the status of each item to active/inactive, when necessary Provide a price template that allows you to manage all items with the same price Look for an announcement in October with more information, including how you can apply.
      SDC21 is coming
      Join us online for the Samsung Developer Conference on October 26th. See what’s cooking with development tools and our latest technology. Learn from and network with our experts and your fellow developers and designers.
      Shape. Design. Create.
      Additional resources on the Samsung Developers site
      This site has many resources for developers looking to build for and integrate with Samsung devices and services. Stay in touch with the latest news by creating a free account and subscribing to our monthly newsletter. Visit the Marketing Resources page for information on promoting and distributing your apps. Finally, our Developer Forum is an excellent way to stay up-to-date on all things related to the Galaxy ecosystem.
      View the full blog at its source

  • Create New...