Langganan

Langganan dalam permainan memungkinkan Anda menawarkan manfaat berulang kepada pengguna dengan biaya bulanan. Langganan mirip dengan pass, tetapi sementara manfaat dari pass diberikan secara tidak terbatas, manfaat dari langganan tergantung pada pengguna yang membayar biaya bulanan.

Langganan di Roblox memiliki karakteristik berikut:

• Perpanjangan otomatis: Langganan diperpanjang secara otomatis, bukan pembelian satu kali, dan dapat dipatok dalam mata uang lokal atau Robux.
• Pembayaran Robux: Apakah langganan dibeli dalam mata uang lokal atau Robux, Anda menerima pendapatan langganan dalam Robux. Untuk rincian lebih lanjut, lihat Dapatkan penghasilan dengan langganan.
• Tingkat tunggal: Semua langganan dalam sebuah permainan dapat dimiliki oleh pengguna secara simultan. Langganan yang saling eksklusif tidak didukung.
• Penetapan harga regional: Penetapan harga regional diaktifkan secara default untuk langganan yang dijual dalam Robux dan tidak dapat dimatikan. Penetapan harga regional tidak tersedia untuk langganan yang dijual dalam mata uang lokal.

Pedoman langganan

Sebelum membuat langganan Anda, pastikan mereka sesuai dengan Ketentuan Layanan Roblox dan mematuhi hukum setempat. Setiap permainan yang terlibat dalam penipuan, berusaha menyesatkan pengguna dengan penawaran palsu, atau melanggar Standar Komunitas kami, akan dihapus.

Anda juga harus memastikan langganan Anda mengikuti pedoman ini:

• Berikan opsi langganan yang jelas dan dapat dibedakan: Gunakan nama yang singkat, padat, dan mudah dipahami yang membedakan opsi langganan satu sama lain. Tentukan harga dan durasi untuk setiap opsi saat menjual dalam permainan.
• Tawarkan manfaat yang sama di seluruh platform dan perangkat: Terlepas dari tempat langganan dibeli, pastikan pengguna menerima manfaat yang sama untuk setiap rencana langganan tertentu.
• Rancang langganan agar cocok satu sama lain dan dengan penawaran permainan secara keseluruhan: Tingkatkan satu set manfaat yang sama, seperti menawarkan tingkat "Perunggu", "Perak", dan "Emas" yang saling eksklusif, saat ini tidak tersedia. Pastikan langganan mewakili seperangkat manfaat yang berbeda.
• Tawarkan manfaat untuk seluruh jangka waktu langganan: Setelah penawaran langganan aktif, hormati manfaat yang dijelaskan dan jangan mencabut manfaat di belakang layar.
• Jangan mengarahkan pengguna untuk membeli di platform lain (seperti mobile, web, dll.) dalam permainan: Sementara Anda bebas berkomunikasi dengan pengguna di luar platform, menggunakan aplikasi Roblox untuk mengarahkan pengguna membeli di tempat lain adalah dilarang.
• Jangan membatasi manfaat langganan dengan persyaratan tambahan setelah pengguna membayar: Mengharuskan pengguna melakukan tugas tambahan, seperti memposting di media sosial, untuk mendapatkan akses ke manfaat yang telah mereka bayar adalah dilarang. Pedoman ini tidak mempengaruhi battle pass, yang boleh Anda buat dan pasarkan sebagai langganan pembelian.

Robux vs mata uang lokal

Langganan dapat dipatok dalam Robux atau mata uang lokal. Tabel berikut membandingkan dua opsi pembayaran.

Buat langganan

Untuk membuat langganan:

1. Pergi ke permainan Anda di Dasbor Kreator dan pilih Monetisasi ⟩ Langganan.
2. Klik Buat Langganan.
3. Unggah gambar sampul.
4. Masukkan nama yang unik. Anda tidak dapat memiliki dua langganan dengan nama yang sama dalam permainan yang sama.
5. Masukkan deskripsi yang jelas menggambarkan manfaat yang Anda tawarkan.
6. Pilih salah satu dari opsi pembayaran berikut:

   • Pelanggan membayar Robux: Kenakan biaya langganan berulang kepada pengguna dalam Robux. Jika Anda memilih opsi ini, Anda harus memasukkan harga kustom yang lebih besar dari atau sama dengan 49 Robux. Penetapan Harga Regional diaktifkan secara default untuk langganan dan tidak dapat dimatikan.
   • Pelanggan membayar mata uang lokal: Kenakan biaya langganan berulang kepada pengguna dalam mata uang lokal mereka. Jika Anda memilih opsi ini, Anda harus memilih harga langganan dari 5 tingkat harga yang tersedia.
7. Pilih salah satu dari jenis produk berikut:

   • Berkelanjutan: Item permanen yang bertahan setelah digunakan atau diperoleh, seperti item fisik seperti senjata. Jika sebuah langganan mencakup kumpulan barang yang berbeda jenisnya, dengan satu atau lebih barang yang berkelanjutan, seperti paket nilai dengan pedang dan ramuan, pilih Berkelanjutan sebagai jenis produk.
   • Bisa digunakan sekali: Item untuk dibeli kembali yang sementara yang kadaluarsa setelah digunakan atau diperoleh, seperti ramuan yang bisa digunakan yang memberikan dorongan sementara yang kadaluarsa seiring waktu.
   • Mata uang: Bentuk pertukaran apa pun yang dapat digunakan pengguna untuk membeli item dalam permainan Anda.
8. Klik Buat Langganan.

Aktifkan langganan

Anda dapat memiliki hingga 50 langganan per permainan antara langganan aktif dan tidak aktif.

Untuk menjual langganan, klik ⋮ di samping langganan yang ingin Anda aktifkan dan pilih Aktifkan. Langganan aktif otomatis tersedia untuk dijual di tab Toko halaman detail permainan, dan dapat ditambahkan ke permainan Anda melalui fungsi MarketplaceService.

Sebelum mengaktifkan langganan Anda untuk pertama kali, Anda harus mengonfirmasi versi singkat dari nama permainan Anda. Nama permainan yang disingkat ini ditampilkan kepada pengguna ketika mereka berlangganan, dan muncul bersamaan dengan nama langganan yang Anda buat di Buat langganan.

Status langganan

Langganan memiliki dua status yang mungkin:

• Aktif: Langganan aktif tersedia untuk dijual, dengan pelanggan dapat memperbarui langganan mereka pada awal periode berikutnya.
• Tidak Aktif: Langganan tidak aktif tidak tersedia untuk dijual.

Untuk mengubah status langganan, klik ⋯ di sudut kanan atas ubin langganan dan pilih Aktifkan (jika langganan saat ini tidak aktif) atau Hapus dari Penjualan (jika langganan saat ini aktif).

Jika Anda memilih Hapus dari Penjualan, Anda akan diberikan opsi untuk membiarkan pelanggan yang ada memperbarui langganan mereka, atau membatalkan pembaruan di masa mendatang untuk pelanggan saat ini. Jika Anda tidak berencana untuk menghapus manfaat langganan yang terkait secara permanen dari permainan Anda, kami merekomendasikan agar Anda membiarkan pelanggan yang ada memperbarui langganan mereka.

Edit langganan

Bidang yang dapat Anda edit tergantung pada metode pembayaran.

Mengubah metode pembayaran hanya memengaruhi langganan baru. Pelanggan yang ada tetap pada metode pembayaran asli mereka dan harus membatalkan dan mendaftar ulang untuk beralih.

Hapus langganan

Untuk menghapus langganan, klik ⋮ di samping langganan yang ingin Anda hapus dan pilih Hapus.

