기술 자료

Unity Engine

User Manual

Script Reference

Unity Engine

유니티 퍼블리싱 포털

Learn about the Unity Distribution Portal, a publishing service that shut down in February 2025.
읽는 시간 6분최근 업데이트: 한 달 전

중요

UDP(유니티 퍼블리싱 포털)는 2025년 2월 17일에 종료됩니다. UDP 웹 콘솔 및 서비스에 대한 액세스는 이 날짜에 영구적으로 비활성화됩니다. 키스토어를 다운로드하고 게임을 앱 스토어에 직접 다시 퍼블리시하는 방법에 대한 지침을 보려면 UDP 개요 페이지를 참조하십시오. 계정에 대한 질문이 있으면 Unity 고객 지원 팀에 티켓을 제출하십시오.

개요

UDP(유니티 퍼블리싱 포털)를 사용하면 단일 허브를 통해 여러 앱 스토어에 게임을 배포할 수 있습니다. UDP는 각 스토어의 전용 인앱 구매 SDK로 Android 빌드를 리패킹하여 게임이 별도의 앱 스토어와 호환되도록 합니다. UDP 콘솔에서 모든 스토어 제출을 관리할 수 있습니다.
UDP 개요
UDP를 사용하여 프리미엄 게임과 IAP가 포함된 게임을 배포할 수 있습니다.

UDP 콘솔

UDP 콘솔은 여러 앱 스토어에 제출할 게임을 준비할 수 있는 웹 기반 포털입니다. UDP 콘솔을 사용하여 다음을 수행할 수 있습니다.
UDP 콘솔 인터페이스에 대해 자세히 알아보십시오.

UDP 패키지

UDP 패키지에는 UDP 작업을 위한 SDK가 포함되어 있습니다. 또한 Unity 에디터의 Project Settings 창에 있는 유니티 퍼블리싱 포털 설정을 활성화합니다.

UDP 클라이언트

UDP를 사용하려면 게임에 UDP 클라이언트 ID를 비롯한 UDP 클라이언트가 있어야 합니다. 이는 UDP 서비스에서 게임을 식별합니다. ID는 UDP에서 게임을 생성할 때 생성되며, Unity 프로젝트에 연결해야 합니다. UDP 클라이언트에서 Unity 프로젝트의 연결을 해제하려면 UDP 콘솔의 Integration Information 섹션에서 Unity 프로젝트 ID를 제거합니다.

UDP 샌드박스

UDP 패키지에는 UDP 게임의 테스트 스토어 역할을 하는 샌드박스 환경이 포함되어 있습니다. 게임에 UDP SDK를 구현하면 UDP 빌드에서 샌드박스를 테스트 환경으로 사용할 수 있습니다. 실제 스토어에 게임을 제출하기 전에 UDP 및 IAP(해당하는 경우) 구현이 올바르게 작동하는지 확인하기 위해 샌드박스에서 게임을 테스트해야 합니다.
샌드박스 테스트를 사용하면 초기 UDP 구현 중에 발생하는 문제를 파악할 수 있습니다. 문제가 해결되지 않으면 UDP가 스토어용 게임을 리패킹하지 못하게 되거나 UDP가 기존 문제가 포함된 상태로 게임을 리패킹하게 될 수 있습니다. 이로 인해 스토어가 게임을 거부하거나 플레이어가 거래를 완료할 수 없게 될 수 있습니다.

인앱 구매가 포함된 게임

