客户洞见报告

我们会提供客户洞察的每日报告和每月报告 __，其中包含 有关您的客户是谁以及他们如何使用您的软件的信息。如需访问客户洞察报告，请访问您在设置接收报告时指定的 目标位置或 BigQuery 数据集。

客户在设置 Cloud Billing 帐号时，可以选择是企业账号还是个人账号。对于客户识别为个人账号的账号，我们会从客户洞察报告中排除身份信息。对于这些账号，您会在相应列中看到 n/a。

报告生成频率

基于美国太平洋时间 (PT)，每日报告的生成时间有 1 天的延迟。 例如，2026 年 6 月 1 日的报告会在 2026 年 6 月 2 日生成。每月报告会在次月的第一个日历日生成。

客户增量洞察报告

您可以选择开启客户增量洞察报告，以便在您配置的目标位置获取更详细的客户洞察报告。客户增量洞察报告包含与客户洞察报告相同的所有信息，以及之前报告中未包含的任何过往使用情况。如果您延迟向 Google 报告使用情况，或者 Google 的内部结算流程存在问题导致报告延迟，则可能会遇到这种情况。

我们强烈建议您开启客户增量洞察报告，因为与非增量客户洞察报告相比，此类报告能更准确地反映客户的使用情况，并有助于您将报告的使用情况与月度支出报告进行对账。

开启客户增量洞察报告

如果您已启用 BigQuery 导出功能，则表示您已开启客户增量洞察报告，无需执行任何其他操作。

如需在 CSV 导出中开启客户增量洞察报告，请完成以下步骤：

  1. 在 Producer Portal 中，访问 “报告”页面。

  2. 在配置报告下，选择您要为其开启客户增量洞察报告的报告目标位置。

  3. 在要导出的报告下，选中客户增量洞察 复选框。

了解客户增量洞察报告

以下示例展示了在您开启客户增量洞察报告后，Cloud Marketplace 如何处理您延迟报告的使用情况：

  1. 2026 年 6 月 1 日，您的客户使用了您的产品，但您未报告其全部或部分使用情况。

  2. 2026 年 6 月 2 日，Cloud Marketplace 生成了一份客户增量洞察报告，其中包含 2026 年 6 月 1 日的所有已知数据。由于您未向 Google 报告 6 月 1 日的过往使用情况，因此 Cloud Marketplace 未将该使用情况纳入此报告。

  3. 2026 年 6 月 10 日，您报告了之前未报告的 2026 年 6 月 1 日的使用情况。

在此示例中，CSV 导出中的报告（名为 2026-06-09 Incremental Daily Insights）或 BigQuery 表（名为marketplace_report.incremental_insights，且 _PARTITIONDATE 为 2026-06-09）包含一个名为 date 的列。其中一行 date 的值为 2026-06-01，其余行的 date 值均为 2026-06-09。您还会看到一个名为 report_date 的新列，其中所有行的值均为 2026-06-09，表示此报告适用于 2026 年 6 月 9 日。根据您使用报告数据的方式，您可能需要更新集成，以考虑新的 report_date 字段。

如需跟踪客户在特定日期或月份的所有产品使用情况，您可能需要合并多个客户增量洞察报告中该日期或月份的行。

对于增量月度洞察报告（例如 2025 年 6 月的使用情况数据），命名惯例因导出类型而异。在 CSV 导出中，文件名为 2025-06-01 Incremental Monthly Insights。在 BigQuery 导出中，数据位于表 marketplace_report.incremental_monthly_insights 中，且 _PARTITIONDATE 为 2025-07-01。

报告字段

销售报告包含以下信息，从 2018 年 7 月 13 日开始：

