구매 시작

애플리케이션에서 구매를 시작하고 플레이어가 Purchase Options UI로 결제 방법을 선택하도록 합니다.

읽는 시간 4분

최근 업데이트: 한 달 전

플레이어가 제품을 구매하기로 결정하면 Unity 인앱 구매(IAP) SDK를 사용하여 애플리케이션에서 구매를 시작합니다. 플레이어에게 네이티브 스토어, 결제 제공업체 또는 웹 스토어와 같은 자격이 있는 결제 옵션을 제공하는 게임 내 구성 요소인 구매 옵션 UI를 사용하는 것이 좋습니다.

Purchase Options UI는 D2C(Direct-to-Consumer) 결제의 기본 통합 경로입니다. 이를 표시하려면 판매하려는 리스팅이 있는 단일 메서드를 호출하고 UI에 결제 옵션이 표시됩니다. 라우팅 규칙 return for that player. You don't build the interface yourself. If a project hasn't configured a payment provider, its purchase behavior doesn't change.

대신에 자체 구매 인터페이스를 제공하고 싶다면, 사용자 지정 UI를 빌드하고 라우팅 출력을 직접 사용할 수 있습니다.

필수 조건

Purchase Options UI를 통해 구매를 시작하기 전에 다음 단계를 완료하십시오.

원격 카탈로그를 생성하고 페치합니다.
IAP 서비스를 초기화하고 스토어에 연결합니다.
D2C 옵션을 표시하려면 하나 이상의 결제 제공업체를 연결하고 플레이어에게 적용되는 라우팅 규칙을 추가합니다.

애플리케이션에서 구매 시작

구매를 시작하고 Purchase Options UI를 표시하려면 판매하려는 리스팅의

catalogListingId

가 있는

IPaymentOptionProvider

에서

ShowPurchaseOption

를 호출합니다. 이

catalogListingId

는 플레이어가 구매하는 특정 리스트를 식별합니다. 제품에 대해 두 개 이상의 리스트를 정의하지 않은 경우, 해당

catalogListingId

가 해당 제품의 SKU와 일치합니다. 자세한 내용은 제품 및 카탈로그 목록을 참조하십시오.

GetPaymentOptionProviderUGUI()

를 호출하거나 프로젝트에서 UI 툴킷을 사용하는 경우

GetPaymentOptionProviderUITK()

를 호출하여

IPaymentProvidersExtendedService

의

IPaymentOptionProvider

를 얻으십시오.


