Men-debug monetisasi menggunakan alat Debug

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Debug monetisasi menggunakan Debug seperti yang dijelaskan di bagian berikut.

Men-debug fase kebijakan autentikasi

Monetisasi Apigee menggunakan kebijakan VerifyAPIKey atau VerifyAccessToken untuk menentukan apakah permintaan masuk dapat dimonetisasi dengan memeriksa paket tarif yang dipublikasikan dan aktif. Untuk informasi selengkapnya tentang cara menambahkan kebijakan, lihat Menambahkan kebijakan autentikasi.

Misalnya, gambar berikut menunjukkan detail fase kebijakan VerifyAPIKey dalam alur permintaan.

Setelah mengautentikasi pengguna, kebijakan VerifyAPIKey akan memeriksa semua paket tarif yang dipublikasikan untuk menentukan paket mana, jika ada, yang aktif berdasarkan waktu aktivasi dan masa berlakunya. Jika paket tarif yang dipublikasikan dan aktif ditemukan, variabel alur berikut akan diisi:

Variabel flow	Setelan
mint.mintng_is_apiproduct_monetized	true jika paket tarif yang dipublikasikan dan aktif ditemukan.
mint.mintng_rate_plan_id	ID paket tarif.
mint.rateplan_end_time_ms	Waktu habis masa berlaku untuk paket tarif. Contoh: 1619433556408
mint.rateplan_start_time_ms	Waktu aktivasi paket tarif. Contoh: 1618433956209

Jika tidak ada paket tarif yang dipublikasikan dan aktif, variabel alur mint.mintng_is_apiproduct_monetized akan ditetapkan ke false dan variabel alur tambahan tidak diisi.

Untuk mengetahui informasi selengkapnya, lihat variabel alur mint.

Men-debug fase kebijakan MonetizationLimitsCheck

Monetisasi Apigee menggunakan kebijakan MonetizationLimitsCheck untuk menerapkan langganan developer ke produk API. Untuk mengetahui informasi selengkapnya tentang cara menambahkan kebijakan, lihat Menerapkan langganan developer ke produk API.

Catatan: Kebijakan MonetizationLimitsCheck tidak berpengaruh jika tidak ada paket tarif aktif yang dipublikasikan dan variabel alur mint.mintng_is_apiproduct_monetized disetel ke false.

Misalnya, gambar berikut menunjukkan detail fase kebijakan MonetizationLimitsCheck dalam alur permintaan.

Jika developer membeli langganan ke produk API, variabel alur berikut akan diisi:

Variabel flow	Deskripsi
mint.limitscheck.is_request_blocked	true untuk permintaan yang diblokir.
mint.limitscheck.is_subscription_found	true jika langganan API ditemukan.
mint.limitscheck_purchased_product_name	Nama produk API yang dibeli. Contoh: MyProduct
mint.limitscheck.status_message	Pesan status. Contoh: limits_check_success
mint.prepaid_developer_balance	Saldo saat ini di dompet akun prabayar developer yang terkait dengan mata uang paket tarif.
mint.prepaid_developer_currency	Mata uang saldo yang tersedia di variabel mint.prepaid_developer_balance.
mint.subscription_end_time_ms	Waktu berakhir langganan produk API.
mint.subscription_start_time_ms	Waktu mulai langganan produk API. Contoh: 1618433956209

Jika developer tidak membeli langganan ke produk API:

• Variabel alur mint.limitscheck_is_subscription_found ditetapkan ke false
• mint.limitscheck.is_request_blocked disetel ke true
• Tidak ada variabel alur lain yang diisi.

Untuk mengetahui informasi selengkapnya, lihat variabel alur mint.

Men-debug fase kebijakan Kuota

Monetisasi Apigee menggunakan kebijakan Kuota untuk menerapkan kuota yang ditentukan di tingkat produk API. Kuota menentukan jumlah permintaan yang diizinkan untuk produk API selama jangka waktu tertentu. Untuk informasi selengkapnya tentang cara menambahkan kebijakan, lihat Menerapkan kuota monetisasi di proxy API.

