Geçmişler

Geçmişler, kullanıcıların oyununuz içinde, kısıtlı bir alana giriş, bir oyun içi avatar öğesi veya kalıcı bir güç artışı gibi özel ayrıcalıklara erişim için bir kerelik Robux ücreti ödemesine olanak tanır.

Bir geçiş oluşturma

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

1. Yaratımlar sayfasına gidin ve bir oyun seçin.
2. Monetizasyon ⟩ Geçmişler bölümüne 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 geçmemesine, dairesel sınırlamaların dışındaki önemli detayları içermemesine ve .jpg, .png veya .bmp formatında olmasına dikkat edin.
5. Geçiş için bir isim ve açıklama girin.
6. Geçiş için bir kategori seçin. Kategori, oyun içi Dükkanını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çmişler bölümüne gidin.

2. Bir geçişin küçük resminin üzerine gelin, ⋯ butonuna tıklayın ve açılır menüden 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 geçişi oyun içinde uygulayıp satmak için MarketplaceService işlevlerini çağırın.

Geçiş hakkında bilgi almak için GetProductInfo() işlevini kullanın. Geçişin adı ve fiyatı gibi bilgileri alarak, bu geçişi kullanıcılara görüntülemek için kullanabilirsiniz. Geçişlerinizi 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örüntüle
	-- Geçişi görüntülemek 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ı geçişi envanterinde yoksa, geçiş satın alımını istemek için PromptGamePassPurchase() işlevini kullanın. Bu işlevi bir kullanıcı bir düğmeye bastığında veya bir satıcı NPC ile konuştuğunda ç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ı isteme
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: " .. tostring(message))
		return
	end

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

Tamamlanan bir geçiş istemesi ve satın alımı ile kullanıcıya geçişle ilişkili ayrıcalıkları vermek için PromptGamePassPurchaseFinished işlevini kullanın.

Scriptinizi 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'niz ile değiştirin

-- Tamamlanan isteme ve satın almanın işlenmesi
local function onPromptPurchaseFinished(player, purchasedPassID, purchaseSuccess)
	if purchaseSuccess and purchasedPassID == passID then
		print(player.Name .. " " .. passID .. " ID'li Geçişi satın aldı")
		-- Kullanıcıya geçiş ile ilişkili yetenek veya bonus verin
	end
end

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

Oyun dışında

Bir geçişi oyunun detay sayfasındaki Dükkan sekmesinde satmak için:

1. Monetizasyon ⟩ Geçmişler bölümüne 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ıştaki öğe geçişini etkinleştirin.
6. Robux fiyatı alanına, geçiş için kullanıcıdan almak istediğiniz Robux miktarını girin. Girdiğiniz fiyat, her satış başına ne kadar Robux kazanacağınızı etkiler. Minimum fiyat 1 Robux, maksimum fiyat 1 milyar Robux'tur.
7. Değişiklikleri Kaydet butonuna tıklayın. Geçiş, oyunun detay sayfasındaki Dükkan sekmesinde görünecektir.

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

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

Scriptinizi 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 geçişe zaten sahip olup olmadığını kontrol et
	local success, message = pcall(function()
		hasPass = MarketplaceService:UserOwnsGamePassAsync(player.UserId, passID)
	end)

	if not success then
		-- Bir uyarı verin ve fonksiyonu sonlandırın
		warn("Oyuncunun geçişe sahip olup olmadığını kontrol ederken hata: " .. tostring(message))
		return
	end

	if hasPass then
		-- Kullanıcıya geçişle ilgili yetenek veya bonus verin
		print(player.Name .. " " .. passID .. " ID'li Geçişe sahip")
	end
end

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

Oyun içi dükkanınızı kişiselleştirin

Kullanıcılara geçmişleri sıralamak ve öneriler sunmak için ürün zeka API'lerini kullanabilirsiniz. Oyun içi dükkanınızı kişiselleştirmek, her kullanıcıya en ilgili öğeleri ön plana çıkararak etkileşimi ve geliri artırır. Kullanıcı tercihlerine göre geçmişleri özelleştirerek, keşiflerini iyileştirebilir, dönüşüm oranlarını artırabilir ve yeni monetizasyon fırsatları açabilirsiniz.

Satışta geçmişleri sıralama

