计量限制和常见问题
什么是 Metering(用通俗的话解释)?
当客户在 Microsoft Marketplace 上购买 SaaS 产品时,他们通常会支付固定的月费。但有些产品还会根据实际使用量收费——例如发送的电子邮件数量、发出的 API 调用次数或处理的数据 GB 数量。这称为按量计费(metered billing)。
其工作方式很简单:您的平台(ISV 的软件)会跟踪客户的使用量,当使用量超过包含的额度时,它会向 Microsoft 发送一份报告,说明“该客户使用了 Y 项中的 X 个单位”。然后 Microsoft 会针对这些额外使用量向客户收费。
该报告通过 Metering Service API 发送。而该 API 对您何时以及如何发送这些报告有明确规定。
您需要了解的一条规则
关于 metering API,几乎所有内容都归结为一条规则:
📌 黄金规则 对于每个客户订阅、每个计费指标、每个日历小时,您只能发送 ONE 条使用量报告。如果您尝试在同一小时内为相同组合发送第二条报告,它会因重复而被拒绝。 |
|---|
就是这样。其他所有情况都只是这一规则的变体。
“每个订阅 + 每个指标 + 每小时”到底是什么意思?
订阅(Subscription)= 一个客户的订单。每个订单都有唯一 ID。
指标(Metric,也称 dimension)= 您收费的项目(例如 emails_sent、api_calls、storage_gb)。每个产品可以有多个指标。
日历小时(Calendar hour)= 例如 08:00–08:59 算作一个小时。09:00 会开始一个新的时间段。
因此,这条规则适用于这三者的特定组合。只要其中任意一个发生变化,它就是一个完全独立的时间槽。
那么我可以发送什么?
✅ 不同客户的两条报告——没问题
如果客户 A 和客户 B 都有活动订阅,您可以在完全相同的时间为两者发送报告。它们具有不同的订阅 ID,因此彼此完全独立。您甚至可以同时为 100 个不同客户发送报告。
✅ 不同指标的两条报告——没问题
如果您的产品有两个计费维度(例如 emails_sent 和 api_calls),您可以在同一分钟内为两者发送报告。不同指标 = 不同时间槽。不会冲突。
✅ 相同客户、相同指标、不同小时的两条报告——可以
如果您在 08:55 发送了一条关于客户 A 邮件使用量的报告,然后又在 09:05 再发送一次——这是可以的。这属于两个不同的日历小时,因此是两个独立的时间槽。
❌ 相同客户、相同指标、相同小时的两条报告——会被拒绝
如果您在 08:10 为客户 A 的邮件使用量发送了一条报告,然后又在 08:45 为同一指标发送另一条报告——第二条会被拒绝。因为您已经占用了该时间槽。
💡 正确的处理方式 不要在每次发生使用事件时都立即发送。相反,请在一小时内收集并汇总所有使用量,然后在该小时结束时发送一条包含总量的报告。这也是 Microsoft 推荐的做法。 |
|---|
仅限活动订阅
您只能为当前处于活动状态的订阅发送使用量报告。Microsoft 会拒绝以下订阅的事件:
• 已取消 / 已退订
• 已暂停
• 仍在等待激活(PendingFulfillmentStart)
唯一的例外情况:如果客户今天取消了订阅,您仍然可以为取消之前期间的使用量发送报告——只要您在 24 小时窗口内完成即可。
常见场景一览
情况 | 结果 | 原因 |
|---|---|---|
同一订单、同一计量器的两个事件,相隔 5 分钟(同一小时内) | ❌ 已拒绝 | 同一小时内 — 合并为一个事件 |
同一订单、同一计量器的两个事件,但处于不同时段(例如 8:50 和 9:05) | ✅ 已接受 | 不同时段,不存在冲突 |
同一订单、不同计量器的两个事件,时间相同 | ✅ 已接受 | 不同维度彼此独立 |
不同订单(订阅)、同一计量器、相同时间的两个事件 | ✅ 已接受 | 不同订阅 = 完全不存在冲突 |
已取消或已暂停订阅的事件 | ❌ 已拒绝 | 仅接受处于活动状态(Subscribed)的订阅 |