Version: 2023.1
언어: 한국어
UDP 빌드에 Firebase 사용
UDP API

UDP 레퍼런스

UDP 콘솔 레퍼런스

이 섹션에서는 UDP 콘솔의 정보 아키텍처에 대한 간략한 개요를 제공합니다.

UDP 콘솔에 있는 탐색 표시줄을 사용하면 UDP 콘솔의 다음 섹션 간에 이동할 수 있습니다.

개요

UDP 콘솔의 Overview 탭에는 UDP 콘솔을 사용하는 방법에 대한 다음과 같은 유용한 정보가 들어 있습니다.

  • 튜토리얼 비디오
  • 진행 상황을 추적하도록 도와주는 가이드
  • 스토어별 정보
  • FAQ

내 게임

My Games 탭에는 UDP 프로젝트가 표시됩니다. 여기에서 UDP 프로젝트 간에 전환하고, 새 게임을 생성하고, 게임을 보관복원할 수 있습니다.

예를 들면 다음과 같이 상태를 기준으로 게임 리스트를 필터링할 수 있습니다.

  • All Games
  • Published to UDP
  • Submitted to stores
  • Live on stores

Submitted to stores 또는 Live on stores를 선택하면 스토어별로 게임 리스트를 필터링할 수도 있습니다.

게임을 선택하면 다음 탭을 사용할 수 있습니다.

  • Game Info
  • Publish
  • Status

각 게임 카드는 게임의 상태를 표시합니다. ‘Published’ 상태는 게임을 리패킹하여 스토어에 제출하기 위한 단계를 완료했음을 나타냅니다.

게임 정보

Game Info 페이지를 사용하면 게임 정보를 확인하고 수정할 수 있습니다. UDP 콘솔에서 게임 정보 입력을 참조하십시오. 게임의 Game Info 페이지를 보려면 My Games 탭에서 카드를 선택하십시오.

Game Info 페이지는 다음 섹션으로 구성됩니다.

Game Info 페이지에는 게임 출시에 얼마나 가까워졌는지 보여주는 진행 표시줄이 있습니다. 각 섹션의 필수 정보를 추가하면 해당 섹션이 Completed 상태로 표시됩니다.

게임 설명

Game Description 섹션에서 앱 스토어에 표시될 게임 정보를 입력하십시오.

아래 표에는 모든 참여 스토어 요구 사항의 상위 집합에 대한 설명이 나와 있습니다. 모든 스토어가 여기에 설명된 모든 프로퍼티를 사용하지는 않습니다. UDP 콘솔은 필수 필드와 옵션 필드에 대한 플래그를 지정합니다. 또한 UDP 콘솔은 스토어별 구문 요구 사항을 나타냅니다.

프로퍼티 설명
Import from Google Play Google Play에 게임을 이미 퍼블리시한 경우 게임의 Google Play URL을 사용하여 기본 정보를 임포트할 수 있습니다.
Game Title 게임의 타이틀입니다(이 필드는 에디터와 동기화됨).
Genre 게임이 속한 카테고리를 나타냅니다. 액션, 어드벤처, 아케이드, 보드, 카드, 카지노, 캐주얼, 교육, 음악, 퍼즐, 레이싱, 롤플레잉, 시뮬레이션, 스포츠, 전략, 퀴즈, 단어 중에서 선택할 수 있습니다.
기기 스마트폰, 태블릿 또는 유니버설 중에서 선택할 수 있습니다.
Game Icon 앱 스토어에 표시할 게임 아이콘입니다.
Short Description 앱 스토어에 표시할 게임에 대한 짧은 설명(최대 60자)입니다.
설명 앱 스토어에 표시할 게임에 대한 전체 설명(최대 4,000자)입니다.
Game Banners 게임을 소개하기 위해 스토어에서 사용하는 이미지입니다. 예를 들어 캐러셀(carousel) 형식으로 배치될 수 있습니다. 가로 배너는 필수이고 세로 배너는 선택 사항입니다.
Keywords 최대 4개의 키워드(각각 30자)를 정의합니다. 키워드는 앱 스토어에서 검색 목적으로 사용됩니다.
Feature Video 게임의 비디오 트레일러를 추가합니다.
참고: 비디오의 경우 MP4 파일만 허용하는 스토어도 있고 Youtube 링크만 허용하는 스토어도 있기 때문에 둘 다 업로드하는 것이 좋습니다.
Screenshots MP4 비디오가 재생되지 않을 때 위에 올려 놓을 커버 이미지(썸네일)를 비롯한 게임 스크린샷을 추가합니다.
사용하는 방향당 최소 4개의 이미지를 추가해야 합니다.
일부 앱 스토어는 가로 이미지 또는 세로 이미지 중 하나만 허용합니다. UDP에 가로 이미지와 세로 이미지를 모두 업로드하는 경우 Preference 필드에서 원하는 방향을 선택하십시오. 스크린샷이 스토어의 요구 사항을 충족하지 않으면 UDP에 알림이 표시됩니다.
Use these screenshots for all languages 모든 언어에 같은 스크린샷을 사용하려면 이 토글을 활성화하십시오. 언어별로 다른 스크린샷을 추가하려면 이 토글을 비활성화하십시오.
환경 설정 일부 앱 스토어는 가로 이미지 또는 세로 이미지 중 하나만 허용합니다. 이 경우 사용할 이미지 방향을 지정하십시오.
Ratings 게임을 플레이하기에 적합한 대상을 선택합니다.

