Play Billing Lab은 Google Play 결제 시스템과의 통합을 테스트하는 데 도움이 되는 호환 앱입니다. Play Billing Lab의 앱 외부 구매(OOAP) 테스트 기능을 사용하면 앱과 백엔드가 Play Games 리워드를 비롯하여 앱 외부에서 획득한 상품을 처리하도록 올바르게 구성되었는지 확인할 수 있습니다.
OOAP 테스트 기능을 사용하면 Play 게임즈 리워드 혜택을 선택하고, Google Play가 Play Billing Lab에서 사용자에게 직접 리워드를 부여하는 상황을 시뮬레이션하고, 엔드 투 엔드 사용 권한 획득 및 처리 흐름을 확인할 수 있습니다.
기본 요건
Play Billing Lab을 사용하여 앱 외부 구매(OOAP) 흐름을 테스트하여 Play 게임즈 리워드 설정을 검증하기 전에 다음 요구사항을 충족하는지 확인하세요.
라이선스가 부여된 테스터 상태: 테스트 계정이 게임의 라이선스가 부여된 테스터로 등록되어 있어야 합니다. 자세한 내용은 Google Play 라이선스 테스터 문서를 참고하세요.
참고: 모든 사용자가 Play Billing Lab 앱을 볼 수 있지만 라이선스가 있는 테스터만 OOAP 재정의를 구성하고 트리거할 수 있습니다.
여러 플랫폼에서 계정 일관성: 동일한 라이선스 테스터 계정을 사용하여 Play Billing Lab과 Google Play 스토어에 로그인해야 합니다. 계정이 일치하지 않으면 Play 스토어에서 재정의된 테스트 제품 또는 혜택을 표시하지 않거나 테스트 구매를 완료하지 못할 수 있습니다.
다운로드 및 설치
Google Play에서 Play Billing Lab 앱을 다운로드하고 설치할 수 있습니다.
단계별 통합 및 테스트 가이드
다음 단계에서는 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): 테스트하려는 Play Games 리워드 혜택이 있는 일회성 제품의 제품 ID입니다.
4단계: Play Games 리워드 혜택 선택하기
패키지 이름, 제품 ID, 제품 유형을 입력하면 Play Billing Lab에서 백엔드를 쿼리하고 해당 제품에 사용할 수 있는 혜택 목록을 표시합니다.
테스트할 Play Games 리워드 혜택을 선택합니다.
사용 가능한 혜택을 선택합니다.
5단계: OOAP 테스트 시작하기
Play 게임즈 리워드 혜택을 선택한 후 테스트 시작을 탭합니다. 구성이 저장되고 Google Play 백엔드 서버와 동기화됩니다.
활성화 후 대시보드의 앱 외부 구매 카드에 활성 배지가 표시되어 구성된 패키지 이름, 제품 ID(SKU), 남은 기간을 보여줍니다.
테스트 기간: 활성 OOAP 테스트 구성은 기본적으로 2시간 동안 활성 상태로 유지된 후 자동으로 만료됩니다. 이 시간이 지나면 테스트를 다시 구성해야 합니다.
OOAP 테스트를 시작합니다.
6단계: 리워드 부여 및 전송 확인하기
Play 게임즈 리워드 혜택에 OOAP 테스트가 활성화되어 있는 동안에는 Google Play 스토어에서 구매하지 않고도 Play Billing Lab에서 직접 리워드를 부여할 수 있습니다.
리워드 부여: Play Billing Lab의 Out of app purchase 화면에서 Grant Reward를 클릭하여 Google Play에서 사용자에게 리워드를 부여하는 상황을 시뮬레이션합니다. 추가 리워드를 부여하려면 기존 리워드를 처리해야 합니다.
Play Games 리워드 테스트 흐름 사용 권한 처리 및 제공: 앱은 앱 외부 구매를 감지한 후(예: 게임이 시작되거나 포그라운드로 전환될 때
queryPurchasesAsync호출) 해당 사용자에게 상품을 제공해야 합니다. 전체 프로세스는 구매 처리를 참고하세요.
7단계: OOAP 테스트 중지 및 삭제
테스트를 완료한 후 다음 단계를 따르세요.
- 앱 외부 구매 페이지로 이동합니다.
- 테스트 지우기를 탭하여 OOAP 테스트를 중지하고 OOAP 테스트 설정을 지웁니다.
테스트 구성 수정
OOAP 테스트가 실행 중인 동안에는 패키지 이름, 제품 ID, 혜택 선택을 변경하거나 Play 스토어 국가 재정의를 변경할 수 없습니다.
이렇게 하려면 현재 OOAP 테스트를 중지하고 삭제해야 합니다.
제품 또는 제품을 수정하는 방법
현재 OOAP 테스트를 실행 중이며 다른 제품 또는 혜택을 테스트하려는 경우:
- Play Billing Lab을 열고 활성 앱 외부 구매 카드에서 보기를 탭합니다.
- 수정을 탭하여 패키지 이름, 제품 ID 또는 테스트 혜택을 수정합니다.
- 메시지가 표시되면 테스트 중지를 확인합니다. 테스트가 중지되고 모든 관련 입력이 삭제됩니다.
- 새 제품을 입력하거나 새 제품을 선택하고 테스트를 다시 시작합니다.
국가 재정의로 지역 구성을 테스트하는 방법
Play Billing Lab을 사용하면 Google Play 스토어 국가를 재정의하여 여러 지역에서 혜택 자격 요건을 테스트할 수 있습니다. 국가를 선택하지 않으면 Play Billing Lab에서 라이선스 테스트 계정의 Play 국가를 사용합니다. 국가 변경은 OOAP 테스트와 동기화되어야 합니다.
활성 OOAP 테스트 중지: OOAP 테스트가 활성 상태인 동안 대시보드 또는 앱 외부 구매 페이지에서 국가 재정의를 수정하려고 하면 Play Billing Lab에 먼저 테스트를 중지하라는 경고가 표시됩니다. 테스트 중지를 탭하여 확인하면 현재 OOAP 테스트가 중지되고 테스트 입력이 삭제됩니다.
국가 재정의 설정: OOAP 테스트를 중지한 후 구성 설정 페이지에서 국가 설정을 수정하거나 앱 외부 구매 화면에서 국가 재정의 설정을 탭할 수 있습니다. 대상 국가(예: 일본, 영국)를 선택하고 적용을 탭합니다.
OOAP 테스트 다시 시작: 국가 재정의가 활성화되면 앱 외부 구매 카드로 돌아가 제품과 혜택을 선택하고 테스트 시작을 탭합니다.
이제 대시보드에 활성 국가 재정의와 활성 OOAP 테스트가 모두 표시됩니다.
문제해결 및 자주 묻는 질문(FAQ)
Play Billing Lab에서 제품을 설정할 때 혜택을 선택하거나 볼 수 없는 이유는 무엇인가요?
- 혜택 자격 요건: Play Billing Lab에는 특정 테스터 계정이 현재 획득할 수 있는 혜택만 표시됩니다. 비소비성 상품의 경우 현재 제품을 소유하고 있지 않아야 합니다. 소비성 항목의 경우 테스트 전에 기존 구매를 소비해야 합니다.
- 라이선스 테스터 상태: 계정이 Play Console에서 활성 라이선스 테스터로 등록되어 있는지 확인합니다.
Play Billing Lab에서 다른 리워드를 부여할 수 없는 이유는 무엇인가요?
- 처리되지 않은 리워드: 기존 리워드를 처리(확인 또는 사용)해야 추가 리워드를 부여할 수 있습니다. 게임을 열고 이전 리워드가 처리되었는지 확인합니다.
- 만료: 활성 OOAP 테스트는 2시간 후에 만료됩니다. Play Billing Lab을 열어 테스트 태그가 Expired로 변경되었는지 확인합니다. 그렇다면 새 테스트를 시작합니다.
부여된 리워드가 게임에 전송되지 않은 이유는 무엇인가요?
- 계정 일관성: Play Billing Lab, Google Play 스토어 앱, 게임에 로그인한 계정이 정확히 동일한 라이선스 테스터 계정인지 확인합니다.
- 앱 외부 구매 처리: 게임의
queryPurchasesAsync구현 및 구매 처리 로직을 확인합니다. 리워드는 앱의 표준 UI 외부에서 부여되므로 게임 또는 백엔드 서버에서 미확인 구매를 감지하고 처리해야 합니다.
2시간 타이머가 만료되기 전에 진행 중인 테스트를 중지하거나 지우려면 어떻게 해야 하나요?
- Play Billing Lab을 열고 활성 카드(앱 외부 구매 또는 구성 설정)를 찾은 다음 중지 또는 삭제를 탭합니다(또는 앱 외부 구매 화면에서 테스트 지우기를 탭함). 메시지가 표시되면 선택한 내용을 확인합니다. 재정의는 Google Play 서버에서 즉시 삭제됩니다.