Google Play 수익 보고서 도구

Google 계정으로 로그인해 수익 보고서를 조회하고 정산 결과를 Excel로 내려받습니다.

도구 열기 도구 목록으로
// about

도구 소개

안드로이드 앱 개발자를 위한 구글 플레이 콘솔 매출 정산 분석 도구입니다. 월별 매출, 수수료, 환불, 세금, 최종 입금액을 한눈에 합산하여 엑셀 파일로 정리해 줍니다.

사용 방법

  1. 구글 계정을 연동하거나 구글 플레이 매출 압축 파일 경로를 설정하세요.
  2. 분석하려는 정산 연도와 월별 파일을 선택하세요.
  3. 정산 처리 후 미리보기를 확인하고 엑셀 파일로 다운로드하세요.

이 도구를 찾는 이유

  • 복잡한 복수의 월별 매출 압축 파일(ZIP)을 몇 초 만에 하나로 합쳐줍니다.
  • 총매출, 구글 수수료, 환불액, 세금을 투명하고 명확하게 분류합니다.
  • 회계 처리 및 세금 신고에 바로 쓸 수 있는 깔끔한 엑셀 문서를 다운로드할 수 있습니다.

자주 묻는 질문 (FAQ)

구글 플레이 금융 데이터가 안전하게 보호되나요?

네! 사용자의 세션 내에서만 안전하게 처리되며 외부에 데이터를 절대 저장하지 않습니다.

어떤 리포트 파일 형태를 지원하나요?

구글 플레이 콘솔의 금융 리포트 메뉴에서 다운로드한 표준 매출 ZIP 파일을 지원합니다.

엑셀 파일로 결과물을 출력할 수 있나요?

네, 월별 정산 내역이 깔끔하게 정리된 Excel(.xlsx) 파일로 내보낼 수 있습니다.

구글 플레이스토어 매출을 정산할 때 발생하는 수수료는 한국 세무 신고 시 어떻게 처리해야 하나요?

구글 플레이스토어 매출 정산 시 발생하는 수수료는 한국 세무 신고 시 비용으로 처리할 수 있습니다. 부가가치세 신고 시: 앱 개발자가 앱 가격을 10,000원으로 설정하고 국내 소비자가 부가가치세 포함 11,000원에 구매했을 경우, 매출액은 부가가치세를 제외한 10,000원으로 잡히며, 거래 징수한 부가가치세 1,000원은 별도로 납부해야 합니다. 구글이 수수료로 공제하는 30%는 개발자의 비용으로 처리되며, 세금계산서를 받으면 매입으로 인정됩니다. 소득세 신고 시: 앱 판매 수익 외에 다른 소득(근로소득, 프리랜서 소득 등)이 있다면 모든 소득을 합산하여 종합소득세 신고를 해야 합니다. 구글 수수료는 판매수수료 등의 비용으로 처리됩니다.

가이드 · 수익 · 5분 읽기

구글 애드센스·플레이 수익 지급 구조 이해하기: 예상 수익, 확정 수익, 환율, 장부 정리

블로그나 앱으로 구글 수익을 받기 시작하면 '대시보드 금액과 통장 입금액이 왜 다를까'라는 질문이 생깁니다. 수익이 확정되고 지급되기까지의 흐름을 알면 매달 정산이 훨씬 쉬워집니다.

애드센스 대시보드에 실시간으로 보이는 금액은 '예상 수익'입니다. 한 달이 끝나면 구글은 무효 트래픽(부정 클릭 등)을 걸러 내고 금액을 검토해, 보통 다음 달 초에 '확정 수익'으로 잔액에 반영합니다. 그래서 예상 수익과 확정 수익은 조금 다를 수 있습니다.

10월 1일~31일  예상 수익 발생 (대시보드)
11월 초         10월 수익 확정 → 잔액 반영
11월 21일 무렵  잔액 ≥ 지급 기준액이면 지급 시작
이후 며칠       은행 입금
애드센스의 예상 수익과 확정 수익의 차이, 월별 지급 일정과 지급 기준액, 지급이 보류되는 흔한 이유, 외화 수익을 원화 장부로 정리하는 방법을 설명합니다.
가이드 읽기 →
AI로 직접 만들기

이 도구를 AI로 직접 만들어 보세요

나만의 버전이 필요하다면 아래 작업지시 프롬프트를 AI 채팅에 붙여 넣거나, 스킬 파일을 AI 코딩 에이전트에 저장하세요. 저희가 이 도구를 만들 때 정리한 기능, 예외 상황, 테스트 케이스가 그대로 담겨 있습니다.

AI 작업지시 프롬프트

Claude, ChatGPT, Gemini 같은 AI 채팅에 그대로 붙여 넣으세요.

당신은 숙련된 풀스택 웹 개발자입니다. 아래 요구사항에 맞춰 "Google Play 수익 보고서" 웹 도구를 만들어 주세요.

## 목표

Google 로그인 후 Cloud Storage에 저장된 구글 플레이 수익 보고서를 읽어 월별 매출·수수료·환불·세금·지급액을 합산한 엑셀을 만드는 웹 도구를 만든다.