public async void BuyProduct(string catalogListingId){    // Show the Purchase Options UI with the payment options the player is eligible for.    await m_PaymentOptionProvider.ShowPurchaseOption(catalogListingId);}

플레이어가 구매를 완료하면 SDK가

OnPurchasePending

콜백을 호출하여 주문을 이행할 수 있습니다. 구매를 수행하고 확인하는 방법에 대한 자세한 내용은 SDK를 통해 구매 수행을 참고하십시오.

UI를 표시하기 전에 적격성 확인

Unity는 Purchase Options UI를 표시하기 전에 규정 준수 또는 자격 규칙을 평가하지 않습니다. D2C 결제에 적합하지 않은 플레이어에게 UI를 표시하고 규정 준수 검사 후에

false

를 반환하면 구매가 실패합니다.

이를 방지하려면 먼저

IPaymentProvidersExtendedService

에

IsUserEligibleForPurchase

를 호출하십시오. 플레이어가 자격이 없는 경우 UI 표시 대신

PurchaseProduct

에 전화하여 네이티브 스토어를 통해 구매를 처리합니다.


var m_PaymentProviderStoreController = new StoreController(PaymentProvider.Name);var m_PaymentProviderStoreExtendedService = m_PaymentProviderStoreController.PaymentProviderStoreExtendedService;// Obtain the Payment Option Provider. 프로젝트가 UI 툴킷 사용하는 경우 GetPaymentOptionProviderUITK를 사용합니다.var m_PaymentOptionProvider = m_PaymentProviderStoreExtendedService?.GetPaymentOptionProviderUGUI();public async void BuyProduct(string catalogListingId){    if (await m_PaymentProviderStoreExtendedService.IsUserEligibleForPurchase())    {        // Show the Purchase Options UI with the eligible payment options.        m_PaymentOptionProvider.ShowPurchaseOption(catalogListingId);    }    else    {        // The player isn't eligible for D2C payment options. 네이티브 구매를 직접 처리합니다.        m_PaymentProviderStoreController.PurchaseProduct(catalogListingId);    }}

Purchase Options UI가 제공하는 사항

"How would you pay?"라는 제목의 Purchase Options UI에는 +200 보너스 배지, Pay with Stripe 버튼, Google Pay 버튼, "Remember my preference" 체크박스가 있는 웹숍 옵션이 표시됩니다.

Purchase Options UI는 다음 소스로 구성된 2~3가지 결제 옵션을 한 번에 제공합니다.

항상 존재하는 네이티브(Apple 앱 스토어 또는 Google Play 스토어).
당신의 라우팅 규칙을 통해 표면화된 결제 제공업체입니다. UI는 우선 순위가 가장 높은 적합한 공급자를 표시합니다. 나머지 공급자는 폴백 역할을 하며 표시되지 않습니다.
프로젝트에 Unity 웹숍이 설정되어 있고 라우팅 규칙이 게임 내 웹숍에 접근하는 것을 선택할 때 나타나는 웹숍 진입점입니다.

UI는 현재 구매를 완료하는 결제 옵션을 웹숍 엔트리 포인트와 구분하여 플레이어가 더 많은 상품을 찾아볼 수 있도록 합니다. 광원 및 어두운 모드와 세로 및 가로 방향을 모두 지원합니다.

보상

보너스 가치, 판매 가격, 시간 제한 혜택 등 결제 제공업체 또는 웹숍 옵션에 대한 보상을 구성하는 경우 Purchase Options UI에 표시됩니다. 카탈로그의 SKU 필드를 통해 보상을 설정합니다. 구매 옵션 UI와 웹숍 모두에 동일한 SKU가 표시되는 경우 UI는 일관된 시각적 처리를 사용하므로 플레이어가 동일한 보상으로 인식합니다.

공급자 메모리

플레이어가 성공적인 구매를 완료하면 SDK는 해당 기기에서 사용한 공급자를 기록합니다. 후속 구매 시 UI는 해당 공급자를 기본 액션으로 표시하고, 해당하는 다른 공급자를 사용할 수 있도록 유지합니다. 플레이어는 언제든지 다른 공급자를 선택할 수 있습니다.

참고

공급자 메모리는 플레이어당, 기기당입니다. 디바이스 전반이나 앱 재설치 시 지속되지 않습니다. 앱을 다시 설치하는 플레이어는 표준 처음 UI를 받습니다.

빌드에 대한 UI 비활성화

ShowPurchaseOption

를 호출하는 경우에도 특정 컨텍스트에서 Purchase Options UI를 억제할 수 있습니다. UI를 억제하면 구매가 네이티브 스토어로 폴백됩니다. 예를 들어 자체 구매 인터페이스를 제공하기 때문에 특정 빌드에 대한 UI를 끄려면 SDK 구성 옵션을 설정하여 비활성화하십시오. 빌드 시 UI를 비활성화하면 대시보드 설정과 관계없이 해당 빌드에 대해 실행되지 않습니다.

직접 구매 UI 빌드

Purchase Options UI는 선택 사항입니다. 자체 인터페이스를 제공하려면 SDK를 통해 직접 라우팅 출력을 사용하고 기본 UI를 건너뛰십시오.

```
IPaymentProvidersExtendedService.GetEligiblePaymentProviders()
```
를 호출하여 플레이어가 사용할 수 있는 공급자 목록을 정렬하십시오.

구입을 강제로 하기 위해

IPaymentProvidersExtendedPurchaseService.SetPaymentProviderOverride(string)

를 호출합니다.

자세한 내용은 코드에서 라우팅 오버라이드를 참조하십시오.

지역별 가용성

Purchase Options UI는 플랫폼 프로그램이 네이티브 및 D2C 결제 옵션을 함께 제공하는 지역(예: 미국, 일본)을 위해 고안되었습니다. EU 및 한국과 같이 외부 프레젠테이션만 필요한 지역에서는 국가별로 UI를 비활성화하고 프레젠테이션 레이어를 직접 처리합니다.

참고

일반적으로 제공되는 경우 Purchase Options UI는 D2C 결제 제공업체를 통한 구독 상품을 지원하지 않으며 네이티브 버튼의 스타일을 커스터마이즈할 수 없습니다.

다음 단계

이 페이지는 IAP를 사용하여 D2C(Direct-to-Consumer) 결제 제공업체를 설정하는 워크플로의 일부입니다. 이 워크플로를 계속하려면 다음 옵션 중 하나를 선택합니다.

Integrate D2C payment providers

Integrate D2C payment providers with IAP 워크플로 페이지로 돌아갑니다.

Fulfill purchases through the SDK

워크플로의 다음 단계로 진행하여 플레이어의 구매를 이행합니다.

기술 자료

Development

User Acquisition

Monetization

산업 분야