客户洞见报告

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

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

报告频率

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

客户增量数据分析报告

（可选）您可以启用客户增量数据分析报告，以便在您配置的目标位置获取更详细的客户数据分析报告。客户增量数据分析报告包含与客户数据分析报告相同的所有信息，以及之前报告中未包含的任何过往日期使用情况数据。如果您向 Google 报告使用情况的时间较晚，或者 Google 的内部结算流程存在问题导致报告延迟，您可能会遇到此问题。

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

启用客户增量数据分析报告

如需在 CSV 导出中启用客户增量分析报告，请完成以下步骤：

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

2. 在配置报告下，选择您要为其启用“客户增量洞见”报告的报告目标平台。

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

了解客户增量洞见报告

以下示例展示了在您启用客户增量数据分析报告后，Cloud Marketplace 如何处理您迟报的使用情况：

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

2. 2023 年 1 月 3 日，Cloud Marketplace 生成一份“客户增量分析”报告，其中包含 2023 年 1 月 1 日的所有已知数据。由于您未向 Google 报告 1 月 1 日之前的用量，因此 Cloud Marketplace 不会将该用量纳入此报告中。

3. 2023 年 1 月 10 日，您报告了之前未报告的 2023 年 1 月 1 日的用量。

在此示例中，CSV Export 中的名为 2023-01-09 Incremental Daily Insights 的报告或 BigQuery 表 marketplace_report.incremental_insights（其中 _PARTITIONDATE 为 2023-01-09）具有一个标记为 date 的列。其中一行 date 的值为 2023-01-01，其余行的 date 值为 2023-01-09。您还会看到一个标记为 report_date 的新列，该列在所有行中的值均为 2023-01-09，表示此报告适用于 2023 年 1 月 9 日。

如果您想跟踪客户在特定日期或月份对您产品的所有使用情况，可能需要将多个“客户增量分析”报告中相应日期或月份的行合并起来。

报告字段

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

字段	说明
report_date（仅适用于客户增量洞见报告）	生成报告所针对的主要日期/月份（美国和加拿大太平洋时间）（报告是在此日期后几天生成的）。启用“客户增量数据分析报告”后，您会看到此字段。每份报告中此字段只有一个值，该值可能与使用情况发生的日期不同。如果您已将报告导入数据库，则可以使用此方法查找特定报告的所有行。
date	用量发生的日期/月份，以美国和加拿大太平洋时间为单位。如果您已启用客户增量分析报告，则此日期可能与 report_date 一致，或者如果用量报告延迟，则此日期可能会更早。
company	客户的公司名称。如果客户使用个人账号，则公司名称不在报告之列。
domain	通过 Google 的 CRM 系统与账号相关联的一组域名中按字母顺序排在最前面的域名。如果客户使用的是个人账号，则网域不在报告之列。
external_account_id	数据洞察账号 ID，针对与客户项目关联的 Cloud Billing 账号生成。所有客户（包括个人账号客户）都有此字段。您可以使用它来跟踪客户在一段时间内的收入、从免费到付费的转化以及客户流失情况。
account_id	与客户关联的 Cloud Billing 账号。如果客户使用的是个人账号，则账号 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	您收到的使用费金额。计算方式为 `(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	如果 Google Cloud 客户的 Cloud Billing 账号因缺少付款而处于观察期，则 Google 会预扣支出，直到该账号信誉恢复良好。此列显示如果我们向客户收取了费用，我们应该向您支付多少费用。当结算账号信誉恢复良好时，我们会在下次向您付款时释放预扣资金。如果结算账号的信誉未恢复良好，我们便会放弃预扣资金。
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 作为卖家的代理）。