Skip to content

Country restrictions, Update, General notices

When servicing a game app, there are situations where you need to either not service the game app in certain countries or display a Notice Popup to update the game app to the latest version. In this way, Hive SDK provides Notice Popups that can respond to the following situations.

Popup Description
Country Restriction Blocks game app usage from specific countries based on IP address
Update Blocks usage of a specific version of the game app and provides a link for updates
General Notice Used to inform about game app updates that are not mandatory and to expose important notices that must be communicated to all users

Exposure method

  1. Register the desired Notice Popup in Hive Console.
  2. The registered popup will be displayed when you run the SDK initialization.

The Country Restriction, Update, and General Notice Popups can only use the default UI provided by Hive SDK.

Exposure order

Notice Popups do not appear simultaneously. If you have registered all Notice Popups (Country Restriction, Update, General Notice, Server Maintenance) in Hive Console, the order in which the Notice Popups are displayed is as follows.

  1. Country Restriction Popup
    1. Role: Notify the user of access denial when accessing from a specific country
    2. Next Step: Encourage the user to exit the game app
  2. Update Popup
    1. Role: (If not subject to country restrictions) Inform the user about using an outdated version of the game app
    2. Next Step: Encourage the user to exit the game app and redirect them to the game app market to update to the latest version
  3. General Notice Popup
    1. Role: (If not subject to country restrictions and the game app is up to date) Display information about game app updates and any notices to be communicated
  4. Server Maintenance Popup
    1. Role: (If not subject to country restrictions, the game app is up to date, and after informing about general notices) Notify about server maintenance
    2. Next Step: Encourage the user to exit the game app

Example 1: when a user accesses from a restricted country

If a user accesses from a country with restricted access, only the Country Restriction Popup will be displayed and the game app will close. If the Country Restriction Popup has not been registered in Hive Console, the Country Restriction Popup will not be displayed, and it will proceed to the Update Popup display stage as shown in example 2 below.

Example 2: when the user accesses from allowed countries

If the user has accessed from a country that is allowed, the Country Restriction Popup will not be displayed. The popup that is displayed afterwards will vary as shown below, depending on whether the app is the latest version or not.

If the game app is an old version (if the game app has not been updated)

Displays an Update Popup. The Update Popup prompts the user to update the game app to the latest version from the market after exiting the game app.

If the game app is the latest version (if the game app has been updated)

Displays a General Notice Popup without showing the Update Popup. If the server is under maintenance, it will display the Server Maintenance Popup.

Using Google In-App Updates

Hive SDK supports the Google In-App Updates feature. In-App Updates allow the game app to be updated to the latest version in the background without closing the game app, according to the Update Popup settings. In-App Updates can only be used under the following conditions.

  • Supported markets: Google Play Store
  • Supported devices: Android mobile, Android tablet, ChromeOS devices
  • App file formats: Supports both AAB (Android App Bundle) and APK
    • However, APK expansion files (.obb files) are not supported
    • AAB supports a maximum size of 200MB, and APK supports a maximum size of 150MB