通知

您现在可以通过 Play 管理中心账号中的“帮助”页面来请求协助。如果您没有 Play 管理中心的访问权限，请联系您的账号管理员获取邀请。

下载和导出每月报告

自 7 月起，我们将更新收入报告和基于账单的结算报告中的费用说明列，以及基于账单的结算报告中的计划列。

为了体现新的服务费结构，费用说明列现在将在适用的情况下包含以下值：

  • NEW_INSTALL
  • EXTERNAL_WEB_LINK（仅适用于基于账单的结算报告）

计划列现在将包含“自选结算方式”（如果适用）。

由于我们正在不同地区逐步推出新的费用结构，您可能会注意到，某些交易的现有列中会加入上述值，而其他交易则保持不变。

如果您使用的自动化工作流依赖于数值的完全匹配，则可能需要对其进行相应更新。请根据需要检查并更新您的工作流。

 
您可以使用 Play 管理中心下载有关各个应用的月度报告，以便跟踪和了解应用的推广效果。

报告的类型

详细报告

详细报告包含各个事件的相关数据：

  • 评价
  • 财务：估算销售额、收入、奖励商品和韩国 Play 余额付款
汇总报告

汇总报告包含应用统计信息的合并数据（平均值、每日总值等）：

  • 统计信息：安装量、崩溃次数、评分和订阅数
  • 用户获取情况：保留应用的安装人数、买家人数（安装应用后 7 天内）和订阅人数

下载报告

  1. 打开 Play 管理中心。
  2. 点击下载报告 报告，然后选择评价、统计信息或财务。
  3. 在“选择应用”下方，输入和选择您的应用名称。
  4. 选择您要下载报告的年份和月份。

请注意：“财务报告”包括您账号中的所有应用。

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

使用命令行工具下载报告
  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 命令下载报告。
    • 要了解其他可用于获取报告的命令，请参阅 gsutil 文档。

我们会将报告整理归到以每个报告类型命名的目录下。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 = '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 管理中心内的数据访问限制相同。这意味着如果账号用户有权访问 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（由两个字母组成的缩写） 是 zh
设备 字符串 是 hammerhead
提交评价的日期和时间 ISO_8601（包括时间和 UTC 时区） 否 2014-06-19T19:12:32Z
提交评价的毫秒时间（自 Epoch 以来） 整数，自 Epoch 以来的毫秒数 否  
评价的日期和时间 ISO_8601（包括时间和 UTC 时区） 是 2014-06-19T19:12:32Z
最后更新评价的毫秒时间（自 Epoch 以来） 整数，自 Epoch 以来的毫秒数 是  
星级 整数（介于 1 和 5 之间） 否  
评价标题 字符串，使用评价者的当地语言（去除换行） 是  
评价内容 字符串，使用评价者的当地语言（去除换行） 是  
开发者回复的日期和时间 ISO_8601（包括时间和 UTC 时区） 是 2014-06-19T19:12:32Z
开发者回复的毫秒时间（自 Epoch 以来） 整数，自 Epoch 以来的毫秒数 是  
开发者回复的内容 字符串（去除换行并压缩空格） 是  
评价链接 字符串 是 https://play.google.com/apps/publish/?dev_acc=<...>#ReviewPlace:id=<..>

示例

如果您的软件包名称为“com.example.app”，并且您想从 ID 为 pubsite_prod_rev_0123456789 的报告存储分区中下载该应用在 2014 年生成的所有报告，请使用以下命令：

gsutil cp -r gs://pubsite_prod_rev_0123456789/reviews/reviews_com.example.app_2014* /your/local/directory

财务报告

估算销售

建议您不要根据 CSV 文件中的列数生成自动报告。

简介

使用估算销售报告可以更及时地查看关于应用、应用内商品或订阅的销售信息。该报告显示的是买家支付的金额，且总金额中包含税费或 Google 费用。

您可以将此报告用于数据分析或趋势分析，但不建议将其用于会计核算。如果要使用报告进行会计核算，请查看收入报告。

您可能会发现，此报告与您的收入之间存在差异，这是由多种原因导致的。例如，估算销售报告未将预扣税费或退款统计在内。该报告中的金额是买家使用本地货币支付的金额，不是换算为您付款所用货币之后的金额。

注意：您还可以使用 Orders API 访问订单信息。

命令

gs://[developer_bucket_id]/sales/salesreport_YYYYMM.zip

示例

如果您的软件包名称为“com.example.app”，并且您想从 ID 为 pubsite_prod_rev_0123456789 的报告存储分区中下载该应用在 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

