客户洞见报告

我们会提供每日和每月的客户洞察报告，其中包含有关您的客户是谁以及他们如何使用您的软件的信息。

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

报告频率

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

客户增量数据分析报告

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

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

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

如需启用“客户增量数据分析”报告，请完成以下步骤：

  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 日的使用情况。

在此示例中，名为 2023-01-09 Incremental Daily Insights 的报告包含一个标签为 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 充当卖方的代理）。