If you have started developing a new game, take advantage of the many benefits of the latest version of the Hive SDK. Hive SDK v4 is the best SDK among the previous Hive SDK, and Authentication v4 is the most advanced authentication system provided by Hive.

Guide for Implementing Hive SDK on Game

All key features and APIs about Hive, required to implement on games, are described in the flow guidelines. Simply download the following file and see details how Hive is run from start to end of a game. 

Configure Hive SDK and develop your app

Install Hive SDK and do the required configurations for SDK implementation. If you finished gearing up, see through each SDK guide to implement the features (authentication, billing, etc.) you need.

Last Mile Test: Check the integration status between your game and Hive

The Hive sync guideline check list provides you with a list of items for each Hive service that allows you to check if Hive are implemented in the game properly. The check list allows you to easily check whether the game complies with Hive’s policies or Hive is implemented in the game properly and find if there are any missing features.

 

Termination of Game Service

If you change the game service state to terminated in the Hive console, the Hive SDK cannot run. When running the Hive SDK, an AuthV4ServiceShutdown error occurs during the Hive SDK initialization or authentication phase. When an error occurs, you can refer to the text below to prepare an error message to notify users of termination of game service. It can be used when the actual game service ends or when FGT (Focus Group Test) and CBT (Closed Beta Test) end.

Language Phrase
Korean 서비스 중단으로 인해 로그인을 할 수 없습니다.
English Unable to log in due to service suspension.
Japanese サービス中断によりログインできません。
Simplified Chinese 由于服务中断，无法登录。
Traditional Chinese 因暫停服務，故無法登入。
French Connexion impossible en raison de la suspension du service.
German Die Anmeldung ist nicht möglich, da der Dienst eingestellt wurde.
Russian Невозможно войти ввиду приостановки обслуживания.
Spanish No se puede iniciar sesión debido a la suspensión del servicio.
Portuguese Não é possível fazer login devido à suspensão do serviço.
Indonesian Tidak bisa login karena layanan sedang ditangguhkan.
Vietnamese Không thể đăng nhập do đã ngừng dịch vụ.
Thai ไม่สามารถล็อกอินได้เนื่องจากหยุดการให้บริการชั่วคราว
Italian Impossibile accedere a causa della sospensione del servizio.
Turkish Hizmet durdurulduğu için giriş yapılamıyor.
Arabic يتعذر تسجيل الدخول نظرًا لإيقاف الخدمة.

Submitting the use of collected user information in market consoles.

When you launch your app, each market (Google Play Console, Apple App Store Connect, etc.) checks what kinds of private information are collected and used by your game. A market opens the kinds of private information your app collects and uses to users, and for this a game studio should answer the questionnaire about data safety when registering its app to a market. Thus, when a game studio answers the questions, it should provide the information collected by its game including the information collected by Hive SDK.

Google

Go to the Google Play Console > Policy and programs > App content > Data safety. Click next.

Your app is asked to whether to collect private information, encrypt it, and transfer it. Also, you will be asked to whether the users can request deleting their private information. Select ‘yes’ to all.

You are asked about the collected data types and the purpose of data collection. Please refer to the data collected from Hive SDK and submit answers.

If all required answers are submitted, you are done. You can find your submitted answers on Google Play Store.

Apple

Go to the App Store Connect > App Store > General > App Privacy. Click Get Started.

You will meet a dialogue that checks whether your app collects data. Select “Yes, we collect data from this app” and click Next as Hive SDK collects data.

Selects the data your app collect. Please refer to the data collected from Hive SDK and submit answers.

Save the selected answers, and click publish. The submitted answers about the data collection will be put on public on App Store.

 

The data collected from Hive SDK

You can understand what kinds of data Hive SDK collects and the purpose of collection.

Collected data

Category Field Android iOS
User Info Name X O
Email Address O O
User ID O O
Phone Number O O
Financial Info Purchase History O O
Photos and Videos Photos O O
App Activity App Interactions O O
Other Activity O O
App Info and Performance Diagnostics O O
Device or Other IDs Device or Other IDs O O
Other Data (iOS only) Other Data – O

 

Collected Data Details

