Memecahkan Masalah Monetisasi

Anda sedang melihat dokumentasi Apigee Edge.
Buka Dokumentasi Apigee X. info

ini.

Topik ini memberikan informasi dan panduan tentang pemecahan masalah monetisasi yang umum diamati menyelesaikan semua jenis permasalahan.

Developer Ditangguhkan

Gejala

Developer ditangguhkan dan tidak akan dapat melakukan monetisasi tambahan transaksi/panggilan API.

Pesan Error

<error>
   <messages>
        <message>Exceeded developer limit configuration -</message>
        <message>Is Developer Suspended - true</message>
   </messages>
</error>

Diagnosis

Untuk mengetahui alasan penangguhan developer, lakukan hal berikut langkah:

  1. Jalankan panggilan API berikut untuk mengidentifikasi kode error yang terkait dengan layanan yang ditangguhkan pengembang:
    1. Jika Anda adalah Pengguna Cloud Publik, gunakan API di bawah ini: 
      curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
    2. Jika Anda adalah Pengguna Cloud Pribadi, gunakan API di bawah ini: 
      curl -X GET "http://<management-host>:<port#>/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
  2. Bandingkan kode error dengan kode alasan berikut untuk mengetahui alasan developer ditangguhkan.

Lihat juga: Ringkasan kode alasan untuk developer yang ditangguhkan

Kode Alasan

Cause

Detail

INSUFFICIENT_FUNDS

Saldo akun developer habis

Jika saldo akun developer prabayar tidak memiliki cukup dana untuk tambahan transaksi, maka developer akan ditangguhkan.

Untuk developer pascabayar, error ini dapat terjadi jika mereka melebihi batas kredit atau jika batas kredit yang ditetapkan pada mata uang yang digunakan habis.

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED

Developer tidak dapat melakukan transaksi lebih lanjut

Setiap developer diizinkan untuk melakukan transaksi dalam jumlah tertentu berdasarkan tarif paket yang dibeli. Jika jumlah transaksi terlampaui, maka developer ditangguhkan dan tidak dapat menyelesaikan transaksi tambahan.

NO_CURRENT_PUBLISHABLE_ENTITY

Developer belum membeli paket tarif apa pun

Developer harus membeli paket tarif sebelum menyelesaikan transaksi apa pun.

Resolusi

Error

Langkah-langkah Selesaikan

INSUFFICIENT_FUNDS

Pengembang perlu memastikan bahwa ada saldo rekening yang cukup atau kredit yang tersedia untuk menyelesaikan transaksi tambahan.

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED
  1. Lakukan panggilan API berikut untuk mendapatkan paket tarif developer dan detail transaksi:
    • Jalankan panggilan API berikut untuk mendapatkan tanggal mulai dan tanggal akhir paket tarif yang telah dibeli developer: 
      http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/developers/%7Bdeveloper_id%7D/developer-accepted-rateplans
    • Jalankan panggilan API berikut untuk mendapatkan jumlah panggilan yang berhasil transaksi yang dilakukan oleh developer: 
      http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/transactions/developers/%7Bdeveloper_email_or_id%7D

  2. Di UI Edge, Anda juga dapat memeriksa jumlah panggilan dibuat dengan memilih:

    Paket > NamaPaket > NamaPlanet > Kartu Tarif

    Misalnya, jika nama paket adalah Pro Package dan adalah Paket Gratis, maka jalurnya adalah:

    Paket > Paket Pro > Paket Gratis > Kartu Tarif

NO_CURRENT_PUBLISHABLE_ENTITY

Developer harus membeli paket tarif agar dapat melakukan panggilan API.

Masalah penyiapan monetisasi

Gejala

Masalah penyiapan Monetisasi dapat berupa gejala yang berbeda-beda seperti:

  • Fungsi webhook tidak berfungsi
  • Tidak dapat membuat webhook
  • Notifikasi webhook tidak dipicu
  • Laporan Monetisasi tidak menampilkan transaksi apa pun. Misalnya, data Analytics menunjukkan bahwa developer telah menyelesaikan banyak transaksi dalam jangka waktu tertentu. Namun, laporan Monetisasi jangan mencantumkan transaksi apa pun.
  • Transaksi tidak dicatat

Pesan Error

Anda mungkin tidak melihat pesan error apa pun, tetapi Anda akan melihat masalah sebagai berikut yang dijelaskan dalam Gejala bagian.

Kemungkinan Penyebab

Jika Anda melihat salah satu gejala yang tercantum di Gejala, maka kemungkinan besar transaksi tidak dimonetisasi.