지원되는 각 언어에 대한 메타데이터를 지정할 수 있습니다. 새 언어를 추가하려면 편집 모드에서 언어 드롭다운을 선택한 후 Manage Languages를 선택하십시오.

바이너리

Binary 섹션을 사용하여 APK 파일과 OBB파일 또는 AAB 파일을 업로드할 수 있습니다.

프로퍼티 설명
APK Files (or AAB) UDP 게임 빌드입니다. 클라우드 빌드를 통해 UDP 빌드를 푸시한 경우 다시 업로드할 필요가 없습니다.
UDP가 APK 파일을 수락하려면 APK 파일이 다음을 충족해야 합니다.
- versionName을 포함해야 합니다.
- Initialize() 메서드를 포함해야 합니다.
- Purchase() 메서드를 포함해야 합니다(IAP를 제공하는 게임의 경우).
다른 패키지 이름이 포함된 새 APK 버전을 업로드하면 오류가 발생합니다. 이 경우 새 APK 버전을 퍼블리시할 수 없습니다.
Android App Bundle(AAB) 파일을 업로드하려면 Convert from AAB file 옵션을 선택하십시오. UDP는 스토어 퍼블리싱을 위해 AAB 파일을 APK로 전환합니다.
Version code 이 필드는 게임을 UDP에 업로드해야 ​​표시됩니다.
Minimum Android Version Support 게임에 대해 지원되는 최소 Android 버전입니다. 이 필드는 게임을 UDP에 업로드해야 ​​표시됩니다.
What’s New 이 버전의 게임에서 변경된 사항을 설명합니다. UDP는 이 정보를 스토어에 퍼블리시합니다.
이 필드는 게임을 UDP에 업로드해야 ​​표시됩니다.
OBB File (Main) 게임 또는 앱에 필요할 수 있는 추가 리소스의 기본 확장 파일입니다.
OBB File (Patch) 기본 확장 파일을 약간 업데이트하기 위한 옵션 파일입니다.
Does your game use Google Play Services? UDP가 Google Play Services 사용에 대해 알고 있으면 제출 단계를 안내하는 데 도움이 됩니다.

OBB 파일은 클라우드 빌드 배포 중에는 푸시되지 않습니다. 게임이 OBB 파일을 사용하는 경우 UDP 콘솔에 수동으로 업로드해야 합니다.

참고: 기본 언어 보기(영어)에서만 APK 파일과 OBB 파일을 변경할 수 있습니다.

광고

아래 표에는 Ads 섹션에 대한 설명이 나와 있습니다.

프로퍼티 설명
Does your game contain ads 게임에 광고가 포함되는지 선택합니다. 이 정보는 UDP가 제출 단계를 안내하는 데 도움이 됩니다.
What ad mediation solutions does your game use? (Optional) 게임에 광고가 포함되는 경우 게임에서 사용할 미디에이션 솔루션을 선택합니다.
What ad networks does your game use? (Optional) 게임에 광고가 포함되는 경우 게임에서 사용할 광고 네트워크를 선택합니다.

특정 스토어는 제출되는 게임이 해당 스토어의 독점 광고 네트워크를 구현하기를 기대합니다.

UDP는 스토어 제출을 더욱 잘 안내하기 위해 게임에 광고가 포함되는지 묻습니다. UDP는 제출된 게임이 이로 인해 스토어에서 거부될 수 있는지 알려줄 수 있습니다.

게임을 거부할 가능성이 있는 스토어인 경우 Publish 섹션에 경고 아이콘과 발생할 수 있는 문제를 설명하는 툴팁이 표시됩니다. 그렇지 않으면 UDP는 게임의 광고 구현을 어떤 식으로도 수정하지 않습니다.

참고: 가장 일반적인 미디에이션 레이어 및 광고 네트워크에 대한 테스트는 UDP 스토어 제출을 위해 리패킹된 게임이 광고 캠페인을 수신하는 데 아무런 문제가 없음을 보여줍니다. 광고 설정과 UDP를 통한 배포에 대한 적합성에 대한 내용은 언제든지 UDP 지원 팀에 문의하시기 바랍니다. 게임에서 사용하는 미디에이션 SDK와 광고 네트워크를 알려주면 정보에 기반한 답변을 빠르게 받을 수 있습니다.

프리미엄 가격

프리미엄 가격은 플레이어가 게임을 다운로드할 때 지불하는 비용입니다.

