Debug della monetizzazione con lo strumento di debug

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza Apigee Edge documentazione.

Esegui il debug della monetizzazione utilizzando Debug come descritto nelle sezioni seguenti.

Eseguire il debug della fase della policy di autenticazione

La monetizzazione di Apigee utilizza la policy VerifyAPIKey o VerifyAccessToken per determinare se una richiesta in entrata è monetizzabile controllando il piano tariffario pubblicato attivo. Per ulteriori informazioni sull'aggiunta della policy, consulta Aggiungere una policy di autenticazione.

Ad esempio, l'immagine seguente mostra i dettagli della fase della policy VerifyAPIKey nel flusso di richiesta.

Dettagli della fase del criterio VerifyAPIKey, incluse le variabili del flusso di monetizzazione

Dopo aver autenticato l'utente, la policy VerifyAPIKey controlla tutti i piani tariffari pubblicati per determinare quale, se presente, è attivo in base agli orari di attivazione e scadenza. Se viene trovato un piano tariffario pubblicato attivo, vengono compilate le seguenti variabili di flusso:

Variabile di flusso Impostazione
mint.mintng_is_apiproduct_monetized true se viene trovato un piano tariffario pubblicato attivo.
mint.mintng_rate_plan_id ID del piano tariffario.
mint.rateplan_end_time_ms Ora di scadenza del piano tariffario. Ad esempio: 1619433556408
mint.rateplan_start_time_ms Ora di attivazione del piano tariffario. Ad esempio: 1618433956209

Se non viene trovato alcun piano tariffario pubblicato attivo, la variabile di flusso mint.mintng_is_apiproduct_monetized viene impostata su false e le variabili di flusso aggiuntive non vengono compilate.

Per ulteriori informazioni, consulta Variabili di flusso di mint.

Eseguire il debug della fase della policy MonetizationLimitsCheck

La monetizzazione di Apigee utilizza la policy MonetizationLimitsCheck per applicare gli abbonamenti degli sviluppatori di app e di AppGroup al prodotto API. Per ulteriori informazioni sull'aggiunta della policy, consulta Applicare gli abbonamenti ai prodotti API.

Ad esempio, l'immagine seguente mostra i dettagli della fase della policy MonetizationLimitsCheck nel flusso di richiesta.

Dettagli della fase delle norme MonetizationLimitsCheck, incluse le variabili del flusso di monetizzazione

Se lo sviluppatore di app o l'AppGroup ha acquistato un abbonamento al prodotto API, vengono compilate le seguenti variabili di flusso:

Variabile di flusso Descrizione
mint.limitscheck.is_request_blocked true per le richieste bloccate.
mint.limitscheck.is_subscription_found true se viene trovato un abbonamento API.
mint.limitscheck_purchased_product_name Nome del prodotto API acquistato. Ad esempio: MyProduct
mint.limitscheck.status_message Messaggio di stato. Ad esempio: limits_check_success
mint.prepaid_developer_balance Saldo attuale nel portafoglio dell'account prepagato dello sviluppatore dell'app o dell'AppGroup associato a la valuta del piano tariffario.
mint.prepaid_developer_currency Valuta del saldo disponibile nella mint.prepaid_developer_balance variabile.
mint.subscription_end_time_ms Ora di fine dell'abbonamento al prodotto API.
mint.subscription_start_time_ms Ora di inizio dell'abbonamento al prodotto API. Ad esempio: 1618433956209

Se lo sviluppatore di app o l'AppGroup non ha acquistato un abbonamento al prodotto API:

  • La variabile di flusso mint.limitscheck_is_subscription_found è impostata su false
  • mint.limitscheck.is_request_blocked è impostato su true
  • Non vengono compilate altre variabili di flusso.

Per ulteriori informazioni, consulta Variabili di flusso di mint.

Eseguire il debug della fase della policy Quota

La monetizzazione di Apigee utilizza la policy Quota per applicare le quote definite a livello di prodotto API. Le quote definiscono il numero di richieste consentite per un prodotto API in un determinato periodo di tempo. Per ulteriori informazioni sull'aggiunta della policy, consulta Applicare le quote di monetizzazione nei proxy API.

Ad esempio, l'immagine seguente mostra i dettagli della fase della policy Quota nel flusso di richiesta in cui la quota è stata superata.

