本页面介绍了如何设置和使用 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.com
Google 小组,对报告可能遇到的问题进行调试和问题排查。
注意:如果要设置 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。 |