In mobile games, Push Notifications are an important means to maintain and increase user retention. Hive provides Push Notification Services to notify news in diverse ways to users. Not only provides advertisement push notification for marketing to increase retention of game, and also supports Google’s FCM and Apple’s APNS. Language-specific and timezone-specific settings are available to support global services as well.

Push Type

Remote Push

Remote Push is a push sent to the user’s device through Hive console or game server using Hive server API.
There is nothing to implement in your game to receive Remote Push. However,  you should call Hive API to check and change the push settings when users intend to see or change settings of Remote Push. View details

Local Push

Local Push is a push sent by Game Client directly to users using Hive API in the game, You can register and release local push using Hive API, and customize push UI for Android devices. View details

Push Settings

The user will see the terms of agreement upon initial game play after the app installs, and will perform the consent process to receive an advertising push for marketing. However, you should provide the function to opt in or out of the service on game settings page for those who do not want to receive push notifications.

Settings Type

It should be available to opt in or out of push notifications for All Notifications, Game Notification, Announcement Notification and Night-time Notification.

All Notifications
  • Android device only.
  • Opt in or out of all push notifications.
Game Notification
  • Opt in or out of Remote Push or Local Push send by Hive server API.
  • It can be divided into the advertisement information and the none advertisement information according to the contents. It can be separated into more detailed items according to the characteristics of the game.
  • Filtering of sending push notification according to game notification settings must be implemented by the developer in the game.
Announcement Notification
  • All pushes sent through Hive Console are considered as advertisements.
  • If this setting is OFF, those of Night-time Notifications are changed to OFF.
Night-time Notification
  • A subordinate item of Announcement Notification.
  • For users who access from Korea, make sure to apply this notification on all platforms including Android and iOS.
    (* Under Article 50 of the Act on Promotion of Information and Communication Network Utilization and Information Protection, transmission of advertising information for profit is restricted. Failure to comply with the article can result in ₩3 million fine.)
  • If this setting is OFF, Night-time Notification (from 9 p.m. to 8 a.m.) is deactivated.
  • Expose this notification to the users who access from Korea, and set the search result from Hive API as default values.
  • Hide this notification from global users except those from Korea, and set the ON/OFF status by following the state of Announcement Notification.

 

Push Settings Policy

1. Provide a menu for users to activate or deactivate push services in games.

  • The composition of Push Settings
    • All Notifications is exposed on Android devices and available to comprise details depending on the game features.
    • Night-time Notification is exposed to users in Korea only.
    • The default value of All Notifications and Game Notification  settings are ON.
    • The default value of Announcement Notification and Night-time Notification settings are from Hive API.
  • Notification setting menu when game language is Korean
    (Make sure to display night-time notification settings on all devices including Android and iOS platform)

    Example for Android

    Example for iOS

  • Notification setting menu when game language is not Korean

    Example for Android

  • You should display a toast popup for two seconds when push notification settings are changed.
  • Expose Notice popups
    • when a user logged in from Korea
    • when the settings of All Notifications, Notices, Night-time Notifications changed (for Game notification,  do not  display toast popups)
  • Texts for toast popup
    • Activate All Notifications: [Company Name] 2016.05.01 You opted in to all notifications.
    • Deactivate Announcement Notification: [Company Name] 2016.05.01 You opted out of announcement notification.
    • Activate Night-time Notification: [Company Name] 2016.05.01 You opted in to night-time notification.
  • An example of toast popup

    Provide notification texts for push settings.
    In case users do not receive a push, even though users have enabled it in the push settings menu, please provide instructions to check user’s notification settings in the device settings menu. Push notifications are not displayed if users opted out of notifications on device settings.
  • An example of Push Service text

2. Use Hive API to configure settings for notification sent through Hive Console.

  • Hive Console delivers two types of push notification; Announcement Notification and Night-time Notification
  • The values of the two notification options must be set to the values set in the Hive server.
  • You must pass changes to the Hive server when both notification options change.
  • For more information, see Sending Remote Push.

3. Apply the Night-time Notification Policy.
Night-time Notification belongs to Announcement Notification.  Please apply the following policies when implementing Night-time Notification settings menu.

  • If a user opted out of Announcement Notification, Night-time Notification should be automatically deactivated.
  • With deactivated Announcement Notification, Night-time Notification should be unable to activate.
  • Even a user opted out of Announcement Notification, Night-time Notification should not be automatically activated.

 

Push Display Settings

Push notification is generally displayed when your game app is not in use. With Hive SDK v4.9.0, however, push service is available to expose even the app is activated. iOS is supported from iOS 10.

Push settings Class
The following classes show whether push messages are sent or not when the app is activated.

Push settings callback
Implement the following callbacks when calling push settings API to retrieve about the request result.

