Paket dan add-on

Tingkat paket Listings dan Social, cakupan masing-masing, harga tiap add-on, cara kerja prorata, dan batas pertumbuhan akun layanan mandiri.

Listings API menjual dua produk. Listings mengelola lokasi bisnis dan keberadaannya di direktori. Social mengelola merek dan memublikasikan konten ke akun media sosial mereka. Keduanya memiliki harga, tagihan, dan batas masing-masing.

Listings

Harga tingkat paket Listings ditentukan berdasarkan jumlah lokasi yang boleh Anda miliki.

Setiap lokasi dalam paket mendapatkan akses ke seluruh jaringan direktori, pengelolaan ulasan, postingan, dan analitik. Tingkat paket menentukan jumlah lokasi yang boleh Anda miliki dan kuota permintaan Anda, bukan endpoint yang dapat Anda panggil.

Social

Harga tingkat paket Social ditentukan berdasarkan jumlah koneksi yang boleh Anda miliki. Satu koneksi adalah satu akun media sosial — Halaman Facebook, akun Instagram Business, akun X, organisasi LinkedIn, atau papan Pinterest — yang ditautkan ke satu merek di satu jaringan melalui tautan koneksi.

Jumlah merek tidak dibatasi dan tidak dihitung sebagai penggunaan pada semua tingkat paket. Merek hanyalah wadah yang menaungi akun terhubung dan postingan yang dipublikasikan dari akun tersebut; pembuatan merek tidak dikenai biaya dan tidak pernah ditolak karena batas jumlah. POST /social/brands tidak memiliki batas jumlah merek pada paket API.

Yang Anda beli adalah koneksi. Dengan lima jaringan yang didukung, satu merek yang terhubung ke semuanya menggunakan lima koneksi, sehingga 20 koneksi setara dengan sekitar empat merek yang terhubung ke semua jaringan, dan 125 koneksi setara dengan sekitar dua puluh lima merek — tetapi pembagian tersebut tidak diwajibkan. Anda dapat membagi 125 koneksi ke enam puluh merek yang masing-masing terhubung ke dua jaringan, atau memusatkannya pada beberapa merek saja.

Add-on

Harga add-on dipublikasikan dan add-on dapat dibeli kapan saja tanpa berpindah tingkat paket.

Paket koneksi dapat diakumulasi. Pembeliannya berdasarkan jumlah paket, sehingga dua paket berharga $50/bulan untuk 10 koneksi tambahan, tiga paket berharga $75/bulan untuk 15 koneksi tambahan, dan seterusnya. Tidak ada add-on per merek dan tidak ada cara untuk membeli satu koneksi saja: satuan pembeliannya adalah lima koneksi. Paket tidak terikat pada jenis tertentu: paket menambahkan lima koneksi ke kapasitas bersama, dan Anda menentukan jaringan serta merek yang akan menggunakannya.

Koneksi merupakan kumpulan kapasitas bersama untuk seluruh akun

Koneksi tidak dialokasikan per merek. Tingkat paket dan paket tambahan Anda digabungkan menjadi satu kumpulan kapasitas untuk seluruh akun yang dapat digunakan oleh merek mana pun:

maxConnections = tier connections + (5 × connection packs)

Pada Social Growth dengan dua paket tambahan, sebuah akun memiliki 125 + 10 = 135 koneksi yang tersedia, dan satu merek dapat menggunakan 12 di antaranya sementara merek lain menggunakan 1. Tidak ada batas koneksi per merek — hanya kapasitas bersama tersebut.

Slot terpakai selama seluruh periode penagihan, bukan hanya selama koneksinya terhubung. Penggunaan kapasitas bersama dihitung berdasarkan koneksi berbeda yang telah digunakan akun selama periode berjalan, sehingga memutuskan koneksi suatu kanal langsung menonaktifkannya, tetapi slotnya tetap terpakai hingga periode diperbarui. Aturan ini sama dengan aturan untuk setiap pengurangan lain pada akun — lihat Prorata — dan berarti kapasitas bersama tidak dapat digunakan ulang dalam satu siklus: hubungkan 20 koneksi, putuskan semuanya, dan penggunaan Anda tetap dihitung 20 hingga perpanjangan.

Ada dua konsekuensi dari aturan ini. Menghubungkan kembali akun media sosial yang sama ke merek yang sama tidak dikenakan biaya, karena tindakan ini menggunakan kembali slot yang sudah dimiliki akun tersebut pada merek itu. Satu slot dimiliki oleh satu pasangan merek dan akun, sehingga menghubungkan akun yang sama ke merek yang berbeda menggunakan slot kedua, dan slot pertama tetap terpakai hingga siklus berganti. Selain itu, membeli paket tambahan adalah satu-satunya cara untuk menambah kapasitas di tengah periode, karena biaya add-on langsung ditagihkan dan kapasitasnya langsung diberikan, sedangkan slot yang dilepas harus menunggu hingga siklus berganti.

GET /social/limits melaporkan gambaran lengkapnya:

Sisa kapasitas adalah maxConnections - usage.connections. Jika kapasitas bersama habis, tautan koneksi mengembalikan SY95042 — itulah sebabnya pengembang yang baru saja memutuskan koneksi beberapa akun masih dapat ditolak. Pembuatan merek tidak mengalami kegagalan serupa pada paket API.

Batas layanan mandiri

Dua batas maksimum mutlak berlaku, berapa pun jumlah add-on yang dibeli:

• 100 lokasi pada akun Listings layanan mandiri.
• 250 koneksi pada akun Social layanan mandiri.

Tidak ada batas maksimum jumlah merek: jumlah merek tidak terbatas, dan sebuah akun dapat memiliki sebanyak apa pun merek selama koneksi yang digunakan merek-merek tersebut tetap berada dalam kapasitas bersama.

