Kartu

Kartu memungkinkan Anda untuk membebankan biaya Robux satu kali kepada pengguna untuk mengakses hak istimewa khusus di dalam permainan Anda, seperti masuk ke area terbatas, item avatar dalam permainan, atau peningkatan kekuatan permanen.

Membuat kartu

Untuk membuat kartu:

1. Pergi ke Kreasi dan pilih permainan.
2. Pergi ke Monetisasi ⟩ Kartu.
3. Klik Buat kartu.
4. Unggah gambar yang ditampilkan sebagai ikon kartu. Pastikan gambar tidak melebihi 512x512 piksel, tidak menyertakan detail penting di luar batas bulatnya, dan dalam format .jpg, .png, atau .bmp.
5. Masukkan nama dan deskripsi untuk kartu.
6. Pilih kategori untuk kartu. Kategori digunakan untuk mengorganisir item di Toko dalam permainan Anda.
7. Klik Buat kartu.

Dapatkan ID kartu

Untuk menggunakan skrip, Anda memerlukan ID kartu. Untuk mendapatkan ID kartu:

1. Pergi ke Monetisasi ⟩ Kartu.

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

   

Menjual kartu

Anda dapat menjual kartu dengan dua cara:

• Di dalam permainan Anda
• Di luar permainan Anda

Di dalam permainan Anda

Untuk mengimplementasikan dan menjual kartu di dalam permainan, panggil fungsi MarketplaceService.

Gunakan GetProductInfo() untuk mengambil informasi tentang kartu, seperti nama dan harga, dan kemudian menampilkan kartu tersebut kepada pengguna. Anda dapat menjual kartu di dalam marketplace permainan Anda, misalnya. Untuk kartu, parameter kedua harus Enum.InfoType.GamePass.

local MarketplaceService = game:GetService("MarketplaceService")

-- Ganti ID placeholder dengan ID kartu Anda
local productId = 000000

local success, productInfo = pcall(function()
	return MarketplaceService:GetProductInfo(productId, Enum.InfoType.GamePass)
end)


if success and productInfo then
	-- Periksa apakah produk tersedia untuk dijual
	if productInfo.IsForSale then
	-- Tampilkan informasi produk
	-- Ganti pernyataan cetak dengan kode UI untuk menampilkan kartu
  	print("Nama Kartu: " .. productInfo.Name)
  	print("Harga dalam Robux: " .. productInfo.PriceInRobux)
  	print("Deskripsi: " .. productInfo.Description)
	else
		print("Produk ini tidak untuk dijual")
	end
end

Gunakan PromptGamePassPurchase() untuk meminta pembelian kartu jika pengguna belum memiliki kartu di inventaris mereka. 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")

-- Ganti ID placeholder dengan ID kartu Anda
local passID = 0000000

-- Minta pembelian kartu
local function promptPurchase()
	local player = Players.LocalPlayer
	local hasPass = false

	local success, message = pcall(function()
		hasPass = MarketplaceService:UserOwnsGamePassAsync(player.UserId, passID)
	end)

	if not success then
		warn("Kesalahan saat memeriksa apakah pemain memiliki kartu: " .. tostring(message))
		return
	end

	if hasPass then
		-- Tampilkan pesan yang memberi tahu pengguna bahwa mereka sudah memiliki kartu
	else
		-- Minta pembelian kartu
		MarketplaceService:PromptGamePassPurchase(player, passID)
	end
end

Gunakan PromptGamePassPurchaseFinished untuk menangani prompt dan pembelian kartu yang telah selesai serta memberi pengguna hak-hak terkait kartu tersebut.

Tempatkan skrip di dalam ServerScriptService agar server menangani hak-hak kartu pengguna.

local MarketplaceService = game:GetService("MarketplaceService")

-- Ganti ID placeholder dengan ID kartu Anda
local passID = 0000000  -- Ubah ini menjadi ID Kartu Anda

