Memecahkan Masalah Monetisasi

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

Topik ini memberikan informasi dan panduan tentang pemecahan masalah monetisasi yang sering terjadi.

Developer Ditangguhkan

Gejala

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

Pesan Error

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

Diagnosis

Untuk mengetahui alasan developer ditangguhkan, 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:

      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:

      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 menentukan alasan developer ditangguhkan.

Lihat juga: Ringkasan kode alasan untuk developer yang ditangguhkan

Resolusi

Masalah penyiapan monetisasi

Gejala

Masalah penyiapan Monetisasi dapat muncul sebagai 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 tercatat

Pesan Error

Anda mungkin tidak melihat 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, maka kemungkinan besar transaksi tidak dimonetisasi.

Mendiagnosis penyebabnya

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

   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:

• Kebijakan Pemeriksaan Batas Monetisasi Tidak Dilampirkan ke Proxy API
• APIProduct tidak Dimonetisasi
• Kebijakan Perekaman Transaksi salah ditentukan
• Developer belum membeli paket tarif

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 dilampirkan ke proxy API.
2. Jika kebijakan tidak dilampirkan, hal ini dapat menjadi alasan transaksi dicantumkan sebagai GAGAL.

Resolusi

Lampirkan Kebijakan Pemeriksaan Batas Monetisasi ke proxy API yang diperlukan, seperti yang dijelaskan dalam Menerapkan batas monetisasi pada 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 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:

      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:

      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, maka hal ini bisa menjadi alasan transaksi tidak dimonetisasi.

Resolusi

Untuk memonetisasi produk API, lakukan langkah-langkah berikut:

1. Mengonfigurasi kebijakan perekaman transaksi.

2. Periksa apakah Produk API memiliki paket tarif yang aktif.

Jika masalah berlanjut, periksa Kebijakan perekaman transaksi salah ditentukan.

Kebijakan perekaman transaksi salah ditentukan

Diagnosis

1. Aktifkan 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 variabel alur monetisasi (pembuatan) berikut memiliki nilai yang tepat:

   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 bahwa variabel alur pencetakan telah disiapkan dengan benar.

   

5. Jika Anda melihat error pada variabel mint.tx.status, maka hal ini menunjukkan bahwa kebijakan perekaman transaksi salah ditetapkan.

Resolusi

1. Pastikan semua langkah yang didokumentasikan dalam Membuat kebijakan perekaman transaksi telah diikuti dengan benar saat membuat kebijakan perekaman transaksi.
2. Nilai utama adalah 'kriteria keberhasilan transaksi' yang ditetapkan dalam kebijakan perekaman transaksi. Lihat Contoh menetapkan kriteria keberhasilan transaksi dalam kebijakan perekaman 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:

      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:

      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 persyaratan mereka, lalu menjalankan transaksi/API.

Jika masalah berlanjut, hubungi Dukungan Apigee Edge.