새로운 게임 개발을 시작하셨다면 Hive SDK 최신 버전에서 제공하는 많은 이점을 활용하세요. Hive SDK v4는 역대 Hive SDK 중 가장 우수한 SDK이며, 인증 v4는 Hive에서 제공하는 가장 진보한 인증 시스템입니다.

게임에서 SDK 실행 플로우

게임 실행부터 종료까지, 게임에 적용해야 할 Hive의 주요 기능과 API를 한눈에 확인해 보세요. 이미지를 클릭하시면 크게 보실 수 있습니다.

 

Hive SDK 설정과 개발

Hive SDK를 설치하고 SDK 구현을 위한 사전 설정을 진행합니다. 설정을 완료했다면, 인증, 빌링 등 Hive SDK로 구현하려는 기능을 SDK 기능별 안내를 따라 구현합니다.

 

Hive와 게임 연동 체크

Hive 연동 가이드라인 체크리스트는 게임과 Hive의 연동이 잘 되었는지 확인할 수 있는 항목들을 각 Hive 서비스 별로 제공합니다. 이를 통해 게임이 Hive의 정책을 잘 구현하였는지, Hive와 게임이 잘 연동되었는지, 누락된 기능이 없는지 쉽게 확인할 수 있습니다.

 

게임 서비스 종료

Hive 콘솔에서 게임 서비스 상태를 종료로 바꾸면 Hive SDK를 실행할 수 없습니다. Hive SDK 실행 시, Hive SDK 초기화 또는 인증 단계에서 AuthV4ServiceShutdown 에러가 발생합니다. 에러 발생 시 아래 문구를 참고하여 에러 메세지를 구성해 게임 서비스 종료를 안내할 수 있습니다. 실제 게임 서비스 종료 혹은 FGT(Focus Group Test)와 CBT(Closed Beta Test) 종료 시 활용할 수 있습니다.

언어 문구
한국어 서비스 중단으로 인해 로그인을 할 수 없습니다.
영어 Unable to log in due to service suspension.
일본어 サービス中断によりログインできません。
중국어 간체 由于服务中断，无法登录。
중국어 번체 因暫停服務，故無法登入。
프랑스어 Connexion impossible en raison de la suspension du service.
독일어 Die Anmeldung ist nicht möglich, da der Dienst eingestellt wurde.
러시아어 Невозможно войти ввиду приостановки обслуживания.
스페인어 No se puede iniciar sesión debido a la suspensión del servicio.
포르투갈어 Não é possível fazer login devido à suspensão do serviço.
인도네시아어 Tidak bisa login karena layanan sedang ditangguhkan.
베트남어 Không thể đăng nhập do đã ngừng dịch vụ.
태국어 ไม่สามารถล็อกอินได้เนื่องจากหยุดการให้บริการชั่วคราว
이탈리아어 Impossibile accedere a causa della sospensione del servizio.
터키어 Hizmet durdurulduğu için giriş yapılamıyor.
아랍어 يتعذر تسجيل الدخول نظرًا لإيقاف الخدمة.

마켓 콘솔에서 고객 개인정보 사용에 관한 정보 제공

앱을 출시할 때 각 마켓(Google Play Console, Apple App Store Connect 등)에서는 게임이 고객의 어떤 개인정보를 수집, 활용하는지 확인합니다. 마켓은 앱이 수집, 활용하는 개인정보가 무엇인지 고객에게 안내하고 있으며, 이를 위해 게임사는 앱을 마켓에 등록할 때 데이터 보안에 관한 설문에 답변해야 합니다. 따라서, 게임사는 설문에 답변할 때 게임에서 수집하는 정보뿐 아니라 Hive SDK가 수집하는 정보도 함께 제공해야 합니다.

Google

Google Play Console > 정책 > 앱 콘텐츠 > 데이터 보안으로 이동합니다. 다음 버튼을 클릭해 주세요.

앱에서 개인 정보를 수집하고 암호화해서 전송하는지 문의합니다. 또한 수집되는 개인 정보를 삭제하도록 요청할 수 있는지 문의합니다. 모두 해당하므로 ‘네’를 선택해 주세요.

수집하는 데이터 유형과 목적에 대해 문의하는 항목이 나옵니다. 아래 Hive SDK에서 수집하는 데이터를 참고하여 단계별로 작성해 주세요.

설정한 정보를 제출하면 데이터 보안 양식 작성이 완료됩니다. Google Play Store에서 데이터 수집에 대해 답변한 내용을 확인할 수 있습니다.

Apple

App Store Connect > 사이드바에서 앱 개인 정보를 선택합니다. 시작하기 버튼을 클릭해 주세요.

앱에서 데이터를 수집하는지 체크하는 대화 상자가 노출됩니다. Hive SDK는 데이터를 수집하므로 ‘예, 이 앱에서 데이터를 수집합니다.’를 선택하고 다음을 클릭해 주세요.

데이터 수집 문항 중 해당하는 항목을 선택합니다. Hive SDK에서 수집하는 데이터를 참고하여 작성해 주세요.

설정한 정보를 저장하고, 게시를 클릭해 주세요. App Store에서 데이터 수집에 대해 답변한 내용이 게시됩니다.

 

Hive SDK에서 수집하는 데이터

Hive SDK가 수집하는 데이터와 수집 목적에 대해 확인할 수 있습니다.

수집 여부

구분
 항목
 Android iOS
유저 정보 이름 X O
이메일 주소 O O
사용자 ID O O
전화번호 O O
금융 정보 구매 내역 O O
사진 및 동영상 사진 O O
앱 활동 앱 상호적용 O O
기타 작업 O O
앱 정보 및 성능 진단 O O
기기 또는 기타 식별자 기기 또는 기타 ID O O
기타 데이터 (iOS용 항목) 기타 데이터 – O

 

