下載及匯出每月報表

您可以透過 Play 管理中心網站下載個別應用程式的每月報表，藉此追蹤及瞭解應用程式的表現。

報表類型

詳細報表

詳細報表內含個別事件的資料：

  • 評論
  • 財務資料：預估銷售額、收益、獎勵商品和韓國 Play 餘額付款
匯總報表

匯總報表內含應用程式統計資料的綜合資料 (平均值，每日總計等)：

  • 統計資料：安裝次數、當機次數、評分和訂閱數
  • 使用者開發：安裝並保留應用程式的使用者人數、買家人數 (安裝應用程式後 7 天內) 和訂閱人數

下載報表

  1. 開啟 Play 管理中心。
  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 管理中心的帳戶。
    • 在設定過程中，如果您是首次使用 gsutil，且尚未在 Google Cloud Storage 中設定任何其他專案，可以在系統要求您提供專案 ID 時輸入應用程式的名稱。
  2. 在「下載報表」頁面上，按一下相應區塊標題旁的「複製 Cloud Storage URI」按鈕，找到報表值區 ID。
    • Cloud Storage URI 的開頭為 pubsite_prod_rev (例如：pubsite_prod_rev_01234567890987654321)。
  3. 使用 gsutil cp 指令下載報表。

系統會將報表歸到以報表類型命名的目錄中。CSV 檔案名稱是由報表類型、套件名稱、時間範圍和維度 (如果適用) 所組成。

使用用戶端程式庫和服務帳戶下載報表

步驟 1：建立服務帳戶

  1. 開啟 Google Developers Console。
  2. 如果已有專案，請使用下拉式選單選取專案。如果沒有專案，或是要建立新專案，請按一下「建立專案」。
  3. 依序點選「選單」圖示 選單圖示 >「權限」>「服務帳戶」>「建立服務帳戶」。
  4. 按照畫面上的指示操作並選取「建立」。
  5. 複製系統列出的電子郵件地址。
    • 例如：accountName@project.iam.gserviceaccount.com

步驟 2：在 Play 管理中心新增服務帳戶

  1. 開啟 Play 管理中心。
  2. 依序點選「設定」圖示 設定 >「使用者帳戶與權限」>「邀請新使用者」。
  3. 貼上或輸入與服務帳戶相關聯的電子郵件地址。
  4. 根據所需報表類型選取權限。 
  5. 按一下「新增使用者」，系統就會在您的帳戶中新增服務帳戶。