IAP(인앱 구매)를 사용하면 게임 내에서 플레이어에게 콘텐츠를 판매할 수 있습니다. UDP를 통해서만 인앱 구매를 구현해야 합니다. 그러면 UDP가 게임을 스토어별 빌드로 자동으로 리패킹합니다.
게임 클라이언트와 서버 측에서 모두 UDP를 구현할 수 있습니다. 오프라인 게임의 경우 게임 클라이언트에서만 UDP를 구현해야 합니다. 온라인 게임의 경우 서버 측에서 UDP를 구현할 수도 있습니다.
  • 게임 클라이언트에서 UDP 인앱 구매 구현
    게임 클라이언트에서의 구현에는 UDP SDK 초기화, UDP의 인앱 구매 플로와의 통합이 포함됩니다.
  • 서버 측에서 UDP 인앱 구매 구현
    서버 측에서 구현하면 주문에 대해 UDP 서버를 쿼리하고, 콜백 알림을 수신하고, 승인을 반환할 수 있습니다.
다음을 수행하는 방법을 알아보십시오.

IAP 제품 유형

UDP는 소비성 및 비소비성 IAP 제품만 지원합니다. 구독 제품은 지원되지 않습니다.

비소비성 IAP 제품

비소비성 제품은 영구적인 효과를 제공합니다. 플레이어는 한 번만 구매해도 됩니다.

소비성 IAP 제품

소비성 제품은 게임 화폐, 추가 경험치와 같은 일시적인 효과를 제공합니다. 플레이어는 여러 번 구매할 수 있습니다.
사용자가 소비성 제품을 구매한 경우, 이를 사용해야 다시 구매할 수 있습니다. 소비를 통해 구매한 제품이 성공적으로 제공되었는지 확인할 수 있습니다.
게임에서 제품을 사용하려면 UDP SDK에 소비자 요청을 전송해야 합니다. 게임은 제품이 사용될 때 이를 제공해야 합니다. 이렇게 하면 제품이 반복적으로 제공되지 않습니다.

IAP 카탈로그

IAP 카탈로그는 게임에 구현된 IAP 아이템의 인벤토리입니다. 각 IAP 아이템에서 다음을 정의해야 합니다.
  • 설명
  • 가격
  • 소비 유형
  • 제품 ID
게임을 리패킹하여 스토어에 제출하면 UDP는 IAP 카탈로그를 스토어의 백엔드와 동기화합니다. 그러면 게임이 스토어의 백엔드에서 IAP 인벤토리를 쿼리할 수 있습니다.
플레이어가 IAP 제품을 구매할 때 게임은 스토어에 IAP 카탈로그 확인을 요청합니다. 이 단계가 원활하게 이루어지려면 UDP를 게임에 올바르게 구현해야 합니다.
UDP 콘솔의 IAP 카탈로그는 스토어의 백엔드 시스템에 제출되는 요소의 진실 공급원(Source of Truth)입니다.
성공적인 구현을 위해서는 UDP 구현 지침을 따르십시오. IAP가 올바르게 작동하도록 하려면 UDP 샌드박스 환경에서 게임을 테스트하십시오.

프리미엄 게임

UDP를 통해 프리미엄 게임(일명 유료 다운로드 게임)을 지원하는 스토어에 퍼블리시할 수 있습니다. 그런 다음 UDP 콘솔의 보고 대시보드에서 프리미엄 게임 수익을 볼 수 있습니다.
UDP를 통해 프리미엄 게임을 배포하는 방법을 알아보십시오.

소유권

UDP 게임은 개별 사용자가 아닌 Unity 조직에 속합니다. 조직의 모든 사용자는 해당 UDP 게임에 액세스할 수 있습니다. 권한은 조직 내 특정 사용자의 역할에 따라 다릅니다.
조직에 속하지 않은 사용자를 특정 프로젝트에 추가할 수도 있습니다. Unity 대시보드의 Project > Settings > Users에서 사용자를 추가합니다.
Unity 조직 내의 작업을 Unity 에디터의 사용자와 비사용자 간에 나눌 수 있습니다. 예를 들면 다음과 같습니다.
  • 퍼블리싱 관리자(에디터 사용자 아님)
    • UDP 콘솔에서 새로운 게임 생성
    • UDP 구현을 수행하는 데 필요한 파라미터를 개발자에게 전달
    • 배포에 필요한 머티리얼 통합
    • 조직이 게임을 배포하려는 스토어에 등록 시작
  • 개발자(에디터 사용자)
    • 프로젝트에서 UDP 구현
    • 게임의 APK 또는 AAB 빌드 및 테스트
    • 게임 빌드를 UDP 콘솔에 배포
  • 퍼블리싱 관리자
    • 게임 릴리스 생성
    • 스토어 제출 완료