销售商品的应用的软件包名称。

产品类型

字符串

否

Subscription, One-time product, Paid app

用于标识所售商品的类型。

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。了解详情。

优惠 ID

字符串

是

spring-offer

订阅的优惠 ID。了解详情。

一次性商品的优惠 ID。了解详情。
群组 ID 整数 是

1234567891234567890

在创建开发者账号群组时，系统会提供唯一 ID。了解详情。
适用前 100 万美元收入的服务费费率 字符串 是

Yes, No

只有在设置开发者账号群组后，此字段才会显示内容。了解详情。
促销 ID 字符串 是

PP.C2fy7Ns0/+e2w, PP.P2fy7Ns0/+e2w, Points used only

只有在涉及与 Play Points 相关的销售交易时，此字段才会显示内容。“PP.C”前缀表明相应订单涉及优惠券，“PP.P”前缀表明相应订单涉及应用内商品促销活动。此外，系统还会显示直接使用 Play 积分进行交易的订单。了解详情。
优惠券价值 整数 是

3.00

以买家的当地币种显示，使用“,”作为千位分隔符。只有在涉及与 Play Points 优惠券相关的销售交易时，此字段才会显示内容。了解详情。
折扣率 整数 是

45, 55, 70

折扣率 (%) 是指与使用货币支付相比，用户使用 Play 积分支付可节省的费用比率。只有在涉及与 Play Points 相关的销售交易时，此字段才会显示内容。了解详情。

精选商品 ID

整数

是

1234567891234567890

开发者创建精选商品时，系统会提供唯一 ID。了解详情。
价格实验 ID 字符串 是

5697329857888256(Variant B)

价格实验 ID 和实验组
销售渠道 字符串 是

In-app、PC emulator、Native PC、Play store、Outside Play store

显示交易的来源。对于周期性订阅，此字段留空。
收入

建议您不要根据 CSV 文件中的列数生成自动报告。

简介

收入报告可让您了解自己的收款和交易。该报告的每一行都代表一种交易类型（例如您向客户收取费用或向 Google 支付费用），还会显示原始金额以及换算后的金额。

收入报告中包含您上个月的交易信息。我们会在提供收入报告的几周后向您支付款项。

系统每月会生成一次收入报告，通常在次月 5 日之前提供。有时，Google 可能会调整您的收入，以更正计算错误。如果出现这种情况，我们会与您联系，告知您相关问题，并额外创建一个仅包含调整后交易信息的“收入”文件，供您留作记录。

注意：

  • 现在，无论 Google 是否为所售商品的收单商家，所有交易均会显示 Google 费用。
  • 退款金额等于购买价格减去 Google Play 的服务费。这些金额按订单逐笔显示，并会出现在次月收入报告的结算周期中。
  • 退款手续费包括金融机构收取的关联退款手续费。退款争议解决后，这些费用会以所有订单每月汇总总额的形式显示。
  • 系统每月会生成一份针对交易的收入报告文件。
  • 台湾预扣税的缴纳时间比报告时间早一个月。

命令

gs://[developer_bucket_id]/earnings/earnings_YYYYMM.zip

示例

如果您的软件包名称为“com.example.app”，并且您想从 ID 为 pubsite_prod_rev_0123456789 的报告存储分区中下载您的应用在 2014 年生成的所有报告，请使用以下命令：

gsutil cp -r gs://pubsite_prod_rev_0123456789/earnings/earnings_2014* /your/local/directory

文件格式

字段 格式 可选 示例和备注

说明

字符串

否

GPA.1234-1234-1234-12345

订阅订单 ID 的末尾包含续订周期编号（例如，首次续订的编号是 GPA.1234-1234-1234-12345..0，第二次续订的编号是 GPA.1234-1234-1234-12345..1，依此类推）。

交易日期

字符串

否

Nov 30, 2016

基于太平洋时区的订单日期（采用 MMM DD, YYYY 格式）。请注意，由于报告会根据发出时间生成，因此交易时间戳可能会记录下个月。

交易时间

字符串

否

12:00:00 PM PDT

税费类型

字符串

是

Third-party tax

如果相应行对应的交易没有税费，则此字段留空。

交易类型

字符串

否

Charge、Google fee、Tax、Charge refund、Google fee refund、Charge rebill、Tax rebill、Google fee rebill、Adjustment

退款类型

字符串

是

Full、Partial

如果向买家退回了其支付的全部金额，则该退款会被标记为“全额”。如果只退回了买家支付的部分金额，则该退款会被标记为“部分”。

