Apple 및 Google 외부 구매 요구 사항 준수

Apple과 Google의 외부 구매에 대한 규정 준수 책임과 이를 충족하는 데 도움이 되는 Unity의 SDK와 웹후크 툴을 이해합니다.

읽는 시간 2분

최근 업데이트: 10일 전

외부 구매는 Apple이나 Google의 인앱 과금 대신 자체 웹 체크아웃(예: 결제 제공업체)을 통해 디지털 콘텐츠를 판매합니다. Apple과 Google은 외부 구매 프로그램(Apple) 및 외부 제공 프로그램(Google Play)과 같은 특정 지역에서만 해당 프로그램 규칙에 따라 이를 허용합니다. 자격, 수수료, 고지 사항, 거래 리포트는 플랫폼, 지역, 앱에 따라 다릅니다. 일부 지역에서는 이러한 구매 요구 사항이 거의 없거나 없을 수 있습니다.

중요

Unity는 사용자를 대신하여 플랫폼 규정 준수를 수행하지 않습니다. 자격을 결정하고 각 플랫폼의 기술 및 정책 요구 사항을 충족하고 필요한 경우 Apple과 Google에 거래를 보고해야 합니다. 외부 구매를 제공하기 전에 Apple과 Google에 직접 문의하고 사전 릴리스 약관을 검토하십시오.

Unity는 자체적인 규정 준수 플로를 빌드하는 데 도움이 되도록 SDK 후크와 웹후크 데이터를 제공합니다. 이 페이지에서는 책임 분할, 준수 단계에서 빌드하는 순서 모델, 취할 수 있는 구체적인 조치를 설명합니다. 이 페이지는 D2C(Direct-to-Consumer) 결제 제공업체 통합 워크플로의 일부입니다. 여기에 설명된 규정 준수 처리를 추가하기 전에 지급업체 및 구매 흐름을 설정합니다.

책임 분할

Unity는 기술적 지원만 제공합니다. 결제 제공업체는 결제 처리, 세금, 이의 기록을 담당하지만 Apple 또는 Google 플랫폼 리포트는 처리하지 않습니다. 플랫폼 규정 준수는 사용자의 책임이며, Unity는 사용자를 플랫폼 프로그램에 등록하지 않습니다.

Unity의 기술적 지원

결제 제공업체 구매가 진행되면 Unity는 고객을 대신하여 체크아웃 URL을 엽니다. 기본적으로 디바이스의 외부 브라우저에서 열립니다. 인앱 프레젠테이션(

CheckoutPresentationMode.WebView

)을 선택하면 Unity가 인앱 브라우저에서 대신 엽니다. Unity가 주문을 처리하는 방법을 자세히 알아보려면 Unity가 주문을 생성하고 여는 방법을 참고하십시오. Unity는 Apple의 외부 구매 알림 또는 Google의 외부 링크 API를 호출하지 않으며, Unity는 자격을 결정하지 않습니다. 자신의 책임에 설명된 대로 해당 플랫폼 API를 직접 호출합니다.

책임

Unity는 기술적 지원만 제공합니다. 다음 작업을 담당합니다.

앱과 지역이 각 플랫폼의 외부 구매 프로그램에 해당하는지 확인합니다.
구매를 시작하기 전에 Apple의
```
ExternalPurchaseClient
```
및 Google의
```
ExternalBillingProgramClient
```
를 사용하여 자격 검사 및 공개 확인을 직접 수행하십시오.
각 플랫폼의 자체 API를 사용하여 Apple이나 Google에 필요한 모든 거래 토큰을 획득하고 리포트합니다.

Unity가 주문을 생성하고 여는 방법

일반적으로 결제 제공업체 구매는 단일 통화인

PurchaseProduct(catalogListingId)

로 시작합니다. 여기서

catalogListingId

는 원격 카탈로그에서 혜택을 확인합니다. 구매에는 두 가지 기본 단계가 있으며, 첫 번째 단계를 직접 실행할 수 있습니다.

