Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi
Apigee X. info
Sebelum memulai
Sebelum mulai menggunakan monetisasi dengan organisasi Apigee, Anda perlu melakukan tugas prasyarat berikut:
- Buat akun Apigee Edge, seperti yang dijelaskan dalam Membuat akun Apigee Edge.
- Monetisasi pembelian. Edge awalnya tidak menyertakan API monetisasi atau mengintegrasikan monetisasi ke dalam UI pengelolaan. Anda perlu membeli fitur monetisasi untuk menggabungkan API monetisasi dan komponen UI monetisasi ke dalam Edge untuk organisasi Apigee Anda.
Setelah membeli monetisasi, Anda perlu melakukan tugas berikut:
- Bekerja sama dengan tim konfigurasi Apigee untuk menyelesaikan penyiapan monetisasi awal. Lihat Penyiapan awal dengan Apigee.
- Konfigurasi monetisasi. Lihat Mengonfigurasi monetisasi.
- Memonetisasi API Anda. Lihat Memonetisasi API.
- Mengelola monetisasi dengan membuat laporan, mengelola saldo akun, dan sebagainya. Lihat Mengelola monetisasi.
Penyiapan awal dengan Apigee
Bekerja sama dengan tim konfigurasi Apigee Edge untuk menyelesaikan penyiapan awal monetisasi. Berdasarkan input Anda, tim konfigurasi akan menyiapkan hal berikut:
- Apakah organisasi Anda adalah perusahaan telekomunikasi.
- Jenis penagihan yang ingin Anda dukung untuk developer yang membeli paket tarif: prabayar, pascabayar, atau keduanya. Lihat Akun prabayar versus pascabayar.
- Apakah Anda menginginkan data yang diekstrak dari monetisasi yang mendetail atau ringkas ke dalam sistem akuntansi Anda dan format data yang diperlukan.
- Alamat balasan email kustom. Untuk notifikasi email monetisasi yang dikirim ke perusahaan dan developer, alamat noreply@apigee.com default dikonfigurasi. Anda harus meminta nama dan alamat balasan kustom untuk organisasi Anda.
Tim konfigurasi Apigee menjalankan skrip untuk menyinkronkan monetisasi dengan organisasi Anda serta developer, aplikasi, dan produk API apa pun yang Anda buat menggunakan Apigee Edge. Dukungan Apigee dapat meminta Anda menyinkronkan organisasi di masa mendatang, seperti yang dijelaskan dalam artikel Menyinkronkan data Apigee Edge dengan monetisasi untuk mengetahui detailnya. Jangan sinkronkan data monetisasi kecuali jika diinstruksikan oleh Apigee.
Mengonfigurasi monetisasi
Tabel berikut merangkum langkah-langkah yang diperlukan untuk mengonfigurasi monetisasi untuk organisasi Apigee Anda.Langkah | Deskripsi |
---|---|
Mengedit profil organisasi | Sebagai bagian dari penyiapan awal monetisasi, tim konfigurasi Apigee Edge akan menyiapkan profil organisasi Anda.
Anda perlu mengedit profil organisasi untuk menambahkan atau memperbarui informasi tentang organisasi Anda, sebagaimana mestinya. Misalnya, Anda mungkin perlu memperbarui jenis penagihan, setelan mata uang, atau model pajak. |
Mengelola mata uang yang didukung | Sebagai bagian dari penyiapan awal monetisasi, tim konfigurasi Apigee Edge menentukan mata uang yang didukung oleh organisasi Anda, dan menetapkan mata uang default.
Anda dapat mengambil mata uang yang didukung organisasi dan menambahkan atau menghapus mata uang yang didukung (untuk mencerminkan mata uang yang digunakan oleh developer atau paket tarif). Catatan: Monetisasi otomatis menjalankan tugas harian yang mendapatkan kurs dalam dolar AS untuk setiap mata uang yang didukung. Secara default, tugas berjalan setiap hari pada 1 detik setelah tengah malam. Untuk mengetahui detailnya, lihat Menjadwalkan tugas monetisasi. |
Menentukan persyaratan dan ketentuan | Secara opsional, Anda dapat menambahkan persyaratan dan ketentuan ke profil organisasi sebelum memublikasikan paket tarif. Setelah memublikasikan paket tarif, versi persyaratan dan ketentuan saat ini akan ditampilkan di portal developer. Catatan: Persyaratan dan ketentuan berada di luar profil organisasi Anda. Di profil organisasi, Anda menentukan lokasi (URL publik) persyaratan dan ketentuan. Anda dapat menambahkan beberapa versi persyaratan dan ketentuan untuk mencerminkan perubahan dari waktu ke waktu. |
Menerapkan batas monetisasi | Lampirkan kebijakan MonetizationLimitsCheck ke proxy API untuk menerapkan batas monetisasi. Secara khusus, kebijakan dipicu dalam kondisi berikut:
|
Menyiapkan notifikasi | Konfigurasikan notifikasi untuk memberi tahu developer atau penyedia API tentang peristiwa tertentu, seperti paket tarif yang baru dipublikasikan. |
Memonetisasi API
Saat memonetisasi API, Anda menggabungkan satu atau beberapa produk API ke dalam paket produk API dan menentukan paket tarif terkait.
Paket produk API tidak akan terlihat oleh developer hingga Anda memublikasikan paket tarif untuk paket tersebut (dengan tanggal mulai tanggal saat ini atau tanggal mendatang). Developer dapat mendaftarkan aplikasi mereka untuk menggunakan paket produk API hanya dengan membeli salah satu paket tarif yang saat ini berlaku. Jika paket produk API tidak memiliki paket tarif yang dipublikasikan dan saat ini berlaku, paket tersebut tidak akan dimonetisasi.
Tabel berikut merangkum langkah-langkah yang diperlukan untuk memonetisasi API Anda.
Langkah | Deskripsi |
---|---|
Mengelola paket produk API | Buat paket produk API untuk mengelompokkan produk API Anda. Catatan: Di UI Edge Klasik dan API monetisasi, paket produk disebut sebagai paket API. Untuk menggunakan API guna mengelola paket produk API, lihat: |
Mengonfigurasi kebijakan perekaman transaksi | Konfigurasikan kebijakan perekaman transaksi untuk setiap produk API Anda. Kebijakan perekaman transaksi menentukan hal yang ingin Anda rekam dalam data transaksi untuk produk API, termasuk atribut kustom. Untuk menggunakan API guna mengonfigurasi kebijakan perekaman transaksi, lihat: |
Mengelola dan memublikasikan paket tarif | Buat paket tarif untuk menentukan pendekatan monetisasi API Anda. Misalnya, apakah Anda mengenakan tarif tetap atau variabel untuk penggunaan API. Untuk mengelola paket tarif menggunakan API, lihat: |
Membeli paket tarif yang dipublikasikan | Beli paket tarif yang dipublikasikan, dan akhiri masa berlaku atau batalkan paket tarif yang dibeli, jika diinginkan, menggunakan API. |
Mengonfigurasi monetisasi di portal developer | Konfigurasikan monetisasi di portal developer untuk memberi developer akses mandiri ke langganan paket tarif, pemrosesan dan penagihan pembayaran otomatis, laporan, katalog produk, dan setelan khusus monetisasi lainnya. |
Kelola monetisasi
Setelah mengonfigurasi monetisasi dan memonetisasi API, Anda dapat melakukan satu atau beberapa langkah yang dirangkum dalam tabel berikut:
Langkah | Deskripsi |
---|---|
Mengelola perusahaan dan developer | Mengelola perusahaan dan developer yang menggunakan API Anda. Developer adalah satu entitas, yang diidentifikasi secara unik oleh alamat email. Perusahaan adalah kumpulan developer yang dikelola sebagai satu entitas. |
Membuat laporan | Buat laporan saldo prabayar, pendapatan, dan varian. Untuk developer prabayar, Anda dapat merekonsiliasi laporan saldo prabayar dengan setoran bank. |
Melakukan penyesuaian penagihan | Lakukan penyesuaian penagihan untuk memperbaiki perbedaan dalam data Anda, misalnya. |
Memberikan kredit | Berikan kredit developer, jika diperlukan. Untuk developer prabayar, kredit akan muncul sebagai pengurangan penggunaan yang akan meningkatkan saldo prabayar developer ke depannya. Untuk developer pascabayar, kredit akan muncul sebagai baris terpisah dalam invoice, sehingga mengurangi tagihan dalam invoice. |
Mengelola saldo akun prabayar | Lihat saldo akun prabayar saat ini, dan isi ulang akun prabayar atau dengan menyiapkan pengisian ulang otomatis menggunakan penyedia pembayaran pihak ketiga. |
Mengelola saldo pascabayar menggunakan batas kredit | Saat menambahkan mata uang yang didukung untuk organisasi, Anda dapat menetapkan batas kredit untuk developer pascabayar. Batas kredit berlaku untuk semua developer pascabayar di organisasi. Selain itu, Anda dapat menetapkan batas kredit untuk setiap developer pascabayar. Dalam hal ini, batas kredit akan menggantikan batas yang ditetapkan untuk mata uang hanya untuk developer yang ditentukan. |
Pengembalian dana pasca-pembelian | Memposting pengembalian dana ke developer untuk transaksi pembelian. |
Menjadwalkan tugas monetisasi | Monetisasi menyediakan penjadwal tugas dan serangkaian tugas yang telah dijadwalkan sebelumnya untuk dijalankan pada waktu yang ditentukan. Mengelola jadwal tugas monetisasi menggunakan API. |
Melihat status transaksi | Lihat status transaksi yang terjadi selama rentang waktu yang ditentukan menggunakan API. |
Menyinkronkan data Apigee Edge dengan monetisasi | Jika diminta oleh Apigee, sinkronkan ulang data dengan monetisasi untuk memastikan data tersebut sudah disinkronkan. Anda dapat menyinkronkan hal berikut: organisasi, produk API, developer, dan aplikasi. |
Menghapus data monetisasi dari organisasi | Anda dapat menghapus data monetisasi dari organisasi untuk menghapus organisasi pengujian atau menghapus organisasi. |