步驟 3：使用 API 呼叫擷取報表

  1. 依您偏好的程式碼語言安裝 API 用戶端程式庫。
  2. 將執行 API 呼叫的程式碼設定為使用 OAuth2 伺服器對伺服器驗證，並要求 OAuth2 範圍的權限 (https://www.googleapis.com/auth/devstorage.read_only)。
  3. 執行經過驗證的 API 呼叫，即可擷取報表。
範例說明 (Python)

如果您使用 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

檔案格式

欄位 格式 是否為選用 範例與附註

訂單號碼

字串

否

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 時間戳記。以秒為單位 (自 Epoch 起算)。

財務狀況

字串

否

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

字串

是

weekly (每週)

訂閱項目的基本方案 ID。只有訂閱項目會有這項資料。瞭解詳情

優惠 ID

字串

是

spring-offer (春季優惠)

訂閱項目的優惠 ID。只有訂閱項目會有這項資料。瞭解詳情
群組 ID 整數 是

1234567891234567890

每個開發人員帳戶群組建立時都會獲得一組專屬 ID。瞭解詳情
前 $100 萬美元收益是否適用 15% 服務費率 字串 是

Yes、 No

只有在已設定開發人員帳戶群組的情況下才會填入資料。瞭解詳情
促銷 ID 字串 是

PP.C2fy7Ns0/+e2w、PP.P2fy7Ns0/+e2w、Points used only (僅使用點數)

只有在銷售活動涉及 Play 點數時才會填入資料。前置字元「PP.C」和「PP.P」分別表示與優待券和應用程式內產品促銷活動相關的訂單。系統也會顯示直接使用 Play 點數的訂單。瞭解詳情
優待券面額 整數 是

3.00

以買家的當地貨幣顯示。「,」是千位分隔符號。只有在銷售活動涉及 Play 點數優待券時才會填入資料。瞭解詳情
折扣費率 整數 是

45、55、70

這個百分比折扣費率用於指明使用者利用 Play 點數消費時所省下的額度 (與使用現金消費相比)。只有在銷售活動涉及 Play 點數時才會填入資料。瞭解詳情

精選產品 ID

整數

是

1234567891234567890

開發人員建立精選產品時都會獲得一組專屬 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

檔案格式

欄位 格式 是否為選用 範例與附註

說明

字串

否

GPA.1234-1234-1234-12345

指派給這筆訂單的唯一識別碼。訂閱項目訂單 ID 的結尾包含續約週期號碼。

交易日期

字串

否

Nov 30, 2016 (2016 年 11 月 30 日)

這筆訂單的日期 (以太平洋時間為準，格式為 MMM DD, YYYY)。請注意，由於系統產生報表時會以問題時間戳記為依據，所以交易時間戳記可能會記錄到下個月份。

交易時間

字串

否

12:00:00 PM PDT

稅額類型

字串

是

Third-party tax (第三方稅項)

如果不是稅項則會留空。

交易類型

字串

否

Charge (收費額)、Google fee (Google 費用)、Tax (稅金)、Charge refund (收費額退款)、Google fee refund (Google 費用退款)、Charge rebill (重新結算的收費額)、Tax rebill (重新結算的稅金)、Google fee rebill (重新結算的 Google 費用)、Adjustment (調整項)。

退款類型

字串

是

Full (全額)、Partial (部分)

如果買家獲得全額退款，此欄會顯示「Full (全額)」。如果使用者僅獲得付款金額的部分退款，則此欄會標示為「Partial」(部分)。

產品名稱

字串

否

coins (金幣)、monthly subscription (月訂閱) 等

產品的開發人員專屬名稱，以買家所在地區的語言顯示。

產品 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

字串

是

weekly (每週)

訂閱項目的基本方案 ID。只有訂閱項目會有這項資料。瞭解詳情

優惠 ID

字串

是

spring-offer (春季優惠)

訂閱項目的優惠 ID。只有訂閱項目會有這項資料。瞭解詳情
群組 ID 整數 是

1234567891234567890

每個開發人員帳戶群組建立時都會獲得一組專屬 ID。瞭解詳情
前 $100 萬美元收益是否適用 15% 服務費率 字串 是

Yes、 No

只有在已設定開發人員帳戶群組的情況下才會填入資料。瞭解詳情

服務費率 (%)

整數

 是

10、15、30
費用說明 字串 是

SUBSCRIPTIONS (訂閱)

Google 服務費的詳細計算資料。
促銷 ID 字串 是

PP.C_x0a08trvC1、PP.PdYfn342Ox10、Points used only (僅使用點數)

只有在銷售活動涉及 Play 點數時才會填入資料。前置字元「PP.C」和「PP.P」分別表示與優待券和應用程式內產品促銷活動相關的訂單。系統也會顯示直接使用 Play 點數的訂單。瞭解詳情
韓國 Play 餘額付款

關於

如果貴商家在韓國依據適用法條和法規必須開立現金收據，或者自主登錄開立現金收據，當有人以 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

檔案格式

欄位 格式 是否為選用 範例與附註

訂單號碼

整數

否

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)。

財務狀況

字串

否

Charged (已收費)、Refund (退款) 等

Play 餘額付款金額

字串

否

12,345.67

交易金額。
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 否

2022-01-01

這筆訂單的日期 (以世界標準時間 (UTC) 為準，格式為 YYYY-MM-DD)
套件名稱 字串 否 com.example.app
產品 ID 字串 否 Premium access (進階存取權)
國家/地區 字串 否

US (美國)、CA (加拿大) 等。
新增訂閱數 數字 否 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 否

使用者瀏覽您商店資訊的日期

