本页面介绍了如何设置和使用 Google Cloud Marketplace 产品的报告。
根据您在 Google Cloud Marketplace 上提供的产品类型，您会收到以下报告：
- 使用情况和支出报告：包含软件使用情况以及应支付给您的金额的详细信息。
- 客户洞察报告：包含有关您的客户是谁以及他们如何使用您的软件的信息，例如客户部署了您产品的虚拟机 (VM) 数量。
- “带来潜在客户”报告（用于虚拟机产品）：包含同意与您共享此信息的客户的联系信息。
- SKU 迁移报告：如果我们将您的产品 SKU 迁移到其他 Cloud Billing 服务或结构，此报告会告知您迁移过程，以便您调整报告提取操作。
您的报告将发送到 Google 云端硬盘文件夹或 Cloud Storage 存储分区，或同时发送到这两者。有关设置报告目标的步骤，请参阅设置报告。
如需了解如何向您的客户收取费用以及设置付款，请参阅接收 Google 的付款。
设置报告
要接收 Google Cloud Marketplace 报告，请设置 Google 云端硬盘文件夹和/或 Cloud Storage 存储分区。您必须是所选目的地的所有者。例如，如果您使用云端硬盘文件夹，则您的 Google Cloud 帐号必须具有可以组织、添加和编辑该文件夹的权限。
您的报告可以存储在共享的 Google 云端硬盘位置和/或 Cloud Storage 存储分区中。当您设置目标位置时，您的 Google Workspace 或 Cloud Storage 管理员必须确保目标位置可以与 google.com 和 system.gserviceaccount.com 网域共享。
添加报告目标时，将以下帐号添加为编辑者或存储对象管理员（如适用）：
cloud-marketplace-stats@system.gserviceaccount.com服务帐号，该帐号将报告上传到存储分区。gcp-marketplace-business-operations@google.comGoogle 小组，对报告可能遇到的问题进行调试和问题排查。
注意：如果要设置 Cloud Storage 存储分区，我们建议您针对存储分区使用访问权限控制列表 (ACL)。我们还建议您移除对存储分区可能具有的任何保留政策，因为保留政策可能会阻止在保留期限结束之前更新报告。
如果使用统一存储分区级访问权限，请注意以下组织政策可能会干扰访问权限：
如需移除存储分区的这些组织政策，请让存储分区管理员为您的文件夹或项目请求将政策设置为 Google 默认处理方式。
设置报告的存储位置后，您必须设置报告的传送方式。要设置传送，请根据您是使用 Producer Portal 还是合作伙伴门户来管理产品，执行以下步骤：
Producer Portal
在 Producer Portal 中，打开“合作伙伴报告”页面。该页面的直接链接是：
https://console.cloud.google.com/producer-portal/reports?project=YOUR_PUBLIC_PROJECT_ID您的公共项目 ID 是托管产品组件的项目的 ID。您在注册成为合作伙伴时创建此项目。
若要添加报告目标，请点击添加目标。
在目标位置下，选择要将报告发送到 Google 云端硬盘文件夹还是 Cloud Storage 存储分区。
单击浏览，然后选择一个文件夹或存储分区（如果适用）。
选择要在此目标位置保存的报告。您可以根据需要将各个报表发送到任意多个目标。
如果您希望在使用情况报告中提供额外的详细信息，请在使用情况报告选项下，选择以下一个或多个选项：
- 按位置划分客户使用情况：按客户位置划分使用情况和支出报告。
- 按结算帐号划分客户使用情况：按客户的 Cloud Billing 帐号划分使用情况和支出报告。
如需了解有关报告中包含的内容的信息，请参阅使用和支出报告。
如果要设置更多目的地，请重复这些步骤。
（可选）添加一个或多个用于测试的 Cloud Billing 帐号。如需了解产品测试，请访问测试已发布的 Google Cloud Marketplace 产品。
要保存更改，请点击保存。 您必须同意授予 Google Cloud Marketplace 帐号访问报告目标地的权限。
合作伙伴门户
在合作伙伴门户中，打开“合作伙伴报告”页面。该页面的直接链接是：
https://console.cloud.google.com/partner/reports?project=YOUR_PUBLIC_PROJECT_ID您的公共项目 ID 是托管解决方案组件的项目的 ID。您在注册成为合作伙伴时创建此项目。
若要添加报告目标，请点击添加目标。
在目标位置下，选择要将报告发送到 Google 云端硬盘文件夹还是 Cloud Storage 存储分区。
单击浏览，然后选择一个文件夹或存储分区（如果适用）。
选择要在此目标位置保存的报告。您可以根据需要将各个报表发送到任意多个目标。
如果您希望在使用情况报告中提供额外的详细信息，请选择以下一个或多个选项：
- 按位置划分客户使用情况：按客户位置划分使用情况和支出报告。
- 按结算帐号划分客户使用情况：按客户的 Cloud Billing 帐号划分使用情况和支出报告。
如需了解有关报告中包含的内容的信息，请参阅使用和支出报告。
如果要设置更多目的地，请重复这些步骤。
要保存更改，请点击保存。 您必须同意授予 Google Cloud Marketplace 帐号访问报告目标地的权限。
使用情况和支出报告
到每个月的第十个工作日，系统会在您设置的目标位置生成两个报告，其中包含上个月的使用情况和收入详情。这两个报告的名称以一个月的第一天开头 (YYYYMMDD)，例如 20210401 表示报告针对的是 2021 年 4 月的使用量。
费用和用量报告
YYYYMMDD Charges and Usage 报告包含以下内容。如有该报告的任何疑问，请与合作伙伴工程师联系。
SKU：Google Cloud Marketplace 产品的说明。
Google 实体：收到客户付款的 Google 公司。由此公司向您付款。
资源：运行产品的资源。显示的资源取决于您的价格模式。
用量：产品部署所使用的资源数量。
单位：“用量”列的计量单位，例如小时、核心小时或吉比字节 (GiB) 小时，具体取决于您的价格模式。
货币：以下三列的计量货币。
费用：客户使用您的产品的费用。 从 2021 年 4 月的报告开始，如果您使用非美元货币付费，此字段将使用您的付款币种。
试用：产品试用赠金所涵盖的费用。 从 2021 年 4 月的报告开始，如果您使用非美元货币付费，则此字段使用您的付款货币。
到期合作伙伴：应计付款，以
(Charges - Trial Use) * revenue share计算。付款方式：您接收付款的方式：如果付款方式为
old，则您的美国银行帐号会收到来自 Google 美国或地区 Google 实体的付款。如果付款方式为new，则您的本地银行帐号会收到一笔一次性付清费用。预扣：如果 Google Cloud 客户的结算帐号因缺少付款而处于暂停状态，则 Google 会预扣支出，直到该帐号信誉恢复良好。
此列显示如果我们向客户收取了费用，我们应该向您支付多少费用。
当结算帐号信誉恢复良好时，我们会在下次向您付款时释放预扣资金。如果它的信誉未恢复良好，我们便会放弃预扣资金。
已释放：如果 Google 已预扣资金，则此列显示因客户结算帐号的信誉恢复良好而向您发放的资金总额。
已放弃：如果 Google 已预扣资金，则此列显示由于我们终止了结算帐号而放弃的资金总额。
试用开始日期：Google 开始预扣资金的第一天，格式为
YYYY-MM-DD。如果我们要释放或放弃资金，则可能是上个月的日期。如果帐号仍处于试用期，则这是我们预扣资金的当月第一天（可能不是我们预扣资金的第一天）。试用结束日期：Google 预扣资金的最后一天，格式为
YYYY-MM-DD。此日期之后的第二天，帐号恢复了良好的信誉，或者我们关闭了帐号。如果此字段为空，则帐号仍在试用期。退款开始：Google 针对客户用量进行退款的第一天，格式为 YYYY-MM-DD。
退款结束：Google 针对客户用量进行退款的最后一天，格式为 YYYY-MM-DD。
退还本月扣除的余额：Google 在当月扣除的与客户退款相关的付款金额。
退还未结余额：如果与客户的退款相关的补偿大于当月的付款，剩余补偿由未来付款决定。
退款原因：客户收到退款的原因。
默认情况下，该报告按 SKU、Google 实体和资源细分。设置报告时，您可以选择以下其他细分：
按帐号：这会将帐号 ID 和数据洞察帐号 ID 列添加到显示客户结算 ID 的报告中。您可以使用此 ID 跟踪诸如客户转化或试用转化之类的指标。帐号 ID 不是客户的 Google Cloud 结算 ID，而是特定于客户的结算帐号。由于历史原因，报告中有两种形式的模糊帐号 ID，这两种报告使用不同的算法来模糊实际帐号 ID。使用数据洞见帐号 ID 将支出与客户洞察报告中的客户信息相匹配。
按位置：这会将位置列添加到报告中，其中包含客户位置的国家/地区代码。如果客户在美国或加拿大，则该列包括国家和州代码。
如果您需要将“扣款和使用情况”报告中的付款与客户名称相关联，则需要
- 启用
by account报告。 - 配置接收客户数据分析报告
- 使用
Insights Account Id列在客户数据分析报告中查找具有匹配的external_account_id列的行。
付款报告
第二种报告是 YYYYMMDD Disbursements 报告。此报告详细介绍了 Google 当月向您转帐的金额。它包含以下内容：
实体：签发付款的 Google 公司实体的名称，或特殊实体
Abandoned Payout或Released Payout：Released Payout- 表示 Google 已扣减款项，因为客户有过付款，现已收到款项并支付给您。
Abandoned Payout- 表示 Google 由于客户已逾期欠款而未支付的款项，因为 Google 已判定无法收款。
货币：支付款项的货币。
金额：调整前的付款总金额。
客户退款：因已将退款退还给客户的产品而进行的任何调整。
总计：调整后的最终金额。
备注：调整原因。
付款方式：您用来收款的方式。如果该值为
old，则您的美国银行帐号会收到来自 Google 美国或地区 Google 实体的一项或多项付款。如果该值为new，则您的本地银行帐号会收到一笔一次性付清费用。
客户洞察报告
您还会获得客户洞察的每日报告和每月报告，其中包含有关您的客户是谁以及他们如何使用您的软件的信息。基于美国太平洋时间 (PT)，每日报告的生成时间有两天的延迟。例如，6 月 1 日的报告在 6 月 3 日生成。每月报告在次月的第二个日历日生成。
客户在设置 Cloud Billing 帐号时，可以选择是企业帐号还是个人帐号。对于客户识别为个人帐号的帐号，我们会从客户数据分析报告中排除身份信息。您将在这些帐号的这些标识列中看到 n/a。
销售报告包含以下信息，从 2018 年 7 月 13 日开始：
| 字段 | 说明 |
|---|---|
date |
使用情况报告的日期。 |
company |
客户的公司名称。如果客户使用个人帐号，则公司名称不在报告之列。 |
domain |
组织的结算管理员的电子邮件网域。如果有多个管理员与结算帐号关联，则报告中的网域是大多数管理员使用的网域。如果客户使用的是个人帐号，则网域不在报告之列。 |
external_account_id |
数据洞察帐号 ID，针对与客户项目关联的结算帐号生成。 |
account_id |
与客户关联的结算帐号。 |
country |
客户所在的国家/地区。 |
state_or_province |
客户所在的州或省（如果适用）。 |
postal_code |
客户的邮政编码（如果适用）。如果客户使用个人帐号，则邮政编码不在报告之列。 |
sku_id |
客户需付费的 SKU。根据产品的配置方式，单个部署可能具有多个 SKU ID。例如，一个 SKU 可能会涵盖在部署中使用 CPU 的费用，而另一个 SKU ID 可能会涵盖使用 RAM 的费用。 |
sku_description |
SKU 的说明。例如，如果客户部署了按 CPU 核心数量收费的 WordPress 产品，则 SKU 说明类似于“一键部署 Wordpress 的许可费用（CPU 费用）”。 |
usage |
客户使用的资源数量。 |
unit |
用量的衡量指标，例如小时或吉比字节 (GiB) 小时。 |
currency |
支付的货币。 |
charges |
客户在此期间支付的费用。 |
due_vendor |
您收到的使用费金额。 |
trial_use |
客户消费的试用赠金（如果适用）。 |
num_vms |
客户已部署产品的虚拟机的数量。 |
num_cpus |
客户部署中的 vCPU 核心数量。如果数量是分数，则表示客户选择了共享 vCPU。 |
ram_mb |
客户部署中的 RAM 大小。 |
num_gpus |
客户部署中的 GPU 数量。 |
gpu_types |
客户部署中以空格分隔的 GPU 类型列表。例如，值 NVIDIA_TESLA_P4 none NVIDIA_TESLA_P100 表示至少一个虚拟机使用 NVIDIA®P4，至少一个虚拟机使用 P100 GPU，至少一个虚拟机没有 GPU。如需了解 Compute Engine 上可用的 GPU 的列表，请参阅 Compute Engine 上的 GPU。 |
earliest |
客户在报告期内创建虚拟机的最早日期（UTC）。 |
latest |
客户在报告期内创建的虚拟机的最新日期（UTC）。 |
machine_spec_sum |
每个 [机器类型]（/compute/docs/machine types）的新计数和总计数的空格分隔列表。例如，值 F1_MICRO:0/1 G1_SMALL:2/3 表示在当前期间使用了 1 个f1-micro 虚拟机 和 3 个 g1-small 虚拟机，其中 0 个 f1-micro 虚拟机和 2 个 g1-small 虚拟机是新的。 |
quote_id |
如果您从非公开优惠获得了收入，则为与优惠的产品和结算帐号关联的报价 ID。 |
quote_creator |
如果您从非公开优惠获得了收入，则为非公开优惠创建者的电子邮件地址。 |
internal_note |
如果您从非公开优惠获得了收入，则为该优惠的可选内部备注。您可以使用内部备注来标记优惠以进行更多处理，例如跟踪它们产生的收入和/或使用情况数据。您需要在创建优惠时指定内部备注。 |
payment_type |
您接收付款的方式：如果为 old，则您的美国银行帐号会收到来自 Google 美国或地区 Google 实体的付款。如果付款方式为 new，则您的本地银行帐号会收到一笔一次性付清费用。 |
withheld |
如果 Google Cloud 客户的结算帐号因缺少付款而处于暂停状态，则 Google 会预扣支出，直到该帐号信誉恢复良好。此列显示如果我们向客户收取了费用，我们应该向您支付多少费用。当结算帐号信誉恢复良好时，我们会在下次向您付款时释放预扣资金。如果它的信誉未恢复良好，我们便会放弃预扣资金。 |
released |
如果 Google 已预扣资金，则此列显示因客户结算帐号的信誉恢复良好而向您发放的资金总额。 |
abandoned |
如果 Google 已预扣资金，则此列显示由于我们终止了结算帐号而放弃的资金总额。 |
probation_start |
Google 开始预扣资金的第一天，格式为 YYYY-MM-DD。如果我们要释放或放弃资金，则可能是上个月的日期。如果帐号仍处于试用期，则这是我们预扣资金的当月第一天，但可能不是我们开始预扣资金的第一天。 |
probation_end |
Google 预扣资金的最后一天，格式为 YYYY-MM-DD。此日期之后的第二天，帐号恢复了良好的信誉，或者我们关闭了帐号。如果此字段为空，则帐号仍在试用期。 |
start_date |
许可生效的第一天，采用 YYYY-MM-DD 格式。日期取决于权益的相关订阅或非公开优惠。如果许可是在 2021 年 1 月 10 日之前创建的，则值为 NULL。 |
end_date |
许可处于有效状态的最后一天，采用 YYYY-MM-DD 格式。日期取决于权益的相关订阅或非公开优惠。如果许可是在 2021 年 1 月 10 日之前创建的，则值为 NULL。 |
有关预付款优惠的其他信息
如果您创建了使用预付款付款时间安排的非公开优惠，则可能会看到以下额外信息：
| 字段 | 说明 |
|---|---|
payment_mode |
优惠的付款时间安排类型。值可以为 PREPAY、PREPAY_INSTALLMENTS 或 POSTPAY。 |
private_offer_acceptance_date |
客户接受非公开优惠的日期。 |
private_offer_total_contract_value |
客户对非公开优惠的所有分期付款所支付的总金额。 |
order_start_date |
非公开优惠的定价生效的日期。 |
order_end_date |
非公开优惠定价已失效的日期。 |
“带来潜在客户”报告
对于虚拟机产品，您可以获取潜在客户生成报告，其中包含每天上传的客户信息，例如电子邮件地址和电话号码。
如果您想收集此信息，请联系您的合作伙伴工程师，请求其在报告中加入以下信息：
对于每个产品，提供您希望在报告中显示的字段。
用于管理如何使用您收集的字段的隐私权政策网址。建议您明确说明信息的用途，让客户能够放心分享他们的信息。
字段和隐私权政策用于创建同意书。当客户第一次开始部署虚拟机解决方案时，他们会看到您要收集的信息以及您的隐私权政策。查看信息后，客户有权同意或拒绝与您共享其信息。
报告的第一行包含选择不共享其信息的客户数量，以及报告涵盖的开始和结束时间。报告中的所有客户答复数据都是两个时间之间的数据。
时间基于 UTC 时区，并且采用 ISO 格式 YYYY-MM-DDTHH:MM:SS+00:00。例如，2019 年 3 月 14 日午夜 UTC 显示为 2019-03-14T00:00:00+00:00。
对于选择共享其信息的客户，报告包含以下信息：
| 字段 | 说明 |
|---|---|
| 名称 | 客户姓名。 |
| 电子邮件 | 客户的电子邮件地址。 |
| 公司 | 客户的公司名称。如果客户未与公司关联，则该值为“_none_”。 |
| 国家/地区代码 | 客户所在国家/地区的双字母国家/地区代码。例如，法国的双字母代码是 FR。 |
| 地址 | 客户的地址。 |
| 电话 | 客户的电话号码。 |
SKU 迁移报告
有时，我们可能会改变与您的产品相关的 SKU 的结构方式，或 Cloud Billing 中的产品显示位置。发生这种情况时，我们会在客户数据洞察报告所在的位置创建一个 sku-migration-report.csv 文件。每个 SKU 都在服务中，该服务具有格式为 0123-4567-89AB 的十六进制 ID（由 3 部分组成）。此外，每个 SKU 都有自己的十六进制 ID（由 3 部分组成），该 ID 与服务 ID 无关，并且在所有服务中是独一无二的。您可以在客户洞察报告的 sku_id 列中查看 SKU ID。
SKU 迁移报告每天更新。如果您对 Cloud Storage 存储分区应用了保留政策，则更新会延迟到保留期限结束为止。该报告包含以下信息：
| 字段 | 说明 |
|---|---|
source_sku_id |
旧 SKU 的 ID。 |
target_sku_id |
已替换原始 SKU 的 SKU 的 ID。如果此字段为空，则原始 SKU 没有替换 SKU。 |
target_service_id |
在其中定义替换 SKU 的服务 ID。如果此字段为空，则原始 SKU 没有替换 SKU。 |
seller |
您的公司名称。 |
product |
SKU 关联的产品的名称。 |
source_sku_name |
源 SKU 的可读名称（不是它在客户帐单上的显示名）。 |
target_sku_name |
替换了原始 SKU 的 SKU 的可读名称。如果此字段为空，则原始 SKU 没有替换 SKU。 |