Menghapus langganan aktif menghasilkan pengembalian dana penuh untuk pelanggan aktif dan nol Robux untuk Anda. Dalam kebanyakan situasi, jika Anda ingin menghapus langganan, kami merekomendasikan agar Anda menghapusnya dari penjualan terlebih dahulu, memilih opsi untuk membatalkan semua pembaruan, dan menunggu periode saat ini berakhir.

Menghapus langganan memerlukan empat digit terakhir dari ID langganan untuk konfirmasi.

Integrasikan langganan ke dalam permainan

Periksa status langganan pengguna

Contoh kode berikut menerapkan deteksi langganan dalam permainan Anda:

-- Jalankan kode ini di server
local MarketplaceService = game:GetService("MarketplaceService")
local Players = game:GetService("Players")

local SUBSCRIPTION_ID = "EXP-11111111" -- Ganti dengan ID langganan Anda

local function grantAward(player: Player)
	-- Anda harus memberikan penghargaan yang terkait dengan langganan di sini
end

local function revokeAwardIfGranted(player: Player)
	-- Metode ini dipanggil untuk setiap pemain yang _tidak_ memiliki langganan
    -- Jika kode Anda menyimpan langganan ke Penyimpanan Data atau memberikan beberapa manfaat yang perlu 'dicabut'
    -- Anda harus menggunakan metode ini untuk menangani pencabutan
end

local function checkSubStatus(player)
	local success, response = pcall(function()
		return MarketplaceService:GetUserSubscriptionStatusAsync(player, SUBSCRIPTION_ID)
	end)

	if not success then
		warn(`Kesalahan saat memeriksa apakah pemain memiliki langganan: {response}`)
		return
	end

	if response.IsSubscribed then
		grantAward(player)
	else
		revokeAwardIfGranted(player)
	end
end

local function onUserSubscriptionStatusChanged(player: Player, subscriptionId: string)
	if subscriptionId == SUBSCRIPTION_ID then
		checkSubStatus(player)
	end
end

Players.PlayerAdded:Connect(checkSubStatus)
Players.UserSubscriptionStatusChanged:Connect(onUserSubscriptionStatusChanged)

Gantikan pass dengan langganan

Salah satu opsi untuk menerapkan langganan dalam permainan Anda adalah menggantikan pass yang ada dengan langganan. Ini adalah opsi yang bagus jika Anda ingin menerapkan langganan dengan cepat tanpa menambahkan fitur atau penghargaan baru.

Saat menggantikan pass dengan langganan, ingatlah yang berikut:

• Pemegang pass yang ada harus terus menerima manfaat yang mereka bayar.
• Pass harus dihapus dari penjualan sehingga pengguna baru dapat membeli langganan sebagai gantinya.
• Langganan dapat dicabut, yang berarti jika pass Anda sebelumnya mempertahankan manfaatnya ke penyimpanan data, Anda perlu "membatalkan" manfaat ini. Pertimbangan ini tidak berlaku untuk semua implementasi pass, tetapi mungkin berlaku untuk yang lebih kompleks.

Contoh kode berikut menggantikan pass dengan langganan:

-- Jalankan kode ini di server
local MarketplaceService = game:GetService("MarketplaceService")
local Players = game:GetService("Players")

local LEGACY_GAME_PASS_ID = 1234 -- Ganti dengan ID pass yang digantikan oleh langganan
local SUBSCRIPTION_ID = "EXP-11111111" -- Ganti dengan ID langganan Anda

local function awardBenefit(player: Player)
	-- Anda harus memberikan manfaat langganan di sini
end

local function revokeBenefitIfGranted(player: Player)
	-- Metode ini dipanggil untuk setiap pemain yang _tidak_ memiliki langganan
    -- Jika kode Anda menyimpan langganan ke Penyimpanan Data atau memberikan beberapa manfaat yang perlu 'dicabut'
    -- Anda harus menggunakan metode ini untuk menangani pencabutan
end

