Produk Pengembang

*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

Sebuah produk pengembang adalah item atau kemampuan yang dapat dibeli pengguna lebih dari sekali, seperti mata uang dalam permainan, amunisi, atau ramuan.

Buat produk pengembang

Untuk membuat produk pengembang:

  1. Pergi ke Kreasi dan pilih sebuah permainan.
  2. Pergi ke Monetisasi ⟩ Produk Pengembang.
  3. Klik Buat produk pengembang.
  4. Unggah gambar untuk ditampilkan sebagai ikon produk. Pastikan gambar tidak melebihi 512x512 piksel, tidak menyertakan detail penting di luar batas lingkarannya, dan dalam format .jpg, .png, atau .bmp.
  5. Masukkan nama dan deskripsi untuk produk tersebut.
  6. Pilih kategori untuk produk tersebut. Kategori digunakan untuk mengorganisir item di Toko dalam permainan Anda.
  7. Atur harga produk dalam Robux. Harga minimum adalah 1 Robux, dan harga maksimum adalah 1 miliar Robux.
  8. Klik Simpan Perubahan.

Dapatkan ID produk pengembang

Untuk menggunakan skrip, Anda memerlukan ID produk pengembang. Untuk mendapatkan ID produk:

  1. Pergi ke Monetisasi ⟩ Produk Pengembang.

  2. Arahkan kursor ke thumbnail produk, klik tombol ⋯ dan pilih Salin ID Aset dari menu konteks.

Jual produk pengembang

Sebelum menjual produk pengembang, pastikan Anda memproses tanda terima penjualan dengan benar dan memberikan produk yang dibeli kepada pengguna. Untuk melakukannya, Anda harus:

  • Menggunakan API ProcessReceipt untuk memeriksa tanda terima pembelian. ProcessReceipt secara otomatis membaca dan mengakui bahwa pengguna telah membeli produk di luar permainan.
  • Memvalidasi setiap tanda terima untuk User ID, Developer Product ID, dan status tanda terima.
  • Jika tanda terima memiliki status Terbuka, berikan kepada pengguna item pengembang yang telah mereka beli.
  • Tanggapi API ProcessReceipt dengan pesan yang mengakui tanda terima dan memvalidasi bahwa item yang dibeli telah diberikan.

Anda dapat menjual produk pengembang dengan dua cara:

Di dalam permainan Anda

Untuk menerapkan dan menjual produk pengembang di dalam permainan, panggil fungsi MarketplaceService.

Gunakan GetProductInfo untuk mengambil informasi tentang produk pengembang, seperti nama dan harga, dan kemudian menampilkan produk tersebut kepada pengguna. Anda dapat menjual produk di dalam pasar permainan Anda, misalnya. Untuk produk pengembang, parameter kedua harus Enum.InfoType.Product.

local MarketplaceService = game:GetService("MarketplaceService")
-- Ganti ID placeholder dengan ID produk pengembang Anda
local productId = 000000
local success, productInfo = pcall(function()
return MarketplaceService:GetProductInfo(productId, Enum.InfoType.Product)
end)
if success and productInfo then
-- Tampilkan informasi produk
-- Ganti pernyataan print dengan kode UI untuk menampilkan produk
print("Nama Produk Pengembang: " .. productInfo.Name)
print("Harga dalam Robux: " .. productInfo.PriceInRobux)
print("Deskripsi: " .. productInfo.Description)
end

Gunakan GetDeveloperProductsAsync untuk mengambil semua produk pengembang yang terkait dengan permainan Anda. Fungsi ini mengembalikan objek Pages yang dapat Anda periksa dan filter untuk membangun hal-hal seperti toko dalam permainan atau GUI daftar produk.

local MarketplaceService = game:GetService("MarketplaceService")
local success, developerProducts = pcall(function()
return MarketplaceService:GetDeveloperProductsAsync()
end)
if success and developerProducts then
local firstPage = developerProducts:GetCurrentPage()
for _, developerProduct in firstPage do
-- Ganti pernyataan print dengan kode UI untuk menampilkan produk
print(field .. ": " .. value)
end
end

Gunakan PromptProductPurchase untuk meminta pembelian produk di dalam permainan Anda. Anda dapat memanggil fungsi ini ketika pengguna melakukan tindakan seperti menekan tombol atau berbicara dengan NPC vendor.

