Play Billing Lab은 Google Play 결제 시스템과의 통합을 테스트하는 데 도움이 되는 호환 앱입니다. Play Billing Lab의 앱 외부 구매(OOAP) 미리보기 테스트를 사용하여 Play 게임즈 리워드를 비롯한 앱 외부에서 획득한 항목을 처리하도록 백엔드가 올바르게 구성되었는지 확인할 수 있습니다.
OOAP 프리뷰 기능을 사용하면 Google Play의 앱 세부정보 페이지와 같은 앱 외부 표시 경로에 표시할 특정 제품 또는 혜택을 선택하고 엔드 투 엔드 사용 권한 획득 및 처리 흐름을 확인할 수 있습니다.
기본 요건
Play Billing Lab을 사용하여 앱 외부 구매(OOAP) 흐름을 테스트하여 Play 게임즈 리워드 설정을 검증하기 전에 다음 요구사항을 충족하는지 확인하세요.
- Play Games 리워드 사전 체험 프로그램에 등록합니다.
라이선스가 부여된 테스터 상태: 테스트 계정이 게임의 라이선스가 부여된 테스터로 등록되어 있어야 합니다. 자세한 내용은 Google Play 라이선스 테스터 문서를 참고하세요.
참고: 모든 사용자가 Play Billing Lab 앱을 볼 수 있지만 허용 목록에 있는 EAP 개발자의 라이선스가 부여된 테스터만 OOAP 재정의를 구성하고 트리거할 수 있습니다.
여러 플랫폼에서 계정 일관성: 동일한 라이선스 테스터 계정을 사용하여 Play Billing Lab과 Google Play 스토어에 로그인해야 합니다. 계정이 일치하지 않으면 Play 스토어에서 재정의된 테스트 제품 또는 혜택을 표시하지 않거나 테스트 구매를 완료하지 못할 수 있습니다.
다운로드 및 설치
Google Play에서 Play Billing Lab을 다운로드하고 설치할 수 있습니다.
- Google Play 스토어(Android): Play Billing Lab 앱
- 웹 테스트 트랙: Play Billing Lab 웹 선택
단계별 EAP 통합 및 테스트 가이드
다음 단계에서는 Play Billing Lab을 사용하여 Play 게임즈 리워드를 통합하고 테스트하는 방법을 자세히 설명합니다.
1단계: Play Billing Lab 실행 및 로그인
설치 후 Play Billing Lab을 처음 열면 다음 단계를 따르세요.
- Google 계정으로 로그인을 탭합니다.
- 앱의 라이선스 테스터로 등록된 Google 계정을 선택합니다.
- 로그인하면 기본 대시보드가 표시됩니다.
2단계: 앱 외부 구매(OOAP) 테스트로 이동하기
- 대시보드에서 앱 외부 구매 카드를 찾습니다.
- 테스트를 탭하여 OOAP 구성 설정 화면을 엽니다.
3단계: 앱 패키지 이름 및 제품 ID 지정하기
OOAP 설정 화면에서 필수 앱 식별자를 입력합니다.
- 패키지 이름: 앱의 정확한 Android 패키지 이름입니다(예:
com.example.app). - 제품 유형: 드롭다운 메뉴를 사용하여 일회성 제품(인앱 상품) 또는 정기 결제를 선택합니다.
- 제품 ID(SKU): 테스트하려는 인앱 상품 또는 정기 결제의 제품 ID입니다.
4단계: 대상 제품 선택하기
패키지 이름, 제품 ID, 제품 유형을 입력하면 Play Billing Lab에서 백엔드를 쿼리하고 해당 제품에 사용할 수 있는 혜택 목록을 표시합니다.
일회성 제품: 해당하는 구매 옵션 또는 혜택을 선택합니다.
사용 가능한 혜택을 선택합니다.
5단계: OOAP 테스트 시작하기
혜택을 선택한 후 테스트 시작을 탭합니다. 구성이 저장되고 Google Play 백엔드 서버와 동기화됩니다.
활성화 후 대시보드의 앱 외부 구매 카드에 활성 배지가 표시되어 구성된 패키지 이름, 제품 ID(SKU), 남은 기간을 보여줍니다.
- 테스트 기간: 활성 OOAP 테스트 구성은 기본적으로 2시간 동안 활성 상태로 유지된 후 자동으로 만료됩니다.
백엔드 재정의: 활성 상태인 동안 구성은 다양한 OOAP 표시 경로(예: Play 스토어의 앱 세부정보 페이지)에서 가장 높은 우선순위로 표시됩니다.
OOAP 테스트를 시작합니다.
6단계: 앱 외부 혜택의 엔드 투 엔드 획득 흐름 테스트
Play Billing Lab에서 OOAP 테스트가 활성 상태인 동안 동일한 라이선스 테스터 계정으로 로그인한 Google Play 스토어 앱을 엽니다.
- Google Play 스토어 캐시 지우기:
- 기기의 설정 앱을 엽니다.
- 앱 > Google Play 스토어를 탭합니다.
- 저장용량 및 캐시를 탭한 다음 캐시 지우기 및 저장용량 비우기를 탭합니다.
- Google Play 스토어 앱을 엽니다.
- 앱 세부정보 페이지로 이동합니다.
테스트 구매 완료(Play Express 오버레이): 상품 카드를 탭합니다. 네이티브 Google Play Express 결제 하단 시트가 Play 스토어에 오버레이됩니다.
- 가격, 결제 수단(라이선스 테스터의 테스트 수단), 혜택 세부정보를 검토합니다.
- 원탭 구매를 탭하여 거래를 완료합니다.
엔드 투 엔드 획득 흐름을 테스트합니다. Thinking till you can't think anymore.백엔드 통합 확인:
- 구매가 완료되면 Google Play에서 백엔드 서버로 실시간 개발자 알림(RTDN)을 전송하는지 확인합니다.
- 참고: 리워드도 RTDN을 전송합니다.
- 서버가 Google Play Developer API를 호출하여 구매를 확인하고 사용자에게 사용 권한을 부여하는지 확인합니다.
- Play 스토어 앱에서 사용자 구매 내역을 확인하여 테스트 주문이 기록되었는지 확인합니다.
- 구매가 완료되면 Google Play에서 백엔드 서버로 실시간 개발자 알림(RTDN)을 전송하는지 확인합니다.
7단계: OOAP 테스트 중지 및 삭제
테스트를 완료한 후 다음 단계를 따르세요.
- 앱 외부 구매 페이지로 이동합니다.
- 테스트 지우기를 탭하여 OOAP 테스트를 중지하고 OOAP 테스트 설정을 지웁니다.
테스트 구성 수정
OOAP 미리보기 테스트가 실행 중인 동안에는 패키지 이름, 제품 ID, 혜택 선택을 변경하거나 Play 스토어 국가 재정의를 변경할 수 없습니다.
이렇게 하려면 현재 OOAP 테스트를 중지하고 삭제해야 합니다.
제품 또는 제품을 수정하는 방법
현재 OOAP 테스트를 실행 중이며 다른 제품 또는 혜택을 테스트하려는 경우:
- Play Billing Lab을 열고 활성 앱 외부 구매 카드에서 보기를 탭합니다.
- 수정을 탭하여 패키지 이름, 제품 ID 또는 테스트 혜택을 수정합니다.
- 메시지가 표시되면 테스트 중지를 확인합니다. 테스트가 중지되고 모든 관련 입력이 삭제됩니다.
- 새 제품을 입력하거나 새 제품을 선택하고 테스트를 다시 시작합니다.
국가 재정의를 사용하여 현지화된 가격을 테스트하는 방법
Play Billing Lab을 사용하면 Google Play 스토어 국가를 재정의하여 지역별 가격 책정 및 통화 형식을 테스트할 수 있습니다. 그러나 국가 변경은 OOAP 테스트와 깔끔하게 동기화되어야 합니다.
활성 OOAP 테스트 중지: OOAP 테스트가 활성 상태인 동안 대시보드 또는 앱 외부 구매 페이지에서 국가 재정의를 수정하려고 하면 Play Billing Lab에 먼저 테스트를 중지하라는 경고가 표시됩니다. 테스트 중지를 탭하여 확인하면 현재 OOAP 테스트가 중지되고 테스트 입력이 삭제됩니다.
국가 재정의 설정: OOAP 테스트를 중지한 후 구성 설정 페이지에서 국가 설정을 수정할 수 있습니다. 대상 국가(예: 일본, 영국)를 선택하고 적용을 탭합니다.
OOAP 테스트 다시 시작: 국가 재정의가 활성화되면 앱 외부 구매 카드로 돌아가 제품과 혜택을 선택하고 테스트 시작을 탭합니다.
이제 대시보드에 활성 국가 재정의와 활성 OOAP 테스트가 모두 표시됩니다.
Play 스토어에서 현지화된 가격 확인: Play 스토어를 열고 앱의 세부정보 페이지를 방문합니다. 이제 표시된 UI 카드와 Play Express 하단 시트에 재정의된 국가의 현지 통화로 형식이 지정된 제품 가격이 표시됩니다.
문제해결 및 자주 묻는 질문(FAQ)
구성된 테스트 혜택이 Play 스토어의 앱 세부정보 페이지에 표시되지 않는 이유는 무엇인가요?
- 계정 일관성: Play 스토어 앱에 로그인한 계정이 Play Billing Lab에 로그인한 계정과 정확히 일치하는지 확인합니다.
- EAP 허용 목록 및 라이선스 테스터 상태: 개발자 계정이 Play Billing Lab OOAP 프리뷰 EAP의 허용 목록에 추가되어 있고 계정이 Play Console에서 활성 라이선스 테스터로 등록되어 있는지 확인합니다.
- 만료: 활성 OOAP 테스트는 2시간 후에 만료됩니다. Play Billing Lab을 열어 테스트 태그가 Expired로 변경되었는지 확인합니다. 그렇다면 새 테스트를 시작합니다.
Play Billing Lab에서 제품을 설정할 때 혜택을 선택하거나 볼 수 없는 이유는 무엇인가요?
- 혜택 자격 요건: Play Billing Lab에는 특정 테스터 계정이 현재 구매할 수 있는 혜택만 표시됩니다.
Play Express 오버레이에서 테스트 구매가 실패한 이유는 무엇인가요?
- 테스트 기기에서 Android 12(API 수준 31) 이상을 실행하고 최신 버전의 Google Play 스토어가 설치되어 있는지 확인합니다.
- 앱 백엔드 RTDN 웹훅 및 API 통합을 확인합니다. Play 스토어를 통해 테스트할 때 구매는 앱 표준 UI 외부에서 발생합니다. 백엔드 서버는 Google Play에서 RTDN 메시지를 안정적으로 수신하고 비동기식으로 구매를 확인해야 합니다.
2시간 타이머가 만료되기 전에 진행 중인 테스트를 중지하거나 지우려면 어떻게 해야 하나요?
- Play Billing Lab을 열고 활성 카드(앱 외부 구매 또는 구성 설정)를 찾은 다음 중지 또는 삭제를 탭합니다. 메시지가 표시되면 선택한 내용을 확인합니다. 재정의는 Google Play 서버에서 즉시 삭제됩니다.