Gerar relatórios de rentabilização

Esta página aplica-se ao Apigee e ao Apigee Hybrid.

Veja a documentação do Apigee Edge.

Ao usar a funcionalidade Relatórios personalizados do Apigee, pode gerar relatórios para ver informações de rentabilização das suas APIs. Para gerar os relatórios, pode usar a IU do Apigee, a API stats ou a API queries, conforme descrito nas secções seguintes:

Dimensões e métricas de rentabilização

O Apigee fornece as seguintes métricas e dimensões de rentabilização:

  • Métricas e dimensões para transações que usam um proxy de API
  • Métricas e dimensões para transações baseadas em taxas

Métricas e dimensões para transações que usam um proxy de API

As tabelas seguintes apresentam as x_apigee_mintng_*métricas e dimensões disponíveis para transações que usam um proxy de API:

  • Métricas
    Nome na IU Nome na API Descrição
    Multiplicador do preço da API x_apigee_mintng_price_multiplier O fator (multiplicador) pelo qual o custo por transação é multiplicado.
    Partilha de receita do programador x_apigee_mintng_dev_share A parte do programador na receita de uma transação.
    Preço de rentabilização x_apigee_mintng_price Receita total de uma transação.
    Taxas de rentabilização x_apigee_mintng_rate Tarifa 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 de transações.
    Transação bem-sucedida x_apigee_mintng_tx_success Estado da rentabilização da transação.

Métricas e dimensões para transações baseadas em taxas

As tabelas seguintes apresentam as métricas e as dimensões disponíveis apenas para transações baseadas em taxas:

  • Métricas
    Nome na IU Nome na API Descrição
    Taxas taxas Valor que representa a taxa de configuração, as taxas recorrentes e a adição de saldo pré-paga.
  • Dimensões
    Nome na IU Nome na API Descrição
    Produto de API api_product Produto da API correspondente ao plano tarifário ao qual se aplica a taxa de configuração, a taxa recorrente ou a taxa de recarga pré-paga. O valor está vazio para um recarregamento pré-pago.
    Email do programador developer_email O programador tem de pagar a taxa de configuração, as taxas recorrentes ou a adição de saldo pré-pago.
    Tipo de taxas fees_type Tipo de taxa. Pode ser uma taxa de configuração, uma taxa recorrente ou um recarregamento pré-pago. Esta dimensão vai ser null quando usada com qualquer métrica que não seja fees.
    Fim do período period_end

    Atualmente disponível em organizações do Apigee, não em organizações do Apigee Hybrid.

    Fim do período para o qual são cobradas taxas recorrentes. Por exemplo, para uma taxa mensal, este é o último dia do mês.
    Início do período period_start

    Atualmente disponível em organizações do Apigee, não em organizações do Apigee Hybrid.

    Início do período para o qual são cobradas taxas recorrentes. 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 adição de saldo pré-paga.
    ID do plano de tarifas x_apigee_mintng_rate_plan_id

    Atualmente disponível em organizações do Apigee, não em organizações do Apigee Hybrid.

    O plano de tarifas de rentabilização para o programador de apps.

Para ver descrições detalhadas destas métricas e dimensões, consulte a referência de métricas, dimensões e filtros do Analytics.

O exemplo de relatório personalizado seguinte apresenta a soma das taxas de rentabilização em todas as apps do programador:

Resultados do relatório personalizado que mostram a soma das taxas de rentabilização

Para cada app de programador, o exemplo mostra o custo total de todas as transações de 1-Apr-2021 to 15-Apr-2021. O custo é calculado com base nos preços de consumo, conforme configurado no seu plano tarifário. Tenha em atenção que, neste exemplo, a métrica (x_apigee_mintng_rate) é um campo de rentabilização, mas a dimensão (developer_app) é um campo de não rentabilização. Assim, com base nos seus requisitos, pode gerar relatórios com uma combinação de campos de rentabilização e não rentabilização.

Também pode limitar os resultados com base nas caraterísticas das métricas através de filtros.

Para ver as taxas recorrentes nos relatórios gerados, inclua no intervalo de datas selecionado o dia após o último dia do mês ou o dia após a data de validade da subscrição, uma vez que é nessa altura que são cobradas.

Exportar dados de estatísticas de rentabilização

No Apigee, não tem de realizar passos adicionais para exportar os dados de estatísticas de rentabilização. Se estiver a exportar dados de estatísticas, o Apigee exporta os seguintes campos de rentabilização juntamente com os dados de estatísticas normais. Quando as transações baseadas em taxas e as transações que usam um proxy de API são exportadas em conjunto, cada registo é exportado com as métricas e as dimensões comuns, com outras métricas e dimensões (não relacionadas) definidas como NULL.
  • 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