local MarketplaceService = game:GetService("MarketplaceService")
local Players = game:GetService("Players")
local player = Players.LocalPlayer
-- Ganti ID placeholder dengan ID produk pengembang Anda
local productId = 000000
local function promptProductPurchase()
local success, errorMessage = pcall(function()
MarketplaceService:PromptProductPurchase(player, productId)
end)
if success then
print("Prompt pembelian ditampilkan dengan sukses")
end
end

Anda juga dapat menggabungkan fungsi di dalam LocalScript. Misalnya, Anda dapat membuat elemen UI seperti tombol atau NPC vendor, kemudian menggunakan GetProductInfo() untuk menghubungkan produk pengembang yang ada ke elemen tersebut, memeriksa apakah produk tersebut untuk dijual, dan menggunakan PromptProductPurchase() untuk meminta pembelian setiap kali pengguna mengkliknya.

local MarketplaceService = game:GetService("MarketplaceService")
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local button = script.Parent
-- Ganti ID placeholder dengan ID produk pengembang Anda
local productId = 000000
-- Mengambil informasi produk ketika pengguna mengklik tombol UI
button.MouseButton1Click:Connect(function()
local success, productInfo = pcall(function()
return MarketplaceService:GetProductInfo(productId, Enum.InfoType.Product)
end)
if success and productInfo then
-- Memeriksa apakah produk untuk dijual
if productInfo.IsForSale then
print("Ini untuk dijual")
-- Meminta pembelian produk
MarketplaceService:PromptProductPurchase(player, productId)
else
-- Memberitahu bahwa produk tidak untuk dijual
print("Produk ini tidak tersedia untuk dijual saat ini.")
end
else
print("Kesalahan mengambil informasi produk: " .. tostring(productInfo))
end
end)

Di luar permainan Anda

Untuk mengaktifkan pembelian produk pengembang di luar permainan Anda, Anda harus bekerja dengan API ProcessReceipt. Setelah pengguna melakukan pembelian di tab Toko dari halaman detail permainan Anda, Anda harus menggunakan ProcessReceipt untuk mengonfirmasi pembelian mereka dan memberikan item mereka setelah mereka memasuki permainan Anda.

Aktifkan penjualan eksternal

Roblox menampilkan produk pengembang dan game pass Anda yang Terdaftar di luar permainan Anda, termasuk di beranda Roblox, dalam hasil pencarian, dan di halaman pasca-pembelian setelah pemain membeli Robux. Seorang pemain dapat membeli item Anda dan kemudian bergabung dengan permainan Anda dengan item tersebut sudah diberikan.

Untuk membuat produk pengembang memenuhi syarat untuk penjualan eksternal:

  1. Di Creator Hub, pergi ke Monetisasi ⟩ Toko.
  2. Tandai produk pengembang sebagai Terdaftar.
  3. Konfirmasi bahwa Anda telah menerapkan ProcessReceipt dengan benar untuk produk tersebut.

Game pass tidak memerlukan perbaikan ProcessReceipt, tetapi mereka juga harus Terdaftar untuk muncul di luar permainan Anda. Kami sarankan menambahkan ikon kustom untuk setiap produk pengembang sehingga pemain dapat mengenalinya di permukaan eksternal; jika Anda tidak menambahkannya, Roblox akan menampilkan ikon default.

Untuk informasi lebih lanjut tentang API ProcessReceipt dan implementasinya, lihat halaman ProcessReceipt.

Perbaiki produk pengembang yang ditandai

Jika Roblox mendeteksi masalah ProcessReceipt dengan salah satu produk pengembang Terdaftar Anda, sebuah spanduk akan muncul di Creator Hub ⟩ Monetisasi ⟩ Toko yang mengarah ke laporan produk yang terpengaruh. Jika tidak ada produk pengembang Anda yang memerlukan perbaikan, tidak akan ada spanduk atau laporan yang muncul.

Untuk menyelesaikan produk pengembang yang ditandai:

  1. Buka laporan dari spanduk. Laporan tersebut mencantumkan setiap produk pengembang Terdaftar yang memerlukan perbaikan ProcessReceipt, bersama dengan nama produk dan ID produk.
  2. Buka permainan Anda di Roblox Studio dan perbaiki implementasi ProcessReceipt untuk produk yang ditandai.
  3. Publikasikan permainan Anda.
  4. Di laporan, pilih produk yang telah diperbaiki dan klik Tandai sebagai diperbaiki.