-- Tangani prompt dan pembelian yang telah selesai
local function onPromptPurchaseFinished(player, purchasedPassID, purchaseSuccess)
	if purchaseSuccess and purchasedPassID == passID then
		print(player.Name .. " membeli Kartu dengan ID " .. passID)
		-- Berikan kepada pengguna kemampuan atau bonus terkait dengan kartu
	end
end

-- Hubungkan event PromptGamePassPurchaseFinished ke fungsi
MarketplaceService.PromptGamePassPurchaseFinished:Connect(onPromptPurchaseFinished)

Di luar permainan Anda

Untuk menjual kartu pada tab Toko di halaman detail permainan:

1. Pergi ke Monetisasi ⟩ Kartu.
2. Arahkan mouse ke kartu dan klik menu ⋯.
3. Pilih kartu yang ingin Anda jual.
4. Pilih Penjualan.
5. Aktifkan toggle Item untuk Dijual.
6. Di bidang Harga dalam Robux, masukkan jumlah Robux yang ingin Anda kenakan kepada pengguna untuk kartu tersebut. Harga yang Anda masukkan memengaruhi seberapa banyak Robux yang Anda peroleh per penjualan. Harga minimum adalah 1 Robux, dan harga maksimum adalah 1 miliar Robux.
7. Klik Simpan Perubahan. Kartu akan muncul di tab Toko pada halaman detail permainan.

Menetapkan hak kartu

Anda harus secara manual menetapkan hak kartu kepada pengguna yang membeli kartu Anda. Untuk melakukan ini, gunakan PlayerAdded ketika seorang pengguna bergabung dengan permainan Anda untuk memeriksa apakah mereka sudah memiliki kartu tersebut dan menetapkan hak kartu kepada mereka.

Tempatkan skrip di dalam ServerScriptService agar server menangani hak kartu pengguna.

local MarketplaceService = game:GetService("MarketplaceService")
local Players = game:GetService("Players")

-- Ganti ID placeholder dengan ID kartu Anda
local passID = 0000000

local function onPlayerAdded(player)
	local hasPass = false

	-- Periksa apakah pengguna sudah memiliki kartu
	local success, message = pcall(function()
		hasPass = MarketplaceService:UserOwnsGamePassAsync(player.UserId, passID)
	end)

	if not success then
		-- Berikan peringatan dan keluar dari fungsi
		warn("Kesalahan saat memeriksa apakah pemain memiliki kartu: " .. tostring(message))
		return
	end

	if hasPass then
		-- Berikan kepada pengguna kemampuan atau bonus terkait dengan kartu
		print(player.Name .. " memiliki Kartu dengan ID " .. passID)
	end
end

-- Hubungkan event PlayerAdded ke fungsi
Players.PlayerAdded:Connect(onPlayerAdded)

Personalisasi toko dalam permainan Anda

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

Ringkasan kartu untuk dijual

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

local MarketplaceService = game:GetService("MarketplaceService")

-- Buat array produk yang ingin Anda rangking
local productIdentifiers = {
    {InfoType = Enum.InfoType.GamePass, Id = 123},
    {InfoType = Enum.InfoType.Product, Id = 456},
    {InfoType = Enum.InfoType.Product, Id = 789}
}

-- Opsional: Bungkus panggilan dalam tugas asinkron sehingga jika permintaan lambat,
-- tidak membekukan UI / permainan
task.spawn(function()
    -- Gunakan pcall untuk menangani kesalahan dengan baik
    local success, result = pcall(function()
        return MarketplaceService:RankProductsAsync(productIdentifiers)
    end)

    if not success then
        -- Jika gagal, 'result' adalah pesan kesalahan.
        warn("Gagal merangking produk:", result)
    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 productInfo ke dalam toko
    end
end)

Tampilkan kartu teratas Anda

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