```
GenerateURL(catalogListingId, tokens)
```
는 주문을 생성하고 열지 않고 결제 URL을 반환합니다.
```
PurchaseProduct(catalogListingId)
```
가 체크 아웃을 엽니다. 이미 같은 목록에 대해
```
GenerateURL
```
를 호출한 경우 해당 순서를 재사용합니다. 그렇지 않으면 토큰이 없는 순서 자체를 생성한 다음 열립니다.

먼저

GenerateURL

가 필요한 경우(공개 또는 렌더링하기 위해) 또는 주문에 보고 토큰을 첨부해야 하는 경우에만 필요합니다. 그렇지 않으면

PurchaseProduct

에게 직접 전화하십시오.

규정 준수 플로에 필요한 사항 결정

나머지 섹션은 독립적입니다. 다음 표를 사용하여 앱과 플랫폼에 적용되는 단계를 찾습니다.

필요한 경우	이렇게 하세요	섹션
자체 자격 규칙을 인앱에서 적용합니다.	각 구매 전에 실행되는 규정 준수 콜백 등록	규정 준수 검사로 구매 확인
구매가 열리기 전에 체크아웃 URL 표시 또는 공개	`GenerateURL` 를 호출하여 URL을 가져오고 `PurchaseProduct` 를 호출하여 엽니다.	체크아웃 URL 공개 또는 렌더링
외부 거래를 Apple 또는 Google에 보고합니다.	`GenerateURL` 로 토큰을 첨부한 다음 순서 웹후크에서 다시 읽습니다.	계속 및 보고 거래 토큰

규정 준수 검사를 통한 구매 게이트

이 단계는 선택 사항입니다. 앱 내에서 고유한 자격 규칙을 적용한 경우에만 추가합니다. 구매를 진행하기 전에 자체 자격 규칙을 적용하려면 규정 준수 콜백을 등록합니다.

PurchaseProduct

(또는

Purchase

)를 호출하면 Unity가 콜백을 먼저 실행하고 구매 중인

Cart

를 노출하는

PaymentProviderComplianceContext

를 전달합니다. 콜백이

false

(또는 던지기)를 반환하면 구매가

PurchasingUnavailable

와 함께 실패하고 주문이 생성되지 않습니다.

플레이어가 규정 준수 검사를 통과했는지 여부를 나타내는

Task<bool>

를 반환하는 함수를 정의합니다.


작업<bool> RunComplianceCheckAsync(PaymentProviderComplianceContext 컨텍스트){    const bool allow = true;    return Task.FromResult(allow);}

Unity가 구매가 시작될 때 함수를 호출하도록 결제 제공업체 구매 서비스에 함수를 등록합니다.
```
m_PurchasingService.PaymentProviders?.SetComplianceCheck(RunComplianceCheckAsync);
```
체크의 플랫폼 클라이언트를 사용하여 각 플랫폼이 규정 준수에 필요한 API를 호출합니다.
- Apple:
```
ExternalPurchaseClient
```
  를 사용하여 Apple의 외부 구매 API에 액세스합니다.
- Google:
```
ExternalBillingProgramClient
```
  를 사용하여 Google의 외부 청구 API에 액세스합니다.

참고

규정 준수 콜백은

PurchaseProduct

및

Purchase

에 대해서만 실행됩니다. 이 콜백은

GenerateURL

에 의해 게이트되지 않으며 즉시 순서를 생성합니다. 따라서

GenerateURL

(고지 또는 토큰을 위해)를 호출하는 경우 해당 호출 전에 자격 검사를 실행하십시오.

체크아웃 URL 공개 또는 렌더링

플랫폼에서는 플레이어가 진행하기 전에 외부 구매 URL을 표시하거나 공개해야 하거나 자체 웹 뷰에서 체크아웃을 렌더링해야 할 수 있습니다. 두 경우 모두

GenerateURL

를 호출하여 URL을 열지 않고 가져오십시오.


string url = await m_PurchasingService.PaymentProviders.GenerateURL(catalogListingId);// Display or disclose the URL, then call PurchaseProduct to open the checkout.

그런 다음

PurchaseProduct(catalogListingId)

