Marketplace 計量計費 API - 常見問題

一旦客戶訂閱 SaaS 服務、具有受控應用程式方案的 Azure 應用程式,或具有計量計費的 Kubernetes 應用程式供應專案,就可以追蹤所使用每個計費維度的使用量。 如果用量超過客戶所選期間設定的所含數量,您的服務就會將使用量事件傳送至 Microsoft。

適用於 SaaS 供應項目、受控應用程式及 Kubernetes 應用程式供應項目

預期多久回報一次使用量?

理想情況下,系統應每小時回報一次前一小時的使用量,但僅限於前一小時有使用量時。

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

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

事件發生時間與使用量事件傳送給 Microsoft 的時間之間,最長會延遲多久?

在理想情況下,系統應每小時發送一次使用量事件,以涵蓋過去一小時內發生的事件。 但預計會有延遲。 允許的延遲上限為 24 小時,之後不會接受使用事件。 最佳實務是收集每小時的使用量,並在每小時結束時將其作為單一事件傳送出去。 例如,如果使用量事件發生在一天下午 1 點,您直到第二天下午 1 點,才會發出與此事件相關聯的使用量事件。 如果傳送使用量資料的系統當機,之後仍可恢復運作,並傳送使用量發生當時所屬小時區間的使用量事件,而不會損失資料精確度。 如果在實際使用後已過 24 小時,您仍然可以透過後續的使用事件回報已耗用的單位。 但這種做法可能會損害客戶計費事件報告的可信度。 建議您避免以每天/每週/每月一次的頻率傳送計量資料。 更難了解客戶的實際使用情況,以及解決可能因使用事件而提出的問題或疑問。 每小時傳送使用量的另一個原因是避免使用者在發行者傳送每日/每周/每月排放事件之前取消訂閱的情況。

注意

傳送使用量事件的 24 小時延遲也適用於已轉換/升級的計劃。 如果客戶將方案升級為新方案,則必須在轉換方案后的24小時內回報先前方案的使用量。

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

每小時區間內僅接受一個使用事件。 每小時區間從第 0 分鐘開始,到第 59 分鐘結束。 如果在同一小時內產生多個使用量事件,則後續的使用量事件都會因視為重複而被捨棄。

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

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

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

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

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

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

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

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

如果獨立軟體廠商(ISV)傳送自訂計量時收到錯誤,而該錯誤可能是由 Microsoft 端的問題所造成(通常是指先前曾接受過類似事件且未出現錯誤的情況),則 ISV 應等待後再重新傳送。

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

報告使用時,我該如何確定 PlanID?

planId 必須與客戶為與該使用量相關聯的訂用帳戶所購買的 Marketplace 方案相符。

對於 SaaS 優惠,請使用與客戶 Marketplace 訂閱相關的 planId,透過 Metering API 報告使用量。

如果客戶更換方案,請使用與該客戶新市集方案相關的 planID 報告後續使用情況。

使用正確的 planID 確保使用量歸因於適當的方案,並支持準確的計費。

僅適用於 SaaS 供應專案

如果您回報已取消訂閱的 SaaS 訂用帳戶使用量,會發生什麼情況?

刪除 SaaS 訂用帳戶之後,不會接受發出至 Microsoft Marketplace 的任何使用事件。

只有處於 Subscribed 狀態的訂用帳戶才能產生使用量(而非處於 PendingFulfillmentStart、Suspended 或 Unsubscribed 狀態的訂用帳戶)。

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

例如,客戶今天下午 3 點取消了 SaaS 訂用帳戶。 現在是下午 5 點,發佈者仍然可以針對此 SaaS 訂閱回報昨天下午 6 點到今天下午 3 點這段期間的使用量。

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

是,當您呼叫 GET 訂用帳戶清單 API,因為它包含所有 SaaS 訂用帳戶的清單。 每個 SaaS 訂用帳戶的回應中,狀態欄位會指出該訂用帳戶是處於啟用中還是已取消訂閱狀態。

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

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

例如,如果發佈者定義了一個 SaaS 方案,以每月固定收費 100 美元包含 1,000 封電子郵件,則超過 1,000 封的每封電子郵件都會透過自訂維度按每封 1 美元計費。

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