프로퍼티 설명
Manage amounts and currencies 게임 가격을 USD로 설정합니다.
Convert*를 선택하면 USD 가격이 나열된 다른 통화로 자동 변환됩니다. 특정 통화에 대한 가격을 수동으로 편집할 수도 있습니다.

참고: 프리미엄 게임을 지원하는 스토어에만 프리미엄 게임을 제출할 수 있습니다.

인앱 구매

In-App Purchases 섹션을 사용하여 IAP 아이템을 추가하고 관리할 수 있습니다.

UDP 패키지를 사용하는 경우 UDP는 Unity 에디터와 UDP 콘솔 간에 게임의 IAP 카탈로그를 자동으로 동기화합니다.

프로퍼티 설명
Search box 텍스트를 기준으로 IAP 아이템 리스트를 필터링합니다.
Type dropdown 타입(소비성 또는 비소비성)을 기준으로 IAP 아이템 리스트를 필터링합니다.
Sort dropdown IAP 아이템 리스트의 정렬 방식을 선택합니다.
Add Item 클릭하여 새로운 IAP 아이템을 추가합니다. 그러면 IAP 세부 정보를 입력할 수 있는 창이 열립니다.
Manage amounts and currencies 클릭하여 추가 통화에 대한 가격을 설정합니다.
Convert IAP 아이템의 USD 가격을 글로벌 통화로 변환합니다. 이 작업은 다른 통화에 대해 수동으로 설정한 가격을 덮어씁니다.
Favourite Currencies 선택하면 Favourite currencies 창이 열립니다. 통화를 즐겨찾기 통화로 설정하려면 해당 통화 코드 옆의 별 아이콘을 선택하십시오. 그러면 해당 통화가 리스트 상단에 고정됩니다. 별 아이콘을 선택 해제하면 고정이 취소됩니다.
IAP 아이템 창

IAP Item 창을 사용하여 IAP 상품의 세부 정보를 추가하고 편집할 수 있습니다. 이 창을 열려면 Add Item을 선택하십시오. 아래 표에는 Add IAP Item 창의 필드에 대한 설명이 나와 있습니다.

필드 설명
Product ID IAP 상품을 식별하는 데 사용되는 고유 Id입니다.
상품 ID는 다음 요구 사항을 준수해야 합니다.
- 문자 또는 숫자로 시작합니다.
- 문자, 숫자, 점(.), 밑줄(_)만 포함합니다.
- 대문자는 사용할 수 없습니다.
Product Name IAP 상품의 이름입니다.
Currency 가격을 표시할 때 사용되는 통화입니다.
Price IAP 상품의 가격(USD)입니다.
플레이어가 게임에서 상품을 구매할 수 있도록 하려면 가격을 지정해야 합니다.
Consumable 소비성 IAP 아이템의 경우 이 옵션을 선택합니다.
설명 IAP 상품에 대한 짧은 설명입니다.

샌드박스 테스트

Sandbox Testing 섹션에는 게임의 테스트 상태가 표시됩니다. 이 섹션을 사용하여 샌드박스 환경에서 테스트할 사용자 자격 증명을 만들고 테스트 상태를 확인할 수 있습니다. 아래 표에는 이 섹션의 필드에 대한 설명이 나와 있습니다.

필드 설명
Test status 게임의 테스트 상태를 표시합니다.
UDP Initialization 초기화 검사에 대한 테스트 상태를 표시합니다. 모든 게임에 대해 Initialize() 메서드가 호출되었는지 확인합니다.
IAP Transaction IAP 거래 검사에 대한 테스트 상태를 표시합니다. IAP 게임에 대해서만 Purchase() 메서드가 호출됩니다.
Sandbox Test Account 샌드박스 테스트 계정의 이메일 주소입니다. UDP 샌드박스 환경의 로그인 이름으로만 사용됩니다.
Password 테스트 계정의 비밀번호입니다.

앱 서명

UDP는 앱 서명 프라이빗 키를 사용하여 스토어에 제출된 리패킹 APK 파일에 서명합니다.

Unity는 Export and upload the key and certificate를 선택하고 자체 앱 서명 프라이빗 키를 사용할 것을 권장합니다. 게임이 Google Play에서 출시된 경우 Google Play에서와 동일한 키를 사용하십시오. 그렇게 하면 사용자가 게임을 설치할 때 Google Play 프로텍트가 해당 게임을 보안 위협으로 간주할 확률이 크게 감소합니다.

참고: 게임이 보안 위협으로 간주되었다면 여기에서 Google에 이의를 제기하십시오.

아래 표에는 Game Info 탭의 App Signature 섹션에 대한 설명이 나와 있습니다.

프로퍼티 설명
Export and upload the key and certificate (recommended) UDP가 업로드되는 앱 서명 프라이빗 키를 사용하여 리패킹된 빌드에 서명합니다. 이 옵션을 선택하면 게임을 제출하는 모든 스토어에 적용됩니다.
Let UDP create and manage App signing private key UDP는 게임이 제출을 위해 리패킹되는 각 스토어에 대해 다른 앱 서명 프라이빗 키를 생성합니다.
이 옵션을 사용하면 게임이 Google Play 프로텍트 경고에 더 취약해집니다.

