새로운 게임 개발을 시작하셨다면 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 연동 가이드 라인 체크리스트 다운로드 (국문)
- 최종 업로드: 2024-12-02
- 다운로드: 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 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 |
프랑스어 | Français | fr |
러시아어 | русский | ru |
스페인어 | Español | es |
포르투갈어 | Português | pt |
인도네시아어 | Bahasa Indonesia | id |
태국어 | ไทย | th |
베트남어 | tiếng Việt | vi |
이탈리아어 | Italiano | it |
터키어 | Türkçe | tr |
아랍어 | العربية | 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$ |