는 중복을 생성하는 대신 이미 생성된 순서

GenerateURL

를 재사용합니다.

참고

사전에 구매를 준비하기 위해서만

GenerateURL

에 전화하지 마십시오. URL이나 토큰이 필요하지 않으면

PurchaseProduct

에 직접 전화하십시오. 그러면 순서가 생성되고 열립니다. 이중화된

GenerateURL

(특히 잊혀진

await

)는 레이스 창만 추가합니다.

거래 토큰 연결 및 보고

이 단계는 Apple 또는 Google에서 외부 거래를 리포트해야 하는 경우(프로그램과 지역에 따라 다름) 필요합니다. Apple과 Google은 각 외부 거래를 서버 API를 통해 다시 보고해야 합니다. 플랫폼에서 불투명 트랜잭션 토큰을 가져온 후 Unity 주문에 연결하고 순서 웨비후크로 다시 수신하여 리포트를 제출할 수 있습니다. 토큰을 직접 생성합니다. Apple 토큰은

ExternalPurchaseClient

에서 유래하고 Google 토큰은

ExternalBillingProgramClient

에서 유래합니다.

PurchaseProduct

는 토큰을 허용하지 않으므로 자체 주문을 생성하는 구매에는 토큰이 연결되지 않습니다. 토큰을 주문에 추가하려면 먼저

GenerateURL(catalogListingId, tokens)

를 호출하십시오. 그런 다음 동일한 목록에 대한 후속

PurchaseProduct

은 해당 토큰을 가지는 순서를 채택합니다.


await m_PurchasingService.PaymentProviders.GenerateURL(catalogListingId, tokenList);m_PurchasingService.PurchaseProduct(catalogListingId);

Unity는 토큰을 검사하거나 검증하지 않고도 순서대로 저장하고, 해당 토큰을 웹후크 순서대로 표시합니다. 주문 API 응답에서 반환되지 않습니다.

참고

리포트 토큰을 첨부하는 경우 순서 웨블후크가 Unity가 토큰을 반환하는 유일한 위치입니다. 구매 이행을 위한 Webhook 또는 Cloud Code 모듈 설정을 참조하십시오.

Webhook 페이로드의 토큰

주문 웹후크에는

data

아래의

externalTransactionTokens

어레이가 포함됩니다. 각 엔트리에는 토큰과 타겟 스토어가 포함됩니다.


{  "eventType": "order.paid",  "data": {    "id": "...",    "playerId": "...",    "status": "paid",    "externalTransactionTokens": [      { "store": "apple", "token": "opaque-apple-transaction-token", "type": "acquisition" },      { "store": "google", "token": "opaque-google-transaction-token" }    ]  }}

store

string

필수

앱 스토어 토큰 타겟.

apple

또는

google

중 하나입니다. 거래를 리포트할 위치를 결정합니다.

token

string

필수

외부 구매 또는 거래 토큰입니다. Unity는 이를 검사하지 않고 저장하고 전달합니다.

type

string

Apple 전용 토큰 카테고리입니다.

acquisition

services

또는

linkOut

중 하나입니다. Google에서는 생략됩니다.

참고

단일 Apple 외부 구매에 지역에 따라 두 가지 토큰 타입(예:

acquisition

토큰(EU) 및

linkOut

토큰(일본)이 필요하기 때문에 주문당 최대 두 개의 토큰을 제공할 수 있습니다. 관련 프로그램에 따라 각 토큰을 보고합니다. Unity는

type

에 따라 작동하지 않습니다.

각 프로그램에 따라 이 토큰을 사용하여 Apple의 외부 구매 서버 API 또는 Google의

externalTransactions

API를 통해 거래를 직접 보고할 수 있습니다.

다음 단계

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

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

Fulfill purchases through the SDK이러한 규정 준수 단계가 기반으로 하는 일반적인 구매 플로를 검토합니다.

Configure a webhook for fulfillment외부 거래 토큰을 포함하여 순서 이벤트를 수신하도록 웹후크를 구성합니다.

기술 자료

Development

User Acquisition

Monetization

산업 분야