참고: 앱 서명 생성은 Android SDK 버전 18 이상에서만 지원됩니다. 게임에서 이보다 낮은 SDK 버전을 사용한다면 RSA 알고리즘 서명을 사용하거나 게임의 최소 API 수준을 높이십시오.

키 변경

언제든지 UDP 키 사용에서 자체 키 사용으로 전환할 수 있습니다. 이 변경 사항은 게임이 리패킹되지 않고 서명되지 않은 스토어에만 적용됩니다. UDP 키를 사용하여 특정 스토어에 제출하기 위해 이미 리패킹한 경우 해당 스토어는 항상 UDP 키를 사용합니다.

특정 스토어에 제출하기 위해 게임과 자체 키를 리패킹하지 않은 경우에만 자체 키 사용에서 UDP 키 사용으로 전환할 수 있습니다.

UDP 생성 키

UDP는 다음 조건이 충족되면 회사 정보를 사용하여 리패킹된 APK 파일에 대한 키스토어를 생성합니다.

  • 개발자가 업로드한 APK 파일에 키스토어 파일이 없습니다.
  • 게임이 파트너 스토어에서 리패킹되지 않았습니다.

이러한 조건이 충족되지 않으면 UDP는 기존 UDP 키스토어(사용 가능한 경우)를 사용하거나 개발자 정보를 사용하여 새로운 서명 파일을 생성합니다.

통합 정보

이 정보는 에디터와 동기화됩니다. 다음 필드를 편집할 수 있습니다.

필드 설명
Unity Project ID UDP 클라이언트에 연결된 Unity 프로젝트 ID입니다.
UDP 클라이언트와 Unity 프로젝트의 연결을 해제하려면 이 필드에서 ID를 삭제하고 Save를 선택하십시오.
참고: 소유자와 관리자만 이 필드를 편집할 수 있습니다.
Callback URL 게임 서버의 URL입니다. UDP는 이 URL을 사용하여 결제 결과에 대한 알림을 보냅니다.

릴리스 창

Release 창을 사용하여 게임 버전을 릴리스할 수 있습니다. 이 창은 Game Info 페이지에서 Release를 선택할 경우 표시됩니다.

Release 창에 있는 필드를 사용하여 버전의 다음 사항을 지정할 수 있습니다.

  • 태그
  • 릴리스 노트

모든 리비전의 태그와 릴리스 노트는 다음 위치에서 확인할 수 있습니다.

  • Game Info 섹션에서 Revision 드롭다운 확장
  • 릴리스별로 구성된 Status 섹션

참고: 최신 리비전만 스토어에 퍼블리시할 수 있습니다.

다음에 대해 자세히 알아보십시오.

퍼블리시 패널

Publish 패널을 사용하여 스토어에 등록하고 게임을 퍼블리시할 수 있습니다. 페이지에는 각 스토어의 자체 섹션이 있습니다.

아래 표에는 Publish 페이지에 대한 설명이 나와 있습니다.

필드 설명
Publish 선택한 게임을 퍼블리시합니다.
Only show stores that accept the game’s pricing model Publish 페이지에서 게임의 가격 모델을 지원하지 않는 스토어를 숨깁니다.
All Stores 퍼블리싱을 위해 표시된 모든 스토어를 선택합니다.
Store checkbox 스토어 체크박스를 선택하면 선택한 스토어에만 퍼블리시합니다.
Premium 프리미엄 게임을 지원하는 스토어의 경우 Premium 레이블이 표시됩니다.
IAP IAP를 지원하는 스토어의 경우 IAP 레이블이 표시됩니다.
Info icon 정보 아이콘은 스토어가 UDP와 완전히 또는 부분적으로 통합되었는지 나타냅니다.
Sign up 선택한 스토어에 등록합니다.
Countries Countries를 선택하면 게임을 퍼블리시할 국가를 선택할 수 있습니다.
선택 시 스토어에서 지원하는 국가 리스트가 포함된 창이 열립니다. 체크박스를 선택하여 특정 국가에 대해 게임을 활성화한 후 Save를 선택하십시오.
이 옵션은 해당 스토어에 등록한 경우에만 표시됩니다.
Advanced 특정 스토어에 대한 고급 프로퍼티를 구성하려는 경우 선택합니다.
이 옵션은 해당 스토어에 등록한 경우에만 표시됩니다.

타겟 단계

Publish 탭의 각 스토어에는 특정 스토어에 대한 타겟 단계를 선택할 수 있는 드롭다운이 있습니다. 이용할 수 있는 옵션은 다음과 같습니다.