字段 说明
report_date（仅适用于客户增量洞察报告） 生成报告的主要日期/月份，以美国和加拿大太平洋时间为准（报告是在此日期后几天生成的）。您会在开启客户增量洞察报告后看到此字段。每个报告在此字段中只有一个值，该值可能与使用情况发生的日期不同。如果您已将报告导入数据库，则可以使用此字段查找特定报告的所有行。
date 使用情况发生的日期/月份，以美国和加拿大太平洋时间为准。如果您已开启客户增量洞察报告，则此日期可能与 report_date 匹配，或者如果延迟报告使用情况，则此日期可能会更早。
company 客户的公司名称。对于涉及供应商转售 Cloud Marketplace 产品的交易，这是向客户转售 产品的供应商的名称。如果客户使用个人账号， 则公司名称不在报告之列。
domain Google CRM 系统中此账号的 website 字段的值。对于涉及供应商转售 Cloud Marketplace 产品的交易，这是与转售供应商的账号相关联的网域。如果 客户使用个人账号，我们会从 报告中排除网域。
external_account_id 数据洞察账号 ID，针对与客户项目关联的 Cloud Billing 帐号 生成。所有客户（包括使用个人账号的客户）都会显示此字段。您可以使用此字段跟踪客户的收入 随时间的变化、免费用户到付费用户的转化情况以及客户流失情况。
account_id 与客户关联的 Cloud Billing 帐号。如果客户使用个人账号，则账号 ID 不在报告之列。
country 客户所在的国家/地区。
state_or_province 客户所在的州或省（如果适用）。
city 客户所在的城市（如果适用）。
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 您收到的使用费金额。计算方式为 `(charges - trial_use + prepay_credits + postpay_credits) * revenue share`。我们添加了 prepay_credits 和 postpay_credits，因为它们的值（如果存在）为负数。我们减去了 trial_use，因为它的值（如果存在）为正数。
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 如果您从非公开优惠获得了收入，则为该优惠的可选内部备注。您可以使用内部备注来标记优惠以进行更多处理，例如跟踪它们产生的收入和/或使用情况数据。您需要在创建优惠时指定内部备注。
usage_metric_discount_percent 如果使用情况与包含此 SKU 的指标折扣的非公开优惠相关，则这是可应用的折扣百分比，具体取决于优惠的定价模式。此折扣可以适用于 所有使用情况，也可以仅适用于被视为超额的使用情况，具体取决于 优惠的条款。如果关联的优惠中没有此 SKU 的指标级折扣，则值为 NULL。
payment_type 您接收付款的方式：如果为 old，则您的美国银行账户会收到来自 Google 美国或地区 Google 实体的付款。如果付款方式为 new，则您的本地银行 账号会收到一笔一次性付清费用。
withheld 如果客户的 Cloud Billing 帐号因缺少付款而处于试用期，则 Google 会预扣支出，直到该账号信誉恢复良好。 Google Cloud 此列显示如果我们向客户收取了费用，我们应该向您支付多少费用。 当 结算账号信誉恢复良好时，我们会在下次向您付款时释放预扣资金。如果它的信誉未恢复良好，我们便会放弃 预扣资金。
released 如果 Google 已预扣资金，则此列显示因客户结算账号 的信誉恢复良好而向您发放的资金总额。
abandoned 如果 Google 已预扣资金，则此列显示由于我们终止了结算账号而放弃的 资金总额。
probation_start Google 开始预扣资金的第一天， 格式为 YYYY-MM-DD，以美国和加拿大太平洋时间为准。如果我们释放或放弃资金，则此日期可能位于较早的月份。如果账号仍处于试用期，则这是我们预扣资金的当月第一天，但我们可能在此之前就开始预扣资金。
probation_end Google 预扣资金的最后一天，格式为 YYYY-MM-DD ，以美国和加拿大太平洋时间为准。此日期之后的第二天，账号要么 恢复了良好的信誉，要么我们关闭了账号。如果此字段为空，则账号 仍在试用期。
start_date 许可生效的第一天，格式为 YYYY-MM-DD ，以美国和加拿大太平洋时间为准。日期取决于权益的相关订阅或非公开优惠。如果 许可是在 2021-01-10 之前创建的，则值为 NULL。
end_date 许可处于有效状态的最后一天，格式为 YYYY-MM-DD ，以美国和加拿大太平洋时间为准。日期取决于权益的相关订阅或非公开优惠。如果 许可是在 2021-01-10 之前创建的，则值为 NULL。
solution_name 客户需付费的产品的名称。
postpay_credits 通过后付费承诺购买的 承诺使用赠金 所涵盖的 charges 金额。如果存在，则为负数 会减少 due_vendor 金额，因为它会减少用于计算向您支付的金额 。
marketplace_fee_percent Cloud Marketplace 根据您与 Google 达成的 收益分成协议保留的费用百分比。
marketplace_fee_amount Cloud Marketplace 根据您与 Google 达成的 收益分成协议保留的费用金额。

