Geliştirici Ürünler

Bir geliştirici ürünü bir kullanıcının deneyim para birimi, cephane veya iksir gibi birden fazla satın alabileceği bir öğe veya yetenektir.

Geliştirici bir ürün oluştur

Geliştirici bir ürün oluşturmak için:

1. Yaratımlara git ve bir deneyim seç.
2. Monetizeasyon > Geliştirici Ürünleri 'ye gidin.
3. Geliştirici ürün oluştur seçeneğine tıklayın.
4. Ürün simgesi olarak görüntülenecek bir görüntü yükle.Resmin 512x512 pikselden fazla olmadığından, dairesel sınırlarının dışındaki önemli detayları içermediğinden ve .jpg , .png veya .bmp formatında olduğundan emin olun.
5. Ürün için bir isim ve açıklama girin.
6. Ürün fiyatını Robux'ta ayarlayın. Minimum fiyat 1 Robux'tur ve maksimum fiyat 1 milyar Robux'tur.
7. Geliştirici Ürünü Oluştur seçeneğine tıklayın.

Geliştirici ürün kimliğini alın

Kod kullanmak için, bir geliştirici ürün kimliğine ihtiyacınız var. Ürün kimliğini almak için:

1. Monetizeasyon > Geliştirici Ürünleri > git.

2. Bir ürünün küçük resminin üzerine gelin, ⋯ düğmesine tıklayın ve konteks menüsünden Varlık Kimliğini Kopyala seçin.

   

Geliştirici ürününü satmak

Geliştirici ürünlerini satmadan önce, satış makbuzlarını doğru işlediğinizden ve kullanıcılara satın aldıkları ürünleri verdiğinizden emin olun.Bunu yapmak için, şunları yapmalısınız:

• Satın alma faturalarını kontrol etmek için ProcessReceipt API'yi kullanın.ProcessReceipt Otomatik olarak bir kullanıcının deneyim dışında bir ürün satın aldığını okur ve kabul eder.
• Her faturayı User ID , Developer Product ID ve fatura durumu için doğrula.
• Faturanın Açık durumu varsa, kullanıcıya satın aldıkları geliştirici öğelerini verin.
• Satın alınan öğelerin verildiğini kabul eden ve satın alınan öğelerin verildiğini doğrulayan bir mesajla ProcessReceipt.

Geliştirici ürünlerini iki şekilde satabilirsiniz:

• Deneyiminizin içinde
• Deneyiminizin dışında

Deneyiminizin içinde

Deneyim içinde bir geliştirici ürününü uygulayıp satmak için MarketplaceService fonksiyonlarını arayın.

Bir geliştirici ürünüyle ilgili bilgileri almak için GetProductInfo kullanın, ardından bu ürünü kullanıcılara görüntüleyin, isim ve fiyat gibi.Deneyiminizin pazarında ürünü satabilirsiniz, örneğin.Geliştirici ürünler için, ikinci parametre Enum.InfoType.Product olmalıdır.

local MarketplaceService = game:GetService("MarketplaceService")

-- Doldurucu kimliğini geliştirici ürün kimliğinizle değiştirin
local productId = 000000

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

if success and productInfo then
	-- Ürün bilgilerini görüntüle
	-- Ürünü görüntülemek için yazıcı ifadelerini UI koduyla değiştirin
  print("Developer Product Name: " .. productInfo.Name)
  print("Price in Robux: " .. productInfo.PriceInRobux)
  print("Description: " .. productInfo.Description)
end

Deneyiminizle ilişkili tüm geliştirici ürünlerini almak için GetDeveloperProductsAsync kullanın.Bu işlev, bir deneyim mağazası veya ürün listesi GUI gibi şeyler inşa etmek için kontrol edebileceğiniz ve filtreleyebileceğiniz bir Pages nesnesi döndürür.

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
			-- Ürünü görüntülemek için yazım ifadesini UI koduyla değiştirin
			print(field .. ": " .. value)
	end
end

Deneyiminizde ürün satın alımlarını teşvik etmek için PromptProductPurchase kullanın.Kullanıcı bir düğmeye basmak veya satıcı bir NPC ile konuşmak gibi eylemler gerçekleştirdiğinde bu işlevi çağırabilirsiniz.