Set whether to receive push messages on the activated app
Using the following APIs, you can set whether to receive push messages when the app is activated.

Unity®

API Reference: Push.setForegroundPush

C++

API Reference: Push ::setForegroundPush

Kotlin

API Reference: Push.setForegroundPush

Java

API Reference: Push.INSTANCE .setForegroundPush

Swift

API Reference: Swift

Objective-C

API Reference: Objective -C

Search whether receiving push messages on activated app
Using the following APIs, you can search the state whether receiving push messages when the app is activated.

Unity®

API Reference: Push .getForegroundPush

C++

API Reference: Push ::getForegroundPush

Kotlin

API Reference: Kotlin

Java

API Reference: Push.INSTANCE .getForegroundPush

Swift

API Reference: PushInterface .getForegroundPush

Objective-C

API Reference: HIVEPush getForegroundPush

Provisional Authorization

Hive SDK v4.11.4 starts to support a new funtion for iOS 12, Provisional Authorization.

As the agreement popup on sending push notification is no more exposed after agreement on terms of service of Hive SDK, users who run your app receive all kinds of push messages as a default. With provisional authorization, all users can select to receive push notifications on the push message or app settings. Default setting is that push messages do not sound nor expose until user manually opts in to push notification even if the user receives the messages.
Devices with earlier than iOS 12 display the agreement popup on sending push notification after initializating Hive as usual.

 

Request Permission for Prominent Push

From Hive SDK v4.16.2 (Android), you can expose the agreement popup on sending prominent push notification if it’s necessary in game. To expose the agreement popup on sending prominent push notification, call requestPushPermission() method in Push class before user set whether to agree on sending push notification.
For iOS, even if user agrees on terms of service of Hive SDK through Provisional Authorization, the agreement popup on sending push notification is exposed, and the user can receive the prominent push notification.
For Android, the pop-up is exposed when the target SDK is 33 or higher on Android 13 or higher devices, and when the target SDK is lower than 33, it is exposed when AuthV4.setup() is called.

Followings are sample codes to expose the agreement popup on sending push notification.

Unity®

API Reference: hive.Push.requestPushPermission

C++

API Reference: Push::requestPushPermission

Kotlin

API Reference: Push.requestPushPermission

Java

API Reference: Push.INSTANCE.requestPushPermission

Swift

API Reference: PushInterface.requestPushPermission

Objective-C

API Reference: HIVEPush:: requestPushPermission

 

Push Multi-Language Settings

Language All Notifications Game Notification Announcement Notification
Korean 모든 알림 게임 알림 공지 알림
English All Notifications Game Notification Announcement Notification
Japanese 全ての通知 ゲーム通知 お知らせ通知
Chinese (Simplified) 所有通知 游戏通知 公告通知
Chinese (Traditional) 所有通知 遊戲通知 公告通知
German Alle Benachrichtigungen Spiel-Benachrichtigung Ankündigungen
Russian Все уведомления Уведомления игры Объявления
Malay Semua notifikasi Notifikasi permainan Notifikasi pengumuman
Vietnamese Tất cả thông báo Thông báo game Thông báo tin tức
Spanish Todas las notificaciones Notificación del Juego Notificación de Anuncio
Italian Tutte le notifiche Notifiche di gioco Notifiche degli avvisi
Indonesian Semua Notifikasi Notifikasi Game Notifikasi Pengumuman
Thai การแจ้งเตือนทั้งหมด การแจ้งเตือนเกม การแจ้งเตือนประกาศ
Turkish Tüm Bildirimler Oyun Bildirimi Duyuru Bildirimi
Portuguese Todas as notificações Notificação de Jogo Notificação de Anúncios
French Toutes les notifications Notification de jeu Notification d’annonce
Arabic كل الإشعارات إشعارات اللعبة إشعارات الإخطار

The push notification and the app icon badge

If you receive a notification on your device, the app icon badge is automatically displayed. The app icon badge is a counter that displays the number of the received notifications for an app on the right upper corner of the app icon. This badge feature can be turned off/on in the device settings or the app configurations. By default, the display of a badge follows the policy below by OS.

  • iOS
    • The app icon badge is always 1 regardless of the number of newly received notifications.
    • When the app icon badge becomes 0, all the notifications stacked up on the notification center will be removed.
    • The time that the app icon badge becomes 0 with the Hive SDK is described as below.
      • The first run of the app
      • When the app gets back to the foreground via clicking one of its notifications.
  • Android
    • The app icon badge increases by 1 as a new notification arrives.
    • When the app gets back to the foreground, by clicking one of its notifications to run the app or by some other ways, the badge is reset to 0.
    • Only the clicked notifications will be removed from the notification center.