타겟 단계 설명
Repack Game UDP가 일반 UDP 빌드를 언패킹한 후 선택한 스토어의 SDK로 게임을 리패킹합니다. 이 작업에는 스토어에 제출한 마지막 빌드의 IAP 카탈로그가 사용됩니다.
Submit to Store UDP가 게임과 해당 메타데이터 및 IAP 카탈로그를 리패킹한 후 선택한 스토어의 프로덕션 환경에 제출합니다.
게임을 처음 퍼블리시하는 경우 이 작업을 수행하지 않으면 스토어의 서버에 IAP 카탈로그가 생성되지 않습니다.

고급 설정

게임을 제출하기 전에 스토어별 설정을 구성하려면 Publish 탭에서 해당 스토어에 대한 Advanced를 선택하십시오. 스토어에 대해 다음 프로퍼티를 설정할 수 있습니다.

프로퍼티 기능 영향을 받는 스토어
Target SDK 게임을 퍼블리시하는 스토어 SDK의 버전입니다. 기본적으로 UDP는 최신 버전의 스토어 SDK에 대해 리패킹을 수행합니다. 모두
CP ID Huawei AppGallery Connect 콘솔의 판매자 ID입니다. Huawei
Product ID Huawei AppGallery Connect 콘솔의 제품 ID입니다. Huawei
App ID Huawei AppGallery Connect 콘솔의 애플리케이션 ID입니다. Huawei
Configuration version on the Huawei AppGallery Connect console. Version of the game Huawei
PubKey Huawei AppGallery Connect 콘솔의 공용 키입니다. Huawei
App Secret Huawei AppGallery Connect 콘솔의 앱 암호입니다. Huawei
privacyPolicy Huawei AppGallery Connect 콘솔의 개인정보 취급방침 주소입니다. Huawei
Premium Price 플레이어가 게임을 다운로드하기 위해 지불하는 가격입니다. 프리미엄 게임을 지원하는 모든 스토어
In-App Purchases IAP 아이템의 이름입니다. 모두
Approval Number from SAPPRFT (aka ISBN) 중국에서 퍼블리시하는 게임에 대한 SAPPRFT 승인 번호를 입력합니다. 이에 대한 퍼블리싱 라이선스가 없으면 국가 리스트에서 중국을 선택 해제하십시오. Xiaomi
Huawei
Registration Number from MCPRC 중국에서 퍼블리시하는 게임에 대한 문화 기록부 번호입니다. Huawei
Launch Manually 스토어에서 게임이 수동으로 출시되도록 설정합니다. Huawei
Launch on 스토어에서 게임을 출시할 날짜와 시간을 지정합니다. Huawei
Renew authentication 선택한 스토어에 ​​대한 인증 토큰을 갱신합니다. Huawei
패키지 이름 패키지 이름을 표시합니다. 등록된 후에는 편집할 수 없습니다. QooApp
Viveport
URL for Privacy Policy 게임의 개인정보 취급방침에 대한 URL을 입력합니다. Viveport
URL for EULA/Terms of Use 게임의 EULA/이용 약관에 대한 URL을 입력합니다. Viveport

세부 정보

제출물에 누락된 항목이 있으면 UDP 콘솔에 오류 또는 경고 메시지가 표시됩니다. Detail을 선택하여 확장한 후 문제에 대한 자세한 내용을 확인하십시오.

오류는 빨간색 패널에 표시됩니다. 게임을 제출하려면 오류를 수정해야 합니다. Modify를 선택하여 오류 위치로 이동한 후 문제를 수정하십시오.

오류가 없는 스토어에만 제출하도록 선택할 수도 있습니다.

경고는 노란색 패널에 표시됩니다. 무시하기로 결정한 경고는 닫을 수 있습니다.

상태 패널

UDP가 게임을 처리하기 시작하면 Status 패널에서 진행 상황을 모니터링하고 게임 제출 기록을 확인할 수 있습니다.

Status 패널에는 게임 기록에 대한 개요가 표시됩니다.

필드 설명
Revisions repacked UDP에서 생성된 리패킹 APK 빌드의 총 개수입니다.
참고: 게임이 동일한 스토어에서 3번 리패킹되면 3개로 집계됩니다.
Revisions submitted UDP를 통해 제출한 제출물의 총 개수입니다.
참고: 게임이 스토어에 5번 제출되면 5개로 집계됩니다.
Submissions accepted 앱 스토어에서 승인된 제출물 개수입니다.
Submissions rejected 앱 스토어에서 거부된 리비전 개수입니다.

각 게임 리비전에 대해 Status 패널은 다음의 세부 정보를 표시합니다.

필드 설명
Store 게임이 제출된 스토어입니다.
Status 리비전의 상태입니다.
일부 스토어는 ‘Live’ 단계까지 가시성을 제공하지 않습니다. Status 섹션은 스토어에서 얻을 수 있는 정보만 제공합니다.
Countries 스토어별로 게임이 활성화된 국가 개수입니다. 국가를 보려면 이 열에서 번호를 선택하십시오.
액션 게임의 리비전을 다운로드하거나 스토어로 이동하는 등의 추가 작업을 수행하여 퍼블리싱 단계를 완료합니다.