RankProductsAsync, bir ürün ID'leri listesi alır ve bu ürünlerin kişiselleştirilmiş sıralanmış bir listesini döndürür. Bu yöntemi kullanarak, kullanıcılarınıza oyun içi dükkanınızda kişiselleştirilmiş öğe önerileri sunabilirsiniz.

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: Çift işlevli olduğu için request yavaşsa, UI'yı / 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 olursa, 'result' hata mesajıdır.
        warn("Ürünleri sıralamakta başarısız:", result)
    end

    -- Dönüş yapılan ürünleri dükkanınıza yükleyin.
    for i, rankedItem in ipairs(rankedProducts) do
        local productIdentifier = rankedItem.ProductIdentifier
        local productInfo = rankedItem.ProductInfo
        -- ...
        -- productInfo'yu dükkanınıza ekleme mantığı
    end
end)

En iyi geçmişlerinizi gösterin

RecommendTopProductsAsync, bir dizi InfoType değeri alır ve kullanıcının en çok etkileşim içinde olacağı ve satın alacağı en fazla 50 öğeyi döndürür. Bu yöntemi kullanarak, oyun içi dükkanınızda bir "En Çok Tercih Edilenler" bölümü oluşturabilirsiniz.

Eğer öneri belirlenemezse, RecommendTopProductsAsync 0 öğe döndürecektir. Kullanıcının zaten sahip olduğu geçmişler de döndürülmeyecektir.

Nadir durumlarda, sıralama modeline yapılan çağrılar yavaş olabilir. Kullanıcılar için geç eklenmeyi önlemek için task.spawn kullanarak RecommendTopProducts çağrısını bloque etmeyen hale getirmenizi öneririz.

local MarketplaceService = game:GetService("MarketplaceService")

-- Dahil edilecek ürün türlerinin 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: Çift işlevli olduğu için request yavaşsa, UI'yı / 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 olursa, 'result' hata mesajıdır.
        warn("Ürünleri sıralamakta başarısız:", result)
    end

    -- Dönüş yapılan ürünleri dükkanınıza yükleyin. `topRankedItems` içindeki uygun olmayan öğeleri, geliştirici ürünler gibi artık satın alınamayacak olanları filtrelemenizi sağlayın.
    for i, rankedItem in ipairs(rankedProducts) do
        local productIdentifier = rankedItem.ProductIdentifier
        local productInfo = rankedItem.ProductInfo
        -- ...
        -- productInfo'yu dükkanınıza ekleme mantığı
    end
end)

Bir geçiş tanıtımı yapın

Daha fazla kullanıcının oyununuzu keşfetmesine yardımcı olmak için, geçmişlerinizi Roblox'un Robux Satın Al sayfasında yer alacak şekilde seçebilirsiniz. Geçişlerinizi tanıtmak, kullanıcıların oyununuzda geçirdiği süreyi ve Robux'u artırabilir. Tanıtılacak geçmiş sayısı için bir sınır yoktur.

Kullanıcılara, oyun tarihleri ve platform üzerindeki etkileşimleriyle ilgili geçişler gösterilmektedir. Zaten sahip oldukları geçmişler gösterilmez.

Kullanıcılar, uygun bir Robux paketi satın aldıklarında tanıtılan geçişi alırlar ve oyununuza katılarak geçişlerini talep etmeleri istenir.

Bir geçişin tanıtımına katılmak için:

1. Monetizasyon ⟩ Geçmişler bölümüne gidin.
2. Tanıtmak istediğiniz geçmiş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 veya satışta olmayabilir. Satıştaysa, 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 öğeleri veremez.
• Topluluk Standartları ile uyumlu olmalıdır.

Geçiş analitiği

Geçiş analitiğini, bireysel geçişlerin başarısını analiz etmek, trendleri belirlemek ve potansiyel gelecekteki kazançları öngörmek için kullanın.

Analitikle şunları yapabilirsiniz:

• Seçilen bir zaman diliminde en iyi geçişlerinizi görüntüleyin.
• Toplam satışı ve net geliri analiz etmek için sekiz adet en çok satan öğeyi zaman serisi grafiğinde sergileyin.
• Katalogunuzu izleyin ve öğeleri satış ve net gelir açısından sıralayın.
• Kullanıcıların Robux Satın Al sayfasında geçiş alarak ne kadar geçiş edindiğini görün.
• Kullanıcıların geçişi Robux Satın Al sayfası aracılığıyla aldıktan sonra oyununuza katıldıkları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çmişler bölümüne gidin.
3. Analitik sekmesini seçin.