local MarketplaceService = game:GetService("MarketplaceService")
local Players = game:GetService("Players")
local player = Players.LocalPlayer

-- Doldurucu kimliğini geliştirici ürün kimliğinizle değiştirin
local productId = 000000

local function promptProductPurchase()
    local success, errorMessage = pcall(function()
      MarketplaceService:PromptProductPurchase(player, productId)
    end)

    if success then
      print("Purchase prompt shown successfully")
		end
end

Ayrıca LocalScript içindeki işlevleri birleştirebilirsiniz.Örneğin, bir düğme veya satıcı NPC gibi bir UI öğesi oluşturabilir ve ardından bu öğeye mevcut bir geliştirici ürünü bağlamak için GetProductInfo() kullanabilir, ürünün satılıp satılıkkontrol edebilir ve kullanıcı buna tıkladığında satın alma için uyarı vermek için PromptProductPurchase() kullanabilir.

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

local player = Players.LocalPlayer
local button = script.Parent

-- Doldurucu kimliğini geliştirici ürün kimliğinizle değiştirin
local productId = 000000

	-- Kullanıcı UI düğmesine tıkladığında ürün bilgileri alınır
button.MouseButton1Click:Connect(function()
	local success, productInfo = pcall(function()
		return MarketplaceService:GetProductInfo(productId, Enum.InfoType.Product)
	end)

	if success and productInfo then
		-- Ürünün satışolup olmadığını kontrol eder
		if productInfo.IsForSale then
			print("This is for sale")
			-- Ürün satın alımını teşvik eder
			MarketplaceService:PromptProductPurchase(player, productId)
		else
			-- Ürünün satışta olmadığını bildirir
			print("This product is not currently for sale.")
		end
	else
		print("Error retrieving product info: " .. tostring(productInfo))
	end
end)

Deneyiminizin dışında

Deneyiminizin dışında geliştirici ürün satın alımlarını etkinleştirmek için, ProcessReceipt API ile çalışmalısınız.Bir kullanıcı deneyim detayları sayfanızdaki Mağaza sekmesinde bir satın alma işlemi yaptıktan sonra, satın alımını onaylamak ve deneyiminize girdiklerinde onlara eşyalarını vermek için ProcessReceipt kullanmalısınız.

Test modu

Test modu özelliği, deneyiminizin dışında bir geliştirici ürün satın alma işlemini simule ederek satın alma akışınızı doğrulamanıza yardımcı olur .Dış geliştirici ürün satışlarını etkinleştirmeden önce doğru bir şekilde uyguladığınızdan emin olmak için test modunu kullanmalısınız ProcessReceipt .

Test modunda satışa sunduğunuz geliştirici ürünleri sadece siz ve grupüyeleri tarafından görülebilir. Kullanıcılar tarafından görülemezler.

Uygulamanızı test etmek için:

1. Yaratıcı Merkez'de , Paraşütleme > Geliştirici Ürünleri 'ye gidin.
2. ⋮ menüsüne tıklayın ve Dış Satın Alım Ayarları seçin.
3. Dış Satın Alım Ayarları sayfasında, Test modunu etkinleştir seçeneğine tıklayın.
4. Test modu aktif olduğunda, Geliştirici Ürünleri sayfasına dönün ve test etmek için bir ürün seçin.
5. Temel Ayarlar sayfasında, Dış satın alımları izin ver kutucuğunu seçin ve değişikliklerinizi kaydedin.
6. Deneyim detayları sayfasının Mağaza sekmesine gidin ve satışa sunduğunuz ürünü satın alın.
7. Deneyime girin ve satın aldığınız ürünü aldığınızı onaylayın.ProcessReceipt API'nin alıcı durumu Kapalı olarak güncellenmelidir.

Uygulamanızı test ettikten sonra Roblox, testin başarıyla tamamlandığını doğrur ve deneyimlerinizin dışındaki geliştirici ürünlerini satmak için özelliği tamamen etkinleştirmenize izin verir.

ProcessReceipt API ve uygulaması hakkında daha fazla bilgi için, ProcessReceipt sayfasına bakın.