Catatan: Kebijakan MonetizationLimitsCheck tidak akan berpengaruh jika tidak ada paket tarif aktif yang dipublikasikan dan variabel alur mint.mintng_is_apiproduct_monetized disetel ke false.

Misalnya, gambar berikut menunjukkan detail fase Kebijakan kuota dalam alur permintaan saat kuota telah terlampaui.

Dalam contoh ini, kuota telah terlampaui, status 429 Too Many Requests HTTP ditampilkan, dan variabel alur ratelimit.* diisi untuk memberikan detail selengkapnya tentang pengecualian kuota. Untuk deskripsi ratelimit.*, lihat Variabel alur kebijakan kuota.

Men-debug fase kebijakan DataCapture

Apigee menggunakan variabel monetisasi yang diambil oleh kebijakan DataCapture untuk rating, menghitung pembagian keuntungan, dan analisis. Untuk informasi selengkapnya tentang pengambilan variabel monetisasi dalam kebijakan, lihat Mengambil data monetisasi.

Misalnya, gambar berikut menunjukkan detail fase eksekusi kebijakan DataCapture dalam alur respons.

Jika tidak ada error saat mengambil variabel monetisasi, variabel alur berikut akan diisi untuk transaksi:

Variabel flow	Deskripsi
mint.mintng_currency	Mata uang untuk menghitung pendapatan. Variabel alur ini memiliki nilai variabel monetisasi currency.
mint.mintng_price	Pendapatan untuk menghitung bagian developer. Variabel alur ini memiliki nilai variabel monetisasi revShareGrossPrice.
mint.mintng_price_multiplier	Faktor (pengganda) yang digunakan untuk mengalikan biaya per transaksi. Variabel alur ini memiliki nilai variabel monetisasi perUnitPriceMultiplier.
mint.mintng_tx_success	Menentukan apakah transaksi dimonetisasi. Variabel alur ini memiliki nilai variabel monetisasi transactionSuccess.

Men-debug fase eksekusi proxy API yang dimonetisasi

Setelah proxy API yang dimonetisasi berhasil dieksekusi, kumpulan variabel alur akan diisi dengan informasi tentang biaya dan tarif berbasis konsumsi monetisasi yang dikenakan.

Misalnya, gambar berikut menunjukkan detail fase Eksekusi Proxy dalam alur PostClient tempat variabel diisi.

Jika eksekusi proxy API yang dimonetisasi berhasil, variabel alur berikut akan diisi:

Variabel flow	Deskripsi
message.status.code	Kode status HTTP pesan respons dari target. Jika Anda memiliki kebijakan dalam respons, nilai variabel ini akan diganti dengan kode status yang ditampilkan oleh kebijakan.
mint.limitscheck.is_request_blocked	Flag yang menentukan apakah permintaan API diblokir.
mint.mintng_consumption_pricing_rates	Biaya berbasis konsumsi yang ditetapkan dalam paket tarif.
mint.mintng_consumption_pricing_type	Jenis harga berdasarkan pemakaian yang ditetapkan dalam paket tarif. Contoh: FIXED_PER_UNIT
mint.mintng_dev_share	Keuntungan yang akan dibagikan kepada developer.
mint.mintng_price_multiplier	Faktor (pengganda) yang diambil dari kebijakan DataCapture. Biaya per transaksi dikalikan dengan faktor ini.
mint.mintng_rate	Tarif yang dikenakan untuk panggilan API.
mint.mintng_rate_before_multipliers	Tarif yang dikenakan untuk panggilan API tanpa penghitungan perUnitPriceMultiplier.
mint.mintng_revenue_share_rates	Rasio pembagian keuntungan yang ditetapkan dalam paket tarif.
mint.mintng_revenue_share_type	Jenis pembagian keuntungan yang ditetapkan dalam paket tarif.
mint.prepaid_updated_developer_usage	Penggunaan saat ini dari developer prabayar.
mint.status	Status panggilan yang dimonetisasi. Hanya diisi saat terjadi error.
mint.status_code	Kode status HTTP panggilan yang dimonetisasi. Hanya diisi saat terjadi error.
mint.tx_success_result	Menunjukkan apakah monetisasi berhasil untuk transaksi.

Untuk deskripsi mendetail tentang semua variabel, lihat variabel alur mint.