产品名称

字符串

否

coins、monthly subscription 等。

开发者指定的产品名称，以买家的当地语言显示。
软件包 ID

字符串

否

com.example.app

所售商品的应用的软件包名称。

产品类型

字符串

否

Subscription、One-time product、Paid app

用于标识所售商品的类型。

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。了解详情。

优惠 ID

字符串

是

spring-offer

订阅的优惠 ID。了解详情。

一次性商品的优惠 ID。了解详情。
群组 ID 整数 是

1234567891234567890

在创建开发者账号群组时，系统会提供唯一 ID。了解详情。
适用前 100 万美元收入的服务费费率 字符串 是

Yes、 No

只有在设置开发者账号群组后，此字段才会显示内容。了解详情。

服务费费率

整数

 是 15、20、25、30
费用说明 字符串 是

SUBSCRIPTIONS、NEW_INSTALL、EXTERNAL_WEB_LINK

与 Google 服务费计算有关的详细信息。

注意：具体数值取决于各地区逐步推出的新服务费结构。
促销 ID 字符串 是

PP.C_x0a08trvC1, PP.PdYfn342Ox10, pass-QbTfn350O810. Used by Points and Pass

只有在涉及与 Play Points 和 Play Pass 相关的销售交易时，此字段才会显示内容。

“PP.C”前缀表明相应订单涉及 Play Points 优惠券，“PP.P”前缀表明相应订单涉及应用内商品促销活动。此外，系统还会显示直接使用 Play Points 进行交易的订单。“pass”前缀表明用户在订单中使用了因订阅 Play Pass 而获得的代金券。
销售渠道 字符串 是

In-app、PC emulator、Native PC、Play store、Outside Play store

显示交易的来源。对于周期性订阅，此字段留空。
账单结算

建议您不要根据 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

示例

如果您想从 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

字符串

否

1234567890

与账单中显示的号码一致的 ID。

计划

字符串

是

用户自选结算方式、仅限备选结算系统、外部优惠

仅为 Google 服务费对应的行设定。

外部交易 ID

字符串

否

com.example.app:1a2b3c4e5f

交易日期

字符串

否

2024 年 7 月 1 日

交易日期，基于太平洋时区。

交易时间戳

整数

否

1719849600

交易的 UNIX 时间戳。从 Epoch 起算，以秒为单位。

交易类型

字符串

否

 用户付费、Google 服务费、税费、用户付费退款、Google 服务费退款、税费退款、用户付费部分退款、Google 服务费部分退款、税费部分退款

税费类型

字符串

是

增值税/商品及服务税

仅为税费对应的行设定。

SKU 类型

字符串

否

应用内商品、订阅

软件包 ID

字符串

否

com.example.app

销售商品的应用的软件包名称。

销售国家/地区

字符串

否

美国、韩国，等等。

不含税的商品价格（销售币种）

小数

是

12.34

不含税的商品价格，以销售币种表示。仅为用户付费对应的行设定。

销售币种

字符串

否

美元、韩元，等等。

买方的本地货币。

应付金额（销售币种）

小数

是

1.23 或 -1.23

应付金额，以销售币种表示。仅为 Google 服务费和税费对应的行设定。如果是已付金额，则为正值；如果是退款或部分退款金额，则为负值。

汇率

小数

否

1.076

将应付金额从销售币种换算为结算币种时所用的汇率。

结算币种

字符串

否

美元、欧元，等等。

应付金额（结算币种）

小数

是

1.32

应付金额，以结算币种表示。仅为 Google 服务费和税费对应的行设定。如果是已付金额，则为正值；如果是退款或部分退款金额，则为负值。

群组 ID

整数

是

1234567891234567890

在创建开发者账号群组时，系统会提供唯一 ID。了解详情。

适用前 100 万美元收入的服务费费率

字符串

是

是、否

只有在设置开发者账号群组后，此字段才会显示内容。了解详情。

服务费费率

整数

是

11、26，等等

费用说明

字符串

是

SUBSCRIPTIONS、MEDIA_PARTNERSHIPS、NEW_INSTALL、EXTERNAL_WEB_LINK，等等

与 Google 服务费计算有关的详细信息。

注意：具体数值取决于各地区逐步推出的新服务费结构。
韩国 Play 余额付款

简介

如果根据适用的法规和规章，您是必须在韩国开立现金收据的商家，或者您已自愿注册要开立现金收据，那么当有人以 Google Play 礼品卡购买付费应用或应用内商品（币种为韩元，KRW）并索取现金收据时，您必须开立现金收据。