Dış satışları etkinleştirin

Dış satışları etkinleştirmek için:

1. Dış Satın Alma Ayarları sayfasına git.
2. Dış Satın Alımları açın.
3. Geliştirici Ürünleri sayfasına geri dönün ve deneyiminizin dışında satmak istediğiniz ürünleri seçin.
4. Temel Ayarlar sayfasında, Dış satın alımları izin ver kutucuğunu seçin ve değişikliklerinizi kaydedin.
5. Ürünlerin şimdi deneyim detayları sayfasındaki Mağaza sekmesinde satın alılabileceğinden emin olun.

Bir geliştirici ürününün dış satışını devre dışı bırakmak için, Geliştirici Ürünleri sayfasındaki ürünü seçin ve Dış satın alımları izin verin kontrol kutusunu temizleyin.

Sınırlar

• Test modunda satışa sunulan eşyalar gerçek Robux'a mal olur. Düşük maliyetli geliştirici ürünlerini test etmenizi öneririz.
• Test modunda satışta olan öğeler sadece sizin tarafınızdan veya grupüyeleri tarafından görülebilir.
• Dışarı satılmak için, geliştirici ürünlerinizin bir küçük küçük resimolmalıdır .
• Deneyiminizin dışında şu şeyleri satmamalısınız:

  • Ödenen rastgele öğeler
  • Belirli miktarlara, zamanlara, dünyaveya kullanıcı ayarlarına ve rollerine sınırlı öğeler

Geliştirici ürün satın alma işlemini ele alın

Bir kullanıcı geliştirici ürün satın aldıktan sonra, işlemi ele almalı ve kaydetmelisiniz.Bunu yapmak için, Script içinde Class.ServerScriptService``ProcessReceipt

ProcessReceipt API ve uygulaması hakkında daha fazla bilgi için, ProcessReceipt sayfasına bakın.

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

local productFunctions = {}

-- Örnek: ürün kimliği 123123, kullanıcıyı tüm sağlığa geri getirir
productFunctions[123123] = function(receipt, player)
	local character = player.Character
	local humanoid = character and character:FindFirstChildWhichIsA("Humanoid")

	if humanoid then
		humanoid.Health = humanoid.MaxHealth
		-- Başarılı bir satın alma işaret eder
		return true
	end
end

-- Örnek: ürün kimliği 456456, kullanıcıya 100 altın ödül verir
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
		-- Geliştirici ürünü ID'si ile ilişkili yönetici işlevini alır ve çalıştırmaya çalışır
		local handler = productFunctions[productId]
		local success, result = pcall(handler, receiptInfo, player)
		if success then
			-- Kullanıcı eşyalarını aldı
			-- İşlemi onaylamak için "Satın Alındı" döndürür
			return Enum.ProductPurchaseDecision.PurchaseGranted
		else
			warn("Failed to process receipt:", receiptInfo, result)
		end
	end

	-- Kullanıcının eşyaları verilemedi
	-- Geri dönüyor "Henüz İşlenmedi" ve kullanıcı deneyime katıldığında bir dahaki sefere tekrar deneyecek
	return Enum.ProductPurchaseDecision.NotProcessedYet
end

-- Geri çağrıyı ayarlar
-- Bu yalnızca bir sunucu tarafı kod tarafından bir kez yapılabilir
MarketplaceService.ProcessReceipt = processReceipt

Geliştirici ürün analizi

Geliştirici ürün analizini kullanarak bireysel ürünlerin başarısını analiz edin, trendleri tanımlayın ve potansiyel gelecekteki kazançları öngörün.

Analizlerle, şunları yapabilirsiniz:

• Seçilen bir süre boyunca en iyi geliştirici ürünlerinizi görün.
• Genel satışları ve net geliri analiz etmek için bir zaman serisi grafiğinde en fazla sekiz en çok satan öğeyi gösterin.
• Kataloğunuzu izleyin ve satış ve net gelir ile eşyaları sıralayın.

Geliştirici ürün analizine erişmek için:

1. Yaratımlara git ve bir deneyim seç.
2. Monetizeasyon > Geliştirici Ürünleri 'ye gidin.
3. Analitik sekmesini seçin.