產生營利報表

本頁內容適用於 Apigee 和 Apigee Hybrid。

查看 Apigee Edge 說明文件。

注意：Apigee Hybrid 不支援產生自訂報表。 已知問題：355714868

使用 Apigee 的自訂報表功能，即可產生報表來查看 API 的營利資訊。如要產生報表，可以使用 Apigee 使用者介面、統計資料 API 或查詢 API，詳情請參閱下列章節：

• 使用 Apigee UI 新增自訂報表
• Stats API
• Queries API (非同步自訂報表 API)

營利指標和維度

Apigee 提供下列營利指標和維度：

• 使用 API Proxy 的交易指標和維度
• 以交易為準的費用指標和維度

使用 API Proxy 的交易指標和維度

下表列出可透過 API 代理進行交易的 x_apigee_mintng_* 指標和維度：

• 指標

  使用者介面中的名稱	API 中的名稱	說明
  API 價格乘數	x_apigee_mintng_price_multiplier	用來乘上單一交易費用的係數 (乘數)。
  開發人員收益比重	x_apigee_mintng_dev_share	開發人員在交易收益中所占的比例。
  營利價格	x_apigee_mintng_price	交易的總收益。
  營利率	x_apigee_mintng_rate	交易的收費費率。

• 維度

  使用者介面中的名稱	API 中的名稱	說明
  房價方案 ID	x_apigee_mintng_rate_plan_id	應用程式開發人員的營利費率方案。
  收益幣別	x_apigee_mintng_currency	交易收益的幣別。
  交易成功	x_apigee_mintng_tx_success	交易的營利狀態。

注意：

• 對於使用 API 代理的交易，您也可以搭配 x_apigee_mintng_* 指標和維度，使用其他指標和維度。
• 維度值的解讀方式取決於指標。舉例來說，如果您選取 API Product 維度，對於以費用為準的交易，該值會是與費率方案相應的 API 產品名稱，而該費率方案應適用設定費或週期性費用。不過，如果為非以費用為準的交易選取 API Product 維度，該值會是包含所呼叫 API Proxy 的 API 產品名稱。

以交易為準的費用指標和維度

下表列出僅適用於付費交易的指標和維度：

• 指標

  使用者介面中的名稱	API 中的名稱	說明
  費用	費用	費用金額。

• 維度

  使用者介面中的名稱	API 中的名稱	說明
  費用類型	fees_type	費用類型：設定費、定期費用、預付加值或退款。與 fees 以外的任何指標搭配使用時，這個維度會是 null。
  費用建立時間	已建立	為應用程式開發人員和 API 產品新增費用的 Unix 時間戳記。如果與 fees 以外的任何指標搭配使用，這個維度會是 null。
  收益幣別	x_apigee_mintng_currency	費用幣別。
  開發人員電子郵件地址	developer_email	開發人員須支付這筆費用。
  API 產品	api_product	費用適用的費率方案所對應的 API 產品。部分費用類型 (例如預付加值) 的值為空白。
  房價方案 ID	x_apigee_mintng_rate_plan_id	應用程式開發人員的營利費率方案。部分費用類型的值為空白，例如預付加值。
  月經開始日期	period_start	系統開始收取定期費用的時間。舉例來說，如果是月費，這就是當月的第一天。如果與 fees 以外的任何指標搭配使用，這個維度會是 null。
  月經結束日期	period_end	系統收取週期性費用的週期結束日期。舉例來說，如果是月費，這就是當月的最後一天。如果與 fees 以外的任何指標搭配使用，這個維度會是 null。

如需這些指標和維度的詳細說明，請參閱「數據分析指標、維度和篩選器參考資料」。

下列自訂報表示範會顯示所有開發人員應用程式的營利指數總和：

針對每個開發人員應用程式，範例會顯示來自 1-Apr-2021 to 15-Apr-2021 的所有交易總費用。系統會根據您在費率方案中設定的用量計費方式計算費用。請注意，在本例中，指標 (x_apigee_mintng_rate) 是營利欄位，但維度 (developer_app) 是非營利欄位。因此，您可以根據需求，產生同時包含營利和非營利欄位的報表。

您也可以使用篩選器，根據指標特徵限制結果。

如要在產生的報表中查看週期性費用，請在所選日期範圍中加入該月最後一天或訂閱到期日之後的一天，因為系統會在當天收費。

匯出營利數據分析資料

在 Apigee 中，您不需要執行任何額外步驟即可匯出營利分析資料。如果您匯出 Analytics 資料，Apigee 會連同一般 Analytics 資料，一併匯出下列營利欄位。如果同時匯出付費交易和使用 API 代理的交易，每筆記錄都會匯出常見的指標和維度，其他 (不相關) 指標和維度則會設為 NULL。

注意：如要進一步瞭解這些值，請參閱上文連結的匯出頁面。

重要事項：Apigee 會定期新增欄位，建議您不要編寫會因新欄位而中斷的相依程式碼。

• client_received_start_timestamp
• period_end
• period_start
• x_apigee_mintng_currency
• x_apigee_mintng_dev_share
• x_apigee_mintng_price
• x_apigee_mintng_price_multiplier
• x_apigee_mintng_rate
• x_apigee_mintng_rate_plan_id
• x_apigee_mintng_tx_success