월별 보고서 다운로드 및 내보내기

Play Console 웹사이트에서 개별 앱에 관한 월별 보고서를 다운로드하여 앱의 실적을 추적하고 파악할 수 있습니다.

보고서 유형

세부 보고서

세부 보고서에는 개별 이벤트에 관한 다음 데이터가 포함됩니다.

  • 리뷰
  • 재무: 예상 매출, 수입, 리워드 제품, 대한민국 Play 잔액 차감
집계 보고서

집계 보고서에는 앱 통계의 통합 데이터(평균, 일일 합계 등)가 포함됩니다.

  • 통계: 설치, 비정상 종료, 평점, 정기 결제
  • 사용자 획득: 설치 후 제거하지 않은 사용자, 구매자(설치 후 7일), 정기 결제 사용자

보고서 다운로드

  1. Play Console을 엽니다.
  2. 보고서 다운로드 보고서를 클릭하고 리뷰, 통계 또는 재무를 선택합니다.
  3. '애플리케이션 선택' 아래에서 앱 이름을 입력하여 선택합니다.
  4. 다운로드하려는 보고서의 연도와 월을 선택합니다.

참고: 재무 보고서에는 개발자 계정에 있는 모든 앱에 대한 정보가 제공됩니다.

Google Cloud Storage에서 보고서 다운로드

Google Cloud Storage에서 보고서를 사용할 수 있습니다. 보고서는 매일 생성되며 월별 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).

명령줄 도구를 사용하여 보고서 다운로드하기
  1. gsutil 도구를 설치합니다.
    • Play Console 액세스 권한이 있는 계정을 사용하여 계정을 인증해야 합니다.
    • gsutil 도구를 처음 사용하고 Google Cloud Storage에 다른 프로젝트가 구성되어 있지 않은 경우, 설정하는 동안 프로젝트 ID를 입력하라는 메시지가 표시되면 앱 이름을 입력합니다.
  2. 보고서 다운로드 페이지에서 원하는 섹션 헤더 옆에 있는 Cloud Storage URI 복사 버튼을 클릭하여 보고서 버킷 ID를 찾습니다.
    • Cloud Storage URI는 pubsite_prod_rev로 시작합니다(예: pubsite_prod_rev_01234567890987654321).
  3. gsutil cp 명령을 사용하여 보고서를 다운로드합니다.
    • 보고서에 액세스할 때 이용할 수 있는 명령을 더 보려면 gsutil 도움말로 이동하세요.

보고서는 각 보고서 유형의 이름을 딴 디렉터리에 정리되어 있습니다. CSV 파일 이름에는 보고서 유형, 패키지 이름, 기간, 측정기준이 포함됩니다(해당하는 경우).

클라이언트 라이브러리 및 서비스 계정을 사용하여 보고서 다운로드하기

1단계: 서비스 계정 만들기

  1. Google Developers Console을 엽니다.
  2. 프로젝트가 있는 경우, 드롭다운을 사용하여 프로젝트를 선택합니다. 목록에 프로젝트가 없거나 새로운 프로젝트를 만들려면 프로젝트 만들기를 클릭합니다.
  3. 메뉴 아이콘 메뉴 아이콘 > 권한 > 서비스 계정 > 서비스 계정 만들기를 선택합니다.
  4. 화면에 표시된 안내를 따른 뒤 만들기를 선택합니다.
  5. 표시된 이메일 주소를 복사합니다.
    • 예: accountName@project.iam.gserviceaccount.com

2단계: Play Console에 서비스 계정 추가하기

  1. Play Console을 엽니다.
  2. 설정 설정 > 사용자 계정 및 권리 > 새로운 사용자 초대를 선택합니다.
  3. 서비스 계정과 연결된 이메일 주소를 붙여넣거나 입력합니다.
  4. 필요한 보고서의 유형에 따라 권한을 선택합니다. 
    • 도움말: 개발자 계정 사용자 추가 및 권한 관리 도움말을 읽고 사용자가 갖고 있는 여러 가지 액세스 수준 및 이러한 액세스 수준을 통해 사용자에게 부여되는 권한에 관해 자세히 알아보세요.
  5. 사용자 추가를 클릭합니다. 서비스 계정이 계정에 추가됩니다.