local function checkSubscriptionStatus(player: Player)
	local success, result = pcall(function()
		return MarketplaceService:GetUserSubscriptionStatusAsync(player, SUBSCRIPTION_ID)
	end)

	if not success then
		print(`Kesalahan saat mengambil status langganan: {result}`)
		return
	end

	if result.IsSubscribed then
		awardBenefit(player)
	else
		revokeBenefitIfGranted(player)
	end
end

local function onPlayerAdded(player: Player)
	local success, result = pcall(function()
		return MarketplaceService:UserOwnsGamePassAsync(player.UserId, LEGACY_GAME_PASS_ID)
	end)

	if not success then
		print(`Kesalahan saat mengambil status pass: {result}`)
		return
	end

	if result then
		-- Jika pemain telah membeli pass warisan, kami tidak perlu memeriksa status langganan mereka
		-- karena mereka memiliki manfaat yang diberikan seumur hidup
		awardBenefit(player)
		return
	end

	checkSubscriptionStatus(player)
end

local function onUserSubscriptionStatusChanged(player: Player, subscriptionId: string)
	if subscriptionId == SUBSCRIPTION_ID then
		checkSubscriptionStatus(player)
	end
end


local function onPromptGamePassPurchaseFinished(player: Player, purchasedPassID: number, purchaseSuccess: boolean)
	if purchaseSuccess and purchasedPassID == LEGACY_GAME_PASS_ID then
		awardBenefit(player)
	end
end

Players.PlayerAdded:Connect(onPlayerAdded)
Players.UserSubscriptionStatusChanged:Connect(onUserSubscriptionStatusChanged)
-- Kami akan terus mendengarkan untuk pembelian pass jika pass masih dijual
MarketplaceService.PromptGamePassPurchaseFinished:Connect(onPromptGamePassPurchaseFinished)

Minta pembelian langganan

Pengguna dapat membeli langganan langsung dari tab Toko halaman detail permainan Anda, tetapi Anda juga harus menambahkan cara bagi mereka untuk membeli langganan dalam permainan.

Saat Anda meminta pembelian langganan, UserSubscriptionStatusChanged terpicu jika pemain sudah memiliki langganan, yang membantu menangkap situasi di mana pemain membeli langganan dari tab Toko halaman detail permainan Anda saat mereka sudah dalam permainan.

Meskipun Anda dapat meminta pembelian langganan dari klien, memeriksa apakah pengguna sudah memiliki langganan dengan GetUserSubscriptionStatusAsync harus dilakukan dari server.

Contoh kode berikut membuat RemoteFunction yang dapat digunakan klien untuk meminta status langganan:

--Kode ini harus dijalankan di server
local ReplicatedStorage = game:GetService("ReplicatedStorage")

-- Buat RemoteFunction yang dapat digunakan klien untuk meminta status langganan
local getSubscriptionStatusRemote = Instance.new("RemoteFunction")
getSubscriptionStatusRemote.Name = "GetSubscriptionStatus"
getSubscriptionStatusRemote.Parent = ReplicatedStorage

getSubscriptionStatusRemote.OnServerInvoke = function(player: Player, subscriptionId: string)
	assert(typeof(subscriptionId) == "string")

	return MarketplaceService:GetUserSubscriptionStatusAsync(player, subscriptionId)
end

-- Kode ini harus dijalankan di klien
local MarketplaceService = game:GetService("MarketplaceService")
local Players = game:GetService("Players")

local SUBSCRIPTION_ID = "EXP-11111111" -- Ganti dengan ID langganan Anda

local getSubscriptionStatusRemote = ReplicatedStorage:WaitForChild("GetSubscriptionStatus")
local purchaseSubscriptionButton = script.Parent.PromptPurchaseSubscription -- Ganti dengan tombol Anda


local function playerHasSubscription()
    -- Catatan jika langganan Anda menggantikan pass, Anda juga perlu memeriksa apakah pass dimiliki di sini

	local success, result = pcall(function()
		return getSubscriptionStatusRemote:InvokeServer(SUBSCRIPTION_ID)
	end)

	if not success then
		print(`Kesalahan saat mengambil status langganan: {result}`)
		return
	end

    return result.IsSubscribed
