共用方式為


Marketplace 計量付費 API - 常見問題集

一旦客戶訂閱 SaaS 服務、使用受控應用程式方案 Azure 應用程式 或具有計量付費計費的 Kubernetes 應用程式供應專案,您就會追蹤所使用的每個計費維度的使用量。 如果耗用量超過客戶所選取字詞所設定的內含數量,您的服務將會發出使用量事件來Microsoft。

針對 SaaS 供應專案、受控應用程式和 Kubernetes 應用程式供應專案

預期會發出使用量的頻率?

在理想情況下,只有在前一小時內有使用量時,您預期會每小時發出使用量。

一個排放與下一個排放之間是否有最大期間?

沒有這樣的限制。 只會在發生時發出使用量。 例如,如果您只需要提交每個訂用帳戶存留期的一個使用量單位,就可以這麼做。

事件發生的時間與使用事件發出時間之間的最大延遲為何?Microsoft?

在理想情況下,過去一小時內發生的事件會每小時發出使用量事件。 不過,預期會有延遲。 允許的最大延遲為 24 小時,之後將不會接受使用事件。 最佳做法是收集每小時使用量,而發出是當做一個事件在一小時結束時。

例如,如果使用量事件發生在一天下午 1 點,您直到第二天下午 1 點,才會發出與此事件相關聯的使用量事件。 如果系統發出使用量已關閉,它可以復原,然後針對發生使用量的小時間隔傳送使用量事件,而不會遺失精確度。

如果在實際使用量之後經過 24 小時,您仍然可以使用較晚的使用事件發出已取用的單位。 不過,這種做法可能會損害客戶計費事件報告的可信度。 建議您避免每天/周/月傳送計量排放一次。 更難瞭解客戶的實際使用量,並解決有關使用事件的問題或問題。

每小時傳送使用量的另一個原因是避免使用者在發行者傳送每日/每周/每月排放事件之前取消訂閱的情況。

當您在同一小時內傳送多個使用事件時,會發生什麼事?

一小時間隔只接受一個使用量事件。 小時間隔從分鐘 0 開始,並以分鐘 59 結束。 如果在同一小時內發出多個使用量事件,則任何後續的使用事件都會卸除為重複專案。

當客戶在取消原則允許的時間內取消購買時,會發生什麼事?

不會收取固定費率金額,但超額使用量將會收費。

自訂計量方案是否可以用於一次性付款?

是,您可以將自定義維度定義為一次性付款的一個單位,並針對每個客戶只發出一次。

自定義計量方案是否可以用於階層式定價模型?

是,可以使用代表單一價格區間的每個自定義維度來實作。

例如,Contoso 想要針對前 1000 封電子郵件收取每封電子郵件 $0.5 美元、每封電子郵件 1000 到 5000 封電子郵件 0.4 美元,以及超過 5000 封電子郵件的每封電子郵件 $0.2 美元。 他們可以定義三個自定義維度,其對應至三個電子郵件定價層。 只要電子郵件數目保持在 1000 以下,就會發出第一個維度的單位,然後在電子郵件數目介於 1000 到 5000 之間時,第二個維度的單位,最後是超過 5000 封電子郵件的第三個維度單位。

如果 Marketplace 計量服務中斷,會發生什麼事?

如果ISV傳送自定義計量並收到錯誤,這可能是由Microsoft端發生問題所造成(通常是在類似事件之前接受但未發生錯誤的情況下),ISV 應該等候並重試排放。

如果錯誤持續發生,則會在下一小時重新提交該自定義計量(累積數量)。 繼續此程式,直到收到非錯誤響應為止。

僅適用於 SaaS 供應專案

當您針對已取消訂閱的 SaaS 訂用帳戶發出使用量時,會發生什麼事?

刪除 SaaS 訂用帳戶之後,將不會接受任何向 Marketplace 平台發出的使用量事件。

只能針對訂閱狀態的訂用帳戶發出使用量(不適用於、 SuspendedUnsubscribed 狀態中的PendingFulfillmentStart訂用帳戶)。

唯一的例外狀況是報告 SaaS 訂用帳戶取消之前的時間使用量。

例如,客戶今天下午 3 點取消了 SaaS 訂用帳戶。 現在為下午 5 點,發行者仍然可以在此 SaaS 訂閱的昨天下午 6 點到今天下午 3 點之間發出使用量。

您是否可以取得所有 SaaS 訂用帳戶的清單,包括使用中和未訂閱的訂用帳戶?

是,當您呼叫 GET 訂用帳戶清單 API 時,它會包含所有 SaaS 訂用帳戶的清單。 每個 SaaS 訂用帳戶回應中的狀態欄位會擷取訂用帳戶為作用中或取消訂閱。

SaaS 訂用帳戶期限和超額使用量排放的開始和結束日期是否已連線?

在訂閱狀態中,現有 SaaS 訂用帳戶可以隨時發出超額事件。 發行者有責任根據計費方案中所定義的原則發出使用量事件。 超額必須根據 SaaS 訂用帳戶期間定義的日期來計算。

例如,如果發行者定義 SaaS 方案,其中包含每月 100 美元一般費率的 1000 封電子郵件,則每個超過 1000 的電子郵件都會透過自定義維度向 $1 計費。

當客戶於 1 月 6 日購買並啟用訂閱時,一般費率中包含的 1000 封電子郵件將從這一天開始計算。 因此,如果直到 2 月 5 日(訂閱的第一個月結束)才會傳送 900 封電子郵件,客戶只會支付此訂閱的第一個月固定費率,而發行者在 1 月 6 日至 2 月 5 日期間不會發出超額使用量事件。 在 2 月 6 日,訂閱將自動更新,計數將會再次啟動。 如果客戶在 2 月 15 日收到 1000 封電子郵件,則傳送到 3 月 5 日的其餘電子郵件會根據發行者發出的超額使用量事件收取超額(每封電子郵件 1 美元)。