Usando o recurso Relatórios personalizados da Apigee, você pode gerar relatórios para ver as informações de monetização das suas APIs. Para gerar
os relatórios, use a IU da Apigee, a API de estatísticas ou a API de consultas, conforme
descrito nas seguintes seções:
A Apigee fornece as seguintes métricas e dimensões de monetização:
Métricas e dimensões para transações usando um proxy de API
Métricas e dimensões para transações com base em taxas
Métricas e dimensões para transações usando um proxy de API
As tabelas a seguir listam as métricas e dimensões de x_apigee_mintng_* disponíveis para
transações usando um proxy de API:
Métricas
Nome na IU
Nome na API
Descrição
Multiplicador de preços da API
x_apigee_mintng_price_multiplier
O fator (multiplicador) pelo qual o custo por transação é multiplicado.
Participação do desenvolvedor na receita
x_apigee_mintng_dev_share
Participação do desenvolvedor na receita de uma transação.
Preço de monetização
x_apigee_mintng_price
Receita total de uma transação
Taxas de monetização
x_apigee_mintng_rate
Taxa cobrada por uma transação.
Dimensões
Nome na IU
Nome na API
Descrição
Moeda da receita
x_apigee_mintng_currency
Moeda da receita da transação.
Transação concluída
x_apigee_mintng_tx_success
Status da monetização da transação.
Métricas e dimensões para transações com base em taxas
As tabelas a seguir listam as métricas e dimensões disponíveis apenas para
transações baseadas em taxas:
Métricas
Nome na IU
Nome na API
Descrição
Taxas
do Postini
Valor que representa a taxa de configuração, as taxas recorrentes e a recarga pré-paga.
Dimensões
Nome na IU
Nome na API
Descrição
Produto de API
api_product
Produto da API correspondente ao plano de taxas a que as taxas de configuração, recorrentes ou de recarga pré-paga se aplicam. O valor está vazio para uma recarga pré-paga.
E-mail do desenvolvedor
developer_email
O desenvolvedor precisará pagar a taxa de configuração, as taxas recorrentes ou a recarga pré-paga.
Tipo de taxa
fees_type
Tipo de taxa. Pode ser uma taxa de configuração, uma taxa recorrente ou uma recarga pré-paga. Essa dimensão vai ser null
quando usada com qualquer métrica diferente de fees.
Fim do período
period_end
Atualmente disponível nas organizações da Apigee, não nas organizações híbridas da Apigee.
Fim do período em que as taxas recorrentes são cobradas. Por exemplo, uma taxa mensal
é o último dia do mês.
Começo do período
period_start
Atualmente disponível nas organizações da Apigee, não nas organizações híbridas da Apigee.
Início do período em que as taxas recorrentes são cobradas. Por exemplo, para uma taxa mensal,
este é o primeiro dia do mês.
Moeda da receita
x_apigee_mintng_currency
Moeda da taxa de configuração, da taxa recorrente ou da recarga pré-paga.
ID do plano de taxas
x_apigee_mintng_rate_plan_id
Atualmente disponível nas organizações da Apigee, não nas organizações híbridas da Apigee.
É o plano de taxa de monetização do desenvolvedor do app.
O exemplo personalizado de relatório a seguir exibe a soma das taxas de monetização em todos os apps para desenvolvedores:
A amostra apresenta o custo total de todas as transações de 1-Apr-2021 to 15-Apr-2021 para cada app do desenvolvedor.
O
custo é calculado com base no preço com base no consumo, conforme configurado no seu plano de tarifas. Neste exemplo, a métrica (x_apigee_mintng_rate) é um campo de monetização, mas a dimensão (developer_app) é um campo de não monetização. Portanto, com base nos seus
requisitos, é possível gerar relatórios combinando os campos de monetização e de não monetização.
Também é possível limitar seus resultados com base nas características das métricas usando
filtros.
Para ver as taxas recorrentes nos relatórios gerados, inclua no período selecionado o dia após o último dia do mês ou o dia após a data de expiração da assinatura, já que é quando elas são cobradas.
Como exportar dados de análise de monetização
Na Apigee, não é necessário realizar etapas adicionais para exportar os dados de análise de monetização. Se você estiver
exportando dados de análise, a Apigee
exportará os campos de monetização a seguir com os dados de análise regulares: Quando as transações
baseadas em taxas e as transações que usam um proxy de API são exportadas juntas, cada registro é exportado com as
métricas e dimensões comuns, com outras métricas e dimensões (não relacionadas) definidas como NULL.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[[["\u003cp\u003eThis documentation outlines how to use Apigee's Custom Reports feature to view monetization data for APIs, applicable to both Apigee and Apigee hybrid.\u003c/p\u003e\n"],["\u003cp\u003eYou can generate monetization reports through the Apigee UI, the Stats API, or the Queries API, utilizing monetization-specific metrics and dimensions.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ex_apigee_mintng_*\u003c/code\u003e metrics and dimensions track API proxy transaction details, such as price multipliers, developer share, and transaction success, while also being able to combine with other non-monetization related fields.\u003c/p\u003e\n"],["\u003cp\u003eFee-based transactions have their own set of metrics (like \u003ccode\u003efees\u003c/code\u003e) and dimensions (like \u003ccode\u003eapi_product\u003c/code\u003e and \u003ccode\u003efees_type\u003c/code\u003e) that capture setup, recurring, and prepaid fees.\u003c/p\u003e\n"],["\u003cp\u003eWhen exporting analytics data, Apigee includes monetization fields alongside regular data, such as \u003ccode\u003ex_apigee_mintng_price\u003c/code\u003e, \u003ccode\u003ex_apigee_mintng_rate\u003c/code\u003e, and \u003ccode\u003eperiod_start\u003c/code\u003e, and common metrics and dimensions, with non-related fields set to NULL.\u003c/p\u003e\n"]]],[],null,["*This page\napplies to **Apigee** and **Apigee hybrid**.*\n\n\n*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*\n\n| Note: Generating Custom Reports is not supported in Apigee hybrid. [Known issue: 355714868](/apigee/docs/release/known-issues#355714868)\n\nBy using Apigee's [Custom Reports](/apigee/docs/api-platform/analytics/create-custom-reports)\nfeature, you can generate reports to view monetization information of your APIs. To generate\nthe reports, you can use the Apigee UI, the stats API, or the queries API as\ndescribed in the following sections:\n\n- [Adding a custom report using the Apigee UI](/apigee/docs/api-platform/analytics/create-custom-reports#add)\n- [Stats API](/apigee/docs/reference/apis/apigee/rest/v1/organizations.environments.stats/get)\n- [Queries API (Asynchronous custom reports API)](/apigee/docs/api-platform/analytics/asynch-reports-api)\n\nMonetization metrics and dimensions\n\nApigee provides the following monetization metrics and dimensions:\n\n\n- Metrics and dimensions for transactions using an API proxy\n- Metrics and dimensions for fee-based transactions\n\nMetrics and dimensions for transactions using an API proxy\n\nThe following tables list the `x_apigee_mintng_*` metrics and dimensions available for\ntransactions using an API proxy:\n\n- **Metrics**\n\n | Name in UI | Name in API | Description |\n |----------------------------|----------------------------------|--------------------------------------------------------------------------|\n | Api price multiplier | x_apigee_mintng_price_multiplier | The factor (multiplier) by which the per-transaction cost is multiplied. |\n | Developer share of revenue | x_apigee_mintng_dev_share | Developer's share in a transaction's revenue. |\n | Monetization price | x_apigee_mintng_price | Total revenue of a transaction. |\n | Monetization rates | x_apigee_mintng_rate | Rate charged for a transaction. |\n\n- **Dimensions**\n\n | Name in UI | Name in API | Description |\n |---------------------|----------------------------|-----------------------------------------|\n | Revenue currency | x_apigee_mintng_currency | Currency of the transaction revenue. |\n | Transaction success | x_apigee_mintng_tx_success | Monetization status of the transaction. |\n\n| **Note:**\n|\n| - For the transactions using an API proxy, you can also use [other metrics and dimensions](/apigee/docs/api-platform/analytics/analytics-reference) along with the `x_apigee_mintng_*` metrics and dimensions.\n| - The interpretation of a dimension value depends on the metric. For example, if you select the `API 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 the `API Product` dimension for a non-fee-based transaction, the value will be the name of the API product containing the API proxies being called.\n\nMetrics and dimensions for fee-based transactions\n\nThe following tables list the metrics and dimensions available only for\nfee-based transactions:\n\n- **Metrics**\n\n | Name in UI | Name in API | Description |\n |------------|-------------|-----------------------------------------------------------------------|\n | Fees | fees | Amount representing the setup fee, recurring fees, and prepaid topup. |\n\n- **Dimensions**\n\n | Name in UI | Name in API | Description |\n |------------------|------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n | API Product | api_product | API product corresponding to the rate plan for which the setup fee, recurring fee, or prepaid topup fee applies. The value is empty for a prepaid topup. |\n | Developer Email | developer_email | Developer to be charged with the setup fee, recurring fees, or prepaid topup. |\n | Fees type | fees_type | Type of fee. It can be a setup fee, recurring fee, or prepaid topup. This dimension will be `null` when used with any metric other than the `fees`. |\n | Period end | period_end | Currently available in Apigee orgs, not Apigee hybrid orgs. End of the period for which recurring fees are charged. For example, for a monthly fee this is the last day of the month. |\n | Period start | period_start | Currently available in Apigee orgs, not Apigee hybrid orgs. Start of the period for which recurring fees are charged. For example, for a monthly fee this is the first day of the month. |\n | Revenue currency | x_apigee_mintng_currency | Currency of the setup fee, recurring fee, or prepaid topup. |\n | Rate plan ID | x_apigee_mintng_rate_plan_id | Currently available in Apigee orgs, not Apigee hybrid orgs. The monetization rate plan for the app developer. |\n\n\nFor detailed descriptions of these metrics and dimensions, see\n[Analytics metrics, dimensions, and filters reference](/apigee/docs/api-platform/analytics/analytics-reference).\n\n\nThe following sample custom report displays the **sum of Monetization rates** across all the developer apps:\n\n\nFor each developer app, the sample, shows the total cost of all the transactions from `1-Apr-2021 to 15-Apr-2021`. The\ncost is calculated based on the consumption-based pricing as configured in your rate plan. Notice that in this example,\nthe metric (`x_apigee_mintng_rate`) is a monetization field but the dimension\n(`developer_app`) is a non-monetization field. So, based on your\nrequirements, you can generate reports with a combination of both monetization and non-monetization fields.\n\nYou can also limit your results based on metric characteristics by\nusing [filters](/apigee/docs/api-platform/analytics/analytics-reference#filters).\n\nTo see recurring fees on generated reports, include in the selected date range the day after the\nlast day of the month or the day after the subscription expiration date, as this is when they are charged.\n\nExporting monetization analytics data In Apigee you do not need to perform any additional steps to export your monetization analytics data. If you are [exporting analytics data](/apigee/docs/api-platform/analytics/export-data), Apigee exports the following monetization fields along with regular analytics data. When fee-based transactions and transactions using an API proxy are exported together, each record exports with the common 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.\n\n- `client_received_start_timestamp`\n- `period_end`\n- `period_start`\n- `x_apigee_mintng_currency`\n- `x_apigee_mintng_dev_share`\n- `x_apigee_mintng_price`\n- `x_apigee_mintng_price_multiplier`\n- `x_apigee_mintng_rate`\n- `x_apigee_mintng_rate_plan_id`\n- `x_apigee_mintng_tx_success`"]]