end

-- Sembunyikan tombol jika pemain sudah memiliki langganan
local function hideButtonIfPlayerHasSubscription()
    if playerHasSubscription() then
        purchaseSubscriptionButton.Visible = false
    end
end

local function onPromptSubscriptionPurchaseFinished(player: Player, subscriptionId: string, didTryPurchasing: boolean)
    if didTryPurchasing then
        -- Mungkin perlu beberapa waktu agar langganan terdaftar, jadi kami akan memeriksa apakah pembelian berhasil dalam 10 detik
        -- dan menyembunyikan tombol jika sudah
        task.delay(10, hideButtonIfPlayerHasSubscription)
    end
end

-- Jika pemain sudah memiliki langganan, kami tidak ingin menampilkan tombol sama sekali
hideButtonIfPlayerHasSubscription()

purchaseSubscriptionButton.Activated:Connect(function()
    MarketplaceService:PromptSubscriptionPurchase(Players.LocalPlayer, SUBSCRIPTION_ID)

    -- Jika pemain sudah memiliki langganan, sembunyikan tombol
    hideButtonIfPlayerHasSubscription()
end)

MarketplaceService.PromptSubscriptionPurchaseFinished:Connect(onPromptSubscriptionPurchaseFinished)

Fungsi relevan lainnya

Fungsi relevan lainnya yang tersedia di MarketplaceService adalah:

• GetSubscriptionProductInfoAsync, yang mengembalikan informasi produk dari sebuah langganan. Termasuk apakah langganan dipatok dalam Robux atau mata uang lokal.
• GetUserSubscriptionPaymentHistoryAsync, yang mengembalikan riwayat pembayaran langganan pengguna.
• GetUserSubscriptionStatusAsync, yang mengembalikan status langganan pengguna.

Dapatkan penghasilan dengan langganan

Untuk langganan yang dipatok dalam mata uang lokal, Anda mendapatkan Robux dengan tarif USD $0.01 hingga 1 Robux sesuai dengan harga platform dasar yang Anda pilih, setelah biaya platform. Anda mendapatkan 70% dari nilai langganan di bulan pertama, dan 100% mulai bulan kedua dan seterusnya. Pembagian pendapatan ini konsisten di semua platform.

Sebagai contoh, jika langganan bulanan Anda dipatok seharga USD $5:

• Bulan pertama: Anda mendapatkan 350 Robux (500 * 0.7 = 350)
• Bulan kedua dan seterusnya: Anda mendapatkan seluruh jumlah 500 Robux (500 * 1.0 = 500)

Untuk langganan yang dipatok dalam Robux, Anda mendapatkan 70% dari nilai langganan setiap bulan. Pembagian pendapatan ini konsisten di semua platform.

Sebagai contoh, jika langganan bulanan Anda dipatok seharga 500 Robux:

• Bulan pertama: Anda mendapatkan 350 Robux (500 * 0.7 = 350)
• Bulan kedua dan seterusnya: Anda terus mendapatkan 350 Robux (500 * 0.7 = 350)

Pendapatan dari langganan dalam mata uang lokal tunduk pada periode penahanan 30 hari dan akan ditambahkan ke saldo Robux Anda setelah seluruh masa langganan telah disampaikan.

Pendapatan dari langganan dalam Robux mengikuti periode penahanan yang sama dengan pass dan produk pengembang, yaitu sekitar 5 hari.

Pengembalian dana

Untuk langganan dalam mata uang lokal, jika pengguna meminta pengembalian dana melalui bank atau toko aplikasi mereka dalam periode penahanan 30 hari, penahanan akan dibatalkan dan Anda tidak akan menerima pembayaran untuk transaksi tersebut.

Pengembalian dana yang diterima di luar jendela penahanan akan mengakibatkan jumlah pembayaran untuk transaksi yang dikembalikan dikurangi dari saldo Robux Anda. Jika permainan Anda dimiliki oleh Grub dan saldo Grub kurang dari jumlah yang harus dikurangi, sisa akan dikurangi dari saldo Robux Pemilik Grub.

