客户洞见报告

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

客户在设置 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 报告您之前的使用情况，因此 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 Insights 帐号 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 +preload_credits + postpay_credits) * 收益分成`。我们添加 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 将充当卖方的代理）。