This pageapplies toApigee andApigee hybrid.

View Apigee Edge documentation.

Note: Generating Custom Reports is not supported in Apigee hybrid.Known issue: 355714868

By using Apigee'sCustom Reports feature, you can generate reports to view monetization information of your APIs. To generate the reports, you can use the Apigee UI, the stats API, or the queries API as described in the following sections:

• Adding a custom report using the Apigee UI
• Stats API
• Queries API (Asynchronous custom reports API)

Monetization metrics and dimensions

Apigee provides the following monetization metrics and dimensions:

• Metrics and dimensions for transactions using an API proxy
• Metrics and dimensions for fee-based transactions

Metrics and dimensions for transactions using an API proxy

The following tables list thex_apigee_mintng_* metrics and dimensions available for transactions using an API proxy:

• Metrics

  Name in UI	Name in API	Description
  Api price multiplier	x_apigee_mintng_price_multiplier	The factor (multiplier) by which the per-transaction cost is multiplied.
  Developer share of revenue	x_apigee_mintng_dev_share	Developer's share in a transaction's revenue.
  Monetization price	x_apigee_mintng_price	Total revenue of a transaction.
  Monetization rates	x_apigee_mintng_rate	Rate charged for a transaction.

• Dimensions

  Name in UI	Name in API	Description
  Rate Plan ID	x_apigee_mintng_rate_plan_id	The monetization rate plan for the app developer.
  Revenue Currency	x_apigee_mintng_currency	Currency of the transaction revenue.
  Transaction Success	x_apigee_mintng_tx_success	Monetization status of the transaction.

Note:

• For the transactions using an API proxy, you can also useother metrics and dimensions along with thex_apigee_mintng_* metrics and dimensions.
• The interpretation of a dimension value depends on the metric. For example, if you select theAPI Product dimension,for a fee-based transaction, the value will be the name of the API product corresponding to the rate plan for which setup fee or recurring fee should be applied. However, if you select theAPI Product dimension for a non-fee-based transaction, the value will be the name of the API product containing the API proxies being called.

Metrics and dimensions for fee-based transactions

The following tables list the metrics and dimensions available only for fee-based transactions:

• Metrics

  Name in UI	Name in API	Description
  Fees	fees	Fee amount.

• Dimensions

  Name in UI	Name in API	Description
  Fee Type	fees_type	Type of fee: setup fee, recurring fee, prepaid topup, or refund. This dimension will benull when used with any metric other thanfees.
  Fee Time Created	created	Unix Timestamp when the fee was added for the app developer and API product. This dimension isnull when used with any metric other thanfees.
  Revenue Currency	x_apigee_mintng_currency	Currency of the fee.
  Developer Email	developer_email	Developer to be charged with the fee.
  API Product	api_product	API product corresponding to the rate plan for which the fee applies. The value is empty for some fee types, such as prepaid topup.
  Rate Plan ID	x_apigee_mintng_rate_plan_id	The monetization rate plan for the app developer. The value is empty for some fee types, such as prepaid topup.
  Period Start	period_start	Start of the period for which recurring fees are charged. For example, for a monthly fee this is the first day of the month. This dimension isnull when used with any metric other thanfees.
  Period End	period_end	End of the period for which recurring fees are charged. For example, for a monthly fee this is the last day of the month. This dimension isnull when used with any metric other thanfees.

For detailed descriptions of these metrics and dimensions, seeAnalytics metrics, dimensions, and filters reference.

The following sample custom report displays thesum of Monetization rates across all the developer apps:

For each developer app, the sample, shows the total cost of all the transactions from1-Apr-2021 to 15-Apr-2021. Thecost is calculated based on the consumption-based pricing as configured in your rate plan. Notice that in this example, the metric (x_apigee_mintng_rate) is a monetization field but the dimension (developer_app) is a non-monetization field. So, based on your requirements, you can generate reports with a combination of both monetization and non-monetization fields.

You can also limit your results based on metric characteristics by usingfilters.

To see recurring fees on generated reports, include in the selected date range the day after the last day of the month or the day after the subscription expiration date, as this is when they are charged.

Exporting monetization analytics data

In Apigee you do not need to perform any additional steps to export your monetization analyticsdata. If you areexporting analytics data, Apigeeexports the following monetization fields along with regular analytics data. When fee-basedtransactions and transactions using an API proxy are exported together, each record exports with thecommon metrics and dimensions, with other (non-related) metrics and dimensions set to NULL.Note: See the exporting page linked in the previous sentence for additional information on these values.Important: Apigee periodically adds new fields, and recommends against writing dependent code that would break for new fields.

• 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