Produk yang telah diperbaiki akan keluar dari laporan dan menjadi memenuhi syarat untuk muncul di luar permainan Anda lagi.

Batasan

  • Untuk dijual di luar permainan Anda, produk pengembang harus Terdaftar dan memiliki ProcessReceipt yang diterapkan dengan benar.
  • Produk pengembang yang tidak terdaftar tidak pernah muncul di Toko atau di luar permainan Anda.
  • Menjual produk pengembang di luar permainan Anda tidak mengubah pendapatan standar atau penanganan pembelian Anda.

Pertanyaan yang Sering Diajukan

Anda hanya akan melihat spanduk jika Roblox mendeteksi produk pengembang Terdaftar yang memerlukan perbaikan ProcessReceipt. Jika Anda tidak melihat spanduk, tidak ada tindakan yang diperlukan.

Tidak. Laporan ProcessReceipt hanya berlaku untuk produk pengembang. Baik produk pengembang yang Terdaftar maupun game pass dapat ditampilkan dan dijual di luar permainan Anda.

Tidak. Penjualan eksternal memberikan pemain tempat tambahan untuk menemukan dan membeli item Anda. Penanganan pembelian dan pendapatan standar Anda tidak berubah.

Tangani pembelian produk pengembang

Setelah pengguna membeli produk pengembang, Anda harus menangani dan mencatat transaksi tersebut. Untuk melakukan ini, gunakan Script di dalam ServerScriptService menggunakan fungsi ProcessReceipt.

Untuk informasi lebih lanjut tentang API ProcessReceipt dan implementasinya, lihat halaman ProcessReceipt.

local MarketplaceService = game:GetService("MarketplaceService")
local Players = game:GetService("Players")
local productFunctions = {}
-- Contoh: ID produk 123123 mengembalikan pengguna ke kesehatan penuh
productFunctions[123123] = function(receipt, player)
local character = player.Character
local humanoid = character and character:FindFirstChildWhichIsA("Humanoid")
if humanoid then
humanoid.Health = humanoid.MaxHealth
-- Menunjukkan pembelian berhasil
return true
end
end
-- Contoh: ID produk 456456 memberikan 100 koin emas kepada pengguna
productFunctions[456456] = function(receipt, player)
local leaderstats = player:FindFirstChild("leaderstats")
local gold = leaderstats and leaderstats:FindFirstChild("Gold")
if gold then
gold.Value += 100
return true
end
end
local function processReceipt(receiptInfo)
local userId = receiptInfo.PlayerId
local productId = receiptInfo.ProductId
local player = Players:GetPlayerByUserId(userId)
if player then
-- Mengambil fungsi penangan yang terkait dengan ID produk pengembang dan mencoba menjalankannya
local handler = productFunctions[productId]
local success, result = pcall(handler, receiptInfo, player)
if success then
-- Pengguna telah menerima item mereka
-- Mengembalikan "PurchaseGranted" untuk mengonfirmasi transaksi
return Enum.ProductPurchaseDecision.PurchaseGranted
else
warn("Gagal memproses tanda terima:", receiptInfo, result)
end
end
-- Item pengguna tidak dapat diberikan
-- Mengembalikan "NotProcessedYet" dan mencoba lagi lain kali pengguna bergabung dengan permainan
return Enum.ProductPurchaseDecision.NotProcessedYet
end
-- Mengatur callback
-- Ini hanya dapat dilakukan sekali oleh satu skrip sisi server
MarketplaceService.ProcessReceipt = processReceipt

Personalisasi toko dalam permainan Anda

Anda dapat menggunakan API kecerdasan produk untuk mengurutkan dan merekomendasikan produk pengembang kepada pengguna. Memperpersonalisasi toko dalam permainan Anda membantu menampilkan item yang paling relevan kepada setiap pengguna, meningkatkan keterlibatan dan pendapatan. Dengan menyesuaikan produk pengembang dengan preferensi pengguna, Anda dapat meningkatkan penemuan mereka, meningkatkan tingkat konversi, dan membuka peluang monetisasi baru.

