Geçişler

Geçişler, kullanıcıların oyununuzda kısıtlı bir alana giriş, bir oyun içi avatar öğesi veya kalıcı bir güçlendirme gibi özel ayrıcalıklara erişim için bir kerelik Robux ücreti ödemenizi sağlar.

Bir geçiş oluşturun

Bir geçiş oluşturmak için:

1. Yaratımlar sayfasına gidin ve bir oyun seçin.
2. Monetizasyon ⟩ Geçişler sekmesine gidin.
3. Geçiş oluştur butonuna tıklayın.
4. Geçiş simgesi olarak görüntülenecek bir resim yükleyin. Resmin 512x512 pikseli aşmadığı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. Geçiş için bir ad ve açıklama girin.
6. Geçiş için bir kategori seçin. Kategori, oyun içi Mağazanızdaki öğeleri düzenlemek için kullanılır.
7. Geçiş oluştur butonuna tıklayın.

Geçiş ID'sini alın

Scripting kullanmak için bir geçiş ID'sine ihtiyacınız var. Geçiş ID'sini almak için:

1. Monetizasyon ⟩ Geçişler sekmesine gidin.

2. Bir geçişin küçük resminin üzerine gelin, ⋯ butonuna tıklayın ve bağlam menüsünden Varlık ID'sini Kopyala seçeneğini seçin.

   

Bir geçiş satın

Geçişleri iki şekilde satabilirsiniz:

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

Oyun içinde

Bir oyunda bir geçişi uygulamak ve satmak için MarketplaceService fonksiyonlarını çağırın.

GetProductInfo() fonksiyonunu kullanarak bir geçiş hakkında bilgi alın, örneğin adı ve fiyatı, ve ardından bu geçişi kullanıcılara gösterin. Örneğin, geçişi oyununuzun pazarında satabilirsiniz. Geçişler için ikinci parametre Enum.InfoType.GamePass olmalıdır.

local MarketplaceService = game:GetService("MarketplaceService")

-- Yer tutucu ID'yi geçiş ID'nizle değiştirin
local productId = 000000

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


if success and productInfo then
	-- Ürünün satışta olup olmadığını kontrol et
	if productInfo.IsForSale then
	-- Ürün bilgilerini göster
	-- Geçişi göstermek için print ifadelerini UI koduyla değiştirin
  	print("Geçiş Adı: " .. productInfo.Name)
  	print("Robux Fiyatı: " .. productInfo.PriceInRobux)
  	print("Açıklama: " .. productInfo.Description)
	else
		print("Bu ürün satışta değil")
	end
end

Kullanıcının envanterinde geçiş yoksa, geçiş satın alımını istemek için PromptGamePassPurchase() fonksiyonunu kullanın. Bu fonksiyonu, bir kullanıcı bir butona basarken veya bir satıcı NPC ile konuşurken çağırabilirsiniz.

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

-- Yer tutucu ID'yi geçiş ID'nizle değiştirin
local passID = 0000000

-- Geçiş satın alımını iste
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("Oyuncunun geçişe sahip olup olmadığını kontrol ederken hata oluştu: " .. tostring(message))
		return
	end

	if hasPass then
		-- Kullanıcıya zaten geçişe sahip olduğunu bildiren bir mesaj göster
	else
		-- Geçiş satın alımını iste
		MarketplaceService:PromptGamePassPurchase(player, passID)
	end
end

Tamamlanan bir geçiş istemini ve satın alımını işlemek ve kullanıcıya geçişle ilişkili ayrıcalıkları atamak için PromptGamePassPurchaseFinished fonksiyonunu kullanın.

Scripti, sunucunun kullanıcının geçiş ayrıcalıklarını yönetmesi için ServerScriptService içine yerleştirin.

local MarketplaceService = game:GetService("MarketplaceService")

-- Yer tutucu ID'yi geçiş ID'nizle değiştirin
local passID = 0000000  -- Bunu Geçiş ID'nizle değiştirin

-- Tamamlanan bir istemi ve satın alımı işleyin
local function onPromptPurchaseFinished(player, purchasedPassID, purchaseSuccess)
	if purchaseSuccess and purchasedPassID == passID then
		print(player.Name .. " Geçişi satın aldı, ID " .. passID)
		-- Kullanıcıya geçişle ilgili yetenek veya bonusu atayın
	end
end

-- PromptGamePassPurchaseFinished olaylarını fonksiyona bağlayın
MarketplaceService.PromptGamePassPurchaseFinished:Connect(onPromptPurchaseFinished)

Oyun dışında

Bir geçişi oyunun detay sayfasındaki Mağaza sekmesinde satmak için:

1. Monetizasyon ⟩ Geçişler sekmesine gidin.
2. Geçişin üzerine gelin ve ⋯ menüsüne tıklayın.
3. Satmak istediğiniz geçişi seçin.
4. Satışlar seçeneğini seçin.
5. Satışta Olan Ürün geçişini etkinleştirin.
6. Robux Fiyatı alanına, geçiş için kullanıcıların ödemesini istediğiniz Robux miktarını girin. Girdiğiniz fiyat, her satışta ne kadar Robux kazanacağınızı etkiler. Minimum fiyat 1 Robux, maksimum fiyat ise 1 milyar Robux'tur.
7. Değişiklikleri Kaydet butonuna tıklayın. Geçiş, oyunun detay sayfasındaki Mağaza sekmesinde görüntülenecektir.

Geçiş ayrıcalıklarını atayın

Geçişlerinizi satın alan kullanıcılara geçiş ayrıcalıklarını manuel olarak atamanız gerekir. Bunu yapmak için, bir kullanıcı oyununuza katıldığında PlayerAdded kullanarak, kullanıcının zaten geçişe sahip olup olmadığını kontrol edin ve onlara geçiş ayrıcalıklarını atayın.

Scripti, sunucunun kullanıcının geçiş ayrıcalıklarını yönetmesi için ServerScriptService içine yerleştirin.

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

-- Yer tutucu ID'yi geçiş ID'nizle değiştirin
local passID = 0000000

local function onPlayerAdded(player)
	local hasPass = false

	-- Kullanıcının zaten geçişe sahip olup olmadığını kontrol et
	local success, message = pcall(function()
		hasPass = MarketplaceService:UserOwnsGamePassAsync(player.UserId, passID)
	end)

	if not success then
		-- Bir uyarı ver ve fonksiyondan çık
		warn("Oyuncunun geçişe sahip olup olmadığını kontrol ederken hata oluştu: " .. tostring(message))
		return
	end

	if hasPass then
		-- Kullanıcıya geçişle ilgili yetenek veya bonusu atayın
		print(player.Name .. " Geçişe sahip, ID " .. passID)
	end
end

-- PlayerAdded olaylarını fonksiyona bağlayın
Players.PlayerAdded:Connect(onPlayerAdded)

Oyun içi mağazanızı kişiselleştirin

Kullanıcılara geçişleri sıralamak ve önermek için ürün zeka API'lerini kullanabilirsiniz. Oyun içi mağazanızı kişiselleştirmek, her kullanıcıya en alakalı öğeleri sunmaya yardımcı olur, etkileşimi ve geliri artırır. Kullanıcı tercihlerine göre geçişleri uyarlayarak, keşiflerini iyileştirebilir, dönüşüm oranlarını artırabilir ve yeni para kazanma fırsatlarını açabilirsiniz.

Satışta olan geçişleri sıralayın

RankProductsAsync, bir ürün ID'si listesi alır ve bu ürünlerin kişiselleştirilmiş sıralı bir listesini döndürür. Bu yöntemi, kullanıcılarınıza oyun içi mağazanızda kişiselleştirilmiş ürün önerileri sağlamak için kullanabilirsiniz.

local MarketplaceService = game:GetService("MarketplaceService")

-- Sıralamak istediğiniz ürünlerin dizisini oluşturun
local productIdentifiers = {
    {InfoType = Enum.InfoType.GamePass, Id = 123},
    {InfoType = Enum.InfoType.Product, Id = 456},
    {InfoType = Enum.InfoType.Product, Id = 789}
}

-- Opsiyonel: Çağrıyı bir asenkron görev içinde sarın, böylece istek yavaşsa,
-- UI / oyunu dondurmaz
task.spawn(function()
    -- Hataları düzgün bir şekilde ele almak için pcall kullanın
    local success, result = pcall(function()
        return MarketplaceService:RankProductsAsync(productIdentifiers)
    end)

    if not success then
        -- Eğer başarısız olduysa, 'result' hata mesajıdır.
        warn("Ürünleri sıralamada hata oluştu:", result)
    end

    -- Döndürülen öğeleri mağazaya yükleyin.
    for i, rankedItem in ipairs(rankedProducts) do
        local productIdentifier = rankedItem.ProductIdentifier
        local productInfo = rankedItem.ProductInfo
        -- ...
        -- productInfo'yu mağazaya ekleme mantığı
    end
end)

En iyi geçişlerinizi gösterin

RecommendTopProductsAsync, bir dizi InfoType değeri alır ve bir kullanıcının en çok etkileşimde bulunması ve satın alması muhtemel 50 öğeye kadar döndürür. Bu yöntemi, oyun içi mağazanızda "En İyi Seçimler" bölümü oluşturmak için kullanabilirsiniz.

