2025년 12월부터 수익 보고서 및 예상 판매실적 보고서가 업데이트될 예정입니다.
- 판매가 발생한 위치에 대한 보다 자세한 통계를 제공하기 위해 두 보고서의 끝부분에 새로운 Sales Channel 열이 추가됩니다. 이 새로운 필드에는 다음 5개 값이 포함됩니다.
- Android 플랫폼의 앱 내에서 발생하는 표준 거래의 경우 In-app 값이 포함됩니다.
- 모든 플랫폼의 Google Play 스토어에서 파생된 거래의 경우 Play store 값이 포함됩니다.
- Play 스토어 외부에서 시작된 거래의 경우 Outside Play store 값이 포함됩니다.
- PC 에뮬레이션 게임 또는 앱 내에서 시작된 거래의 경우 PC emulator 값이 포함됩니다.
- 네이티브 PC 게임 또는 앱 내에서 시작된 거래의 경우 Native PC 값이 포함됩니다.
반복 정기 결제의 경우 Sales Channel에 값이 표시되지 않습니다.
- 일회성 제품 데이터 모델을 반영하기 위해 수익 보고서 및 예상 판매실적 보고서에서 기존 필드의 이름이 변경되고 값이 업데이트됩니다. 필드의 변경사항은 다음과 같습니다.
- Base Plan ID 필드가 Base Plan 또는 Purchase Option ID로 변경됩니다.
- 수익 보고서에서 Product Type 값이 정수 대신 문자열로 변경되며 제품이 Subscription, One-time product, Paid app으로 구별됩니다. 예상 판매실적 보고서도 동일한 값으로 업데이트됩니다.
- 수익 보고서의 현재 Product id 필드와 예상 판매실적 보고서의 Product ID 필드의 이름이 두 보고서 모두에서 Package ID로 변경됩니다.
이러한 변경사항이 자동 데이터 워크플로에 영향을 미칠 수 있습니다. 원활한 전환을 위해 예정된 변경사항을 검토하세요.
보고서 유형
세부 보고서세부정보 보고서에는 개별 이벤트에 관한 다음 데이터가 포함됩니다.
- 리뷰
- 재무: 예상 매출, 수입, 리워드 제품, 한국 Play 잔액 충전 결제 내역
집계 보고서에는 앱 통계의 통합 데이터(평균, 일일 합계 등)가 포함됩니다.
- 통계: 설치, 비정상 종료, 평점, 정기 결제
- 사용자 확보: 설치 후 제거하지 않은 사용자, 구매자(설치 후 7일), 정기 결제 사용자
보고서 다운로드
- Play Console을 엽니다.
- 보고서 다운로드
를 클릭하고 리뷰, 통계 또는 재무를 선택합니다.
- '애플리케이션 선택' 아래에서 앱 이름을 입력하여 선택합니다.
- 다운로드하려는 보고서의 연도와 월을 선택합니다.
를 클릭하고 리뷰, 통계 또는 재무를 선택합니다.참고: 재무 보고서에는 개발자 계정에 있는 모든 앱에 대한 정보가 제공됩니다.
Google Cloud Storage에서 보고서 다운로드
Google Cloud Storage에서 보고서에 액세스할 수 있습니다. 데이터는 매일 캡처되며 3~7일 이내에 월별 CSV 파일에 게시됩니다. 보고서는 Google Play 개발자 계정의 비공개 Google Cloud Storage 버킷에 저장됩니다.
브라우저의 Google Cloud Storage를 사용하거나 프로그래매틱 방식으로 gsutil을 사용하여 보고서에 액세스할 수 있습니다. 다른 도구를 사용하여 Cloud Storage 버킷에 프로그래매틱 방식으로 액세스할 수도 있습니다. 내보내기가 특정 시간에 업데이트되는 것에 의존하지 않는 시스템을 구축하는 것이 좋습니다.
도움말: Google Cloud Storage에서 BigQuery로 보고서를 가져오려면 CSV 파일을 UTF-16에서 UTF-8로 변환해야 합니다.
Google Cloud Storage URI 확인
보고서 다운로드 페이지에서 원하는 섹션 헤더 옆에 있는 Cloud Storage URI 복사 버튼을 클릭하여 Google Cloud Storage URI를 복사할 수 있습니다.
Cloud Storage URI는 pubsite_prod_rev로 시작합니다(예: pubsite_prod_rev_01234567890987654321).
- gsutil 도구를 설치합니다.
- Play Console 액세스 권한이 있는 계정을 사용하여 계정을 인증해야 합니다.
- gsutil 도구를 처음 사용하고 Google Cloud Storage에 다른 프로젝트가 구성되어 있지 않은 경우, 설정하는 동안 프로젝트 ID를 입력하라는 메시지가 표시되면 앱 이름을 입력합니다.
- 보고서 다운로드 페이지에서 원하는 섹션 헤더 옆에 있는 Cloud Storage URI 복사 버튼을 클릭하여 보고서 버킷 ID를 찾습니다.
- Cloud Storage URI는
pubsite_prod_rev로 시작합니다(예:pubsite_prod_rev_01234567890987654321).
- Cloud Storage URI는
gsutil cp명령을 사용하여 보고서를 다운로드합니다.- 보고서에 액세스할 때 이용할 수 있는 명령을 더 보려면 gsutil 도움말로 이동하세요.
보고서는 각 보고서 유형의 이름을 딴 디렉터리에 정리되어 있습니다. CSV 파일 이름에는 보고서 유형, 패키지 이름, 기간, 측정기준이 포함됩니다(해당하는 경우).
1단계: 서비스 계정 만들기
- Google Play Console을 엽니다.
- 프로젝트가 있는 경우, 드롭다운을 사용하여 프로젝트를 선택합니다. 목록에 프로젝트가 없거나 새로운 프로젝트를 만들려면 프로젝트 만들기를 클릭합니다.
- 메뉴 아이콘
> 권한 > 서비스 계정 > 서비스 계정 만들기를 선택합니다.
- 화면에 표시된 안내를 따른 뒤 만들기를 선택합니다.
- 표시된 이메일 주소를 복사합니다.
- 예:
accountName@project.iam.gserviceaccount.com
- 예:
> 권한 > 서비스 계정 > 서비스 계정 만들기를 선택합니다.2단계: Play Console에 서비스 계정 추가하기
- Play Console을 엽니다.
- 사용자 및 권한 > 새로운 사용자 초대를 선택합니다.
- 서비스 계정과 연결된 이메일 주소를 붙여넣거나 입력합니다.
- 필요한 보고서의 유형에 따라 권한을 선택합니다.
- 도움말: 개발자 계정 사용자 추가 및 권한 관리 도움말을 읽고 사용자가 갖고 있는 여러 가지 액세스 수준 및 이러한 액세스 수준을 통해 사용자에게 부여되는 권한에 관해 자세히 알아보세요.
- 사용자 추가를 클릭합니다. 서비스 계정이 계정에 추가됩니다.
3단계: API 호출을 사용하여 보고서 가져오기
- 원하는 코드 언어로 API 클라이언트 라이브러리를 설치합니다.
OAuth2서버 간 인증을 사용하고OAuth2범위(https://www.googleapis.com/auth/devstorage.read_only)에 대한 권한을 요청하기 위해, API 호출을 실행하는 코드를 설정합니다.- 인증된 API 호출을 사용해 보고서를 가져옵니다.
보고서를 가져오기 위해 Python을 사용한 경우의 코드 예제는 다음과 같습니다.
import json
from httplib2 import Http
from oauth2client.client import SignedJwtAssertionCredentials
from apiclient.discovery import build
# Change these variables to fit your case
client_email = 'your service account here'
json_file = 'path_to_json_file_obtained_when_creating_the_service_account'
cloud_storage_bucket = 'pubsite_prod_rev_…'
report_to_download = ‘earnings/earnings_….zip’
private_key = json.loads(open(json_file).read())['private_key']
credentials = SignedJwtAssertionCredentials(client_email, private_key,
'https://www.googleapis.com/auth/devstorage.read_only')
storage = build('storage', 'v1', http=credentials.authorize(Http()))
print storage.objects().get(
bucket=cloud_storage_bucket,
object=report_to_download).execute()
Google Cloud Storage 액세스 권한 관리
Google Cloud Storage에서 보고서에 액세스할 때 Play Console에서 데이터 액세스를 관리할 때와 동일한 액세스 제한이 적용됩니다. 즉, Play Console 계정 영역에 액세스할 수 있는 계정 사용자는 Google Cloud Storage의 해당 보고서에도 액세스할 수 있습니다.
계정 소유자는 언제든지 사용자별로 권한을 업데이트할 수 있습니다.
- 일괄 보고서에 액세스하려면 '앱 정보 보기' 권한이 '전체'로 설정되어 있어야 합니다.
- 재무 보고서를 다운로드하려면 '재무 데이터 보기' 권한이 '전체'로 설정되어 있어야 합니다.
상세 보고서의 명령 및 파일 형식
비정상 종료 및 ANR
2018년 5월부터는 더 이상 비정상 종료 및 ANR의 세부정보 보고서를 다운로드할 수 없습니다.
리뷰
명령어
gs://[developer_bucket_id]/reviews/reviews_[package_name]_YYYYMM.csv
파일 형식
| 입력란 | 형식 | 선택사항 | 예시 및 참고사항 |
|---|---|---|---|
| 패키지 이름 | 문자열 | 아니요 | com.company.app |
| 앱 버전 코드 | 정수 | 예 | 프로덕션 APK만 |
| 앱 버전 이름 | 문자열 | 예 | |
| 리뷰 작성자 언어 | 문자열 - ISO 639-1 2자 약어 | 예 | en |
| 기기 | 문자열 | 예 | hammerhead |
| 리뷰 제출 일시 | 시간 포함 ISO_8601(UTC 시간대) | 아니요 | 2014-06-19T19:12:32Z |
| 에포크 이후 리뷰 제출 밀리초 | 정수, 에포크 이후 밀리초 | 아니요 | |
| 리뷰 최종 업데이트 일시 | 시간 포함 ISO_8601(UTC 시간대) | 예 | 2014-06-19T19:12:32Z |
| 에포크 이후 리뷰 최종 업데이트 밀리초 | 정수, 에포크 이후 밀리초 | 예 | |
| 별표 평점 | 정수(1~5) | 아니요 | |
| 리뷰 제목 | 문자열, 리뷰 작성자의 현지 언어(줄바꿈 제거) | 예 | |
| 리뷰 본문 | 문자열, 리뷰 작성자의 현지 언어(줄바꿈 제거) | 예 | |
| 개발자 답장 일시 | 시간 포함 ISO_8601(UTC 시간대) | 예 | 2014-06-19T19:12:32Z |
| 에포크 이후 개발자 답장 밀리초 | 정수, 에포크 이후 밀리초 | 예 | |
| 개발자 답장 본문 | 문자열(줄바꿈 제거 및 공백 압축) | 예 | |
| 리뷰 링크 | 문자열 | 예 | https://play.google.com/apps/publish/?dev_acc=<...>#ReviewPlace:id=<..> |
예시
보고서 버킷 ID pubsite_prod_rev_0123456789에서 패키지 이름이 'com.example.app'인 앱에 대해 2014년에 생성된 모든 보고서를 다운로드하려면 다음과 같은 명령어를 사용해야 합니다.
gsutil cp -r gs://pubsite_prod_rev_0123456789/reviews/reviews_com.example.app_2014* /your/local/directory재무 보고서
예상 판매실적자동화된 보고서에서 CSV 파일 열의 개수에 의존하지 않는 것이 좋습니다.
소개
예상 판매실적 보고서를 사용하여 앱, 인앱 상품 또는 정기 결제 판매에 관한 지연 시간이 짧은 정보를 볼 수 있습니다. 이 보고서에는 구매자가 지불한 금액이 포함되며 총액에서 세금이나 Google 수수료는 공제되지 않습니다.
이 보고서는 분석 또는 트렌드 분석에 사용할 수 있지만 회계용으로는 적합하지 않습니다. 수익 보고서를 대신 참고하세요.
여러 가지 이유로 이 보고서와 실제 수익 간에 차이가 있을 수 있습니다. 예를 들어 예상 판매실적 보고서에는 원천징수세나 지불 거절이 고려되지 않습니다. 이 보고서에는 구매자가 현지 통화로 지불한 금액이 포함되며 판매 대금 통화로 환산된 금액은 포함되지 않습니다.
명령어
gs://[developer_bucket_id]/sales/salesreport_YYYYMM.zip
예시
보고서 버킷 ID pubsite_prod_rev_0123456789에서 패키지 이름이 'com.example.app'인 앱에 대해 2014년에 생성된 모든 보고서를 다운로드하려면 다음과 같은 명령어를 사용해야 합니다.
gsutil cp -r gs://pubsite_prod_rev_0123456789/sales/salesreport_2014* /your/local/directory
파일 형식
| 입력란 | 형식 | 선택사항 | 예시 및 참고사항 |
|---|---|---|---|
|
주문 번호 |
문자열 |
아니요 |
정기 결제 주문 ID에는 끝에 갱신 주기 숫자가 포함됩니다. 예를 들어 첫 번째 갱신은 |
|
주문 청구일 |
문자열 |
아니요 |
UTC 시간대를 기준으로 하는 주문 날짜입니다(YYYY-MM-DD 형식). |
|
주문 청구 타임스탬프 |
정수 |
아니요 |
사용자에게 주문이 청구된 UNIX 타임스탬프입니다. 에포크 이후 초 단위로 측정됩니다. |
|
결제 상태 |
문자열 |
아니요 |
부분 환불이 이루어진 후 주문을 전체 환불한 경우
|
|
기기 모델 |
문자열 |
아니요 |
구매에 사용된 Android 기기 모델입니다. 정기 결제 주문의 경우 최초 구매에 사용된 기기를 나타냅니다. |
|
제품 이름 |
문자열 |
아니요 |
개발자가 지정한 제품 이름입니다. 구매자의 언어로 표시됩니다. |
|
패키지 ID |
문자열 |
아니요 |
제품이 판매된 앱의 패키지 이름입니다. |
|
제품 유형 |
문자열 |
아니요 |
판매된 제품 유형을 식별하는 데 사용됩니다. |
|
SKU ID |
문자열 |
아니요 |
개발자가 제품에 지정한 고유 ID입니다. |
|
판매 통화 |
문자열 |
아니요 |
|
|
상품 가격 |
정수 |
아니요 |
구매자의 현지 통화로 표시됩니다. 천 단위 구분 기호로 쉼표(,)를 사용합니다. |
|
징수된 세금 |
정수 |
예 |
구매자의 현지 통화로 표시됩니다. 천 단위 구분 기호로 쉼표(,)를 사용합니다. |
|
청구 금액 |
정수 |
아니요 |
구매자의 현지 통화로 표시됩니다. 상품 가격과 징수된 세금의 합계입니다. 천 단위 구분 기호로 쉼표(,)를 사용합니다. |
|
구매자 거주 도시 |
문자열 |
예 |
개발자가 등록된 판매자인 판매에만 표시됩니다. |
|
구매자 거주 주 |
문자열 |
예 |
|
|
구매자 우편번호 |
문자열 |
예 |
개발자가 등록된 판매자인 판매에만 표시됩니다. |
|
구매자 거주 국가 |
문자열 |
아니요 |
|
|
기본 요금제 또는 구매 옵션 ID |
문자열 |
예 |
정기 결제의 기본 요금제 ID입니다. 자세히 알아보기 일회성 제품의 구매 옵션 ID입니다. 자세히 알아보기 |
|
혜택 ID |
문자열 |
예 |
정기 결제의 혜택 ID입니다. 자세히 알아보기 일회성 제품의 혜택 ID입니다. 자세히 알아보기 |
| 그룹 ID | 정수 | 예 |
개발자 계정 그룹이 생성될 때 고유 ID가 부여됩니다. 자세히 알아보기 |
| 첫 100만 달러(미화) 기준 달성 | 문자열 | 예 |
개발자 계정 그룹이 설정된 경우에만 표시됩니다. 자세히 알아보기 |
| 프로모션 ID | 문자열 | 예 |
|
| 쿠폰 값 | 정수 | 예 |
구매자의 현지 통화로 표시됩니다. 천 단위 구분 기호로 쉼표(,)를 사용합니다. Play Points 쿠폰 관련 판매에만 표시됩니다. 자세히 알아보기 |
| 할인율 | 정수 | 예 |
사용자가 돈을 지출하는 대신 Play 포인트를 사용하는 경우 얼마나 절약되는지를 나타내는 할인율(%)입니다. Play Points 관련 판매에만 표시됩니다. 자세히 알아보기 |
|
추천 제품 ID |
정수 |
예 |
개발자가 추천 제품을 생성할 때 고유 ID가 부여됩니다. 자세히 알아보기 |
| 가격 실험 ID | 문자열 | 예 |
가격 실험 ID 및 실험 부문 |
| 판매 채널 | 문자열 | 예 |
거래가 발생한 출처를 표시합니다. 반복 정기 결제는 비워 둡니다. |
자동화된 보고서에서 CSV 파일 열의 개수에 의존하지 않는 것이 좋습니다.
소개
수익 보고서를 사용하여 판매 대금과 거래 내역를 파악할 수 있습니다. 보고서의 각 행은 거래 유형(예: 고객에 대한 대금 청구 또는 Google에 수수료 지급)과 함께 원래 금액 및 변환된 금액을 나타냅니다.
수익 보고서에는 이전 달의 거래 내역이 포함됩니다. 수익 보고서가 제공된 후 몇 주 내에 판매 대금을 수령할 수 있습니다.
수익 보고서는 한 달에 한 번 생성되며 일반적으로 다음 달 5일에 제공됩니다. 경우에 따라 Google에서 계산 오류를 바로잡기 위해 수익을 조정할 수 있습니다. 이 경우 Google에서 연락하여 문제에 관해 알려 드리며, 참고하실 수 있도록 조정된 거래만 포함된 추가 수입 파일을 생성합니다.
참고:
- 이제 Google이 판매 제품의 등록된 판매자인지 여부와 관계없이 모든 거래에 Google 수수료가 표시됩니다.
- 수익 보고서에는 지불 거절이 포함되지 않습니다.
- 매달 거래에 대한 수익 보고서 파일이 1개 생성됩니다.
- 타이완 원천징수세는 신고일의 이전 달에 지불된 것입니다.
명령어
gs://[developer_bucket_id]/earnings/earnings_YYYYMM.zip
예
보고서 버킷 ID pubsite_prod_rev_0123456789에서 패키지 이름이 'com.example.app'인 앱에 대해 2014년에 생성된 모든 보고서를 다운로드하려면 다음과 같은 명령어를 사용해야 합니다.
gsutil cp -r gs://pubsite_prod_rev_0123456789/earnings/earnings_2014* /your/local/directory
파일 형식
| 입력란 | 형식 | 선택사항 | 예시 및 참고사항 |
|---|---|---|---|
|
설명 |
문자열 |
아니요 |
정기 결제 주문 ID에는 끝에 갱신 주기 숫자가 포함됩니다. 예를 들어 첫 번째 갱신은 |
|
거래 날짜 |
문자열 |
아니요 |
태평양 시간대를 기준으로 하는 주문 날짜입니다(YYYY MM DD 형식). 보고서는 문제 타임스탬프를 기준으로 생성되므로 거래 타임스탬프에 다음 달이 기록될 수 있습니다. |
|
거래 시간 |
문자열 |
아니요 |
|
|
세금 유형 |
문자열 |
예 |
비과세 항목의 경우 비어 있습니다. |
|
거래 유형 |
문자열 |
아니요 |
|
|
환불 유형 |
문자열 |
예 |
구매자가 전체 금액을 환급받은 환불은 '전체'로 표시됩니다. 사용자의 결제 금액 중 일부만 환불된 경우 '부분'으로 표시됩니다. |
|
제품 이름 |
문자열 |
아니요 |
개발자가 지정한 제품 이름입니다. 구매자의 언어로 표시됩니다. |
| 패키지 ID |
문자열 |
아니요 |
제품이 판매된 앱의 패키지 이름입니다. |
|
제품 유형 |
문자열 |
아니요 |
판매된 제품 유형을 식별하는 데 사용됩니다. |
|
SKU ID |
문자열 |
아니요 |
개발자가 제품에 지정한 고유 ID입니다. |
|
하드웨어 |
문자열 |
아니요 |
구매에 사용된 Android 기기 모델입니다. 정기 결제 주문의 경우 원래 구매에 사용된 모델을 나타냅니다. |
|
구매자 거주 국가 |
문자열 |
아니요 |
|
|
구매자 거주 주 |
문자열 |
예 |
|
|
구매자 우편번호 |
문자열 |
예 |
|
|
구매자 통화 |
문자열 |
아니요 |
|
|
금액(구매자 통화) |
정수 |
아니요 |
통화 변환 이전의 인보이스 총액입니다. |
|
환율 |
정수 |
아니요 |
구매자 금액을 판매자 통화의 판매 대금 금액으로 변환할 때 사용되는 환율입니다. |
| 판매자 통화 | 문자열 | 아니요 |
주문 금액이 변환된 통화입니다. 지급받는 현지 통화를 나타냅니다. |
| 금액(판매자 통화) | 정수 | 아니요 |
통화 변환 이후의 인보이스 총액입니다. |
| 기본 요금제 또는 구매 옵션 ID |
문자열 |
예 |
정기 결제의 기본 요금제 ID입니다. 자세히 알아보기 일회성 제품의 구매 옵션 ID입니다. 자세히 알아보기 |
|
혜택 ID |
문자열 |
예 |
정기 결제의 혜택 ID입니다. 자세히 알아보기 일회성 제품의 혜택 ID입니다. 자세히 알아보기 |
| 그룹 ID | 정수 | 예 |
개발자 계정 그룹이 생성될 때 고유 ID가 부여됩니다. 자세히 알아보기 |
| 첫 100만 달러(미화) 기준 달성 | 문자열 | 예 |
개발자 계정 그룹이 설정된 경우에만 채워집니다. 자세히 알아보기 |
|
서비스 수수료(%) |
정수 |
예 |
|
| 수수료 설명 | 문자열 | 예 |
Google 서비스 수수료 계산 시 제공되는 세부정보입니다. |
| 프로모션 ID | 문자열 | 예 |
Play Points 및 Play Pass 관련 판매에만 채워집니다. 접두사 'PP.C'와 'PP.P'는 각각 Play 포인트 쿠폰 및 인앱 상품 프로모션과 관련된 주문을 정의합니다. Play 포인트를 직접 사용한 주문도 표시됩니다. 접두사 'pass'는 사용자가 Play Pass 정기 결제의 일부로 제공된 쿠폰을 적용한 주문을 정의합니다. |
| 판매 채널 | 문자열 | 예 |
거래가 시작된 위치를 표시합니다. 반복 정기 결제는 비워 둡니다. |
자동화된 보고서에서 CSV 파일 열의 개수에 의존하지 않는 것이 좋습니다.
정보
개발자 제공 결제 또는 외부 제안 프로그램에 등록하고 Google Play에 거래를 보고한 경우 인보이스 결제 보고서를 통해 거래 내역 및 인보이스에 청구된 Google 서비스 수수료를 확인할 수 있습니다.
인보이스 결제 보고서는 단일 CSV 파일로 제공되며 이전 달의 거래 내역을 모두 포함합니다. 보고서에는 거래 유형별로 사용자 요금, Google 서비스 수수료 및 해당하는 경우 세금 금액이 상세히 제공됩니다. 또한 서비스 수수료의 인보이스 금액이 어떻게 계산되는지 이해할 수 있도록 서비스 수수료 비율 및 환율과 같은 정보가 포함됩니다.
참고:
- 인보이스 결제 보고서는 한 달에 한 번 생성되며 일반적으로 다음 달 5일에 제공됩니다.
- 결제 통화에서 0으로 반올림된 Google 수수료 또는 세금 항목은 보고서에서 제외됩니다.
명령어
gsutil cp -r gs://[developer_bucket_id]/invoice_billing_reports/invoice_billing_report_YYYYMM.zip /your/local/directory
예
보고서 버킷 ID pubsite_prod_rev_0123456789에서 2024년에 생성된 모든 보고서를 다운로드하려면 다음과 같은 명령어를 사용해야 합니다.
gsutil cp -r gs://pubsite_prod_rev_0123456789/invoice_billing_reports/invoice_billing_report_2024* /your/local/directory
파일 형식
태평양 시간대를 기준으로 하는 거래 날짜입니다.
| 필드 | 형식 | 선택사항 | 예시 및 참고사항 |
|---|---|---|---|
|
인보이스 ID |
문자열 |
아니요 |
인보이스에 표시된 숫자와 일치하는 ID입니다. |
|
프로그램 |
문자열 |
예 |
Google 수수료 항목에만 설정됩니다. |
|
외부 거래 ID |
문자열 |
아니요 |
|
|
거래 날짜 |
문자열 |
아니요 |
태평양 시간대를 기준으로 하는 거래 날짜입니다. |
|
거래 타임스탬프 |
정수 |
아니요 |
거래의 UNIX 타임스탬프입니다. 에포크 이후 초 단위로 측정됩니다. |
|
거래 유형 |
문자열 |
아니요 |
사용자 요금, Google 수수료, 세금, 사용자 요금 환불, Google 수수료 환불, 세금 환불, 사용자 요금 부분 환불, Google 수수료 부분 환불, 세금 부분 환불 |
|
세금 유형 |
문자열 |
예 |
세금 항목에만 설정됩니다. |
|
SKU 유형 |
문자열 |
아니요 |
|
|
패키지 ID |
문자열 |
아니요 |
제품이 판매된 앱의 패키지 이름입니다. |
|
판매 국가 |
문자열 |
아니요 |
|
|
세금 미포함 제품 가격(판매 통화) |
십진수 |
예 |
판매 통화로 표시된 제품 가격(세금 미포함)입니다. 사용자 요금 항목에만 설정됩니다. |
|
판매 통화 |
문자열 |
아니요 |
구매자의 현지 통화입니다. |
|
결제 금액(판매 통화) |
십진수 |
예 |
판매 통화로 표시된 결제 금액입니다. Google 수수료 및 세금 항목에만 설정됩니다. 청구 금액은 양수로 표시되고 환불/부분 환불 금액은 음수로 표시됩니다. |
|
환율 |
십진수 |
아니요 |
판매 통화에서 결제 통화로 결제 금액을 변환할 때 사용되는 환율입니다. |
|
결제 통화 |
문자열 |
아니요 |
|
|
결제 금액(결제 통화) |
십진수 |
예 |
결제 통화로 표시된 결제 금액입니다. Google 수수료 및 세금 항목에만 설정됩니다. 청구 금액은 양수로 표시되고 환불/부분 환불 금액은 음수로 표시됩니다. |
|
그룹 ID |
정수 |
예 |
개발자 계정 그룹이 생성될 때 고유 ID가 부여됩니다. 자세히 알아보기 |
|
첫 100만 달러(미화) 기준 달성 |
문자열 |
예 |
개발자 계정 그룹이 설정된 경우에만 표시됩니다. 자세히 알아보기 |
|
서비스 수수료(%) |
정수 |
예 |
|
|
수수료 설명 |
문자열 |
예 |
Google 서비스 수수료 계산 시 제공되는 세부정보입니다. |
정보
관련 규칙 및 규정에 따라 현금 영수증을 발급해야 하는 대한민국의 판매자이거나 현금 영수증을 발급하도록 자발적으로 등록한 경우, Google Play 기프트 카드를 사용해 대한민국 원화(KRW)로 결제된 유료 앱 또는 인앱 상품과 관련하여 앱 구매자의 요청에 따라 현금 영수증을 발급해야 합니다.
한국 Play 잔액 충전 결제 내역 보고서에는 Google Play 잔액을 이용해 전액 또는 일부 금액이 한국 원화로 결제된 판매 내역이 포함됩니다. 이 보고서를 사용하여 사용자에게 현금 영수증을 보낼 수 있습니다.
참고: 사용자는 Google 또는 파트너의 프로모션 크레딧을 비롯한 여러 출처에서 Google Play 잔액을 추가할 수 있습니다. 현금 영수증을 발급하기 전에 사용자가 현금등가물(예: 기프트 카드)을 사용하여 잔액을 추가했는지 확인해야 합니다.
명령어
gs://[developer_bucket_id]/play_balance_krw/play_balance_krw_YYYYMM.zip
예
보고서 버킷 ID pubsite_prod_rev_0123456789에서 패키지 이름이 com.example.app인 앱과 관련하여 2018년에 생성된 모든 보고서를 다운로드하려면 다음과 같은 명령어를 사용합니다.
gsutil cp -r gs://pubsite_prod_rev_0123456789/play_balance_krw/play_balance_krw_2018* /your/local/directory
파일 형식
| 필드 | 형식 | 선택사항 | 예시 및 참고사항 |
|---|---|---|---|
|
주문 번호 |
정수 |
아니요 |
정기 결제 주문 ID에는 끝에 갱신 주기 숫자가 포함됩니다. 예를 들어 첫 번째 갱신은 |
|
주문 청구일 |
문자열 |
아니요 |
UTC 시간대를 기준으로 하는 주문 날짜입니다(YYYY-MM-DD 형식). |
|
결제 상태 |
문자열 |
아니요 |
|
|
Google Play 잔액 차감액 |
문자열 |
아니요 |
거래 금액입니다. |
| Google Play 잔액 통화 | 문자열 | 아니요 | KRW한국 Play 잔액 충전 결제 내역 보고서에서는 항상 한국 원화(KRW)를 가리킵니다. |
| 주문 청구 타임스탬프 | 정수 | 아니요 | 1480507200
사용자에게 주문이 청구된 UNIX 타임스탬프입니다. 에포크 이후 초 단위로 측정됩니다. |
정기 결제
취소 설문조사 응답명령어
gs://[developer_bucket_id]/subscriptions/cancellations/freeform_[package_name].csv
파일 형식
| 필드 | 형식 | 선택사항 | 예시 및 참고사항 |
|---|---|---|---|
| 취소 날짜 | 문자열 | 아니요 | 2016-11-30 |
| SKU ID | 문자열 | 예 | treasure_chest_for_new_users개발자가 지정한 제품의 고유 ID입니다. |
| 국가 | 문자열 | 아니요 | US, CA 등 |
| 응답 | 문자열 | 아니요 |
집계 보고서의 명령어 및 파일 형식
통계
설치 수명령어
gs://[developer_bucket_id]/stats/installs/installs_[package_name]_yyyyMM_[dimension].csv
파일 형식
| 필드 | 형식 | 선택사항 | 예 |
|---|---|---|---|
| 날짜 | YYYY-mm-dd | 아니요 | 2014-06-19 |
| 패키지 이름 | 문자열 | 아니요 | com.my.app |
| 기기(또는 기타 지원되는 측정기준) | 문자열 | 예 | hammerhead |
| 현재 기기 설치 수 | 정수 | 아니요 | |
| 사용 중인 기기에 설치된 횟수 | 정수 | 아니요 | |
| 일일 기기 설치 수 | 정수 | 아니요 | |
| 일일 기기 제거 수 | 정수 | 아니요 | |
| 일일 기기 업그레이드 수 | 정수 | 아니요 | |
| 현재 사용자 설치 수 | 정수 | 아니요 | |
| 총 사용자 설치 수 | 정수 | 아니요 | |
| 일일 사용자 설치 수 | 정수 | 아니요 | |
| 사용자의 일일 앱 제거 수 | 정수 | 아니요 |
지원되는 측정기준
| 측정기준 | 파일 이름 |
|---|---|
| 앱 버전 코드 | ..._app_version.csv |
| 이동통신사 | ..._carrier.csv |
| 국가 | ..._country.csv |
| 기기 | ..._device.csv |
| 언어 | ..._language.csv |
| Android OS 버전 | ..._os_version.csv |
예
보고서 버킷 ID pubsite_prod_rev_0123456789에서 패키지 이름이 'com.example.app'인 앱에 대해 2014년에 생성된 모든 보고서를 다운로드하려면 다음과 같은 명령어를 사용해야 합니다.
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/installs/installs_com.example.app_2014* /your/local/directory 참고: 2018년 1월 기준으로 앱의 통계 페이지에 있는 정보와 일치하는 새로운 데이터 소스의 데이터가 내보내기에 포함됩니다. 2018년 1월 이전의 내보내기 항목에서는 이전 데이터 소스에서 수집된 데이터만 사용할 수 있습니다.
명령어
gs://[developer_bucket_id]/stats/crashes/crashes_[package_name]_yyyyMM_[dimension].csv
파일 형식
| 필드 | 형식 | 선택사항 | 예 |
|---|---|---|---|
| 날짜 | YYYY-mm-dd | 아니요 | 2014-06-19 |
| 패키지 이름 | 문자열 | 아니요 | com.my.app |
| 기기(또는 기타 지원되는 측정기준) | 문자열 | 예 | hammerhead |
| 일일 비정상 종료 수 | 정수 | 아니요 | |
| 일일 ANR 수 | 정수 | 아니요 |
지원되는 측정기준
| 측정기준 | 파일 이름 |
|---|---|
| 앱 버전 코드 | ..._app_version.csv |
| 기기 | ..._device.csv |
| Android OS 버전 | ..._os_version.csv |
예
보고서 버킷 ID pubsite_prod_rev_0123456789에서 패키지 이름이 'com.example.app'인 앱에 대해 2014년에 생성된 모든 보고서를 다운로드하려면 다음과 같은 명령어를 사용해야 합니다.
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/crashes/crashes_com.example.app_2014* /your/local/directory 명령어
gs://[developer_bucket_id]/stats/ratings/ratings_[package_name]_yyyyMM_[dimension].csv
파일 형식
| 필드 | 형식 | 선택사항 | 예 |
|---|---|---|---|
| 날짜 | YYYY-mm-dd | 아니요 | 2014-06-19 |
| 패키지 이름 | 문자열 | 아니요 | com.my.app |
| 기기(또는 기타 지원되는 측정기준) | 문자열 | 예 | hammerhead |
| 일일 평균 평점 | %.2f | 예 | |
| 총 평균 평점 | %.2f | 예 | 4.16 |
지원되는 측정기준
| 측정기준 | 파일 이름 |
|---|---|
| 앱 버전 코드 | ..._app_version.csv |
| 이동통신사 | ..._carrier.csv |
| 국가 | ..._country.csv |
| 기기 | ..._device.csv |
| 언어 | ..._language.csv |
| Android OS 버전 | ..._os_version.csv |
예
보고서 버킷 ID pubsite_prod_rev_0123456789에서 패키지 이름이 'com.example.app'인 앱에 대해 2014년에 생성된 모든 보고서를 다운로드하려면 다음과 같은 명령어를 사용해야 합니다.
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/ratings/ratings_com.example.app_2014* /your/local/directory명령어
gs://[developer_bucket_id]/financial-stats/subscriptions/subscriptions_[package_name]_[product_id]_yyyyMM_[dimension].csv
파일 형식
| 필드 | 형식 | 선택사항 | 예시 및 참고사항 |
|---|---|---|---|
| 날짜 | YYYY-MM-DD | 아니요 |
UTC 시간대를 기준으로 하는 주문 날짜(YYYY-MM-DD 형식) |
| 패키지 이름 | 문자열 | 아니요 | com.example.app |
| 제품 ID | 문자열 | 아니요 | 프리미엄 액세스 |
| 국가 | 문자열 | 아니요 |
|
| 새 구독 | 숫자 | 아니요 | 1234 |
| 취소된 정기 결제 | 숫자 | 아니요 | 1234 |
| 구독 항목 | 숫자 | 아니요 | 1234 |
| 기본 요금제 ID | 문자열 | 아니요 | 매주 |
| 혜택 ID | 문자열 | 아니요 | spring-offer |
참고: 신규, 취소 및 활성 상태의 정기 결제 통계에 관해 자세히 알아보려면 앱의 수익 및 구매자 데이터 검토하기로 이동하세요.
지원되는 측정기준
| 측정기준 | 파일 이름 |
|---|---|
| 국가 | ..._country.csv |
사용자 획득
설치 후 제거하지 않은 사용자 및 구매자 보고서에서는 이전 획득 보고서의 데이터에 프로그래매틱 방식으로 액세스할 수 있습니다. 이 내보내기는 Play Console의 스토어 분석 및 전환 분석 페이지의 데이터가 포함된 새 프로그래매틱 방식 내보내기로 대체되었습니다. 이 기능은 2021년 3월에 출시되었습니다.
이전 보고서는 2021년 10월에 삭제되었습니다.
자세한 내용은 획득 데이터를 다운로드하려면 어떻게 해야 하나요?를 읽어보세요.
참고: 2019년 11월부터 정기 결제 사용자 보고서가 더 이상 지원되지 않습니다. 자세한 내용은 획득 소스 및 측정항목을 참고하세요.
설치 후 제거하지 않은 사용자(이전 내보내기: 2021년 8월까지 사용 가능)명령어
gs://[developer_bucket_id]/acquisition/retained_installers/retained_installers_[package_name]_yyyyMM_[dimension].csv
파일 형식
| 입력란 | 형식 | 선택사항 | 예시 및 참고사항 |
|---|---|---|---|
| 날짜 | YYYY-mm-dd | 아니요 |
사용자가 내 스토어 등록정보에 방문한 날짜 참고: 여러 날에 걸친 고유 스토어 등록정보 방문자를 추가하면 스토어 등록정보 방문자 수가 주간 또는 월간 사용자 집단 조회수에 표시되는 방문자 수보다 많아집니다. 주간 및 월간 사용자 집단 조회수는 각 방문자가 여러 번 방문해도 1회 방문한 것으로 집계됩니다. |
| 획득 채널 | 문자열 | 예 |
'획득 채널' 측정기준과 관련하여 표시 참고: 'Play 스토어(자연)' 채널은 'Play 스토어(자연) 검색'과 'Play 스토어(자연) 탐색'의 합입니다. 이 보고서에서 방문자를 중복으로 계산하지 않으려면 총 'Play 스토어(자연)' 행을 무시하거나 검색 행과 탐색 행을 둘 다 무시합니다. |
| 국가 | 문자열 | 예 | '국가' 및 '국가(Play 스토어(자연))' 측정기준과 관련하여 표시 |
| UTM 소스/캠페인 | 문자열 | 예 |
'추적한 채널(UTM)' 측정기준과 관련하여 표시 |
| 키워드 | 문자열 | 예 |
'Play 스토어 검색(자연)'과 관련하여 표시 |
| 스토어 등록정보 방문자 | 정수 | 아니요 | |
| 설치한 사용자 | 정수 | 아니요 | |
| 방문자-설치한 사용자 전환율 | 소수 | 아니요 | |
| 방문자-설치한 사용자 전환율 중앙값 벤치마크 | 소수 | 예 |
2019년 8월 기준으로 입력되지 않았습니다. 새 계산을 사용하도록 업데이트된 벤치마크 모음을 획득 보고서 페이지에서 확인할 수 있습니다. 자세한 내용은 Play 스토어 트래픽의 전환율 동종 앱 비교를 확인하세요. |
| 1일 동안 유지된 설치한 사용자 | 정수 | 아니요 | |
| 설치한 사용자-1일 유지 비율 | 소수 | 아니요 | |
| 7일 동안 유지된 설치한 사용자 | 정수 | 아니요 | |
| 설치한 사용자-7일 유지 비율 | 소수 | 아니요 | |
| 15일 동안 유지된 설치한 사용자 | 정수 | 아니요 | |
| 설치한 사용자-15일 유지 비율 | 소수 | 아니요 | |
| 30일 동안 유지된 설치한 사용자 | 정수 | 아니요 | |
| 설치한 사용자-30일 유지 비율 | 소수 | 아니요 |
지원되는 측정기준
| 측정기준 | 파일 이름 |
|---|---|
| 획득 채널* | ..._channel.csv |
| 국가 | ..._country.csv |
| 국가(Play 스토어(자연)) | ..._play_country.csv |
| Play 스토어(자연) 검색 | ..._play_search.csv |
| 추적한 채널(UTM) | ..._utm_tagged.csv |
* 참고: 'Play 스토어(자연)' 채널은 'Play 스토어(자연) 검색'과 'Play 스토어(자연) 탐색'의 합입니다. 이 보고서에서 방문자를 중복으로 계산하지 않으려면 'Play 스토어(자연)' 행을 무시하거나 검색 행과 탐색 행을 둘 다 무시합니다.
Google 검색(자연) 측정기준은 2019년 6월부터 더 이상 지원되지 않습니다.
CSV 이름
사용 가능한 각 CSV 파일에는 한 달 동안의 데이터와 분석이 포함됩니다. CSV에는 다음 패턴에 따라 다루는 연도, 월, 보고서 분석을 반영하는 구조화된 이름이 제공됩니다.
파일 이름 형식: store_performance_[package_name]_[yyyyMM]_[breakdown].csv
참고
- 패키지 이름은 파일 이름에 그대로 유지되고 특수문자(‘
.’ 또는 ‘_’)가 있는 경우 포함됩니다. yyyyMM은 연도와 월을 나타냅니다(예:202101).
명령어
gs://[developer_bucket_id]/stats/store_performance/store_performance_[package_name]_[yyyyMM]_[breakdown].csv
파일 형식
| 입력란 | 형식 | 선택사항 | 예시 | 설명 |
|---|---|---|---|---|
| 날짜 | YYYY-mm-dd | 아니요 | 2021-01-01 |
사용자가 내 스토어 등록정보에 방문한 날짜입니다. |
| 패키지 이름 | 문자열 | 아니요 | com.example.app |
보고서 데이터를 소유한 패키지의 이름입니다. |
| 국가/지역 | 문자열 | 아니요 | UK |
사용자의 Google 계정이 등록된 국가 또는 지역입니다. |
| 트래픽 소스 | 문자열 | 아니요 | Google Play search |
사용자가 스토어 등록정보를 방문한 방법입니다.
참고: 이 값이 특정 최소 기준점에 도달하지 않을 경우 |
| 검색어 | 문자열 | 예 | app store |
사용자가 스토어 등록정보로 이동하기 전에 검색한 검색어입니다. Google Play 검색에 관해서만 제공됩니다. 참고: 이 값이 특정 최소 기준점에 도달하지 않을 경우 |
| UTM 소스 | 문자열 | 예 | google |
스토어 등록정보로 연결되는 딥 링크의 utm_source URL 매개변수 값입니다. 서드 파티 추천에만 제공됩니다. 참고: 이 값이 특정 최소 기준점에 도달하지 않을 경우 |
| UTM 캠페인 | 문자열 | 예 | campaign |
스토어 등록정보로 연결되는 딥 링크의 utm_campaign URL 매개변수 값입니다. 서드 파티 추천에만 제공됩니다. 참고: 이 값이 특정 최소 기준점에 도달하지 않을 경우Other일 수 있습니다. |
| 스토어 등록정보 획득 | 정수 | 아니요 | 10 |
스토어 등록정보를 방문하여 앱을 설치한 사용자 중 당시에 다른 기기에 앱이 설치되어 있지 않았던 사용자 수입니다. |
| 스토어 등록정보 방문자 | 정수 | 아니요 | 100 |
스토어 등록정보를 방문한 사용자 중 기기에 아직 앱이 설치되어 있지 않았던 사용자 수입니다. |
| 스토어 등록정보 전환율 | 소수 | 아니요 | 0.1 |
스토어 등록정보 방문자 중 앱을 설치한 사람의 비율입니다. 참고: 이미 다른 기기에 앱을 설치한 사용자의 방문이나 설치는 포함되지 않습니다. |
사용 가능한 분석 구조
다음 분석을 사용할 수 있습니다.
| 분석 이름 | 각 CSV의 입력란(순서대로) |
|---|---|
|
파일 이름 예:
|
날짜, 패키지 이름, 국가, 스토어 등록정보 획득, 스토어 등록정보 방문자, 스토어 등록정보 전환율 |
|
파일 이름 예:
|
날짜, 패키지 이름, 트래픽 소스, 검색어, UTM 소스, UTM 캠페인, 스토어 등록정보 획득, 스토어 등록정보 방문자, 스토어 등록정보 전환율 |
이스케이프 전략
- 큰따옴표를 두 겹으로 합니다. (
"->"") - 셀에 탭, 줄바꿈, 큰따옴표 또는 쉼표가 포함된 경우 셀을 큰따옴표로 묶습니다. (
...->"...")
예
보고서 버킷 ID pubsite_prod_0123456789에서 패키지 이름이 com.example.app인 앱과 관련하여 2020년에 생성된 모든 보고서를 다운로드하려면 다음과 같은 명령어를 사용해야 합니다.
gsutil cp -r gs://pubsite_prod_0123456789/stats/store_performance/store_performance_com.example.app_2020* /your/local/directory
명령어
gs://[developer_bucket_id]/acquisition/buyers_7d/buyers_7d_[package_name]_yyyyMM_[dimension].csv
파일 형식
| 입력란 | 형식 | 선택사항 | 예시 및 참고사항 |
|---|---|---|---|
| 날짜 | YYYY-mm-dd | 아니요 |
사용자가 내 스토어 등록정보에 방문한 날짜 참고: 여러 날에 걸친 고유 스토어 등록정보 방문자를 추가하면 스토어 등록정보 방문자 수가 주간 또는 월간 사용자 집단 조회수에 표시되는 방문자 수보다 많아집니다. 주간 및 월간 사용자 집단 조회수는 각 방문자가 여러 번 방문해도 1회 방문한 것으로 집계됩니다. |
| 획득 채널 | 문자열 | 예 |
'획득 채널' 측정기준과 관련하여 표시 참고: 'Play 스토어(자연)' 채널은 'Play 스토어(자연) 검색'과 'Play 스토어(자연) 탐색'의 합입니다. 이 보고서에서 방문자를 중복으로 계산하지 않으려면 총 'Play 스토어(자연)' 행을 무시하거나 검색 행과 탐색 행을 둘 다 무시합니다. |
| 국가 | 문자열 | 예 | '국가' 및 '국가(Play 스토어(자연))' 측정기준과 관련하여 표시 |
| UTM 소스/캠페인 | 문자열 | 예 | '추적한 채널(UTM)' 측정기준과 관련하여 표시 |
| 키워드 | 문자열 | 예 |
'Play 스토어 검색(자연)'과 관련하여 표시 |
| 스토어 등록정보 방문자 | 정수 | 아니요 | |
| 설치한 사용자 | 정수 | 아니요 | |
| 방문자-설치한 사용자 전환율 | 소수 | 아니요 | |
| 방문자-설치한 사용자 전환율 중앙값 벤치마크 | 소수 | 예 |
2019년 8월 기준으로 입력되지 않았습니다. 새 계산을 사용하도록 업데이트된 벤치마크 모음을 획득 보고서 페이지에서 확인할 수 있습니다. 자세한 내용은 Play 스토어 트래픽의 전환율 동종 앱 비교를 확인하세요. |
| 구매자 | 정수 | 아니요 | |
| 설치한 사용자-구매자 전환율 | 소수 | 아니요 | |
| 반복 구매자 | 정수 | 아니요 | |
| 설치한 사용자-반복 구매자 전환율 | 소수 | 아니요 | |
| 구매자-반복 구매자 전환율 | 정수 | 아니요 |
지원되는 측정기준
| 측정기준 | 파일 이름 |
|---|---|
| 획득 채널* | ..._channel.csv |
|
국가 |
..._country.csv |
|
국가(Play 스토어(자연)) |
..._play_country.csv |
| Play 스토어(자연) 검색 | ..._play_search.csv |
| 추적한 채널(UTM) | ..._utm_tagged.csv |
* 참고: 'Play 스토어(자연)' 채널은 'Play 스토어(자연) 검색'과 'Play 스토어(자연) 탐색'의 합입니다. 이 보고서에서 방문자를 중복으로 계산하지 않으려면 'Play 스토어(자연)' 행을 무시하거나 검색 행과 탐색 행을 둘 다 무시합니다.
Google 검색(자연) 측정기준은 2019년 6월부터 더 이상 지원되지 않습니다.