Peringkat produk pengembang untuk dijual

RankProductsAsync menerima daftar ID produk dan mengembalikan daftar terurut yang dipersonalisasi dari produk-produk tersebut. Anda dapat menggunakan metode ini untuk memberikan rekomendasi item yang dipersonalisasi kepada pengguna di toko dalam permainan Anda.

Contoh: Tiga item "Kekuatan" yang diperingkat untuk pengguna
Tiga item yang diperingkat untuk pengguna.
local MarketplaceService = game:GetService("MarketplaceService")
-- Buat array produk yang ingin Anda peringkatkan
local productIdentifiers = {
{InfoType = Enum.InfoType.GamePass, Id = 123},
{InfoType = Enum.InfoType.Product, Id = 456},
{InfoType = Enum.InfoType.Product, Id = 789}
}
-- Lakukan panggilan terlindungi untuk menangani kesalahan
local success, rankedProducts = pcall(function()
return MarketplaceService:RankProductsAsync(productIdentifiers)
end)
if not success then
error("Gagal untuk memberi peringkat produk")
end
-- Muat item yang dikembalikan ke dalam toko
for i, rankedItem in ipairs(rankedProducts) do
local productIdentifier = rankedItem.ProductIdentifier
local productInfo = rankedItem.ProductInfo
-- ...
-- Logika untuk menambahkan produk ke dalam toko
end

Tampilkan produk pengembang teratas Anda

RecommendTopProductsAsync mengambil array nilai InfoType dan mengembalikan hingga 50 item yang kemungkinan besar akan dilibatkan dan dibeli oleh pengguna. Anda dapat menggunakan metode ini untuk membuat bagian "Pilihan Teratas" di toko dalam permainan Anda.

Jika tidak ada rekomendasi yang dapat ditentukan, RecommendTopProductsAsync mengembalikan 0 item.

Dalam kasus yang jarang terjadi, panggilan ke model peringkat dapat lambat. Untuk membantu mencegah penambahan yang terlambat bagi pengguna, kami sarankan menggunakan task.spawn untuk membuat panggilan ke RecommendTopProducts tidak memblokir.

Contoh: Tab "Pilihan Teratas" di toko dalam permainan
Tab Pilihan Teratas dari toko dalam permainan.
local MarketplaceService = game:GetService("MarketplaceService")
-- Buat array jenis produk yang ingin Anda sertakan dalam rekomendasi -- Contoh ini mencakup baik pass maupun produk pengembang
local productTypes = {Enum.InfoType.GamePass, Enum.InfoType.Product}
-- Lakukan panggilan terlindungi untuk menangani kesalahan
local success, topRankedItems = pcall(function()
return MarketplaceService:RecommendTopProductsAsync(productTypes)
end)
if not success then
error("Gagal untuk memberi peringkat produk")
end
-- Muat item yang dikembalikan ke dalam toko
-- Pastikan untuk menyaring item yang tidak memenuhi syarat dari topRankedItems seperti produk pengembang yang tidak dapat lagi dibeli pengguna
for i, rankedItem in ipairs(topRankedItems) do
local productIdentifier = rankedItem.ProductIdentifier
local productInfo = rankedItem.ProductInfo
-- ...
-- Logika untuk menambahkan produk ke dalam toko
end

Analitik produk pengembang

Gunakan analitik produk pengembang untuk menganalisis keberhasilan produk individu, mengidentifikasi tren, dan meramalkan potensi pendapatan di masa depan.

Dengan analitik, Anda dapat:

  • Melihat produk pengembang teratas Anda selama periode waktu yang dipilih.
  • Menampilkan hingga delapan item terlaris pada grafik deret waktu untuk menganalisis penjualan keseluruhan dan pendapatan bersih.
  • Memantau katalog Anda dan mengurutkan item berdasarkan penjualan dan pendapatan bersih.

Untuk mengakses analitik produk pengembang:

  1. Pergi ke Kreasi dan pilih sebuah permainan.
  2. Pergi ke Monetisasi ⟩ Produk Pengembang.
  3. Pilih tab Analitik.
©2026 Roblox Corporation. Roblox, logo Roblox, dan Powering Imagination termasuk dalam merek dagang kami yang terdaftar dan tidak terdaftar di AS dan negara lainnya.