Eğer öneriler belirlenemezse, RecommendTopProductsAsync 0 öğe döndürür. Kullanıcının zaten sahip olduğu geçişler de döndürülmez.

Nadir durumlarda, sıralama modeline yapılan çağrılar yavaş olabilir. Kullanıcılar için eklenmiş bir gecikmeyi önlemek için, RecommendTopProducts çağrısını engelleyici olmaktan kaçınmak için task.spawn kullanmanızı öneririz.

local MarketplaceService = game:GetService("MarketplaceService")

-- Dahil edilecek ürün türleri dizisini oluşturun. Bu durumda hem oyun geçişleri hem de geliştirici ürünleri
local productTypes = {Enum.InfoType.GamePass, Enum.InfoType.Product}

-- Opsiyonel: Çağrıyı bir asenkron görev içinde sarın, böylece istek yavaşsa,
-- UI / oyunu dondurmaz
task.spawn(function()
    -- Hataları düzgün bir şekilde ele almak için pcall kullanın
    local success, result = pcall(function()
        return MarketplaceService:RecommendTopProductsAsync(productTypes)
    end)

    if not success then
        -- Eğer başarısız olduysa, 'result' hata mesajıdır.
        warn("Ürünleri sıralamada hata oluştu:", result)
    end

    -- Döndürülen öğeleri mağazaya yükleyin. Kullanıcının artık satın alamayacağı
    -- geliştirici ürünleri gibi uygun olmayan öğeleri topRankedItems'dan filtrelediğinizden emin olun
    for i, rankedItem in ipairs(rankedProducts) do
        local productIdentifier = rankedItem.ProductIdentifier
        local productInfo = rankedItem.ProductInfo
        -- ...
        -- productInfo'yu mağazaya ekleme mantığı
    end
end)

Bir geçişi tanıtın

Daha fazla kullanıcının oyununuzu keşfetmesine yardımcı olmak için, geçişlerinizin Roblox'un Robux Satın Al sayfasında öne çıkmasını sağlayabilirsiniz. Geçişlerinizi tanıtmak, kullanıcıların oyununuzda geçirdiği süreyi ve harcadığı Robux'u artırmaya yardımcı olabilir. Tanıtımını yapabileceğiniz geçiş sayısında bir sınırlama yoktur.

Kullanıcılara, oyun geçmişleri ve platformdaki etkileşimleriyle ilgili geçişler gösterilir. Zaten sahip oldukları geçişler gösterilmez.

Kullanıcılar, uygun bir Robux paketi satın aldıklarında, tanıtılan geçişi alır ve oyununuzu katılarak geçişlerini talep etmeleri için yönlendirilirler.

Bir geçişinizi tanıtmak için:

1. Monetizasyon ⟩ Geçişler sekmesine gidin.
2. Tanıtmak istediğiniz geçişi seçin.
3. Tanıtımlar seçeneğini seçin.
4. Bu öğeyi bonus havuzuna dahil et seçeneğini etkinleştirin.
5. Değişiklikleri Kaydet butonuna tıklayın. Geçiş, ilgili kullanıcılara Robux Satın Al sayfasında gösterilecektir.

Tanıtılan geçiş:

• Satışta olmayan veya satışta olan olabilir. Eğer satışta ise, Robux değeri 49 Robux'tan büyük ve 801 Robux'tan küçük olmalıdır.
• Bir küçük resim içermelidir.
• Ücretli rastgele öğeler veremez.
• Topluluk Standartları ile uyumlu olmalıdır.

Geçiş analitiği

Geçiş analitiğini kullanarak bireysel geçişlerin başarısını analiz edebilir, trendleri belirleyebilir ve potansiyel gelecekteki kazançları tahmin edebilirsiniz.

Analitik ile şunları yapabilirsiniz:

• Seçilen bir zaman diliminde en iyi geçişlerinizi görüntüleyin.
• Genel satışları ve net geliri analiz etmek için zaman serisi grafiğinde en çok satan sekiz öğeyi sergileyin.
• Kataloğunuzu izleyin ve öğeleri satış ve net gelire göre sıralayın.
• Kullanıcıların Robux Satın Al sayfasında geçişi alarak kaç tane geçiş edindiğini görün.
• Kullanıcıların Robux Satın Al sayfasından geçişi aldıktan sonra oyununuzu kaç kez katıldığını görün.

Geçiş analitiğine erişmek için:

1. Yaratımlar sayfasına gidin ve bir oyun seçin.
2. Monetizasyon ⟩ Geçişler sekmesine gidin.
3. Analitik sekmesini seçin.