3단계: API 호출을 사용하여 보고서 가져오기

  1. 원하는 코드 언어로 API 클라이언트 라이브러리를 설치합니다.
  2. OAuth2 서버 간 인증을 사용하고 OAuth2 범위(https://www.googleapis.com/auth/devstorage.read_only)에 대한 권한을 요청하기 위해, API 호출을 실행하는 코드를 설정합니다.
  3. 인증된 API 호출을 사용해 보고서를 가져옵니다.
예시 보기(Python)

보고서를 가져오기 위해 Python을 사용한 경우의 코드 예제는 다음과 같습니다.

import json

from httplib2 import Http

from oauth2client.client import SignedJwtAssertionCredentials

from apiclient.discovery import build

# 상황에 맞게 아래 변수를 수정하세요.

client_email = '여기에 서비스 계정 입력'

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

파일 형식

입력란 형식 선택사항 예시 및 참고사항

주문 번호

문자열

아니요

GPA.1234-1234-1234-12345

정기 결제 주문 ID에는 끝에 갱신 주기 숫자가 포함됩니다. 예를 들어 첫 번째 갱신은 GPA.1234-1234-1234-12345..0, 두 번째 갱신은 GPA.1234-1234-1234-12345..1 등입니다.

주문 변경일

문자열

아니요

2016-11-30

UTC 시간대를 기준으로 하는 주문 날짜입니다(YYYY-MM-DD 형식).

주문 청구 타임스탬프

정수

아니요

1480507200

사용자에게 주문이 청구된 UNIX 타임스탬프입니다. 에포크 이후 초 단위로 측정됩니다.

결제 상태

문자열

아니요

charged, refund, partial refund 등

부분 환불이 이루어진 후 주문을 전체 환불한 경우

  • 부분 환불이 별도 행에 표시됨
  • 전체 환불 행에 잔액이 표시됨

기기 모델

문자열

아니요

mako 등

구매에 사용된 Android 기기 모델입니다. 정기 결제 주문의 경우 원래 구매에 사용된 기기를 나타냅니다.

제품 이름

문자열

아니요

coins, monthly subscription 등

개발자가 지정한 제품 이름입니다. 구매자의 언어로 표시됩니다.

제품 ID

문자열

아니요

com.example.app

제품이 판매된 앱의 패키지 이름입니다.

제품 유형

문자열

아니요

paidapp, subscription, inapp

SKU ID

문자열

아니요

treasure_chest_for_new_users

개발자가 제품에 지정한 고유 ID입니다.

판매 통화

문자열

아니요

USD, EUR, THB 등

상품 가격

정수

아니요

12,345.67

구매자의 현지 통화로 표시됩니다. 천 단위 구분 기호로 쉼표(,)를 사용합니다.

징수된 세금

정수

예

12,345.67

구매자의 현지 통화로 표시됩니다. 천 단위 구분 기호로 쉼표(,)를 사용합니다.

청구 금액

정수

아니요

12,345.67

구매자의 현지 통화로 표시됩니다. 상품 가격과 징수된 세금의 합계입니다. 천 단위 구분 기호로 쉼표(,)를 사용합니다.

구매자 거주 도시

문자열

예

Boston, Toronto 등

개발자가 등록된 판매자인 거래에만 채워집니다.

구매자 거주 주

문자열

예

MA, ON 등

구매자 우편번호

문자열

예

02140, M5B 1L6 등

개발자가 등록된 판매자인 거래에만 채워집니다.

구매자 거주 국가

문자열

아니요

US, CA 등

기본 요금제 ID

문자열

예

매주

정기 결제의 기본 요금제 ID입니다. 정기 결제에서만 채워집니다. 자세히 알아보기

혜택 ID

문자열

예

spring-offer

정기 결제의 혜택 ID입니다. 정기 결제에서만 채워집니다. 자세히 알아보기
그룹 ID 정수  예

1234567891234567890

개발자 계정 그룹이 생성될 때 고유 ID가 부여됩니다. 자세히 알아보기
첫 100만 달러(미화) 기준 달성 문자열  예

예, 아니요

개발자 계정 그룹이 설정된 경우에만 채워집니다. 자세히 알아보기
프로모션 ID 문자열 예

PP.C2fy7Ns0/+e2w, PP.P2fy7Ns0/+e2w, 포인트만 사용

Play Points 관련 판매에만 채워집니다. 'PP.C'와 'PP.P' 접두사는 각각 쿠폰 및 인앱 상품 프로모션과 관련된 주문을 정의합니다. Play 포인트를 직접 사용한 주문도 표시됩니다. 자세히 알아보기
쿠폰 값 정수 예

3.00

구매자의 현지 통화로 표시됩니다. 천 단위 구분 기호로 쉼표(,)를 사용합니다. Play Points 쿠폰 관련 판매에만 채워집니다. 자세히 알아보기
할인율 정수 예

45, 55, 70

할인율(%)은 사용자가 Play 포인트를 사용할 경우 지출 금액을 기준으로 절약되는 비율을 지정하는 데 사용됩니다. Play Points 관련 판매에만 채워집니다. 자세히 알아보기

추천 제품 ID

정수

예

1234567891234567890

고유 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

파일 형식

입력란 형식 선택사항 예시 및 참고사항

설명

문자열

아니요

GPA.1234-1234-1234-12345

이 주문에 할당된 고유 ID입니다. 정기 결제 주문 ID에는 끝에 갱신 주기 숫자가 포함됩니다.

거래 날짜

문자열

아니요

2016년 11월 30일

태평양 시간대를 기준으로 하는 주문 날짜입니다(YYYY MM DD 형식). 보고서는 문제 타임스탬프를 기준으로 생성되므로 거래 타임스탬프에 다음 달이 기록될 수 있습니다.

거래 시간 

문자열

아니요

12:00:00 PM PDT

세금 유형

문자열

예

타사 세금

비과세 항목의 경우 비어 있습니다.

거래 유형

문자열

아니요

청구, Google 수수료, 세금, 청구 환불, Google 수수료 환불, 재청구, 세금 재청구, Google 수수료 재청구, 조정

환불 유형

문자열

예

전체, 부분

구매자가 전체 금액을 환급받은 환불은 '전체'로 표시됩니다. 사용자의 결제 금액 중 일부만 환불된 경우 '부분'으로 표시됩니다. 

제품 이름

문자열

아니요

코인, 월간 정기 결제 등

개발자가 지정한 제품 이름입니다. 구매자의 언어로 표시됩니다.

제품 ID

문자열

아니요

com.example.app

제품이 판매된 앱의 패키지 이름입니다.

제품 유형

정수

아니요

0, 1

판매된 제품 유형을 식별하는 데 사용됩니다. '0'은 유료 앱 판매를 나타내고, '1'은 인앱 상품 또는 정기 결제 판매를 나타냅니다.

SKU ID

문자열

아니요

treasure_chest_for_new_users

개발자가 제품에 지정한 고유 ID입니다.

하드웨어

문자열

아니요

mako 등

구매에 사용된 Android 기기 모델입니다. 정기 결제 주문의 경우 원래 구매에 사용된 모델을 나타냅니다.

구매자 거주 국가

문자열

아니요

US, CA 등

구매자 거주 주

문자열

예

MA, ON 등

구매자 우편번호

문자열

예

02140, M5B 1L6 등

구매자 통화

문자열

아니요

USD, EUR, THB 등

금액(구매자 통화)

정수

아니요

12345.67

통화 변환 이전의 인보이스 총액입니다.

환율

정수

아니요

0.56789

구매자 금액을 판매자 통화의 판매 대금 금액으로 변환할 때 사용되는 환율입니다.
판매자 통화 문자열 아니요

USD, EUR, THB 등

주문 금액이 변환된 통화입니다. 지급받는 현지 통화를 나타냅니다.
금액(판매자 통화) 정수 아니요

12345.67

통화 변환 이후의 인보이스 총액입니다.

기본 요금제 ID

문자열

예

매주

정기 결제의 기본 요금제 ID입니다. 정기 결제에서만 채워집니다. 자세히 알아보기

혜택 ID

문자열

예

spring-offer

정기 결제의 혜택 ID입니다. 정기 결제에서만 채워집니다. 자세히 알아보기
그룹 ID 정수  예

1234567891234567890

개발자 계정 그룹이 생성될 때 고유 ID가 부여됩니다. 자세히 알아보기
첫 100만 달러(미화) 기준 달성  문자열 예

예, 아니요

개발자 계정 그룹이 설정된 경우에만 채워집니다. 자세히 알아보기

서비스 수수료(%)

정수

 예

10, 15, 30
수수료 설명 문자열 예

정기 결제

Google 서비스 수수료 계산 시 제공되는 세부정보입니다.
프로모션 ID 문자열 예

PP.C_x0a08trvC1, PP.PdYfn342Ox10, 포인트만 사용

Play Points 관련 판매에만 채워집니다. 'PP.C'와 'PP.P' 접두사는 각각 쿠폰 및 인앱 상품 프로모션과 관련된 주문을 정의합니다. Play 포인트를 직접 사용한 주문도 표시됩니다. 자세히 알아보기
대한민국 Play 잔액 차감

정보

관련 규칙 및 규정에 따라 현금 영수증을 발급해야 하는 대한민국의 판매자이거나 현금 영수증을 발급하도록 자발적으로 등록한 경우, Google Play 기프트 카드를 사용해 대한민국 원화(KRW)로 결제된 유료 앱 또는 인앱 상품과 관련하여 앱 구매자의 요청에 따라 현금 영수증을 발급해야 합니다.

대한민국 Play 잔액 차감 보고서에는 Play 잔액을 이용해 한국 원화로 결제된 판매 내역이 포함됩니다. 이는 사용자에게 현금 영수증을 발급하기 위한 것입니다.

참고: 사용자는 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

파일 형식

입력란 형식 선택사항 예시 및 참고사항

주문 번호

정수

아니요

GPA.1234-1234-1234-12345

정기 결제 주문 ID에는 끝에 갱신 주기 숫자가 포함됩니다. 예를 들어 첫 번째 갱신은 GPA.1234-1234-1234-12345..0, 두 번째 갱신은 GPA.1234-1234-1234-12345..1 등입니다.

주문 변경일

문자열

아니요

2016-11-30

UTC 시간대를 기준으로 하는 주문 날짜입니다(YYYY-MM-DD 형식).

결제 상태

문자열

아니요

청구됨, 환불 등

Play 잔액 차감액

문자열

아니요

12,345.67

거래 금액입니다.
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 아니요

2022-01-01

UTC 시간대를 기준으로 하는 주문 날짜(YYYY-MM-DD 형식)
패키지 이름 문자열 아니요 com.example.app
제품 ID 문자열 아니요 프리미엄 액세스
국가 문자열 아니요

US, CA 등
새 정기 결제 숫자 아니요 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회 방문한 것으로 집계됩니다.
획득 채널 문자열 예

자연, Google Ads, UTM 태그 지정

'획득 채널' 측정기준과 관련하여 표시

참고: '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월부터 더 이상 지원되지 않습니다.

스토어 실적(새 내보내기: 2021년 3월 제공)

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

사용자가 스토어 등록정보를 방문한 방법입니다.

  • Google Play 검색
  • 서드 파티 추천
  • Google Play 탐색

참고: 이 값이 특정 최소 기준점에 도달하지 않을 경우 Other일 수 있습니다.
검색어 문자열 예 app store

사용자가 스토어 등록정보로 이동하기 전에 검색한 검색어입니다. Google Play 검색에 관해서만 제공됩니다.

참고: 이 값이 특정 최소 기준점에 도달하지 않을 경우 Other일 수 있습니다.
UTM 소스 문자열 예 google

스토어 등록정보로 연결되는 딥 링크의 utm_source URL 매개변수 값입니다. 서드 파티 추천에만 제공됩니다.

참고: 이 값이 특정 최소 기준점에 도달하지 않을 경우 Other일 수 있습니다.
UTM 캠페인 문자열 예 campaign

스토어 등록정보로 연결되는 딥 링크의 utm_campaign URL 매개변수 값입니다. 서드 파티 추천에만 제공됩니다.

참고: 이 값이 특정 최소 기준점에 도달하지 않을 경우 Other일 수 있습니다.
스토어 등록정보 획득 정수 아니요 10 스토어 등록정보를 방문하여 앱을 설치한 사용자 중 당시에 다른 기기에 앱이 설치되어 있지 않았던 사용자 수입니다.
스토어 등록정보 방문자 정수 아니요 100 스토어 등록정보를 방문한 사용자 중 기기에 아직 앱이 설치되어 있지 않았던 사용자 수입니다.
스토어 등록정보 전환율 소수 아니요 0.1

스토어 등록정보 방문자 중 앱을 설치한 사람의 비율입니다. 

참고: 이미 다른 기기에 앱을 설치한 사용자의 방문이나 설치는 포함되지 않습니다.

사용 가능한 분석 구조

다음 분석을 사용할 수 있습니다.

분석 이름 각 CSV의 입력란(순서대로)

국가

파일 이름 예:

store_performance_com.example.app_202012_country.csv

 날짜, 패키지 이름, 국가, 스토어 등록정보 획득, 스토어 등록정보 방문자, 스토어 등록정보 전환율

traffic_source

파일 이름 예:

store_performance_com.example.app_202012_traffic_source.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

구매자(설치 후 7일 - 2021년 8월까지 사용 가능)

명령어

gs://[developer_bucket_id]/acquisition/buyers_7d/buyers_7d_[package_name]_yyyyMM_[dimension].csv

파일 형식

입력란 형식 선택사항 예시 및 참고사항
날짜 YYYY-mm-dd 아니요

사용자가 내 스토어 등록정보에 방문한 날짜

참고: 여러 날에 걸친 고유 스토어 등록정보 방문자를 추가하면 스토어 등록정보 방문자 수가 주간 또는 월간 사용자 집단 조회수에 표시되는 방문자 수보다 많아집니다. 주간 및 월간 사용자 집단 조회수는 각 방문자가 여러 번 방문해도 1회 방문한 것으로 집계됩니다.
획득 채널 문자열 예

자연, Google Ads, UTM 태그 지정

'획득 채널' 측정기준과 관련하여 표시

참고: '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월부터 더 이상 지원되지 않습니다.

도움이 되었나요?

어떻게 하면 개선할 수 있을까요?

도움이 더 필요하신가요?

다음 단계를 시도해 보세요.

문의하기 자세히 알려주시면 도움을 드리겠습니다.
true
검색
검색어 지우기
검색 닫기
Google 앱
기본 메뉴
8222501428621561042
true
도움말 센터 검색
true
true
true
true
true
92637
false
false