Get Started in Instant Plays 2.0

The following is a list of tasks (required, recommended, and optional), and recommended reading to help you get started in Instant Plays 2.0. A link to more detailed information is provided, when available.

The icons represent the following:

  Requirement/Required task

  Recommendation/Recommended task

  Optional task

  Recommended reading

  Video

Preparation

Before you do anything, you must be ready to sell your apps in Galaxy Store. See Get Started in Galaxy Store for more information.

Android Build

  • 32-bit or 64-bit Android built for ARM APK
  • Android 8.0 (API level 26) or higher
    (Android 10.0 (Q) or higher if you are using the Samsung SignIn SDK)
  • Latest LuaJIT (2.1+) if your games use Lua
  • Remove the Firebase Unity SDK if your games use it
Google Mobile Services (GMS) are not available in the cloud gaming environment. Games should not prompt for a Google Play login (if any) nor require other Google Play services.

Android (Download) and Instant Plays 2.0 supported as one binary.

User Acquisition

To effectively acquire users and measure their attribution, please meet the following requirements.

Integrate with the Samsung CloudDev SDK. If the game is using a Google Advertising ID (GAID) to store user data, you can use the GAID of the local device in the cloud environment using the Samsung CloudDev SDK. In addition, the Samsung CloudDev SDK allows you to check if the game operates in a cloud environment.
Add the Shell APK, which installs an app icon for your Instant Plays game in the user's smartphone app tray when the user launches your game through an ad in Instant Plays.
To enable user acquisition campaign attribution via mobile measurement partners(MMPs), please follow their guide. (Currently supporting AppsFlyer, Kochava, and Adjust).

Cloud Game Environment

Due to the nature of the cloud environment, branch processing is required during the operation.

If the game restricts emulator environments after game execution, please skip the operation in case of isCloudEnvironment provided by CloudDevSDK.

  • Cloud games run in emulator environments and stream them to actual devices.
If IP duplication or VPN operation is restricted after game execution, please skip the operation in case of isCloudEnvironment provided by CloudDevSDK.

  • Cloud game runs only with a specific IP, which may result in duplicate IPs.
If you use an installation-type rewarded advertisement(for example, Tapjoy), please skip the operation in case of isCloudEnvironment provided by CloudDevSDK.

  • Installation completion event tracking for rewarded ads is not supported.

SDKs and APIs

As part of the onboarding process, we provide you with a build of our SDK containing additional cloud APIs to support the following requirements.

Integrate with Samsung In-App Purchase (Samsung IAP). If you are selling your app and/or in-app items, you must use Samsung IAP as your billing solution. Samsung IAP includes an SDK, guides, examples, and Unity and Unreal plugins.

  • Instant Plays 2.0 supports Samsung IAP SDK 5.0 or higher

If your app is integrated with Samsung IAP 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.

If you are using Samsung IAP 6.0 or earlier, add the following to the manifest file:

<queries>
  <package android:name="com.sec.android.app.samsungapps" />
</queries>

If you are using Samsung IAP 6.1 or higher, you do not need to make this update.

Integrate with the Samsung SignIn SDK. If the game has a login feature, it is recommended to integrate with the Samsung SignIn SDK so that the progress of the game can be restored when logged in to a Samsung account.

The Samsung SignIn SDK provides the best account experience in the cloud when using a Samsung account: the user can log in immediately using the Samsung account login information of the user’s local device.

  • The Samsung SignIn SDK supports Android 10.0 (Q) or higher
Maximize your revenue with the Samsung Ads SDK. If you are using in-app ads to monetize your game, use the Samsung Ads SDK to maximize revenue.

Launch and test

Register and test your Instant Plays 2.0 app in Seller Portal. Watch this video for more information (tips for registering your app starts in Chapter 03).