Untuk melampaui salah satu batas maksimum tersebut, akun harus beralih ke Enterprise, yang batas kapasitasnya dinegosiasikan — hubungi tim penjualan alih-alih membeli lebih banyak paket tambahan. Akun yang sama sekali tidak memiliki paket Listings tidak dapat membuat lokasi dan menerima SY10155; kondisi yang setara untuk Social adalah tidak memiliki langganan Social, yang menyebabkan setiap endpoint /social/* tidak tersedia.

Menambahkan produk kedua

Akun yang memiliki satu produk dapat membeli produk lainnya melalui dasbor, tanpa berbicara dengan tim penjualan dan tanpa membuat akun baru. Setiap produk tetap memiliki langganan, tanggal perpanjangan, dan pembatalannya sendiri, persis seperti jika Anda membelinya secara terpisah.

Setiap produk memiliki uji coba gratisnya sendiri. Tingkat Launch untuk produk yang belum pernah Anda miliki dimulai dengan 14 hari gratis, meskipun Anda sudah menjadi pelanggan berbayar untuk produk lainnya. Pelanggan Listings Growth yang menambahkan Social Launch mendapatkan 14 hari uji coba tersendiri untuk Social dengan tanggal perpanjangannya sendiri, dan penagihan Listings mereka berlanjut tanpa perubahan. Hal yang sama berlaku sebaliknya bagi pelanggan Social yang menambahkan Listings Launch.

Semua tingkat di atas Launch ditagihkan pada hari Anda membelinya, dan cakupan Enterprise untuk kedua produk ditentukan bersama kami, bukan dijual melalui layanan mandiri.

Uji coba hanya berlaku sekali per produk. Jika Anda sudah pernah mencoba suatu produk, pembelian produk itu kembali langsung dikenakan biaya — tidak ada periode gratis kedua untuk produk yang sama. Membeli add-on saat langganan masih dalam masa uji coba akan mengakhiri uji coba tersebut dan memulai penagihan berbayar, yang dikonfirmasikan melalui dasbor sebelum hal itu terjadi.

Prorata

Biaya add-on langsung ditagihkan. Pembelian lokasi tambahan atau paket koneksi langsung berlaku dan ditagihkan saat itu juga, dengan biaya yang dihitung secara prorata untuk sisa siklus penagihan saat ini. Anda tidak perlu menunggu pergantian siklus untuk menggunakan kapasitas yang baru saja Anda beli.

Pengurangan berlaku pada akhir siklus penagihan. Tidak ada pengembalian dana untuk sisa periode atas apa pun yang Anda lepaskan, dan tidak ada kapasitas yang dibebaskan dari apa pun yang Anda lepaskan sebelum siklus berakhir. Aturan ini berlaku untuk semua pengurangan pada kedua produk:

Jadi, slot koneksi yang dilepaskan berperilaku persis seperti add-on yang dibatalkan: dampaknya berlaku pada akhir periode, bukan saat pemanggilan API. Selama Anda menunggu, slot tersebut dilaporkan sebagai usage.connectionsReleased pada GET /social/limits, yang menunjukkan perkiraan kapasitas yang akan kembali tersedia bagi Anda.

Perbedaan perlakuan ini disengaja: Anda selalu dapat menambah kapasitas saat itu juga dan membayar tepat sesuai penggunaan, serta tidak pernah kehilangan kapasitas yang sudah Anda bayar—ataupun menggunakannya kembali dua kali dalam periode yang sama.

Aturan usia minimum 90 hari

Lokasi atau merek harus berusia setidaknya 90 hari sebelum dapat diarsipkan. Baik POST /locations/archive maupun POST /social/brands/archive menerapkan aturan ini; endpoint merek melaporkannya sebagai status: "TENURE_NOT_MET" dengan SY95051.

Aturan ini ada karena pengarsipan merupakan cara untuk mengurangi kapasitas langganan, dan tanpa aturan ini, sumber daya yang dibuat dan diarsipkan dalam satu siklus tidak akan dikenai biaya. Ada satu konsekuensi praktis yang perlu Anda pertimbangkan dalam perancangan: merek atau lokasi yang dibuat secara tidak sengaja tidak dapat dihapus selama 90 hari. Lakukan validasi sebelum membuatnya.

Setelah usia minimum terpenuhi, proses selanjutnya berbeda menurut produk:

• Merek langsung diarsipkan, tetapi slot koneksinya tidak langsung kembali tersedia. Merek dan setiap koneksi yang tertaut dengannya diarsipkan dalam permintaan yang sama dan langsung nonaktif; setiap slot tersebut kemudian ditahan hingga akhir siklus penagihan, persis seperti ketika koneksi diputus secara langsung. GET /social/limits menunjukkan penurunan pada usage.connectionsActive dan kenaikan yang sesuai pada usage.connectionsReleased saat pembacaan berikutnya, sementara usage.connections yang ditagihkan tetap tidak berubah hingga perpanjangan. Pengarsipan itu sendiri tidak memiliki status terjadwal dan tidak ada yang dapat dibatalkan.
• Pengarsipan lokasi dijadwalkan pada akhir siklus penagihan. Lokasi tetap aktif dan terus diperhitungkan dalam batas Listings Anda hingga siklus berakhir, dan keputusan tersebut dapat dibatalkan hingga saat itu melalui batalkan pengarsipan lokasi.

Melihat batas Anda sendiri

Periksa batas yang relevan sebelum melakukan pembuatan, bukan setelah terjadi kegagalan: dengan begitu, Anda dapat menunjukkan opsi peningkatan paket kepada pelanggan, alih-alih kode kesalahan.