Version: 2022.3
Language : English
Getting started with UDP
Implementing IAP products

Distributing your game with UDP

Important
The Unity Distribution Portal (UDP) is shutting down on February 17th, 2025. Access to the UDP Web console and services will be permanently deactivated on this date. To download your keystores and instructions on how to republish your games directly to app stores, visit the UDP overview page. If you have any questions about your account, submit a ticket with Unity Customer Support.

The steps below describe the overall process to publish a game to app stores via UDP.

  1. Creating a game in the UDP console.
    1. Entering your game info on the UDP console.
    2. Defining supported languages.
  2. Implement UDP in your Unity project.
    1. Install the package.
    2. Link your project to the UDP client.
    3. Initialize the UDP SDK.
    4. Implement IAP (if applicable).
    5. Implement LicenceCheck for premium games (optional).
  3. Build and test your game
    1. Build your game APKThe Android Package format output by Unity. An APK is automatically deployed to your device when you select File > Build & Run. More info
      See in Glossary
      .
    2. Ensure all your IAP products are listed in the UDP console (if applicable).
    3. Test your game in the Sandbox.
  4. Upload your game APK to the UDP console.
  5. Finalize the game information page in the UDP console.
    1. Verify testing was successful.
    2. Upload your app signing private key.
    3. Set a premium price (if applicable).
    4. Localize your game information for additional languages (if applicable).
  6. Release your game on UDP.
  7. Publish your game to stores.

The image below illustrates the overall workflow.

The workflow.
The workflow.

Creating a game in the UDP console

To create a new game in the UDP console:

  1. In the My Games tab, select Add Game.
  2. Add a title for your game and select Create New Game.
    The Game Info page opens.
  3. Select Save.

This is the minimum required to create a new game in the UDP console. The next step is to enter your game information.

When you create a new game in the UDP console it generates a UDP client and UDP client ID. You must link the UDP client to your game in the Unity Editor.

Entering game information on the UDP console

To edit your game information on the UDP console:

  1. In the My games tab, select your game’s card.
  2. In the Game Info page, select EDIT INFO to enter edit mode.
    1. Update your game information. Learn more about the requirements for the Game Info page.
      To help complete this information, you can also import metadata from Google Play.
  3. To save changes select SAVE. To discard your changes, select CANCEL.

If you intend to provide descriptions for your game in multiple languages, add your supported languages in the UDP console. Otherwise, implement UDP in your project.

Adding supported languages

When you add a language in the Game Info page, it copies the information from the default version. Therefore, to reduce duplication of work, add as much information as possible in the default version before you add more languages. To add languages:

  1. In the Game Info page, select EDIT INFO.
  2. In the language dropdown, select Manage languages.
    1. Select the languages you wish to support and select Save.
  3. In the Game Info page, select Save.

If you will use the bulk import feature to import IAP products, including descriptions in multiple languages, you should first add the languages in the UDP Console. Otherwise, the IAP descriptions would not be imported for those languages.

Implementing UDP in your project

Follow the steps to get started with the UDP package. This includes:

  1. Install the UDP package.
  2. Link your project to an existing UDP client ID.
  3. Initialize the SDK.
  4. If applicable, implement code in your game for:
    • IAP
    • Premium games
Getting started with UDP
Implementing IAP products