📙 Web-to-App Funnels Guide. Get Your Free Copy.

Android 인앱 구매, 4부: 결제 라이브러리 오류 코드 및 테스트를 망치지 않는 방법

Vlad Guriev

Updated: 3월 20, 2023

Content

62fdf1acd9ba1f688246e39e jp android tutorial 1 configuration 3 4

오늘우리는getResponseCode()메소드에서결제 라이브러리를 통해 볼 수 있는오류 코드에대해 알아보겠습니다.

콜백에오류를 전달한 방법의 예는이 기사에서찾을 수 있습니다.우리는이미 이전 기사에서 사용자가 아무것도 구매하지 않고구매 대화 상자를 닫을 때 발생하는 오류 중 하나인USER_CANCELED를살펴보았습니다.다른오류들을 알아 봅시다.

ERROR와DEVELOPER_ERROR

처음살펴볼 오류는ERROR(responseCode 6)와DEVELOPER_ERROR(responseCode 5)입니다.첫번째의 경우,Google은”Fatalerror during the API action” 문서를기록하고 두 번째의 경우 “Invalidarguments provided to the API”를기록합니다.예를들어,querySkuDetailsAsync()요청을위해setType()으로빈 문자열을 빌더에 전달했을 때 DEVELOPER_ERROR를얻을 수 있었습니다.

하지만그렇게 간단한 것은 아닙니다.계속진행하면서 launchBillingFlow()메소드에서수정된SkuDetails를사용했습니다.(실제제품의 SkuDetails에서json(json)을가져와서 productID를변경하고 새 SkuDetails제작자에게전달했습니다)사실,이것은근거 없는 주장이고,나는DEVELOPER_ERROR를얻을 거라고 예상했지만 …ERROR를얻었습니다.

물론이것은 인위적인 예였습니다.구글이결제를 거부한 경우가 훨씬 현실적인 사례입니다.기사끝부분에서 알려드리겠지만,테스트카드로 구매를 테스트할 때 구매 대화 상자에서 “testcard, always declined”를선택하면 적절한 텍스트와 함께 ERROR역시반환됩니다.

구독(subscription)변경을설명한세 번째 기사에서,우리는비례 배분 방식 중 하나에 대해 연간 구독 가격을 거의3배나인상했는데,그렇게하지 않은 경우 발생했어야 하는 실수가 무엇인지에대해서는 말하지 않았습니다.개정중입니다.

잘못된비례 배분 모드가 지정된 것으로 밝혀졌기 때문에,논리적으로동일한 DEVELOPER_ERROR을가져와야 합니다.그대신, SERVICE_UNAVAILABLE(responseCode 2)를얻었습니다.또한비례 배분 모드로 부적절한 숫자를 입력하고 (이것은enum이아니라 int입니다.아무도우리를 막을 수 없죠.)잘못된purchaseToken을지정하는 경우에도 이를 얻습니다.SERVICE_UNAVAILABLE에대한 문서를 살펴보면 …잠깐,이게뭐죠?!”Network connection is down.”이표시됩니다.

동시에이상한 대화 상자도 표시됩니다.

615371cbae3a194fdd67617c 5n7uqaw9bx5dejwxgqh9sluv3r38yqwegbzbnzj5db9bullr12o2uraffoyko2jn4pjwhsy04xwdwrwxt37pkvgt3q1zgtblivzbagg 91v1ogagpaptqj av1kdmoqhe96kwy4x3ds0 4

ERROR의경우 또 한 가지 흥미로운 것은 “확인”버튼을누르지 (즉,”뒤로가기”로해석되는 수단을 통하지)않고대화 상자를 닫으면 ERRORonPurchasesUpdated()에발생하고,SERVICE_UNAVAILABLE의경우 비슷한 상황에서 USER_CANCELED가나타납니다.(그러나대화 상자에서 “OK”를클릭하면 예상할 수 있듯이 SERVICE_UNAVAILABLE를받게 됩니다)

그리고인터넷 연결이 끊긴 경우에는 SERVICE_UNAVAILABLE가실제로 나옵니다.

2024 subscription benchmarks and insights

Get your free copy of our latest subscription report to stay ahead in 2024.

오류코드