Dettagli della fase delle norme relative alle quote, incluse le variabili del flusso di monetizzazione

In questo esempio, la quota è stata superata, viene restituito uno stato HTTP 429 Too Many Requests e le variabili di flusso ratelimit.* flow vengono compilate per fornire maggiori dettagli sull'eccezione di quota. Per una descrizione di ratelimit.*, consulta le variabili di flusso della policy Quota.

Eseguire il debug della fase della policy DataCapture

Apigee utilizza le variabili di monetizzazione acquisite dalla policy DataCapture per la valutazione, il calcolo della quota di entrate e l'analisi. Per ulteriori informazioni sull'acquisizione delle variabili di monetizzazione nella policy, consulta Acquisire i dati di monetizzazione.

Ad esempio, l'immagine seguente mostra i dettagli della fase di esecuzione della policy DataCapture nel flusso di risposta.

Fase di esecuzione del criterio DataCapture con le variabili del flusso di monetizzazione

Se non si verificano errori durante l'acquisizione delle variabili di monetizzazione, vengono compilate le seguenti variabili di flusso per una transazione:

Variabile di flusso Descrizione
mint.mintng_currency

Valuta per il calcolo delle entrate.

Questa variabile di flusso ha il valore della variabile di monetizzazione currency.
mint.mintng_price

Entrate per il calcolo della quota dello sviluppatore dell'app o dell'AppGroup.

Questa variabile di flusso ha il valore della variabile di monetizzazione revShareGrossPrice.
mint.mintng_price_multiplier

Fattore (moltiplicatore) per cui viene moltiplicato il costo per transazione.

Questa variabile di flusso ha il valore della variabile di monetizzazione perUnitPriceMultiplier.
mint.mintng_tx_success

Specifica se la transazione è monetizzata.

Questa variabile di flusso ha il valore della variabile di monetizzazione transactionSuccess.

Eseguire il debug della fase di esecuzione del proxy API monetizzato

Dopo l'esecuzione corretta del proxy API monetizzato, un insieme di variabili di flusso viene compilato con informazioni sulle tariffe e le tariffe basate sul consumo della monetizzazione addebitate.

Ad esempio, l'immagine seguente mostra i dettagli della fase Esecuzione del proxy nel flusso PostClient in cui vengono compilate le variabili.

Dettagli della fase di esecuzione del proxy, incluse le variabili del flusso di monetizzazione

Se l'esecuzione del proxy API monetizzato ha esito positivo, vengono compilate le seguenti variabili di flusso:

Variabile di flusso Descrizione
message.status.code Codice di stato HTTP del messaggio di risposta dalla destinazione.

Se hai una policy nella risposta, il valore di questa variabile viene sostituito dal codice di stato restituito dalla policy.
mint.limitscheck.is_request_blocked Flag che specifica se la richiesta API è bloccata.
mint.mintng_consumption_pricing_rates Tariffe basate sul consumo impostate nel piano tariffario.
mint.mintng_consumption_pricing_type Tipo di prezzi basati sul consumo impostato nel piano tariffario. Ad esempio: FIXED_PER_UNIT
mint.mintng_dev_share Entrate da condividere con lo sviluppatore di app o l'AppGroup.
mint.mintng_price_multiplier Fattore (moltiplicatore) acquisito dalla policy DataCapture. Il costo per transazione viene moltiplicato per questo fattore.
mint.mintng_rate

Tariffa addebitata per la chiamata API.
mint.mintng_rate_before_multipliers Tariffa addebitata per la chiamata API senza il calcolo perUnitPriceMultiplier.
mint.mintng_revenue_share_rates Tariffe di condivisione delle entrate impostate nel piano tariffario.
mint.mintng_revenue_share_type Tipo di condivisione delle entrate impostato nel piano tariffario.
mint.prepaid_updated_developer_usage Utilizzo attuale dello sviluppatore di app o dell'AppGroup prepagato.
mint.status Stato della chiamata monetizzata. Compilato solo in caso di errore.
mint.status_code Codice di stato HTTP della chiamata monetizzata. Compilato solo in caso di errore.
mint.tx_success_result Indica se la monetizzazione è andata a buon fine per la transazione.

Per una descrizione dettagliata di tutte le variabili, consulta Variabili di flusso di mint.