게임의 상태는 다음과 같습니다.

  • Repacked: 선택한 스토어의 SDK로 게임을 성공적으로 리패킹했습니다.
  • Published: 리패킹하여 스토어에 제출한 게임이 해당 스토어에서 요구하는 모든 단계를 통과했습니다.
  • Pending: 선택한 스토어의 SDK로 게임을 리패킹하는 중입니다.
  • Failed: 선택한 스토어의 SDK로 게임을 리패킹하지 못했습니다.
  • Canceled: 제출자 또는 조직 내 다른 사람이 게임 제출을 취소했습니다.

Store Sign-Ups

Store Sign-Ups 탭에는 UDP를 사용하여 게임을 배포할 수 있는 스토어에 대한 정보가 표시됩니다.

More 링크를 선택하면 스토어에 대한 자세한 내용(예: 개요, FAQ, 기타 유용한 스토어별 링크)을 확인할 수 있습니다.

모든 스토어의 정보 개요를 확인하려면 Compare stores를 선택하여 파트너 스토어 치트 시트를 엽니다. 이 시트는 사용자 수, 스토어가 제공되는 국가, 스토어의 프리미엄 게임 지원 여부 등의 데이터를 포함한 모든 데이터의 세부 정보를 비교하여 나타냅니다.

보고 대시보드

Reporting 탭에는 퍼블리시된 게임의 실적 정보가 표시됩니다. 상단 탐색 표시줄에서 액세스할 수 있는 보고 대시보드에서 퍼블리시된 게임의 실적을 모니터링하십시오.

보고 대시보드에 표시되는 정보는 게임별로 및 스토어별로 필터링할 수 있습니다.

전체 보고 대시보드에 대해 All GamesAll Stores에서 아무것도 선택하지 않으면 개별 차트 수준(해당하는 경우)의 분석 데이터를 확인할 수 있습니다. 지원되는 차트에서 by store 또는 by game 필터를 선택하여 특정 스토어 또는 개별 게임에 대한 실적을 확인하십시오.

보고 대시보드는 다섯 개의 패널로 나뉘고, 모두 Games 및 Stores 필터의 적용을 받습니다. 날짜 필터가 적용된 패널의 경우 차트 데이터를 CSV 파일 및 이미지로 익스포트할 수 있습니다. 데이터를 CSV 파일 또는 이미지로 다운로드하려면 차트에 대한 해당 아이콘을 선택하십시오.

참고: Huawei AppGallery는 개발자가 QueryOrder를 사용하여 서버 측 확인을 설정한 경우에만 수익 정보를 UDP에 반환합니다. 콜백 알림을 사용한 경우 Huawei에 대한 수익 관련 차트 또는 정보를 사용할 수 없습니다.

지표 및 정의

보고 대시보드는 게임이 퍼블리시된 UDP 스토어에서 다음 데이터를 추적합니다.

지표 설명
Gross revenue 플레이어로부터 거둔 수익(USD)입니다(예: IAP 가격이 0.99이면 $0.99).
Players 게임을 다운로드하고 실행한 고유 사용자 수입니다. 이 수치는 고유 기기를 기준으로 집계됩니다.
Spenders 유료 플레이어 수입니다. 즉 한 번 이상 결제를 완료한 고유 사용자 수입니다.
Days since 1st activity 게임이 앱 스토어에서 10명의 플레이어에게 도달한 이후 경과한 일수입니다.
New Players 선택된 기간 동안 게임을 처음으로 실행한 플레이어 수입니다.
DAU 일별 액티브 유저입니다. 해당 일에 한 번 이상 게임을 실행한 고유 사용자 수를 나타냅니다.
MAU 월별 액티브 유저입니다. 지난 30일 동안 한 번 이상 게임을 실행한 고유 사용자 수를 나타냅니다.
IAP Revenue IAP를 통해 거둔 총 수익(USD)입니다.
Average Revenue per Transaction 수익을 거래 수로 나눈 값(USD)으로 정의됩니다.
ARPPU 유료 사용자당 평균 수익(USD)입니다. 총 수익을 유료 사용자 수로 나눈 값으로 정의됩니다.
ARPU 사용자당 평균 수익(USD)입니다. 총 수익을 사용자 수로 나눈 값으로 정의됩니다.
Spender Conversion Rate 유료 플레이어 수를 플레이어 수로 나눈 값으로 정의됩니다.
Transactions 결제로 이어진 성공적인 거래의 수입니다(OrderID가 UDP 서버에서 성공적으로 확인됨).
Revenue by IAP IAP를 통해 거둔 총 수익(USD)에 대한 분석 데이터입니다.
Transaction Volume by IAP IAP 거래에 대한 분석 데이터입니다.
Premium Revenue 프리미엄 게임을 통해 발생한 총 수익(USD)입니다.
Sessions 모든 기기에서 게임이 실행된 횟수입니다.
Day 1 Retention (%) 첫 게임 실행 이후 1일 동안 활성 상태를 유지한 플레이어 비율로 정의됩니다.
Day 7 Retention (%) 첫 게임 실행 이후 7일 동안 활성 상태를 유지한 플레이어 비율로 정의됩니다.
Day 30 Retention (%) 첫 게임 실행 이후 30일 동안 활성 상태를 유지한 플레이어 비율로 정의됩니다.

