Memecahkan Masalah Monetisasi

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

Topik ini memberikan informasi dan panduan untuk memecahkan masalah monetisasi yang umum ditemui.

Developer Ditangguhkan

Gejala

Developer ditangguhkan dan tidak akan dapat melakukan transaksi monetisasi tambahan/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 langkah-langkah berikut:

  1. Jalankan panggilan API berikut untuk mengidentifikasi kode error yang terkait dengan developer yang ditangguhkan:
    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 Private Cloud, 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 transaksi tambahan, 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 jumlah transaksi tetap berdasarkan paket tarif yang dibeli. Jika jumlah transaksi terlampaui, developer akan 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 Menyelesaikan

INSUFFICIENT_FUNDS

Developer perlu memastikan bahwa ada saldo akun yang memadai 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 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 transaksi yang berhasil 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 yang diizinkan untuk dilakukan developer dengan memilih:

    Paket > PackageName > RatePlanName > Kartu Tarif

    Misalnya, jika nama paket adalah Paket Pro dan Paket Gratis, 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, tetapi laporan Monetisasi tidak mencantumkan transaksi tersebut.
  • Transaksi tidak dicatat

Pesan Error

Anda mungkin tidak mengamati pesan error apa pun, tetapi Anda akan melihat masalah seperti yang dijelaskan di bagian Gejala.

Kemungkinan Penyebab

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

Mendiagnosis penyebabnya

  1. Gunakan panggilan API pengelolaan yang dijelaskan di bagian berikut untuk memeriksa apakah transaksi dimonetisasi atau tidak.

    Melihat status transaksi

  2. Jika Anda tidak melihat transaksi apa pun yang tercantum sebagai BERHASIL dalam durasi yang ditentukan, berarti transaksi tersebut tidak 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 tersebut tercantum sebagai FAILED.

Resolusi

Lampirkan Kebijakan Pemeriksaan Batas Monetisasi ke proxy API yang diperlukan, seperti yang dijelaskan di Menerapkan batasan monetisasi untuk proxy API.

Jika masalah 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 dicantumkan di bagian transaksi). Produk yang dimonetisasi adalah produk yang memiliki minimal satu paket tarif aktif.
  2. Gunakan panggilan Management API 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 Private Cloud, 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, hal ini bisa menjadi alasan transaksi tidak dimonetisasi.

Resolusi

Untuk memonetisasi produk API, lakukan langkah-langkah berikut:

  1. Mengonfigurasi kebijakan pencatatan transaksi.

  2. Pastikan Produk API memiliki paket tarif yang aktif.

Jika masalah berlanjut, periksa Kebijakan pencatatan transaksi salah ditentukan.

Kebijakan pencatatan transaksi tidak ditentukan dengan benar

Diagnosis

  1. Aktifkan rekaman aktivitas UI untuk Proxy API yang memiliki Kebijakan Pemeriksaan Batas Monetisasi yang terlampir.
  2. Memilih permintaan API tertentu dari rekaman aktivitas UI.
  3. Pilih alur AX Analytics dan periksa apakah variabel alur monetisasi (mint) berikut 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 flow mint disiapkan dengan benar.

  5. Jika Anda melihat error dalam variabel mint.tx.status, hal tersebut menunjukkan bahwa kebijakan pencatatan transaksi salah ditentukan.

Resolusi

  1. Pastikan semua langkah yang didokumentasikan dalam Membuat kebijakan pencatatan transaksi telah diikuti dengan benar saat membuat kebijakan pencatatan transaksi.
  2. Nilai kuncinya adalah 'kriteria keberhasilan transaksi' yang ditetapkan dalam 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 Public Cloud, 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 adalah 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 paket yang aktif pada saat transaksi diselesaikan oleh developer.

Resolusi

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

Jika masalah berlanjut, hubungi Dukungan Apigee Edge.