2026 年 10 月起，我們將更新收益和月結型帳單報表中的「費用說明」欄。
為反映新的服務費結構，「費用說明」欄現在會視情況包含下列值：
- APPS_GAMES_PROGRAM
- APPS_GAMES_PROGRAM_NEW_INSTALL
如果您使用自動化工作流程，且值完全相符時才會執行工作流程，可能需要更新。請檢查工作流程並視需要更新。
報表類型
詳細報表詳細報表內含個別事件的資料：
- 評論
- 財務資料：預估銷售額、收益、獎勵商品和韓國 Play 餘額付款
匯總報表內含應用程式統計資料的綜合資料 (平均值，每日總計等)：
- 統計資料：安裝次數、當機次數、評分和訂閱數
- 獲取新客：安裝並保留應用程式的使用者人數、買家人數 (安裝應用程式後 7 天內) 和訂閱人數
下載報表
- 開啟 Play 管理中心。
- 按一下「下載報表」圖示
，然後選取「評論」、「統計資料」或「財務」。
- 在「選取應用程式」下方，輸入並選取您的應用程式名稱。
- 選取您要下載報表的年份和月份。
，然後選取「評論」、「統計資料」或「財務」。注意：財務報表包含您帳戶中所有應用程式的財務資料。
從 Google Cloud Storage 下載報表
您可以透過 Google Cloud Storage 存取報表。系統每天都會擷取資料，並在 3 到 7 天內發布至當月的 CSV 檔案，而這些報表會儲存在 Google Play 開發人員帳戶的私人 Google Cloud Storage bucket 中。
您可以使用瀏覽器在 Google Cloud Storage 上查閱報表，或是透過 gsutil 程式取得報表。您也可以使用其他工具，透過程式存取 Cloud Storage bucket。您建構的系統以不仰賴匯出資料在特定時間更新為宜。
提示：如要將報表從 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」按鈕，找到報表 bucket ID。
- Cloud Storage URI 的開頭為
pubsite_prod_rev(例如：pubsite_prod_rev_01234567890987654321)。
- Cloud Storage URI 的開頭為
- 使用
gsutil cp指令下載報表。- 您可以參閱 gsutil 說明文件，瞭解還有哪些實用的報表存取指令。
系統會將報表歸到以報表類型命名的目錄中。CSV 檔案名稱是由報表類型、套件名稱、時間範圍和維度 (如果適用) 所組成。
步驟 1：建立服務帳戶
- 開啟 Google 開發人員控制台。
- 如果已有專案，請使用下拉式選單選取專案。如果沒有專案，或是要建立新專案，請按一下「建立專案」。
- 依序點選「選單」圖示
>「權限」>「服務帳戶」>「建立服務帳戶」。
- 按照畫面上的指示操作並選取「建立」。
- 複製系統列出的電子郵件地址。
- 例如：
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。瞭解詳情 |
| 群組 ID | 整數 | 是 |
每個開發人員帳戶群組建立時都會獲得一組專屬 ID。瞭解詳情 |
| 前 $100 萬美元收益是否適用 15% 服務費率 | 字串 | 是 |
必須設定開發人員帳戶群組才會填入資料。瞭解詳情 |
| 促銷 ID | 字串 | 是 |
|
| 優惠券面額 | 整數 | 是 |
以買家的當地貨幣顯示。「,」是千位分隔符號。只有在銷售活動涉及 Play 點數優待券時才會填入資料。瞭解詳情 |
| 折扣費率 | 整數 | 是 |
這個百分比折扣費率用於指明使用者利用 Play 點數消費時所省下的額度 (與使用現金消費相比)。只有在銷售活動涉及 Play 點數時才會填入資料。瞭解詳情 |
|
精選產品 ID |
整數 |
是 |
開發人員建立精選產品時獲得的一組專屬 ID。瞭解詳情 |
| 價格實驗 ID | 字串 | 是 |
價格實驗 ID 和實驗組 |
| 銷售通路 | 字串 | 是 |
顯示交易來源；週期性訂閱項目則留空。 |
建議您不要根據 CSV 檔案中的欄數自動產生報告。
關於
您可以使用收益報表瞭解撥款情形與交易明細。報表中的每一列皆代表一種交易類型 (例如向客戶收取的款項或支付給 Google 的費用)，並會顯示原始金額與換算後的金額。
收益報表包含前一個月的交易資料。收益報表產生後，您過幾週就會收到撥款。
收益報表每月產生一次，通常會在次月 5 日前提供。Google 有時可能會調整您的收益，以更正計算錯誤。若發生這種情況，我們會與您聯絡並說明問題，同時另外建立一份僅包含調整後交易記錄的收益檔案，供您備查。
注意事項：
- 無論 Google 是否為所售產品的收單商家，現在所有交易皆會顯示 Google 費用。
- 交易退單金額為購買價格扣除 Google Play 服務費。這類金額會顯示在訂單層級，並出現在次月的收益報表帳單週期。
- 交易退單手續費包含金融機構收取的相關費用。交易退單爭議解決後，系統會將所有訂單的這類費用彙整為每月總計顯示。
- 系統每月會針對交易產生一份收益報表檔案。
- 台灣扣繳稅額會於申報月份的前一個月撥付。
指令
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 |
字串 |
否 |
售出產品的應用程式所屬套件名稱。 |
|
產品類型 |
字串 |
否 |
用於辨識販售產品的類型。 |
|
SKU ID |
字串 |
否 |
產品的開發人員專屬 ID。 |
|
硬體 |
字串 |
否 |
購買時所用的 Android 裝置型號。如果是訂閱項目訂單，則指的是最初購買時使用的型號。 |
|
買家所在國家/地區 |
字串 |
否 |
|
|
買家所在州/省 |
字串 |
是 |
|
|
買家郵遞區號 |
字串 |
是 |
|
|
買家使用幣別 |
字串 |
否 |
|
|
金額 (買家使用幣別) |
整數 |
否 |
此帳單明細項目在貨幣換算前的總金額。 |
|
貨幣匯率 |
整數 |
否 |
以商家使用幣別將買家金額換算成付款金額時的匯率。 |
| 商家使用幣別 | 字串 | 否 |
訂單換算後使用的幣別。這個值指的是系統向您付款時所使用的當地幣別。 |
| 金額 (商家使用幣別) | 整數 | 否 |
此帳單明細項目經貨幣換算後的總金額。 |
| 基本方案或購買選項 ID |
字串 |
是 |
訂閱項目的基本方案 ID。瞭解詳情 單次產品的購買選項 ID。瞭解詳情 |
|
優惠 ID |
字串 |
是 |
訂閱項目的優惠 ID。瞭解詳情 單次產品的優惠 ID。瞭解詳情 |
| 群組 ID | 整數 | 是 |
每個開發人員帳戶群組建立時都會獲得一組專屬 ID。瞭解詳情 |
| 前 $100 萬美元收益是否適用 15% 服務費率 | 字串 | 是 |
只有在設定開發人員帳戶群組後，系統才會填入資料。瞭解詳情 |
|
服務費率 |
整數 |
是 | 15、20、25、30 |
| 費用說明 | 字串 | 是 |
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% 服務費率 |
字串 |
是 |
必須設定開發人員帳戶群組才會填入資料。瞭解詳情 |
|
服務費率 |
整數 |
是 |
10、11、15、20、25、26 等 |
|
費用說明 |
字串 |
是 |
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 搜尋 (自然) 維度。