## 핵심 기능

- Google OAuth 로그인(devstorage.read_only 범위)
- 플레이 콘솔 보고서 버킷(gs://pubsite_prod_...) 목록 조회
- 연도별 earnings ZIP/CSV 다운로드 및 파싱
- 거래 유형별·월별·통화별 합계
- Excel(.xlsx) 내보내기

## 입력

- Google 로그인
- 버킷 URI, 연도

## 출력

- 월별 정산 요약 표
- Excel 파일

## 예외 상황과 처리 규칙

- 버킷 접근 권한이 없을 때 안내
- CSV 인코딩·구분자 차이 처리
- 환불(음수) 행과 세금 행 분리 집계
- 대용량 파일을 스트리밍으로 처리

## 구현 조건

- 서버 측 구현이 필요합니다. 읽기 전용 범위만 요청하고, 보고서 파일은 세션 동안만 임시로 사용합니다.
- OAuth 동의 화면과 개인정보처리방침에 데이터 사용 목적을 명시합니다.
- 모바일에서도 쓰기 편한 반응형 UI로 만들고, 입력 요소에는 레이블을 달아 키보드로도 조작할 수 있게 해 주세요.
- 결과에는 '복사' 버튼을 달고, 잘못된 입력에는 이해하기 쉬운 한국어 오류 메시지를 보여 주세요.
- 핵심 로직은 UI와 분리된 함수로 작성해 단위 테스트를 할 수 있게 해 주세요.

## 완료 기준 (테스트 케이스)

- 샘플 CSV로 월 합계가 수동 계산과 일치
- 환불이 매출에서 차감
- 권한 없는 버킷 접근 시 명확한 오류

먼저 구현 계획을 5줄 이내로 설명한 다음 전체 코드를 작성하고, 마지막에 위 테스트 케이스를 확인하는 방법을 알려 주세요.

스킬 (SKILL.md)

Claude Code 같은 AI 코딩 에이전트에서 .claude/skills/build-google-play-earning/SKILL.md 경로로 저장하면, 이 도구를 만들거나 고칠 때마다 다시 쓸 수 있습니다.

---
name: build-google-play-earning
description: Google Play 수익 보고서 도구를 새로 만들거나 수정할 때 사용합니다. Google 로그인 후 Cloud Storage에 저장된 구글 플레이 수익 보고서를 읽어 월별 매출·수수료·환불·세금·지급액을 합산한 엑셀을 만드는 웹 도구를 만든다.
---

# Google Play 수익 보고서 만들기

## 목표

Google 로그인 후 Cloud Storage에 저장된 구글 플레이 수익 보고서를 읽어 월별 매출·수수료·환불·세금·지급액을 합산한 엑셀을 만드는 웹 도구를 만든다.

## 작업 순서

1. 아래 필수 기능, 입력, 출력을 확인하고 빠진 정보가 있으면 먼저 질문합니다.
2. 핵심 로직을 UI와 분리된 순수 함수로 구현합니다.
3. 검증 목록의 테스트 케이스로 로직을 확인합니다.
4. 입력 폼, 결과 영역, 복사 버튼을 갖춘 반응형 UI를 만듭니다.
5. 규칙에 적힌 예외 상황을 하나씩 재현해 보고 오류 메시지를 다듬습니다.

## 핵심 기능

- Google OAuth 로그인(devstorage.read_only 범위)
- 플레이 콘솔 보고서 버킷(gs://pubsite_prod_...) 목록 조회
- 연도별 earnings ZIP/CSV 다운로드 및 파싱
- 거래 유형별·월별·통화별 합계
- Excel(.xlsx) 내보내기

## 입력

- Google 로그인
- 버킷 URI, 연도

## 출력

- 월별 정산 요약 표
- Excel 파일

## 규칙

- 버킷 접근 권한이 없을 때 안내
- CSV 인코딩·구분자 차이 처리
- 환불(음수) 행과 세금 행 분리 집계
- 대용량 파일을 스트리밍으로 처리
- 서버 측 구현이 필요합니다. 읽기 전용 범위만 요청하고, 보고서 파일은 세션 동안만 임시로 사용합니다.
- OAuth 동의 화면과 개인정보처리방침에 데이터 사용 목적을 명시합니다.

## 검증

- [ ] 샘플 CSV로 월 합계가 수동 계산과 일치
- [ ] 환불이 매출에서 차감
- [ ] 권한 없는 버킷 접근 시 명확한 오류

AI에게 맡길 때 팁

  • 첫 줄에 사용 중인 기술(예: React, Vue, 순수 HTML)을 적으면 프로젝트에 맞는 코드를 받을 수 있습니다.
  • 코드를 받기 전에 목록의 테스트 케이스를 실제로 실행하고 결과를 보여 달라고 요청하세요.
  • 실제 비밀번호, 고객 데이터, API 키는 프롬프트에 넣지 말고 예시 값으로 바꿔 쓰세요.