注意：如果您將某幾天的不重複商店資訊訪客數加總起來，累計的數字會大於單週或單月同類群組顯示的商店資訊訪客數。單一訪客在單週和單月同類群組的瀏覽次數中只計為一次，即使訪客多次造訪亦然。
客戶開發管道 字串 是

Organic (自然)、Google Ads、UTM-Tagged (UTM 標記)

顯示「客戶開發管道」維度

注意：「Play 商店 (自然)」管道的訪客數是「Play 商店 (自然) 搜尋」和「Play 商店 (自然) 瀏覽」的總和。為了避免在報表中重複計算訪客人數，您可以選擇忽略「Play 商店 (自然)」這個總計數據列，或是同時忽略搜尋維度與瀏覽維度的資料列。
國家/地區 字串 是 顯示「國家/地區」和「國家/地區 (來自 Play 商店的自然流量)」維度
Urchin 流量監視器 (UTM) 來源/廣告活動 字串 是

顯示「已追蹤管道 (UTM)」維度
關鍵字 字串 是

例如：「games」(遊戲)。

顯示「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 搜尋 (自然) 維度。

商店成效 (新版匯出功能 - 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 網址參數值。僅適用於第三方轉介訪客

注意：如果這個值未達到部分最低門檻，可以是 Other
UTM 廣告活動 字串 是 campaign

商店資訊深層連結的 utm_campaign 網址參數值。僅適用於第三方轉介訪客。

注意：如果這個值未達到部分最低門檻，可以是 Other
商店資訊的使用者開發人數 整數 否 10 造訪過您的商店資訊，而且在安裝應用程式的當下，不曾在任何其他裝置上安裝過該應用程式的使用者人數
商店資訊訪客數 整數 否 100 造訪過您的商店資訊，但不曾在任何裝置上安裝過該應用程式的使用者人數
商店資訊轉換率 小數 否 0.1

有多少百分比的商店資訊訪客安裝了您的應用程式

注意：對於已在其他裝置上安裝應用程式的使用者，這項數據不會納入他們的造訪次數或安裝次數

可用的細目資料結構

可用的細目資料如下：

細目資料名稱 各個 CSV 檔案中的欄位 (依序顯示)：

country

檔案名稱範例：

store_performance_com.example.app_202012_country.csv

 日期、套件名稱、國家/地區、商店資訊的客戶開發人數、商店資訊訪客數、商店資訊轉換率

traffic_source

檔案名稱範例：

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

買家人數 (安裝應用程式後 7 天內 - 2021 年 8 月停用)

指令

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

檔案格式

欄位 格式 是否為選用 範例與附註
日期 YYYY-mm-dd 否

使用者瀏覽您商店資訊的日期

注意：如果您將某幾天的不重複商店資訊訪客數加總起來，累計的數字會大於單週或單月同類群組顯示的商店資訊訪客數。單一訪客在單週和單月同類群組的瀏覽次數中只計為一次，即使訪客多次造訪亦然。
客戶開發管道 字串 是

Organic (自然)、Google Ads、UTM-Tagged (UTM 標記)

顯示「客戶開發管道」維度

注意：「Play 商店 (自然)」管道的訪客數是「Play 商店 (自然) 搜尋」和「Play 商店 (自然) 瀏覽」的總和。為了避免在報表中重複計算訪客人數，您可以選擇忽略「Play 商店 (自然)」這個總計數據列，或是同時忽略搜尋維度與瀏覽維度的資料列。
國家/地區 字串 是 顯示「國家/地區」和「國家/地區 (來自 Play 商店的自然流量)」維度
Urchin 流量監視器 (UTM) 來源/廣告活動 字串 是 顯示「已追蹤管道 (UTM)」維度
關鍵字 字串 是

例如：「games」(遊戲)。

顯示「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 搜尋 (自然) 維度。

這對您有幫助嗎？

我們應如何改進呢？

還有其他問題嗎？

嘗試以下步驟：

與我們聯絡 進一步說明相關資訊，我們會盡力協助您
true
搜尋
清除搜尋內容
關閉搜尋
主選單
5367537776066571004
true
搜尋說明中心
true
true
true
true
true
92637
false
false