韩国 Play 余额付款报告中包含以韩元进行的、完全或部分使用 Google Play 余额支付的交易。您可以使用此报告向用户发送现金收据。

注意：用户可以通过多种来源充值 Google Play 余额，包括使用 Google 或我们的合作伙伴提供的赠送金额。在开具现金收据之前，请务必确保用户使用现金等价物（例如礼品卡）充值了余额。

命令

gs://[developer_bucket_id]/play_balance_krw/play_balance_krw_YYYYMM.zip

示例

如果您的软件包名称为“com.example.app”，并且您想从 ID 为 pubsite_prod_rev_0123456789 的报告存储分区中下载该应用在 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

示例

如果您的软件包名称为“com.example.app”，并且您想从 ID 为 pubsite_prod_rev_0123456789 的报告存储分区中下载该应用在 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

示例

如果您的软件包名称为“com.example.app”，并且您想从 ID 为 pubsite_prod_rev_0123456789 的报告存储分区中下载该应用在 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

示例

如果您的软件包名称为“com.example.app”，并且您想从 ID 为 pubsite_prod_rev_0123456789 的报告存储分区中下载该应用在 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 月之前仍可使用旧导出功能）

命令

gs://[developer_bucket_id]/acquisition/retained_installers/retained_installers_[package_name]_yyyyMM_[dimension].csv

文件格式

字段 格式 可选 示例和备注
日期 YYYY-mm-dd 否

用户访问商品详情的日期

注意：将多日内访问商品详情的唯一身份用户数加总计算，将会导致访问商品详情的用户数大于您在每周或每月同类群组视图中看到的数据。每个访问者在每周和每月同类群组视图中只统计一次，即使访问者多次访问也是如此。
用户获取渠道 字符串 是

自然、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 商店（自然）”这个合计数据行，或者忽略“搜索”和“浏览”这两行。

从 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 拥有报告数据的软件包名称
国家/地区 字符串 否 英国 与用户注册的 Google 帐号相关联的国家或地区
流量来源 字符串 否 Google Play 搜索

用户发现商品详情的途径：

  • Google Play 搜索
  • 第三方引荐来源网址
  • Google Play 浏览

注意：如果此值未达到特定最低阈值，可为 Other
搜索字词 字符串 是 应用商店

用户在转到您的商品详情之前搜索过的字词。仅限用户通过 Google Play 搜索的字词。

注意：如果此值未达到特定最低阈值，可为 Other
UTM 来源 字符串 是 google

指向您商品详情的深层链接中所含的 utm_source 网址参数的值。仅限第三方引荐来源网址中的值

注意：如果此值未达到特定最低阈值，可为 Other
UTM 广告系列 字符串 是 广告系列

指向您商品详情的深层链接中所含的 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 广告系列、商品详情的用户获取量、访问商品详情的用户数、商品详情的转化率

 

转义方案

  • 将双引号加倍。(" -> "")
  • 如果某个单元格包含制表符、换行符、双引号或逗号，请用双引号将单元格括起来。(... -> "...")

示例

如果您的软件包名称为 com.example.app，并且您想从 ID 为 pubsite_prod_0123456789 的报告存储分区中下载该应用在 2020 年生成的所有报告，请使用以下命令：

gsutil cp -r gs://pubsite_prod_0123456789/stats/store_performance/store_performance_com.example.app_2020* /your/local/directory

买家人数（2021 年 8 月之前仍可获取安装应用后 7 天内的数据）

命令

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

文件格式

字段 格式 可选 示例和备注
日期 YYYY-mm-dd 否

用户访问商品详情的日期

注意：将多日内访问商品详情的唯一身份用户数加总计算，将会导致访问商品详情的用户数大于您在每周或每月同类群组视图中看到的数据。每个访问者在每周和每月同类群组视图中只统计一次，即使访问者多次访问也是如此。
用户获取渠道 字符串 是

自然、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 商店（自然）”这个合计数据行，或者忽略“搜索”和“浏览”这两行。

从 2019 年 6 月起，我们不再支持“Google 搜索（自然）”维度。

本页面可能包含使用 AI 技术翻译的内容。AI 翻译未必准确无误。

该内容对您有帮助吗？

您有什么改进建议？

需要更多帮助？

请尝试以下步骤：

与我们联系 向我们提供更多信息，以便我们帮您解决问题
true
搜索
清除搜索内容
关闭搜索框
主菜单
12762842430922995927
true
搜索支持中心
false
true
true
true
true
true
92637
false
false
false
false
false