Generazione di rapporti sulla monetizzazione

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza Apigee Edge documentazione.

Nota: la generazione di report personalizzati non è supportata in Apigee hybrid. Problema noto: 355714868

Utilizzando la funzionalità Report personalizzati di Apigee, puoi generare report per visualizzare le informazioni sulla monetizzazione delle tue API. Per generare i report, puoi utilizzare la UI di Apigee, l'API Stats o l'API Queries, come descritto nelle sezioni seguenti:

• Aggiungere un report personalizzato utilizzando la UI di Apigee
• API Stats
• API Queries (API per report personalizzati asincroni)

Metriche e dimensioni di monetizzazione

Apigee fornisce le seguenti metriche e dimensioni di monetizzazione:

• Metriche e dimensioni per le transazioni che utilizzano un proxy API
• Metriche e dimensioni per le transazioni basate su commissioni

Metriche e dimensioni per le transazioni che utilizzano un proxy API

Le tabelle seguenti elencano le metriche e le dimensioni x_apigee_mintng_* disponibili per le transazioni che utilizzano un proxy API:

• Metriche

  Nome nella UI	Nome nell'API	Descrizione
  Moltiplicatore del prezzo dell'API	x_apigee_mintng_price_multiplier	Il fattore (moltiplicatore) per cui viene moltiplicato il costo per transazione.
  Quota di condivisione delle entrate dello sviluppatore	x_apigee_mintng_dev_share	Quota di condivisione delle entrate di un'app o di un AppGroup in una transazione.
  Prezzo di monetizzazione	x_apigee_mintng_price	Entrate totali di una transazione.
  Tariffe di monetizzazione	x_apigee_mintng_rate	Tariffa addebitata per una transazione.

• Dimensioni

  Nome nella UI	Nome nell'API	Descrizione
  ID piano tariffario	x_apigee_mintng_rate_plan_id	Il piano tariffario di monetizzazione per lo sviluppatore di app.
  Valuta delle entrate	x_apigee_mintng_currency	Valuta delle entrate della transazione.
  Transazione eseguita	x_apigee_mintng_tx_success	Stato della monetizzazione della transazione.

Nota:

• Per le transazioni che utilizzano un proxy API, puoi utilizzare anche altre metriche e dimensioni insieme alle x_apigee_mintng_* metriche e dimensioni.
• L'interpretazione di un valore di dimensione dipende dalla metrica. Ad esempio, se selezioni la dimensione API Product, per una transazione basata su commissioni, il valore sarà il nome del prodotto API corrispondente a il piano tariffario a cui deve essere applicata la commissione di configurazione o la commissione ricorrente. Tuttavia, se selezioni la dimensione API Product per una transazione non basata su commissioni, il valore sarà il nome del prodotto API contenente i proxy API chiamati.

Metriche e dimensioni per le transazioni basate su commissioni

Le tabelle seguenti elencano le metriche e le dimensioni disponibili solo per transazioni basate su commissioni:

• Metriche

  Nome nella UI	Nome nell'API	Descrizione
  Tariffe	fees	Importo della tariffa.

• Dimensioni

  Nome nella UI	Nome nell'API	Descrizione
  Nome gruppo di app	app_group_name	Nome dell'AppGroup a cui si applicano le commissioni, se applicabile. Per gli sviluppatori di app, questo campo è vuoto.
  Tipo di tariffa	fees_type	Tipo di commissione: commissione di configurazione, commissione ricorrente, ricarica prepagata o rimborso. Questa dimensione sarà null se utilizzata con una metrica diversa da fees.
  Data e ora di creazione della commissione	created	Timestamp UNIX che indica quando è stata aggiunta la commissione per lo sviluppatore di app e il prodotto API. Questa dimensione è null se utilizzata con una metrica diversa da fees.
  Valuta delle entrate	x_apigee_mintng_currency	Valuta della commissione.
  Email sviluppatore	developer_email	Sviluppatore di app o AppGroup a cui addebitare la commissione di configurazione, le commissioni ricorrenti o la ricarica prepagata.
  ID sviluppatore / ID AppGroup	developer	ID dello sviluppatore di app o dell'AppGroup registrato in Apigee a cui si applicano le commissioni. Questo valore può essere utilizzato per i calcoli di fatturazione.
  Prodotto API	api_product	Prodotto API corrispondente al piano tariffario a cui si applica la commissione. Il valore è vuoto per alcuni tipi di commissioni, ad esempio la ricarica prepagata.
  ID piano tariffario	x_apigee_mintng_rate_plan_id	Il piano tariffario di monetizzazione per lo sviluppatore di app. Il valore è vuoto per alcuni tipi di commissioni, ad esempio la ricarica prepagata.
  Inizio ciclo	period_start	Inizio del periodo per il quale vengono addebitate le commissioni ricorrenti. Ad esempio, per una tariffa mensile questo è il primo giorno del mese. Questa dimensione è null se utilizzata con una metrica diversa da fees.
  Fine ciclo	period_end	Fine del periodo per il quale vengono addebitate le commissioni ricorrenti. Ad esempio, per una tariffa mensile questo è l'ultimo giorno del mese. Questa dimensione è null se utilizzata con una metrica diversa da fees.

Per descrizioni dettagliate di queste metriche e dimensioni, consulta Riferimento per metriche, dimensioni e filtri di analisi.

Il seguente report personalizzato di esempio mostra la somma delle tariffe di monetizzazione per tutte le app dello sviluppatore:

Per ogni app dello sviluppatore, l'esempio mostra il costo totale di tutte le transazioni dal 1-Apr-2021 to 15-Apr-2021. Il costo viene calcolato in base ai prezzi basati sul consumo configurati nel piano tariffario. Tieni presente che in questo esempio, la metrica (x_apigee_mintng_rate) è un campo di monetizzazione, ma la dimensione (developer_app) è un campo non di monetizzazione. Pertanto, in base ai tuoi requisiti, puoi generare report con una combinazione di campi di monetizzazione e non di monetizzazione.

Puoi anche limitare i risultati in base alle caratteristiche delle metriche utilizzando i filtri.

Per visualizzare le commissioni ricorrenti nei report generati, includi nell'intervallo di date selezionato il giorno successivo al ultimo giorno del mese o il giorno successivo alla data di scadenza dell'abbonamento, poiché è in questo giorno che vengono addebitate.

Esportare i dati di analisi della monetizzazione

In Apigee non è necessario eseguire passaggi aggiuntivi per esportare i dati di analisi della monetizzazione. Se stai esportando dati di analisi, Apigee esporta i seguenti campi di monetizzazione insieme ai dati di analisi regolari. Quando le transazioni basate su commissioni e le transazioni che utilizzano un proxy API vengono esportate insieme, ogni record viene esportato con le metriche e le dimensioni comuni, mentre le altre metriche e dimensioni (non correlate) vengono impostate su NULL.

Nota: per ulteriori informazioni su questi valori, consulta la pagina di esportazione collegata nella frase precedente.

Importante: Apigee aggiunge periodicamente nuovi campi e sconsiglia di scrivere codice dipendente che non funzionerebbe per i nuovi campi.

• 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