Category Field Android iOS
User Info Name – Only used for the real-name verification for the users from China. You need to check this only for the games launched in China.
Email Address The required information for the Hive membership login. The email is collected when a user signs up at Hive membership v1/v4.
You may have to check this when it is used on the event pages.
User ID Nickname, PlayerID, VID, UID, etc. Nickname, PlayerID, VID, UID, etc.
Phone Number Only used for the users from China (for SMS sign in) It is collected when a user enters in his/her Hive membership v1/v4 profile.
You may have to check this when it is used on the event pages.
Financial Info Purchase History The purchase history per PlayerID is saved. The purchase history per PlayerID is saved.
Photos and Videos Photos It is collected if a user agrees to offer it for uploading profile image. It is collected if a user agrees to offer it for uploading profile image.
App Activity App Interactions The number of real-time users is collected when the app is running, and the funnel log data is also collected. The number of real-time users is collected when the app is running, and the funnel log data is also collected.
Other Activity The click counts for the cross banner and promotion banner. The click counts for the cross banner and promotion banner.
App Info and Performance Diagnostics The number of real-time users is collected when the app is running, and the funnel log data is also collected. The number of real-time users is collected when the app is running, and the funnel log data is also collected.
It is used by SDK v4 when the remote logging was initiated via push.
Device or Other IDs Device or Other IDs IP address, browser name, etc.
It is used as a reward criterion of the cross promotion. Only collected when a user allows.		 Collects the advertising identifier and use it for UA tracking and the cross promotion reward.
Other Data (iOS only) Other Data – The user data for supporting customer service is collected (expired within 30 days).

 

The purpose of collection

Category Field Android iOS
User Info Name – app feature
Email Address app feature, ad or marketing, account management, analytics app feature
User ID app feature, analytics, account management app feature, developer ad (the ad for the product or service of the app developer) or marketing, analytics, product personalization
Phone Number app feature, account management app feature, developer ad or marketing
Financial Info Purchase History app feature app feature
Photos and Videos Photos app feature app feature
App Activity App Interactions analytics analytics
Other Activity analytics, developer ad or marketing analytics, developer ad or marketing, other ad (the ad for the product or service of other companies)
App Info and Performance Diagnostics analytics analytics, other purpose
Device or Other IDs Device or Other IDs app feature, analytics, developer ad or marketing analytics, developer ad or marketing, other ad (the ad for the product or service of other companies)
Other Data (iOS only) Other Data – other purpose

 

Hive Identifier Policy

Language Code

The language codes for the 16 languages currently supported by Hive Platform are used by default. The code is in small letter. The language code is based on ‘ISO 639 alpha-2′, and languages not distinguished by ISO 639 alpha-2 are separated by a ‘script tag’.

 

Language Orthography Code
Korean 한국어 ko
English English en
Japanese 日本語 ja
Chinese (Simplified) 简体中文 zh-hans
Chinese (Traditional) 繁體中文 zh-hant
German Deutsch de
French Français fr
Russian русский ru
Spanish Español es
Portuguese Português pt
Indonesian Bahasa Indonesia id
Thai ไทย th
Vietnamese tiếng Việt vi
Italian Italiano it
Turkish Türkçe tr
Arabic العربية ar

Country Code

Country code is based on ‘ISO 3166 alpha-2′ and uses capital letters.

Region Country Code
Europe Germany DE
The United Kingdom GB
France FR
Italy IT
Spain ES
Netherlands NL
Turkey TR
Sweden SE
Switzerland CH
Austria AT
België BE
Poland PL
Norway NO
Denmark DK
Portugal PT
Finland FI
Russia RU
Asia Taiwan TW
Hong Kong HK
Singapore SG
Malaysia MY
Thailand TH
Indonesia ID
India IN
Vietnam VN
Australia AU
America The United States US
Canada CA
Mexico MX
Brazil BR
Argentina AR
Colombia CO
Northeast Asia Korea KR
Japan JP
China CN

Game Server

Hive indicates game server name by location as following table;

Location Server Name
Global GLOBAL
Europe EU
Asia SEA
USA US
Korea KR
Japan JP
China CN

Currency Code

Currency symbols are based on iOS, so some of them may look different on Android-based device.