참고: 보고 대시보드에는 예상 데이터가 포함되어 있으며, 정확한 수치는 해당 스토어에서 직접 얻을 수 있습니다. 표시된 데이터는 UTC 시간 기준이며, 가장 정확하고 완전한 데이터를 표시하기 위해 전날까지의 데이터만 집계합니다.

전체 시간

이 패널에는 다음의 생애 지표가 표시됩니다.

  • 총 수익(USD)
  • 플레이어 수
  • 지출자 수
  • 첫 번째 활동 이후 경과 일수

어제

이 패널에는 지난 24시간에 대한 다음 지표가 표시됩니다(UTC 기준).

  • 총 수익(USD)과 전날 대비 금액($) 또는 비율(%)
  • 신규 플레이어 수
  • DAU와 지난 7일간의 평균 DAU 값 대비 비율(%)
  • MAU와 지난 7일간의 평균 MAU 값 대비 비율(%)

IAP 실적

이 패널에는 선택한 날짜 범위에 대한 다음 지표가 표시됩니다.

  • IAP 수익
  • 거래당 평균 수익
  • ARPPU
  • ARPU
  • 지출자 전환율
  • 거래 수
  • IAP별 수익. 차트에서 최대 5개의 IAP를 확인할 수 있으며, 드롭다운 선택기를 통해 확인할 항목을 선택할 수 있습니다. 이 차트에는 다음에 대한 프리셋이 포함되어 있습니다.
    • 최고 수익
    • 최대 거래 수
    • 최고 가격 지점
    • 최저 가격 지점
  • IAP별 거래량. 차트에서 최대 5개의 IAP를 확인할 수 있으며, 드롭다운 선택기를 통해 확인할 항목을 선택할 수 있습니다. 이 차트에는 다음에 대한 프리셋이 포함되어 있습니다.
    • 최고 수익
    • 최대 거래 수
    • 최고 가격 지점
    • 최저 가격 지점

프리미엄 수익

이 패널에는 선택한 날짜 범위에 대한 다음 지표가 표시됩니다.

  • 프리미엄 수익(유료 다운로드를 통해 얻은 수익)

게임 상태

이 패널에는 선택한 날짜 범위에 대한 다음 지표가 표시됩니다.

  • DAU - 일일 및 기간 평균
  • MAU - 일일 및 기간 평균
  • 신규 플레이어 수 - 일일 및 기간 총계
  • 세션 수 - 일일 및 기간 총계
  • 1일 리텐션율 - 일일 및 기간 평균
  • 7일 리텐션율 - 일일 및 기간 평균
  • 30일 리텐션율 - 일일 및 기간 평균

Documentation

Documentation 탭에는 시작하는 데 도움이 되는 다음과 같은 유용한 정보가 표시됩니다.

  • UDP 문서 링크
  • 다른 앱 스토어에 대한 가이드
  • 비디오 튜토리얼

리소스

Resources 탭은 시작하는 데 도움이 되는 다음과 같은 유용한 정보를 제공합니다.

  • 시작 가이드
  • 튜토리얼 비디오
  • 스토어 가이드
  • Knowledge base
  • 릴리스 노트

설정 항목

Company Information

Company Information 창을 사용하여 앱 스토어에서 회사에 대해 표시할 정보를 추가할 수 있습니다. UDP 콘솔에서 조직을 선택하고 연필 아이콘을 선택하여 프로필을 편집하십시오.

필드 설명
Company Name 플레이어에게 표시할 회사 이름입니다.
Company Icon 회사를 나타내는 이미지를 업로드합니다.
위치 스튜디오의 본사로 정의할 위치입니다.
Company Size 드롭다운을 사용하여 회사의 직원 수를 지정합니다.
Official Website 회사의 공식 웹사이트입니다.
Support Email Address 플레이어가 회사에 연락하는 데 사용할 수 있는 지원 이메일입니다.
Introduction 회사/스튜디오에 대한 추가 정보입니다

개발자 API

개발자 API 페이지에서는 UDP API와 함께 사용할 인증 토큰을 생성하고 관리할 수 있습니다. UDP API를 사용하여 UDP 콘솔에 바이너리 파일을 업로드할 수 있습니다. UDP 콘솔에서 게임 관리 및 퍼블리싱을 참조하십시오.

아래 표에는 개발자 API 페이지에 대한 설명이 나와 있습니다.

