Debug della monetizzazione con lo strumento di debug

Questa pagina si applica a Apigee e Apigee ibridi.

Visualizza documentazione di Apigee Edge.

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

Debug della fase del criterio di autenticazione

La monetizzazione di Apigee utilizza la norma VerifyAPIKey o VerifyAccessToken per Determina se una richiesta in entrata è monetizzabile controllando il piano tariffario attivo pubblicato. Per saperne di più sull'aggiunta di un criterio, consulta Aggiunta di un criterio di autenticazione.

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

Dopo l'autenticazione dell'utente, il criterio VerifyAPIKey controlla tutti i piani tariffari pubblicati per determinare quale, se presente, è attivo in base ai relativi tempi 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 piano tariffario.
mint.rateplan_end_time_ms	Data 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 è impostata su false e il flusso aggiuntivo non vengono compilate.

Per ulteriori informazioni, consulta le variabili di flusso mint.

Debug della fase delle norme MonetizationLimitsCheck

La monetizzazione Apigee utilizza il criterio MonetizationLimitsCheck per imporre gli abbonamenti degli sviluppatori al prodotto API. Per maggiori informazioni sull'aggiunta di queste norme, consulta la sezione Applicare gli abbonamenti degli sviluppatori ai prodotti API.

Nota: la norma MonetizationLimitsCheck non ha effetto se non viene trovato alcun piano tariffario pubblicato attivo e la variabile di flusso mint.mintng_is_apiproduct_monetized è impostata su false.

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

Se lo sviluppatore 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 associato alla valuta del piano tariffario.
mint.prepaid_developer_currency	Valuta del saldo disponibile nel Variabile mint.prepaid_developer_balance.
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 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 impostata su true
• Non vengono compilate altre variabili di flusso.

Per ulteriori informazioni, consulta le variabili di flusso mint.

Debug della fase dei criteri per le quote

La monetizzazione Apigee utilizza i criteri per le quote 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 scoprire di più sull'aggiunta delle norme, consulta l'articolo Applicazione delle quote di monetizzazione nei proxy API.

Nota: la norma MonetizationLimitsCheck non ha effetto se non viene trovato alcun piano tariffario pubblicato attivo e la variabile di flusso mint.mintng_is_apiproduct_monetized è impostata su false.

Ad esempio, l'immagine seguente mostra i dettagli della fase del criterio per le quote nel flusso di richieste in cui è stata superata la quota.

In questo esempio la quota è stata superata, viene restituito uno stato 429 Too Many Requests HTTP e il flusso ratelimit.* del flusso vengono compilate per fornire ulteriori dettagli sull'eccezione di quota. Per una descrizione di ratelimit.*, consulta le variabili di flusso dei criteri per le quote.

Debug della fase del criterio Data Capture

Apigee utilizza le variabili di monetizzazione acquisite dal criterio Data Capture per la classificazione, calcolo della quota di condivisione delle entrate e analisi. Per ulteriori informazioni sull'acquisizione variabili di monetizzazione nelle norme, consulta Acquisizione dei dati sulla monetizzazione.

Ad esempio, l'immagine seguente mostra i dettagli della fase di esecuzione del criterio Data Capture nel flusso di risposta.

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

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. 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.

Debug della fase di esecuzione del proxy API monetizzato

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

Ad esempio, l'immagine seguente mostra i dettagli della fase Proxy Execution nella Flusso PostClient in cui vengono compilate le variabili.

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 la risposta include criteri, il valore di questa variabile è sovrascritto dal codice di stato restituito dal criterio.
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 prezzo a consumo impostato nel piano tariffario. Ad esempio: FIXED_PER_UNIT
mint.mintng_dev_share	Le entrate da condividere con lo sviluppatore.
mint.mintng_price_multiplier	Fattore (moltiplicatore) acquisito dal criterio Data Capture. Il costo per transazione è 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 di perUnitPriceMultiplier.
mint.mintng_revenue_share_rates	Percentuali relative alla quota di condivisione delle entrate impostate nel piano tariffario.
mint.mintng_revenue_share_type	Tipo di quota di condivisione delle entrate impostato nel piano tariffario.
mint.prepaid_updated_developer_usage	Utilizzo attuale dello sviluppatore 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 le variabili di flusso di menta.