수집 정보

구분 항목 Android iOS
유저 정보 이름 – 중국 실명 인증 시에만 사용. 중국에 런칭하는 게임에만 체크 필요
이메일 주소 Hive 멤버십 로그인 필수 정보 HIVE 멤버십 v1/v4 가입하는 경우 이메일 수집
이벤트 페이지에서 사용 시 체크 필요할 수 있음
사용자 ID 닉네임, PlayerID, VID, UID 등 닉네임, PlayerID, VID, UID 등
전화번호 중국에서만 SMS 로그인 용도로 사용 (휴대폰 번호) HIVE 멤버십 v1/v4 프로필에서 유저가 입력 시 수집
이벤트 페이지에서 사용 시 체크 필요할 수 있음
금융 정보 구매 내역 PlayerID 기준 구매 기록 저장 PlayerID 기준 구매 기록 저장
사진 및 동영상 사진 프로필 사진 등록을 위해 유저가 동의하는 경우 수집 프로필 사진 등록을 위해 유저가 동의하는 경우 수집
앱 활동 앱 상호적용 앱 실행 시 동시 접속자 수 수집, 퍼널 로그 앱 실행 시 동시 접속자 수 수집, 퍼널 로그
기타 작업 크로스 배너 클릭수, 프로모션 배너 클릭 수 크로스 배너 클릭수, 프로모션 배너 클릭 수
앱 정보 및 성능 진단 동시 접속자 수 수집 시 실행 시간 포함 동시 접속자 수 수집 시 실행 시간 포함
SDK v4에서 푸시를 통한 리모트 로그 활성화 시 사용
기기 또는 기타 식별자 기기 또는 기타 ID IP 주소, 브라우저 이름 등
크로스 프로모션 보상 기준으로 사용. 유저 허용 시에만 수집		 광고 식별자 수집하여 UA 트래킹 및 크로스 프로모션 보상에 사용
기타 데이터 (iOS용 항목) 기타 데이터 – 유저가 서비스 지원을 받기 위해 입력한 정보 수집 (30일 내 파기함)

 

수집 목적

구분 항목 Android iOS
유저 정보 이름 – 앱 기능
이메일 주소 앱 기능, 광고 또는 마케팅, 계정 관리, 애널리틱스 앱 기능
사용자 ID 앱 기능, 애널리틱스, 계정 관리 앱 기능, 개발자 광고(앱 개발자의 제품과 서비스를 위한 광고) 및 마케팅, 애널리틱스, 제품 개인 맞춤화
전화번호 앱 기능, 계정 관리 앱 기능, 개발자 광고 및 마케팅
금융 정보 구매 내역 앱 기능 앱 기능
사진 및 동영상 사진 앱 기능 앱 기능
앱 활동 앱 상호적용 애널리틱스 애널리틱스
기타 작업 애널리틱스, 개발자 광고 및 마케팅 애널리틱스, 개발자 광고 및 마케팅, 타사 광고(타사의 제품과 서비스를 위한 광고)
앱 정보 및 성능 진단 애널리틱스 애널리틱스, 기타 목적
기기 또는 기타 식별자 기기 또는 기타 ID 앱 기능, 애널리틱스, 개발자 광고 및 마케팅 애널리틱스, 개발자 광고 및 마케팅, 타사 광고
기타 데이터 (iOS용 항목) 기타 데이터 – 기타 목적

 

Hive 식별자

Hive 언어 코드

언어 코드는 소문자를 사용하며 Hive 플랫폼이 현재 지원중인 16개 언어를 기본으로 합니다. 언어 코드는 ‘ISO 639 alpha-2’를 기준으로 하며 ‘ISO 639 alpha-2’로 구분되지 않는 언어는 ‘Script tag’를 붙여 구분합니다.

언어 언어별 표기법 Hive 언어 코드
한국어 한국어 ko
영어 English en
일본어 日本語 ja
중국어 간체 简体中文 zh-hans
중국어 번체 繁體中文 zh-hant
독일어 Deutsch de
러시아어 русский ru
베트남어 tiếng Việt vi
스페인어 Español es
이탈리아어 Italiano it
인도네시아어 Bahasa Indonesia id
태국어 ไทย th
터키어 Türkçe tr
포르투갈어 Português pt
프랑스어 Français fr
아랍어 العربية ar

Hive 국가 코드

국가 코드는 대문자를 사용하며 ‘ISO 3166 alpha-2’를 기준으로 합니다.

광역 국가 Hive 국가 코드
유럽 독일 DE
영국 GB
프랑스 FR
이탈리아 IT
스페인 ES
네델란드 NL
터키 TR
스웨덴 SE
스위스 CH
오스트리아 AT
벨기에 BE
폴란드 PL
노르웨이 NO
덴마크 DK
포르투갈 PT
핀란드 FI
러시아 RU
아시아 대만 TW
홍콩 HK
싱가포르 SG
말레이시아 MY
태국 TH
인도네시아 ID
인도 IN
베트남 VN
호주 AU
아메리카 미국 US
캐나다 CA
멕시코 MX
브라질 BR
아르헨티나 AR
콜롬비아 CO
동북아 한국 KR
일본 JP
중국 CN

게임 서버 표기법

Hive에서 게임 서버 지역을 표기하는 법은 다음과 같습니다.

지역 영문 표기 Hive 게임 서버 표기법
글로벌 Global GLOBAL
유럽 Europe EU
동남아시아 Asia SEA
북미 USA US
한국 Korea KR
일본 Japan JP
중국 China CN

통화 기호

통화 표기 문자는 iOS 기준이며, 안드로이드에서는 일부 차이가 있을 수 있습니다.

국가 및 통화 통화 코드 통화 표기 문자
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 $
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$