다음은작은 주석이 달린 오류 코드들로,선외가작이라고 할만한 것들입니다.

  • BILLING_UNAVAILABLE (responseCode 3). Google은 “요청한 유형에 대해 Billing API 버전이 지원되지 않습니다”라고 설명합니다. Google 계정에서 로그아웃했을 때와 Google Play 서비스가 없는 Huawei 기기를 사용할 때 이 오류를 재현할 수 있었습니다. Google Play가 업데이트되지 않은 구형 휴대폰에서도 재현할 수 있습니다.
  • SERVICE_DISCONNECTED (responseCode -1). 애플리케이션이 Google Play 서비스에서 연결이 끊기는 경우가 간혹 있습니다. Play Store가 예기치 않게 업데이트되는 경우 발생할 수 있습니다. 따라서 이전 기사에서와 같이, 안전하게 결제 라이브러리 메소드 호출 전에 연결하도록 권해드립니다. 또한 이 오류가 계속 응답하면 재시도 방책을 추가하도록 Google과 우리가 공통적으로 조언하고 있습니다.
  • SERVICE_TIMEOUT (responseCode -3). 이름에서 알 수 있는 것처럼, Google Play의 응답을 너무 오랫동안 기다렸습니다.
  • FEATURE NOT SUPPORTED. BillingClient 클래스에는 5가지 FeatureType 상수가 있습니다. 이 기기에서의 가용성은 BillingClient.isFeatureSupported(BillingClient.FeatureType.A_NECESSARY_FEATURE) 메소드를 사용해서 확인할 수 있습니다. 제 폰(Xiaomi Mi A2 Lite)에서는 FEATURE_NOT_SUPPORTEDSUBSCRIPTIONS_ON_VR에 대해서만 반환되었습니다. 동시에 다른 모든 기능은 물론이고 IN_APP_ITEMS_ON_VR에 대해서는 OK가 반환되었습니다.
  • ITEM_NOT_OWNED (responseCode 8). 우리가 가지고 있지 않은 구매를 소비하려고 할 때 발생합니다. 어쩌면 성공적인 소비 후에도 반복적으로 나타날 수 있습니다.
  • ITEM_ALREADY_OWNED (responseCode 7). 그와는 반대로, 이미 가지고 있는 제품을 구매하려고 하다가 발생하는 오류입니다. 이 경우, UI를 업데이트하고 구매 버튼을 클릭할 수 없도록 하기만 하면 됩니다.

ITEM_UNAVAILABLE

마지막으로인앱 구매 구현 경로의 출발점에서 분명 가장 많이발생하는 오류는 ITEM_UNAVAILABLE(responseCode 4)입니다.제품을구매할 수 없다고 나와 있지만,이유는설명하지 않습니다.이유는매우 다양할 수 있습니다.잘못된계정이나 기기에서 테스트하는 것부터 비활성 제품을구매하는 것까지입니다.

다음은테스트 중 이 오류를 방지하기 위해 확인해야 하는체크리스트입니다.

1.   결제라이브러리와 함께 앱을 테스트 트랙으로 보냅니다.이것은필수 조건입니다.동시에동일한 applicationId를사용하여 디버그 빌드에서 테스트할 수도 있지만,결제라이브러리와 함께 앱을 PlayConsole에최소 한 번은 업로드하는 것이 중요합니다.

2.  테스터의Google계정을이 테스트 트랙에 추가하는데,이는내부 테스트 또는 비공개 알파/베타에서특히 중요합니다.또한테스터가테스트에 참여하는 방법섹션에 링크가 있는데,여기서테스터가 초대를 수락해야 합니다.

3.  활성화된제품만 구매할 수 있습니다.제품생성 후,Play Console에activate버튼이있습니다.제품생성 과정은 첫 번째 기사에서더 자세히 설명했습니다.

4.   기기상에서의 테스트가 테스터의 Google계정에서수행되는지 확인합니다 (즉,해당계정은 이 테스트 트랙에 테스터로 등록되어야 하고필요한 모든 기술 액세스 권한을 가져야 합니다).이점은 당연해 보이지만 문제는 생기기 마련이라,이런에러가 발생한다면 이 부분을 확인할 필요가 있습니다.

5.   구매테스트에 사용되는 빌드의 applicationId는PlayConsole의applicationId와완전히 일치해야 합니다.이것은디버그 빌드에 확장자를 추가한 사람들에게 특히중요합니다.

6.  (애플리케이션이아니라)계정의왼쪽 메뉴에서 Setup→ License Testing섹션에테스터의 이메일 주소를 추가하여,실제카드가 아닌 테스트 카드에서 무료로 제품을 구매합니다.또다른 이점은,이경우 구독에테스트 기간이있다는 것입니다.이오류와 관련이 없지만 유용한 지식입니다.

결론

오류는작업을 매우 복잡하게 만들 수 있으므로,오류가어떻게 발생할 수 있는지 이해하는 것이 항상 중요합니다.제품에액세스하기 위해 얼마나 많은 단계를 거쳐야 하는지생각해보면,가장쉬운 방법은 ITEM_UNAVAILABLE을잡는 것입니다.따라서,제체크리스트가 도움이 되기를 바랍니다.

TheAdapty SDK는오류 처리를 용이하게 하고 많은 이점을 제공하는데,그중에는 기본 구독 분석,코호트분석 (cohortanalysis), 페이월(paywall)의간단한 테스트,분석서비스와의 통합 (integration),서버오류 검증 등이 있습니다.지금해보세요!

Unlock 2024 subscription secrets
Access our free 2024 in-app subscription report to view essential benchmarks and market trends.
Includes cheat sheets!
Get your free report
State of In-App Subscriptions 2024