Men-debug monetisasi menggunakan Alat Debug

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Baca dokumentasi Apigee Edge.

Lakukan 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 atau tidak dengan memeriksa paket tarif aktif yang dipublikasikan. Untuk mengetahui informasi selengkapnya tentang menambahkan kebijakan, lihat Menambahkan kebijakan autentikasi.

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

Detail fase kebijakan VerifyAPIKey termasuk variabel alur monetisasi

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

Variabel flow Setelan
mint.mintng_is_apiproduct_monetized true jika paket tarif aktif yang dipublikasikan 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 ditemukan paket tarif aktif yang dipublikasikan, variabel alur mint.mintng_is_apiproduct_monetized ditetapkan ke false dan variabel alur tambahan tidak akan diisi.

Untuk 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 untuk produk API.

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

Detail fase kebijakan MonetizationLimitsCheck termasuk variabel alur monetisasi

Jika developer membeli langganan 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 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 produk API:

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

Untuk informasi selengkapnya, lihat variabel alur mint.

Men-debug fase kebijakan Kuota

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

Misalnya, gambar berikut menampilkan detail fase kebijakan Kuota dalam alur permintaan saat kuota telah terlampaui.

Detail fase kebijakan kuota termasuk variabel alur monetisasi

Dalam contoh ini, kuota telah terlampaui, status 429 Too Many Requests HTTP ditampilkan, dan variabel alur ratelimit.* alur 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 memberi rating, menghitung pembagian keuntungan, dan analisis. Untuk informasi selengkapnya tentang pengambilan variabel monetisasi dalam kebijakan, lihat Merekam data monetisasi.

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

Fase eksekusi kebijakan DataCapture dengan variabel alur monetisasi

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

Faktorkan (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 berhasil menjalankan proxy API yang dimonetisasi, serangkaian 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.

Detail fase Eksekusi Proxy termasuk variabel alur monetisasi

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 respons Anda memiliki kebijakan, nilai variabel ini akan diganti oleh kode status yang ditampilkan oleh kebijakan tersebut.

mint.limitscheck.is_request_blocked Flag yang menentukan apakah permintaan API diblokir atau tidak.
mint.mintng_consumption_pricing_rates Biaya berbasis pemakaian yang ditetapkan dalam paket tarif.
mint.mintng_consumption_pricing_type Jenis penetapan harga berbasis pemakaian yang ditetapkan dalam paket tarif. Contoh: FIXED_PER_UNIT
mint.mintng_dev_share Pendapatan 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 Tarif 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 developer prabayar saat ini.
mint.status Status panggilan yang dimonetisasi. Hanya diisi jika terjadi error.
mint.status_code Kode status HTTP dari panggilan yang dimonetisasi. Hanya diisi jika terjadi error.
mint.tx_success_result Menunjukkan apakah monetisasi untuk transaksi berhasil atau tidak.

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