Google Cloud Marketplace 产品报告

本页面介绍了如何设置和使用 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.comsystem.gserviceaccount.com 网域共享。

添加报告目标时,将以下帐号添加为编辑者或存储对象管理员(如适用):

  • cloud-marketplace-stats@system.gserviceaccount.com 服务帐号,该帐号将报告上传到存储分区。
  • gcp-marketplace-business-operations@google.com Google 小组,对报告可能遇到的问题进行调试和问题排查。

注意:如果要设置 Cloud Storage 存储分区,我们建议您针对存储分区使用访问权限控制列表 (ACL)。我们还建议您移除存储分区上可能存在的任何保留政策,因为保留政策可能会导致报告在保留期限结束之前无法更新。

如果使用统一存储分区级访问权限,请注意以下组织政策可能会干扰访问权限:

如需移除存储分区的这些组织政策,请让存储分区管理员为您的文件夹或项目请求将政策设置为 Google 默认处理方式。

设置报告的存储位置后,您必须设置报告的传送方式。要设置传送,请根据您是使用 Producer Portal 还是合作伙伴门户来管理产品,执行以下步骤:

Producer Portal

  1. 在 Producer Portal 中,打开“合作伙伴报告”页面。该页面的直接链接是:

    https://console.cloud.google.com/producer-portal/reports?project=YOUR_PUBLIC_PROJECT_ID
    

    您的公共项目 ID 是托管产品组件的项目的 ID。您在注册成为合作伙伴时创建此项目。

  2. 若要添加报告目标,请点击添加目标

  3. 目标位置下,选择要将报告发送到 Google 云端硬盘文件夹还是 Cloud Storage 存储分区。

  4. 单击浏览,然后选择一个文件夹或存储分区(如果适用)。

  5. 选择要在此目标位置保存的报告。您可以根据需要将各个报表发送到任意多个目标。

  6. 如果您希望在使用情况报告中提供额外的详细信息,请在使用情况报告选项下,选择以下一个或多个选项:

    • 按位置划分客户使用情况:按客户位置划分使用情况和支出报告。
    • 按结算帐号划分客户使用情况:按客户的 Cloud Billing 帐号划分使用情况和支出报告。

    如需了解有关报告中包含的内容的信息,请参阅使用和支出报告

  7. 如果要设置更多目的地,请重复这些步骤。

  8. (可选)添加一个或多个用于测试的 Cloud Billing 帐号。如需了解产品测试,请访问测试已发布的 Google Cloud Marketplace 产品

  9. 要保存更改,请点击保存。 您必须同意授予 Google Cloud Marketplace 帐号访问报告目标地的权限。

合作伙伴门户

  1. 在合作伙伴门户中,打开“合作伙伴报告”页面。该页面的直接链接是:

    https://console.cloud.google.com/partner/reports?project=YOUR_PUBLIC_PROJECT_ID
    

    您的公共项目 ID 是托管解决方案组件的项目的 ID。您在注册成为合作伙伴时创建此项目。

  2. 若要添加报告目标,请点击添加目标

  3. 目标位置下,选择要将报告发送到 Google 云端硬盘文件夹还是 Cloud Storage 存储分区。

  4. 单击浏览,然后选择一个文件夹或存储分区(如果适用)。

  5. 选择要在此目标位置保存的报告。您可以根据需要将各个报表发送到任意多个目标。

  6. 如果您希望在使用情况报告中提供额外的详细信息,请选择以下一个或多个选项:

    • 按位置划分客户使用情况:按客户位置划分使用情况和支出报告。
    • 按结算帐号划分客户使用情况:按客户的 Cloud Billing 帐号划分使用情况和支出报告。

    如需了解有关报告中包含的内容的信息,请参阅使用和支出报告

  7. 如果要设置更多目的地,请重复这些步骤。

  8. 要保存更改,请点击保存。 您必须同意授予 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 将支出与客户洞察报告中的客户信息相匹配。

  • 按位置:这会将位置列添加到报告中,其中包含客户位置的国家/地区代码。如果客户在美国或加拿大,则该列包括国家和州代码。

如果您需要将“扣款和使用情况”报告中的付款与客户名称相关联,则需要

  1. 启用 by account 报告。
  2. 配置接收客户数据分析报告
  3. 使用 Insights Account Id 列在客户数据分析报告中查找具有匹配的 external_account_id 列的行。

付款报告

第二种报告是 YYYYMMDD Disbursements 报告。此报告详细介绍了 Google 当月向您转帐的金额。它包含以下内容:

  • 实体:签发付款的 Google 公司实体的名称,或特殊实体 Abandoned PayoutReleased 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

“带来潜在客户”报告

对于虚拟机产品,您可以获得包含客户信息(例如电子邮件地址和电话号码)的“带来潜在客户”报告。您可以选择每天、每周、每两周或每月接收此报告。

如果您想收集此信息,请联系您的合作伙伴工程师,请求其在报告中加入以下信息:

  • 对于每个产品,提供您希望在报告中显示的字段。

  • 用于管理如何使用您收集的字段的隐私权政策网址。建议您明确说明信息的用途,让客户能够放心分享他们的信息。

  • 您希望生成报告的频率。

字段和隐私权政策用于创建同意书。当客户第一次开始部署虚拟机解决方案时,他们会看到您要收集的信息以及您的隐私权政策。查看信息后,客户有权同意或拒绝与您共享其信息。

报告的第一行包含选择不共享其信息的客户数量,以及报告涵盖的开始和结束时间。报告中的所有客户答复数据都是两个时间之间的数据。 时间基于 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。