Mendiagnosis penyebabnya

  1. Gunakan panggilan API pengelolaan yang dijelaskan di bagian berikut untuk periksa apakah transaksi dimonetisasi.

    Melihat status transaksi

  2. Jika Anda tidak melihat transaksi apa pun yang tercantum sebagai SUCCESS dalam durasi yang ditentukan, maka transaksi tidak akan dimonetisasi.

Penyebab umum transaksi tidak dimonetisasi adalah:

Bagian berikut menjelaskan cara mendiagnosis dan menyelesaikan setiap masalah.

Kebijakan Pemeriksaan Batas Monetisasi tidak digunakan di Proxy API

Diagnosis

  1. Periksa apakah Kebijakan Pemeriksaan Batas Monetisasi disertakan ke proxy API.
  2. Jika kebijakan tidak dilampirkan, hal ini mungkin menjadi alasan transaksi dicantumkan sebagai FAILED.

Resolusi

Lampirkan Kebijakan Pemeriksaan Batas Monetisasi ke proxy API yang diperlukan, sebagaimana dijelaskan dalam Terapkan batas monetisasi pada proxy API.

Jika masalah masih berlanjut, periksa Produk API tidak dimonetisasi.

Produk API tidak dimonetisasi

Diagnosis

  1. Periksa apakah produk API dimonetisasi (hanya produk API yang dimonetisasi yang diberi rating dan akan yang tercantum di bagian transaksi). Produk yang dimonetisasi adalah produk yang memiliki setidaknya satu paket tarif aktif yang tersedia.
  2. Gunakan panggilan API pengelolaan berikut untuk mendapatkan daftar produk API yang dimonetisasi:
    1. Jika Anda adalah Pengguna Cloud Publik, gunakan API di bawah ini: 
      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
    2. Jika Anda adalah Pengguna Cloud Pribadi, gunakan API di bawah ini: 
      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
  3. Jika produk API yang terkait dengan Proxy API Anda tidak dimonetisasi, ini bisa jadi alasan transaksi tersebut tidak dimonetisasi.

Resolusi

Untuk memonetisasi produk API, lakukan langkah-langkah berikut:

  1. Mengonfigurasi kebijakan pencatatan transaksi.

  2. Pastikan Produk API memiliki paket tarif aktif.

Jika masalah masih berlanjut, periksa Kebijakan pencatatan transaksi salah ditentukan.

Kebijakan pencatatan transaksi salah ditetapkan

Diagnosis

  1. Mengaktifkan rekaman aktivitas UI untuk Proxy API yang memiliki Kebijakan Pemeriksaan Batas Monetisasi terlampir.
  2. Pilih permintaan API tertentu dari rekaman aktivitas UI.
  3. Pilih alur AX Analytics dan periksa apakah monetisasi berikut (mint) variabel alur memiliki nilai yang sesuai: 
    mint.tx.status - Should match the value set up for "success criteria" in the transaction recording policy for the API product being used. When tracing, the txProviderStatus in the transaction recording policy is stored in the variable 'mint.tx.status'.
mint.tx.app_id - Application id of API product.
mint.tx.prod_id - API product id.

  4. Berikut adalah contoh rekaman aktivitas UI yang menunjukkan variabel alur mint disiapkan dengan benar.

  5. Jika Anda mengamati error dalam variabel mint.tx.status, maka itu menunjukkan bahwa kebijakan pencatatan transaksi salah didefinisikan.

Resolusi

  1. Pastikan bahwa semua langkah yang didokumentasikan dalam Membuat kebijakan pencatatan transaksi telah diikuti dengan benar saat membuat kebijakan pencatatan transaksi.
  2. Nilai kunci adalah 'kriteria keberhasilan transaksi' yang ditetapkan di kebijakan pencatatan transaksi. Lihat Contoh penetapan kriteria keberhasilan transaksi dalam kebijakan pencatatan transaksi

Developer belum membeli paket tarif

Diagnosis

  1. Gunakan panggilan API pengelolaan berikut untuk memverifikasi paket tarif yang dibeli oleh developer:
    1. Jika Anda adalah pengguna Cloud Publik, gunakan API di bawah ini: 
      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
    2. Jika Anda pengguna Private Cloud, gunakan API di bawah ini: 
      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
  2. Berdasarkan respons dari panggilan di atas, temukan rencana yang aktif pada saat transaksi diselesaikan oleh pengembang.

Resolusi

Developer harus membeli paket tarif berdasarkan persyaratan mereka, lalu menjalankan transaksi/API.

Jika masalah berlanjut, hubungi Dukungan Apigee Edge.