프로젝트 관련 권한

조직의 구성원과 프로젝트 액세스 권한이 부여된 개인은 모두 Unity 프로젝트에서 작업할 수 있습니다.
프로젝트 관련 권한은 Unity 에디터와 UDP 콘솔 모두에서 특정 Unity 프로젝트에서 액세스할 수 있는 UDP 기능과 관련이 있습니다. 적용 대상은 다음과 같습니다.
  • 프로젝트가 속한 조직의 구성원(조직 수준 권한 포함)
  • 프로젝트 액세스 권한만 부여된 개인(프로젝트 수준 권한 포함)
아래 표에는 Unity 에디터 사용자, 관리자, 소유자에 대한 프로젝트 관련 UDP 권한이 나열되어 있습니다. 프로젝트 수준 권한과 조직 수준 권한은 모두 동일합니다.

사용자

관리자

소유자

새로운 UDP 클라이언트 생성지원지원지원
Unity 프로젝트를 UDP 클라이언트에 연결지원지원지원
UDP 설정 수정지원지원지원
IAP 생성 또는 수정지원지원지원
아래 표에는 UDP 콘솔의 사용자, 관리자, 소유자에 대한 프로젝트 관련 UDP 권한이 나열되어 있습니다. 프로젝트 수준 권한과 조직 수준 권한은 모두 동일합니다.

사용자

관리자

소유자

새로운 UDP 클라이언트 생성지원지원지원
게임 리스트에 게임 보관지원 안 함지원지원
게임 리스트에서 게임 삭제지원 안 함지원지원
게임 리비전 편집지원지원지원
Unity 프로젝트를 UDP 클라이언트에 연결지원지원지원
Unity 프로젝트를 UDP 클라이언트에서 연결 해제지원 안 함지원지원
게임 리비전 릴리스지원 안 함지원지원
스토어에 게임 등록지원 안 함지원지원
스토어에 게임 퍼블리시지원 안 함지원지원
고급 페이지 작업지원 안 함지원지원
상태 페이지 액세스 및 작업지원 안 함지원지원
인증 토큰 생성지원 안 함지원지원

조직 관련 권한

조직 관련 권한은 조직에서 액세스할 수 있는 UDP 기능과 관련이 있습니다. 이러한 기능은 일반적으로 조직 멤버로만 제한됩니다. 즉 특정 프로젝트에만 액세스할 수 있는 사람은 조직 수준 권한이 없습니다. 예외는 다음과 같습니다.
  • 프로젝트 소유자는 보고 대시보드를 볼 수 있습니다.
  • 모든 프로젝트 역할은 게임 리스트에서 액세스 권한이 있는 프로젝트를 볼 수 있습니다.
아래 표에는 사용자, 관리자, 소유자에 대한 추가적인 조직 관련 권한이 나와 있습니다.

프로젝트 수준

조직 수준

사용자관리자소유자사용자관리자소유자
보고 대시보드 보기지원 안 함지원 안 함지원지원 안 함지원지원
게임 리스트 액세스지원*지원*지원*지원지원지원
회사 프로필 편집지원 안 함지원 안 함지원 안 함지원 안 함지원지원
조직을 스토어에 등록지원 안 함지원지원지원 안 함지원지원
참고: 프로젝트 수준 사용자는 프로젝트를 소유한 호스트 조직 내 게임과 자신의 조직 내에서 액세스할 수 있는 다른 프로젝트를 평가할 수 있습니다.