Country Name and Currency Code Symbol
Albania Lek ALL Lek
Afghanistan Afghani AFN ؋
Argentina Peso ARS AR$
Aruba Guilder AWG ƒ
Australia Dollar AUD AU$
Azerbaijan New Manat AZN ман
Bahamas Dollar BSD $
Barbados Dollar BBD $
Belarus Ruble BYR p.
Belize Dollar BZD BZ$
Bermuda Dollar BMD $
Bolivia Bolíviano BOB $b
Bosnia and Herzegovina Convertible Marka BAM KM
Botswana Pula BWP P
Bulgaria Lev BGN лв
Brazil Real BRL R$
Brunei Darussalam Dollar BND $
Cambodia Riel KHR ៛
Canada Dollar CAD CA$
Cayman Islands Dollar KYD $
Chile Peso CLP CL$
China Yuan Renminbi CNY ¥
Colombia Peso COP CO$
Costa Rica Colon CRC ₡
Croatia Kuna HRK kn
Cuba Peso CUP ₱
Czech Republic Koruna CZK Kč
Denmark Krone DKK kr
Dominican Republic Peso DOP RD$
East Caribbean Dollar XCD EC$
Egypt Pound EGP £
El Salvador Colon SVC $
Euro Member Countries EUR €
Falkland Islands (Malvinas) Pound FKP £
Fiji Dollar FJD $
Ghana Cedi GHS ¢
Gibraltar Pound GIP £
Guatemala Quetzal GTQ Q
Guernsey Pound GGP £
Guyana Dollar GYD $
Honduras Lempira HNL L
Hong Kong Dollar HKD HK$
Hungary Forint HUF Ft
Iceland Krona ISK kr
India Rupee INR ₹
Indonesia Rupiah IDR Rp
Iran Rial IRR ﷼
Isle of Man Pound IMP £
Israel Shekel ILS ₪
Jamaica Dollar JMD J$
Japan Yen JPY ¥
Jersey Pound JEP £
Kazakhstan Tenge KZT лв
Korea (North) Won KPW ₩
Korea (South) Won KRW ₩
Kyrgyzstan Som KGS лв
Laos Kip LAK ₭
Lebanon Pound LBP £
Liberia Dollar LRD $
Macedonia Denar MKD ден
Malaysia Ringgit MYR RM
Mauritius Rupee MUR ₨
Mexico Peso MXN MX$
Mongolia Tughrik MNT ₮
Mozambique Metical MZN MT
Namibia Dollar NAD $
Nepal Rupee NPR ₨
Netherlands Antilles Guilder ANG ƒ
New Zealand Dollar NZD NZ$
Nicaragua Cordoba NIO C$
Nigeria Naira NGN ₦
Korea (North) Won KPW ₩
Norway Krone NOK kr
Oman Rial OMR ﷼
Pakistan Rupee PKR ₨
Panama Balboa PAB B/.
Paraguay Guarani PYG Gs
Peru Sol PEN S/.
Philippines Peso PHP ₱
Poland Zloty PLN zł
Qatar Riyal QAR ﷼
Romania New Leu RON lei
Russia Ruble RUB руб
Saint Helena Pound SHP £
Saudi Arabia Riyal SAR ﷼
Serbia Dinar RSD Дин.
Seychelles Rupee SCR ₨
Singapore Dollar SGD S$
Solomon Islands Dollar SBD $
Somalia Shilling SOS S
South Africa Rand ZAR R
Korea (South) Won KRW ₩
Sri Lanka Rupee LKR ₨
Sweden Krona SEK kr
Switzerland Franc CHF CHF
Suriname Dollar SRD $
Syria Pound SYP £
Taiwan New Dollar TWD NT$
Thailand Baht THB ฿
Trinidad and Tobago Dollar TTD TT$
Turkey Lira TRY ₺
Tuvalu Dollar TVD $
Ukraine Hryvnia UAH ₴
United Kingdom Pound GBP £
United States Dollar USD US$
Uruguay Peso UYU $U
Uzbekistan Som UZS лв
Venezuela Bolivar VEF Bs
Viet Nam Dong VND ₫
Yemen Rial YER ﷼
Zimbabwe Dollar ZWD Z$