필드 설명
Token UDP API가 UDP 콘솔에 액세스할 수 있도록 사용하는 인증 토큰입니다. 토큰을 클립보드로 복사하려면 COPY를 선택하십시오.
Expiry date 인증 토큰의 만료일입니다(지정된 경우).
Operations 기존 토큰을 수정하거나 삭제합니다.
NEW TOKEN 새 토큰을 생성하려면 선택합니다.

CSV 레퍼런스

CSV 파일용 데이터 값

인앱 구매 CSV 파일의 각 행에는 다음 값이 포함될 수 있습니다. 빈 값을 전달하지 마십시오.

필드 설명
product_id 고유한 IAP 상품의 ID를 나타냅니다. product_id는 소문자 또는 숫자로 시작하고 소문자(a-z), 숫자(0–9), 밑줄(_), 마침표(.)로만 구성되어야 합니다.
language; product_name; description 언어 값을 설정할 때에는 표 A에 나열된 언어 코드를 사용하십시오.
UDP는 기본 언어로 en-US를 사용합니다.
세미콜론(;)을 사용하여 언어, 상품 이름, 설명을 구분하십시오.
아이템의 상품 이름과 설명에 대한 현지화 버전을 포함하려면 기본 언어, 상품 이름, 설명을 나열한 후 각 로케일에 대한 언어, 상품 이름, 설명을 나열합니다. 다음 예에서 상품은 en-US(영어)를 기본 언어로 사용하고 zh-CN(중국어)을 현지 언어로 사용합니다.
en-US;Product 1;This is my first product; zh-CN; 产品1; 产品描述1.
참고: UDP는 UDP 콘솔의 Game Info 섹션에 이미 정의된 언어에 해당하는 필드만 임포트합니다. 여러 언어를 지원하려는 경우 UDP 콘솔에서 해당 언어들을 정의한 후 IAP 카탈로그를 임포트하십시오.
consumable IAP 제품이 소비 가능한지 여부를 정의하려면 TRUE 또는 FALSE(대소문자 구분)로 설정하십시오.
auto_convert_prices 값이 true이면 UDP가 자동으로 가격을 다른 통화로 변환합니다. 통화가 변환되지 않게 하려면 currency;price 필드에 해당 통화 및 가격을 지정하십시오.
currency; price 통화 값을 설정할 때에는 표 B에 나열된 통화 코드를 사용하십시오. 가격은 양수여야 합니다. 기본 통화는 USD입니다. 각 IAP 상품의 가격은 즉시 해당 통화를 따라야 합니다. 예: USD;0.99;CNY;6

표 A - 언어 코드

언어 코드
아프리카어 af
암하라어 am
불가리아어 bg
카탈로니아어 ca
중국어 zh-CN
중국어(홍콩) zh-HK
중국어(대만) zh-TW
크로아티아어 hr
체코어 cs
덴마크어 da
네덜란드어 nl
영어(영국) en-GB
영어 en-US
에스토니아어 et
필리핀어 fil
핀란드어 fi
프랑스어(캐나다) fr-CA
프랑스어 fr-FR
독일어 de
그리스어 el
힌디어 hi
헝가리어 hu
인도네시아어 id
이탈리아어 it
일본어 ja
한국어 ko
라트비아어 lv
리투아니아어 lt
말레이어 ms
노르웨이어 지원 안 함
폴란드어 pl
포르투갈어(브라질) pt-BR
포르투갈어(포르투갈) pt-PT
루마니아어 ro
러시아어 ru
세르비아어 sr
슬로바키아어 sk
슬로베니아어 sl
스페인어(중남미) es
스페인어 es-ES
스와힐리어 sw
스웨덴어 sv
태국어 th
터키어 tr
우크라이나어 uk
베트남어 vi
줄루어 zu

표 B - 통화 코드

코드 코드 코드
AED IDR PEN
ARS ILS PHP
AUD INR PKR
BGN IQD PLN
BHD ISK QAR
BND JOD RON
BIF JPY RUB
BRL KES SAR
CAD KHR SDG
CHF KRW SEK
CNY KWD SGD
CZK LAK THB
DKK LKR TND
DZD LYD TRY
EGP MAD TWD
EUR MMK TZS
GBP MXN USD
GHS MYR UYU
HKD NOK VND
HRK NZD ZAR
HUF OMR

예제 1

product_id,language; product_name; description,consumable,auto_convert_prices,currency; price
com.mystudio.mygame.product1,en-US;Product 1;This is my first product; zh-CN; 产品1; 产品描述1,TRUE,TRUE,USD;0.99;CNY;6;EUR;0.79
com.mystudio.mygame.product2,en-US;Product 2;This is my second product; zh-CN; 产品2; 产品描述2,FALSE,FALSE,USD;1.99;CNY;12;EUR;1.59
com.mystudio.mygame.product3,en-US;Product 3;This is my third product; zh-CN; 产品3; 产品描述3,TRUE,TRUE,USD;4.99;CNY;30;EUR;3.99
UDP 빌드에 Firebase 사용
UDP API