Google Play 연결
Google로 로그인하고, 앱을 고르고, Play 재무 리포트 URI를 붙여넣어 실제 수익을 가져올 수 있게 하세요.
Google Play에는 두 가지가 필요합니다. Play Console에 접근할 수 있는 Google 로그인, 그리고 Google이 재무 리포트를 기록하는 Cloud Storage URI입니다. 환불은 로그인만으로 들어오지만 실제 인앱 구매 수익은 그 리포트에만 있으므로, 설정을 마치기 전에 URI를 요청합니다. 콘솔에서 이 소스의 이름은 Google IAP입니다.
시작하기 전에
- 앱 정보 보기와 재무 데이터 보기 권한이 있는 Play Console 사용자인 Google 계정. 재무 데이터 접근 권한이 없으면 Financial reports 페이지가 아예 나타나지 않습니다.
- Google Cloud에서 만들 것은 없습니다. 프로젝트, 서비스 계정, 키 파일이 필요 없습니다.
로그인하고 앱 고르기
- 1
연결 시작
Revenue Sensor 콘솔에서 Integrations → Google IAP → Connect로 이동한 뒤, Authorize 단계에서 Connect를 누르고 Play Console에 사용하는 Google 계정으로 로그인하세요.
- 2
읽기 전용 접근 승인
Google 동의 화면에서 앱 정보, 구매와 구독, Cloud Storage의 재무 리포트를 볼 수 있는 접근을 승인하세요. Revenue Sensor는 릴리스나 결제를 절대 변경하지 않습니다.
- 3
앱 고르기
동기화할 앱을 고르세요. 각 앱은 수익 리포트의 한 행이 됩니다.
Cloud Storage URI 추가
- 1
재무 리포트 열기
Play Console 사이드바에서 Download reports를 펼치고 Financial을 클릭하세요.
- 2
올바른 URI 복사
Estimated sales reports까지 스크롤한 뒤 그 제목 옆의 Copy Cloud Storage URI를 클릭하세요. Korean Play balance funded reports 아래의 버튼은 사용하지 마세요. 판매 데이터가 없는 다른 버킷을 가리킵니다.
- 3
그대로 붙여넣기
Revenue 단계에서 복사한 값을 그대로 붙여넣고(gs://pubsite_prod_ 뒤에 긴 숫자가 붙은 형태), 끝에 슬래시나 폴더를 붙이지 말고 Save & continue를 클릭하세요. 저장하기 전에 Google에 확인합니다.
개발자 계정이 여러 개인 경우
각 Play 개발자 계정은 자체 버킷을 가집니다. 계정의 Config 탭 → Revenue buckets에서 개발자 계정마다 URI를 하나씩 추가하세요.
최종 Play 수익은 4~5주 늦게 들어옵니다
Google은 월이 마감된 뒤 한 달에 한 번 최종 수익 리포트를 발행하므로, 최종 수익은 최대 4~5주 늦게 들어옵니다. 그때까지 이번 달은 Google이 월중에 업데이트하는 잠정 판매 리포트로 채워지고, 수익 리포트가 도착하면 최종 수치로 대체됩니다. 환불은 거의 실시간으로 들어옵니다.
가져오는 데이터
| 항목 | 비고 |
|---|---|
| 수익 | 월간 수익 리포트의 Charge 및 Charge refund 금액, 앱별·국가별. 아직 수익 리포트가 없는 달은 잠정 판매 리포트를 사용합니다. |
| 환불 | Play Developer API에서 가져오는 무효화된 구매(환불과 지불 거절), 거의 실시간. |
| 구매자 세금 | 판매 리포트에서 가져와 별도로 저장하므로, 수익 기준으로 포함하거나 제외할 수 있습니다. |
| Google 수수료 | 수익 리포트에 명시되므로 Payout 기준에서 뺄 수 있습니다. 아직 수익 리포트가 없는 달은 Google 수수료를 빼기 전 금액으로 표시됩니다. |
문제 해결
- “Revenue needs your Play reports bucket”: 저장된 Cloud Storage URI가 없어 환불만 동기화됩니다. 계정의 Config 탭에서 URI를 추가하세요.
- “Play reports bucket not found”: 저장된 URI가 잘못되었거나 이 로그인으로 읽을 수 없습니다. Config 탭에서 URI를 확인하세요.
- “N apps not found in your Play reports”: 해당 앱들이 다른 개발자 계정에 속해 있습니다. 그 앱을 소유한 계정의 Cloud Storage URI를 추가하세요.
- “Google Play won't share financial reports”: 로그인이 리포트 접근을 거부당했습니다. 다시 연결하고 재무 리포트 접근을 허용하세요.
- 새로 만든 개발자 계정에 아직 아무것도 없음: Google이 아직 리포트를 하나도 발행하지 않았을 수 있습니다. 다음 발행 때 수익이 채워집니다.