報表類型
詳細報表詳細報表內含個別事件的資料：
- 評論
- 財務資料：預估銷售額、收益、獎勵商品和韓國 Play 餘額付款
匯總報表內含應用程式統計資料的綜合資料 (平均值，每日總計等)：
- 統計資料：安裝次數、當機次數、評分和訂閱數
- 獲取新客：安裝並保留應用程式的使用者人數、買家人數 (安裝應用程式後 7 天內) 和訂閱人數
下載報表
- 開啟 Play 管理中心。
- 按一下「下載報表」圖示
，然後選取「評論」、「統計資料」或「財務」。
- 在「選取應用程式」下方，輸入並選取您的應用程式名稱。
- 選取您要下載報表的年份和月份。
，然後選取「評論」、「統計資料」或「財務」。注意：財務報表包含您帳戶中所有應用程式的財務資料。
從 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)。
- 安裝 gsutil 工具。
- 驗證帳戶時，請務必使用可存取 Play 管理中心的帳戶。
- 在設定過程中，如果您是首次使用 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 Developers Console。
- 如果已有專案，請使用下拉式選單選取專案。如果沒有專案，或是要建立新專案，請按一下「建立專案」。
- 依序點選「選單」圖示
>「權限」>「服務帳戶」>「建立服務帳戶」。
- 按照畫面上的指示操作並選取「建立」。
- 複製系統列出的電子郵件地址。
- 例如：
accountName@project.iam.gserviceaccount.com
- 例如：
>「權限」>「服務帳戶」>「建立服務帳戶」。步驟 2：在 Play 管理中心新增服務帳戶
- 開啟 Play 管理中心。
- 依序點選「設定」圖示
>「使用者帳戶與權限」>「邀請新使用者」。
- 貼上或輸入與服務帳戶相關聯的電子郵件地址。
- 根據所需報表類型選取權限。
- 提示：請參閱「新增開發人員帳戶使用者以及管理各項權限」一文，瞭解使用者所具備的不同存取層級，以及各個權限所賦予的權利。
- 按一下「新增使用者」，系統就會在您的帳戶中新增服務帳戶。
>「使用者帳戶與權限」>「邀請新使用者」。步驟 3：使用 API 呼叫擷取報表
- 依您偏好的程式碼語言安裝 API 用戶端程式庫。
- 將執行 API 呼叫的程式碼設定為使用
OAuth2伺服器對伺服器驗證，並要求OAuth2範圍的權限 (https://www.googleapis.com/auth/devstorage.read_only)。 - 執行經過驗證的 API 呼叫，即可擷取報表。
如果您使用 Python 擷取報表，程式碼範例如下：
import json
from httplib2 import Http
from oauth2client.client import SignedJwtAssertionCredentials
from apiclient.discovery import build
# 視需求調整以下變數
client_email = '<您的服務帳戶>'
json_file = '<建立服務帳戶時取得的 json 檔案路徑>'
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 管理中心的資料存取權限相同。也就是說，如果帳戶使用者在 Play 管理中心帳戶擁有某些部分的存取權，即可存取 Google Cloud Storage 中的相應報表。
帳戶擁有者可隨時更新個別使用者的權限。
- 如要存取大量報表，您的「查看應用程式資訊」權限必須設為「全域」。
- 如要下載財務報表，您的「查看財務資料」權限必須設為「全域」。
詳細報表的指令與檔案格式
當機次數和 ANR
自 2018 年 5 月起，您無法繼續下載當機次數和 ANR 的詳細報表。
評論
指令
gs://[developer_bucket_id]/reviews/reviews_[package_name]_YYYYMM.csv
檔案格式
| 欄位 | 格式 | 是否為選用 | 範例與附註 |
|---|---|---|---|
| 套件名稱 | 字串 | 否 | com.company.app |
| 應用程式版本代碼 | 整數 | 是 | 僅限正式發布階段 APK |
| 應用程式版本名稱 | 字串 | 是 | |
| 評論者語言 | 字串 (雙字母縮寫的 ISO 639-1) | 是 | en |
| 裝置 | 字串 | 是 | hammerhead |
| 評論提交日期和時間 | 包括時間 (UTC 時區) 的 ISO_8601 | 否 | 2014-06-19T19:12:32Z |
| 評論提交毫秒時間 (自 Epoch 起算) | 整數，以毫秒為單位 (自 Epoch 起算) | 否 | |
| 評論上次更新日期和時間 | 包括時間 (UTC 時區) 的 ISO_8601 | 是 | 2014-06-19T19:12:32Z |
| 評論上次更新毫秒時間 (自 Epoch 起算) | 整數，以毫秒為單位 (自 Epoch 起算) | 是 | |
| 星級評分 | 整數 (介於 1 和 5 之間) | 否 | |
| 評論標題 | 評論者的當地語言字串 (去除新行) | 是 | |
| 評論文字 | 評論者的當地語言字串 (去除新行) | 是 | |
| 開發人員回覆日期和時間 | 包括時間 (UTC 時區) 的 ISO_8601 | 是 | 2014-06-19T19:12:32Z |
| 開發人員回覆毫秒時間 (自 Epoch 起算) | 整數，以毫秒為單位 (自 Epoch 起算) | 是 | |
| 開發人員回覆文字 | 字串 (去除新行並壓縮空格) | 是 | |
| 評論連結 | 字串 | 是 | 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 時間戳記。以秒為單位 (自 Epoch 起算)。 |
|
財務狀況 |
字串 |
否 |
如果您在核發部分退款後要進行全額退款：
|
|
裝置型號 |
字串 |
否 |
購買時所用的 Android 裝置型號。如果是訂閱訂單，則指的是最初下單時使用的裝置。 |
|
產品名稱 |
字串 |
否 |
產品的開發人員專屬名稱，以買家所在地區的語言顯示。 |
|
產品 ID |
字串 |
否 |
售出產品的應用程式所屬套件名稱。 |
|
產品類型 |
字串 |
否 |
|
|
SKU ID |
字串 |
否 |
產品的開發人員專屬 ID。 |
|
銷售貨幣 |
字串 |
否 |
|
|
商品價格 |
整數 |
否 |
以買家的當地貨幣顯示。「,」是千位分隔符號。 |
|
稅額 |
整數 |
是 |
以買家的當地貨幣顯示。「,」是千位分隔符號。 |
|
扣款金額 |
整數 |
否 |
以買家的當地貨幣顯示。這個值是商品價格和稅額的總和。「,」是千位分隔符號。 |
|
買家所在城市 |
字串 |
是 |
只有在您是收單商家時才會填入資料。 |
|
買家所在州/省 |
字串 |
是 |
|
|
買家郵遞區號 |
字串 |
是 |
只有在您是收單商家時才會填入資料。 |
|
買家所在國家/地區 |
字串 |
否 |
|
|
基本方案 ID |
字串 |
是 |
訂閱項目的基本方案 ID。只有訂閱項目會有這項資料。瞭解詳情 |
|
優惠 ID |
字串 |
是 |
訂閱項目的優惠 ID。只有訂閱項目會有這項資料。瞭解詳情 |
| 群組 ID | 整數 | 是 |
每個開發人員帳戶群組建立時都會獲得一組專屬 ID。瞭解詳情 |
| 前 $100 萬美元收益是否適用 15% 服務費率 | 字串 | 是 |
只有已設定開發人員帳戶群組時才會填入資料。瞭解詳情 |
| 促銷 ID | 字串 | 是 |
|
| 優待券面額 | 整數 | 是 |
以買家的當地貨幣顯示。「,」是千位分隔符號。只有在銷售活動涉及 Play 點數優待券時才會填入資料。瞭解詳情 |
| 折扣費率 | 整數 | 是 |
這個百分比折扣費率用於指明使用者利用 Play 點數消費時所省下的額度 (與使用現金消費相比)。只有在銷售活動涉及 Play 點數時才會填入資料。瞭解詳情 |
|
精選產品 ID |
整數 |
是 |
開發人員建立精選產品時獲得的一組專屬 ID。瞭解詳情 |
| 價格實驗 ID | 字串 | 是 |
價格實驗 ID 和實驗組 |
建議您不要根據 CSV 檔案中的欄數自動產生報告。
關於
您可以使用收益報表瞭解您的付款和交易明細。報表中每一行都代表某種類型的交易 (例如向客戶收取款項或向 Google 支付費用)，並且會顯示原始金額和換算後的金額。
收益報表包含前一個月的交易資料。收益報表產生後，您過幾週就會收到付款。
收益報表每月會產生一次，且通常會在下個月的 5 日之前提供。有時候，Google 可能會調整您的收益以更正計算錯誤。在這類情況下，我們會通知您問題所在，並另外建立一個只含有調整後交易資料的「收益」檔案。
注意事項：
- 從現在起，無論 Google 是否為所售產品的收單商家，所有交易都會顯示 Google 費用。
- 收益報表不含交易退單。
- 系統每月會針對交易的收益報表產生一個檔案。
- 台灣扣繳稅額是在申報當月的前一個月繳納
指令
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 的結尾是續約週期號碼。例如，首次續約的號碼是 |
|
交易日期 |
字串 |
否 |
這筆訂單的日期 (以太平洋時間為準，格式為 MMM DD, YYYY)。請注意，由於系統產生報表時會以問題時間戳記為依據，所以交易時間戳記可能會記錄到下個月份。 |
|
交易時間 |
字串 |
否 |
|
|
稅額類型 |
字串 |
是 |
如果不是稅項則會留空。 |
|
交易類型 |
字串 |
否 |
|
|
退款類型 |
字串 |
是 |
如果買家獲得全額退款，此欄會顯示「Full (全額)」。如果使用者僅獲得付款金額的部分退款，則此欄會標示為「Partial」(部分)。 |
|
產品名稱 |
字串 |
否 |
產品的開發人員專屬名稱，以買家所在地區的語言顯示。 |
|
產品 ID |
字串 |
否 |
售出產品的應用程式所屬套件名稱。 |
|
產品類型 |
整數 |
否 |
用來識別售出的產品類型。「0」代表售出的是付費應用程式，「1」則代表售出的是應用程式內商品或訂閱項目。 |
|
SKU ID |
字串 |
否 |
產品的開發人員專屬 ID。 |
|
硬體 |
字串 |
否 |
購買時所用的 Android 裝置型號。如果是訂閱項目訂單，則指的是最初購買時使用的型號。 |
|
買家所在國家/地區 |
字串 |
否 |
|
|
買家所在州/省 |
字串 |
是 |
|
|
買家郵遞區號 |
字串 |
是 |
|
|
買家使用幣別 |
字串 |
否 |
|
|
金額 (買家使用幣別) |
整數 |
否 |
此應付憑據在換算匯率前的總金額。 |
|
貨幣匯率 |
整數 |
否 |
以商家使用幣別將買家金額換算成付款金額時的匯率。 |
| 商家使用幣別 | 字串 | 否 |
訂單經換算後所採用的幣別。這個值指的是系統向您付款時所使用的當地貨幣。 |
| 金額 (商家使用幣別) | 整數 | 否 |
此應付憑據在換算匯率後的總金額。 |
|
基本方案 ID |
字串 |
是 |
訂閱項目的基本方案 ID。只有訂閱項目會有這項資料。瞭解詳情 |
|
優惠 ID |
字串 |
是 |
訂閱項目的優惠 ID。只有訂閱項目會有這項資料。瞭解詳情 |
| 群組 ID | 整數 | 是 |
每個開發人員帳戶群組建立時都會獲得一組專屬 ID。瞭解詳情 |
| 前 $100 萬美元收益是否適用 15% 服務費率 | 字串 | 是 |
只有在設定開發人員帳戶群組後，系統才會填入資料。瞭解詳情 |
|
服務費率 |
整數 |
是 |
|
| 費用說明 | 字串 | 是 |
Google 服務費的詳細計算資料。 |
| 促銷 ID | 字串 | 是 |
只有在銷售活動涉及 Play Points 和 Play Pass 時，才會填入資料。 前置字元為「PP.C」，代表訂單已套用 Play Points 優待券；前置字元為「PP.P」，代表訂單參與應用程式內商品促銷活動。系統也會顯示直接使用 Play 點數的訂單。前置字串「pass」表示使用者已在訂單中套用 Play Pass 訂閱方案提供的優待券。 |
建議您不要根據 CSV 檔案中的欄數自動產生報告。
關於
如果您已註冊其他結帳系統或外部優惠計畫，並向 Google Play 回報交易，就能透過月結帳單報表瞭解您的交易資訊和 Google 服務費應付金額。
月結帳單報表會將上個月的交易資訊整合為單一 CSV 檔案，並列出每筆交易的明細，包括使用者付款、Google 服務費，以及適用稅金。檔案中也會附上服務費率和貨幣匯率等資訊，協助您瞭解服務費的月結單金額計算方式。
注意：
- 月結帳單報表每月會產生一次，且通常會在下個月的 5 日之前提供。
- Google 費用或稅項會以帳單幣別計算，如果四捨五入為零，便不會在報表中列出。
指令
gsutil cp -r gs://[developer_bucket_id]/invoice_billing_reports/invoice_billing_report_YYYYMM.zip /your/local/directory
範例
如要從報表 bucket 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 時間戳記，以秒為單位 (自 Epoch 時間起算)。 |
|
交易類型 |
字串 |
否 |
使用者付款、Google 費用、稅金、使用者付款退款、Google 費用退款、稅金退款、使用者付款部分退款、Google 費用部分退款、稅金部分退款 |
|
稅金類型 |
字串 |
是 |
僅適用於稅項。 |
|
SKU 類型 |
字串 |
否 |
|
|
套件 ID |
字串 |
否 |
售出產品的應用程式所屬套件名稱。 |
|
銷售國家/地區 |
字串 |
否 |
|
|
商品未稅價格 (銷售幣別) |
小數 |
是 |
以銷售幣別計算的商品價格 (不含稅)，僅適用於使用者付款。 |
|
銷售幣別 |
字串 |
否 |
買家的當地幣別。 |
|
應付金額 (銷售幣別) |
小數 |
是 |
以銷售幣別計算的應付金額，僅適用於 Google 費用和稅項。收費金額以正數顯示，退款和部分退款則以負數顯示。 |
|
貨幣匯率 |
小數 |
否 |
將應付金額從銷售幣別換算為帳單幣別時的匯率。 |
|
帳單幣別 |
字串 |
否 |
|
|
應付金額 (帳單幣別) |
小數 |
是 |
以帳單幣別計算的應付金額，僅適用於 Google 費用和稅項。收費金額以正數顯示，退款和部分退款則以負數顯示。 |
|
群組 ID |
整數 |
是 |
每個開發人員帳戶群組建立時都會獲得一組專屬 ID。瞭解詳情 |
|
前 $100 萬美元收益是否適用 15% 服務費率 |
字串 |
是 |
必須設定開發人員帳戶群組才會填入資料。瞭解詳情。 |
|
服務費率 |
整數 |
是 |
|
|
費用說明 |
字串 |
是 |
Google 服務費的詳細計算資料。 |
關於
如果貴商家在韓國依據適用法條和法規必須開立現金收據，或者自主登錄開立現金收據，當有人以 Google Play 禮物卡 (幣別為韓元) 購買付費應用程式或應用程式內商品並索取收據時，貴商家必須開立現金收據。
韓國 Play 餘額付款報表包含幣別為韓元的 Play 餘額交易資料，以便貴商家傳送現金收據給使用者。
注意：使用者可以透過多種來源加值 Play 餘額，包括 Google 或合作夥伴提供的促銷抵免額。在開立現金收據前，請務必確認使用者使用了現金等值物 (例如禮物卡) 加值餘額。
指令
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)。 |
|
財務狀況 |
字串 |
否 |
|
|
Play 餘額付款金額 |
字串 |
否 |
交易金額。 |
| Play 餘額使用的幣別 | 字串 | 否 | KRW韓國 Play 餘額付款報表使用的幣別一律是韓元 (KRW)。 |
| 訂單收費時間戳記 | 整數 | 否 | 1480507200
向使用者收取訂單費用時的 UNIX 時間戳記。以秒為單位 (自 Epoch 紀元時間起算)。 |
訂閱
取消訂閱問卷回覆情形指令
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_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_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_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 | 字串 | 否 | Premium access (進階存取權) |
| 國家/地區 | 字串 | 否 |
|
| 新增訂閱數 | 數字 | 否 | 1234 |
| 取消訂閱數 | 數字 | 否 | 1234 |
| 有效訂閱數 | 數字 | 否 | 1234 |
| 基本方案 ID | 字串 | 否 | weekly (每週) |
| 優惠 ID | 字串 | 否 | spring-offer (春季優惠) |
注意：如要進一步瞭解有關新增訂閱數、取消訂閱數和有效訂閱數的統計資料，請參閱「查看應用程式的收益和買家資料」一文。
支援的維度
| 維度 | 檔案名稱 |
|---|---|
| 國家/地區 | ..._country.csv |
使用者開發
「安裝並保留應用程式的使用者人數」和「買家人數」報表可讓開發人員透過程式存取舊版獲客報表的資料。不過，這項匯出功能已由新的程式輔助匯出功能取代，新功能匯出資料的來源包括 Play 管理中心的商店分析和轉換分析頁面，推出時間為 2021 年 3 月。
舊版報表已在 2021 年 10 月移除。
想瞭解有關詳情，請務必參閱「如何下載獲取新客資料？」
注意：自 2019 年 11 月起，我們不再支援「訂閱人數」報表。如需瞭解詳情，請務必參閱客戶開發來源與指標。
安裝並保留應用程式的使用者人數 (舊版匯出功能 - 2021 年 8 月 1 日停用)指令
gs://[developer_bucket_id]/acquisition/retained_installers/retained_installers_[package_name]_yyyyMM_[dimension].csv
檔案格式
| 欄位 | 格式 | 是否為選用 | 範例與附註 |
|---|---|---|---|
| 日期 | YYYY-mm-dd | 否 |
使用者瀏覽您商店資訊的日期 注意：如果您將某幾天的不重複商店資訊訪客數加總起來，累計的數字會大於單週或單月同類群組顯示的商店資訊訪客數。單一訪客在單週和單月同類群組的瀏覽次數中只計為一次，即使訪客多次造訪亦然。 |
| 客戶開發管道 | 字串 | 是 |
顯示「客戶開發管道」維度 注意：「Play 商店 (自然)」管道的訪客數是「Play 商店 (自然) 搜尋」和「Play 商店 (自然) 瀏覽」的總和。為了避免在報表中重複計算訪客人數，您可以選擇忽略「Play 商店 (自然)」這個總計數據列，或是同時忽略搜尋維度與瀏覽維度的資料列。 |
| 國家/地區 | 字串 | 是 | 顯示「國家/地區」和「國家/地區 (來自 Play 商店的自然流量)」維度 |
| Urchin 流量監視器 (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 商店 (自然)」這個總計數據列，或是同時忽略搜尋維度與瀏覽維度的資料列。
自 2019 年 6 月起，我們不再支援 Google 搜尋 (自然) 維度。
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 網址參數值。僅適用於第三方轉介訪客 注意：如果這個值未達到部分最低門檻，可以是 |
| UTM 廣告活動 | 字串 | 是 | campaign |
商店資訊深層連結的 utm_campaign 網址參數值。僅適用於第三方轉介訪客。 注意：如果這個值未達到部分最低門檻，可以是Other |
| 商店資訊的使用者開發人數 | 整數 | 否 | 10 |
造訪過您的商店資訊，而且在安裝應用程式的當下，不曾在任何其他裝置上安裝過該應用程式的使用者人數 |
| 商店資訊訪客數 | 整數 | 否 | 100 |
造訪過您的商店資訊，但不曾在任何裝置上安裝過該應用程式的使用者人數 |
| 商店資訊轉換率 | 小數 | 否 | 0.1 |
有多少百分比的商店資訊訪客安裝了您的應用程式 注意：對於已在其他裝置上安裝應用程式的使用者，這項數據不會納入他們的造訪次數或安裝次數 |
可用的細目資料結構
可用的細目資料如下：
| 細目資料名稱 | 各個 CSV 檔案中的欄位 (依序顯示)： |
|---|---|
|
檔案名稱範例：
|
日期、套件名稱、國家/地區、商店資訊的客戶開發人數、商店資訊訪客數、商店資訊轉換率 |
|
檔案名稱範例：
|
日期、套件名稱、流量來源、搜尋字詞、UTM 來源、UTM 廣告活動、商店資訊的客戶開發人數、商店資訊訪客數、商店資訊轉換率 |
逸出配置
- 每次都使用兩個雙引號 (
"->"")。 - 如果儲存格包含任何 Tab 字元、換行符號、雙引號或逗號，請在儲存格前後加上雙引號 (
...->"...")。
範例
如要從報表值區 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 | 否 |
使用者瀏覽您商店資訊的日期 注意：如果您將某幾天的不重複商店資訊訪客數加總起來，累計的數字會大於單週或單月同類群組顯示的商店資訊訪客數。單一訪客在單週和單月同類群組的瀏覽次數中只計為一次，即使訪客多次造訪亦然。 |
| 客戶開發管道 | 字串 | 是 |
顯示「客戶開發管道」維度 注意：「Play 商店 (自然)」管道的訪客數是「Play 商店 (自然) 搜尋」和「Play 商店 (自然) 瀏覽」的總和。為了避免在報表中重複計算訪客人數，您可以選擇忽略「Play 商店 (自然)」這個總計數據列，或是同時忽略搜尋維度與瀏覽維度的資料列。 |
| 國家/地區 | 字串 | 是 | 顯示「國家/地區」和「國家/地區 (來自 Play 商店的自然流量)」維度 |
| Urchin 流量監視器 (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 商店 (自然)」這個總計數據列，或是同時忽略搜尋維度與瀏覽維度的資料列。
自 2019 年 6 月起，我們不再支援 Google 搜尋 (自然) 維度。