Ketika pengguna membatalkan atau gagal memperbarui langganan aktif mereka, mereka tidak secara otomatis menerima pengembalian dana. Mereka harus meminta pengembalian dana secara manual, yang ditangani secara kasus per kasus. Untuk informasi lebih lanjut tentang proses pengembalian dana langganan pengguna, lihat pusat bantuan.

Pembayaran

Anda dapat menemukan pembayaran langganan Anda di Saldo Robux ⟩ Transaksi Saya.

Pembayaran Langganan dan Langganan Grup muncul di bawah Robux Masuk, sementara pengembalian dana dikelompokkan di bawah Robux Keluar sebagai Pembalikan Pembayaran. Subhalaman untuk langganan dan langganan grup menyediakan informasi tambahan untuk kategori masing-masing.

Untuk melihat informasi pengembalian dana untuk pengguna individu, gunakan GetUserSubscriptionPaymentHistoryAsync.

Analitik langganan

Analitik langganan membantu Anda mengukur keberhasilan langganan individu, mengidentifikasi tren, dan meramalkan potensi pendapatan di masa depan. Langganan ditambahkan ke halaman analitik langganan setelah pertama kali diaktifkan dan tidak dihapus saat dinonaktifkan atau dihapus. Anda dapat mengakses analitik siap pakai melalui Dasbor Kreator, atau Anda dapat menangkap pembaruan langganan secara real-time menggunakan webhook.

Melalui Dasbor Kreator

Untuk mengakses analitik langganan di Dasbor Kreator:

1. Pergi ke halaman Kreasi Anda di Dasbor Kreator dan pilih permainan Anda.
2. Pergi ke Monetisasi ⟩ Langganan.
3. Pilih tab Analitik.

Analitik langganan melacak metrik berikut:

• Langganan: Jumlah total langganan aktif dalam permainan Anda.
• Pendapatan yang diperkirakan: Pendapatan bersih yang diperoleh oleh permainan setelah biaya. Tidak termasuk informasi pengembalian dana.
• Rincian pelanggan: Berbagai jenis pelanggan.

  • Baru: Jumlah pembelian langganan oleh pelanggan baru.
  • Diperbarui: Jumlah langganan yang diperbarui yang dibeli di periode sebelumnya.
  • Dihidupkan kembali: Jumlah langganan baru yang dibeli oleh pengguna yang sebelumnya membatalkan.
• Pembatalan: Jumlah langganan yang tidak diperbarui. Ini mencakup semua pembatalan terlepas dari pemicu, baik itu pembatalan oleh pengguna, dinonaktifkannya langganan oleh kreator, atau dengan cara lain.

  • Pembatalan berbeda dari pengembalian dana. Langganan yang dibatalkan adalah langganan yang tidak akan diperbarui tetapi telah dibayar penuh untuk sisa siklus penagihan, sementara pengembalian dana mengembalikan jumlah langganan yang dibayar kepada pengguna.
• Langganan berdasarkan platform: Jumlah langganan yang dibeli di setiap platform.
• Pendapatan platform: Pendapatan bersih yang diperoleh melalui langganan yang dibeli di setiap platform.

Informasi ini terlihat dalam bentuk grafik berdasarkan jangkauan tanggal di bawah tab Tren, dan sebagai daftar komprehensif dari total langganan yang ditawarkan di bawah tab Riwayat.

Melalui webhook

Fitur Webhook API Cloud mencakup pemicu untuk empat peristiwa langganan: dibatalkan, dibeli, dikembalikan, dan diperbarui. Pemberitahuan ini dipicu secara langsung, sehingga Anda dapat merespons secara real time atau membuat analitik kustom Anda sendiri. Untuk informasi lebih lanjut tentang cara mengatur webhook, lihat Pemberitahuan webhook.