有关非公开优惠的其他信息

如果您为特定客户创建了 非公开优惠，则可能会看到以下其他信息：

字段 说明
payment_schedule 优惠的付款时间表类型。此字段的值可以是 PREPAY、PREPAY_INSTALLMENTS 或 POSTPAY。

注意：对于在创建时使用 结算频率（每月、每季度、每年或自定义）而非 付款时间表的非公开优惠，此字段为空。对于这些 优惠，我们建议您改用 billing_frequency 列 。
private_offer_acceptance_date 客户接受非公开优惠的日期。
private_offer_total_contract_value 客户在 非公开优惠的所有分期付款中支付的总金额。
term_total_contract_value 客户在优惠当前期限的所有分期付款中支付的总金额。
order_start_date 非公开优惠价格生效的日期。
order_end_date 非公开优惠价格不再生效的日期。
billing_frequency 描述创建优惠 时选择的定期结算间隔。此字段的值可以是 monthly、quarterly、 yearly、pay_go 或 custom。

注意： 对于在创建时使用支付时间安排（预付款或后付费） 而非 结算频率（每月、每季度、每年或自定义）的非公开优惠，此字段的值为 prepay 或 postpay 。
installment_count 优惠当前期限内的分期付款次数。
first_installment_date 优惠当前期限内第一笔分期付款的开始日期，格式为 YYYY-MM-DD。
final_installment_date 优惠当前期限内最后一笔分期付款的结束日期，格式为 YYYY-MM-DD。
prepay_credits 通过预付款承诺购买的 承诺使用赠金 所涵盖的charges 金额。如果存在，则为负数 会减少 due_vendor 金额，因为它会减少用于计算向您支付的金额 。
offer_title 您在创建优惠时在非公开优惠的 Offer Title 字段中输入的文本。此字段对您的客户可见。 如果客户使用同一 Cloud Billing 帐号为同一 产品购买了多个非公开优惠，您可以使用此字段 在优惠表和报告中区分这些优惠。对于 在此字段可用之前创建的非公开优惠，此 字段已回填优惠的产品名称。
entitlement_id 与客户购买交易相关的优惠许可 ID。如果 客户使用 同一 Cloud Billing 帐号为同一产品购买了多个非公开优惠，您可以使用此字段在 优惠表和报告中区分这些优惠。

有关转售产品的其他信息

如果您已为 Cloud Marketplace 产品 启用转售功能， 则可能会看到以下其他信息：

字段 说明
channel 指示使用情况是针对直接从独立软件供应商 (ISV) 处购买的产品，还是通过转售 ISV 产品的其他公司购买的产品。
reseller_discount ISV 配置的 转销商折扣 金额。
parent_account_id 与此使用情况的转销商关联的结算账号。
wholesale_charges 对于转售的非公开优惠（channel 字段的值为 RESOLD），此字段显示的值为： charges - reseller_discount。
对于直接向最终客户提供的非公开优惠（channel 字段的值为 DIRECT），此字段的值为 NULL。

有关代理机构交易模式的其他信息

字段 说明
transaction_type 描述交易的买方、卖方和 Google 之间的关系。此字段的值可以是 THIRD_PARTY_RESELLER（Google 直接销售 ISV 的产品）或 THIRD_PARTY_AGENCY（Google 充当卖方的代理）。