Jika tidak ada rekomendasi yang dapat ditentukan, RecommendTopProductsAsync mengembalikan 0 item. Kartu yang sudah dimiliki pengguna juga tidak akan dikembalikan.

Dalam kasus yang jarang terjadi, panggilan ke model perankingan bisa lambat. Untuk membantu mencegah penambahan terbaru bagi pengguna, kami sarankan menggunakan task.spawn untuk membuat panggilan ke RecommendTopProducts non-blokir.

local MarketplaceService = game:GetService("MarketplaceService")

-- Buat array tipe produk untuk disertakan. Dalam hal ini baik kartu permainan maupun produk pengembang
local productTypes = {Enum.InfoType.GamePass, Enum.InfoType.Product}

-- Opsional: Bungkus panggilan dalam tugas asinkron sehingga jika permintaan lambat,
-- tidak membekukan UI / permainan
task.spawn(function()
    -- Gunakan pcall untuk menangani kesalahan dengan baik
    local success, result = pcall(function()
        return MarketplaceService:RecommendTopProductsAsync(productTypes)
    end)

    if not success then
        -- Jika gagal, 'result' adalah pesan kesalahan.
        warn("Gagal merangking produk:", result)
    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 oleh pengguna
    for i, rankedItem in ipairs(rankedProducts) do
        local productIdentifier = rankedItem.ProductIdentifier
        local productInfo = rankedItem.ProductInfo
        -- ...
        -- Logika untuk menambahkan productInfo ke dalam toko
    end
end)

Mempromosikan kartu

Untuk membantu lebih banyak pengguna menemukan permainan Anda, Anda dapat memilih untuk memiliki kartu Anda ditampilkan di halaman Beli Robux Roblox. Memilih untuk mempromosikan kartu Anda dapat membantu meningkatkan waktu dan Robux yang dihabiskan pengguna di permainan Anda. Tidak ada batasan jumlah kartu yang dapat Anda promosikan.

Pengguna akan ditampilkan kartu yang relevan dengan riwayat permainan dan keterlibatan mereka di platform. Mereka tidak akan ditampilkan kartu yang sudah mereka miliki.

Ketika pengguna membeli paket Robux yang memenuhi syarat, mereka menerima kartu yang dipromosikan dan diminta untuk mengklaim kartu mereka dengan bergabung ke permainan Anda.

Untuk memilih salah satu kartu Anda untuk dipromosikan:

1. Pergi ke Monetisasi ⟩ Kartu.
2. Pilih kartu yang ingin Anda promosikan.
3. Pilih Promosi.
4. Aktifkan Sertakan item ini dalam kumpulan bonus.
5. Klik Simpan Perubahan. Kartu ditampilkan kepada pengguna yang relevan di halaman Beli Robux.

Kartu yang dipromosikan:

• Dapat tidak dijual atau dijual. Jika mereka dijual, nilai Robux mereka harus lebih besar dari 49 Robux dan kurang dari 801 Robux.
• Harus menyertakan thumbnail.
• Tidak dapat memberikan item acak berbayar.
• Harus mematuhi Standar Komunitas.

Analitik kartu

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

Dengan analitik, Anda dapat:

• Melihat kartu teratas Anda selama periode waktu tertentu.
• Menampilkan hingga delapan item terlaris dalam grafik deret waktu untuk menganalisis penjualan keseluruhan dan pendapatan bersih.
• Memantau katalog Anda dan menyortir item berdasarkan penjualan dan pendapatan bersih.
• Melihat berapa banyak kartu yang diperoleh pengguna melalui promosi di halaman Beli Robux.
• Melihat berapa banyak pengguna yang bergabung dengan permainan Anda setelah memperoleh kartu melalui halaman Beli Robux.

Untuk mengakses analitik kartu:

1. Pergi ke Kreasi dan pilih sebuah permainan.
2. Pergi ke Monetisasi ⟩ Kartu.
3. Pilih tab Analitik.