Singkatnya: agensi cukup mendaftar sekali dengan nama resminya sendiri, lalu beriklan untuk kliennya dengan memasukkan nama setiap klien di Nama tampilan bagi anggota. Agensi yang membayar, memegang saldo, dan menerima faktur. Pengembang dapat membuat dan mengelola Promo dan Acara melalui REST API Agilis (https://ads.agilis.dating) dengan kunci API dari Portal Iklan; kunci uji gratis dan tidak pernah ditampilkan kepada anggota.
Untuk agensi
- Daftarkan agensi dengan nama resminya sendiri. → Cara mendaftar
- Saat membuat Promo atau Acara, masukkan nama klien Anda di Nama tampilan bagi anggota. Anggota akan melihat nama klien, bukan nama Anda.
- Anda harus mendapat wewenang dari setiap klien untuk beriklan atas nama mereka. Ketentuan Periklanan menetapkan bahwa agensi bertanggung jawab atas hal ini.
Siapa yang membayar dan siapa yang menerima faktur
- Pembayaran dilakukan dari akun agensi Anda, dalam mata uang penagihan agensi Anda.
- Setiap orang di agensi Anda memiliki saldo sendiri dan membayar dari saldo tersebut. Saldo organisasi adalah totalnya. → Cara kerja saldo
- Faktur dan hasil diterbitkan atas nama agensi Anda, satu faktur untuk setiap pembayaran, sehingga Anda dapat menagihkannya kembali kepada setiap klien.
- Agar pengeluaran setiap klien tetap terpisah, gunakan satu Promo atau Acara per klien dan tagihkan kembali berdasarkan fakturnya.
Peran tim
Admin Organisasi dan Pengiklan bekerja di Portal Iklan; Pengembang bekerja melalui API. Pengembang tidak dapat membuat Promo atau Acara di Portal Iklan, tetapi dengan kunci API mereka, mereka dapat membuat, menerbitkan, dan membayarnya melalui API, dan bisnis Anda bertanggung jawab atas penggunaan kuncinya. Tabel lengkapnya ada di Peran dan izin tim.
REST API Agilis
- URL dasar: https://ads.agilis.dating
- Referensi: www.agilis.dating/api-doc, dengan contoh dalam cURL, Python, Node.js, dan PHP, serta asisten API
- Format yang dapat dibaca mesin: OpenAPI 3.1 di www.agilis.dating/openapi.json, Markdown di www.agilis.dating/api-doc.md, dan teks lengkap untuk alat AI di www.agilis.dating/llms-full.txt
- Promo: tampilkan daftar kategori dan minat Anda; hitung harga Promo sebelum membuatnya; buat, tampilkan daftar, jeda, lanjutkan, dan hapus Promo; baca hasil setiap Promo
- Acara: pratinjau, terbitkan, tampilkan daftar, edit, jadwalkan ulang, batalkan, dan hapus Acara; baca hasil setiap Acara
Dapatkan kunci API
- Masuk ke Portal Iklan sebagai Admin Organisasi atau Pengembang.
- Pilih Mode Uji atau Mode Tayang dengan tombol di bagian atas halaman.
- Buka Kunci API → Buat Kunci Baru, beri nama dan, jika mau, tanggal kedaluwarsa.
- Segera salin kuncinya. Anda tidak akan dapat melihatnya lagi.
Kunci uji diawali pk_test_; kunci tayang diawali pk_live_. Setiap orang dapat memiliki hingga 10 kunci di setiap mode. Ganti kunci langsung menggantikan kunci, jadi perbarui sistem Anda terlebih dahulu. Kirim kunci di header permintaan x-api-key: x-api-key: pk_test_….
Membangun dengan aman
- Bangun dan uji dengan kunci
pk_test_: Promo dan Acara uji gratis dan tidak pernah ditampilkan kepada anggota. - Hitung harga Promo dengan endpoint perkiraan harga sebelum membuatnya.
- Jangan simpan kunci di repositori kode atau browser; panggil API dari server Anda.
Pertanyaan
Bisakah agensi mengelola beberapa klien dari satu akun?
Bisa. Daftarkan agensi sekali saja dan cantumkan nama klien pada setiap Promo atau Acara.
Bisakah setiap klien mendapat faktur sendiri?
Faktur diterbitkan untuk agensi Anda, satu untuk setiap pembayaran. Tagihkan kembali kepada klien Anda berdasarkan faktur tersebut.
Apakah tersedia lingkungan uji (sandbox)?
Ya. Mode Uji, dengan kunci pk_test_, adalah sandbox lengkap. Tidak ada biaya yang ditagihkan dan tidak ada yang ditampilkan kepada anggota.
Bisakah saya menghubungkan alat AI untuk coding?
Bisa. Arahkan alat Anda ke www.agilis.dating/api-doc.md atau www.agilis.dating/openapi.json.
