Przepustki

Przepustki pozwalają pobierać od użytkowników jednorazową opłatę w Robuxach za dostęp do specjalnych przywilejów w twojej grze, takich jak wejście do zastrzeżonego obszaru, element awatara w grze lub stały bonus.

Utwórz przepustkę

Aby utworzyć przepustkę:

1. Przejdź do Tworzenia i wybierz grę.
2. Przejdź do Monetyzacja ⟩ Przepustki.
3. Kliknij Utwórz przepustkę.
4. Prześlij zdjęcie, które ma być użyte jako ikona przepustki. Upewnij się, że obrazek nie przekracza 512x512 pikseli, nie zawiera ważnych szczegółów poza swoimi okrągłymi granicami i jest w formacie .jpg, .png lub .bmp.
5. Wprowadź nazwę i opis przepustki.
6. Wybierz kategorię dla przepustki. Kategoria jest używana do organizowania przedmiotów w twoim sklepie w grze.
7. Kliknij Utwórz przepustkę.

Uzyskaj identyfikator przepustki

Aby użyć skryptowania, potrzebujesz identyfikatora przepustki. Aby uzyskać identyfikator przepustki:

1. Przejdź do Monetyzacja ⟩ Przepustki.

2. Najedź kursorem na miniaturkę przepustki, kliknij przycisk ⋯ i wybierz Kopiuj identyfikator zasobu z menu kontekstowego.

   

Sprzedaj przepustkę

Możesz sprzedawać przepustki na dwa sposoby:

• W swojej grze
• Poza swoją grą

W twoim doświadczeniu

Aby wdrożyć i sprzedawać przepustkę wewnątrz doświadczenia, wywołaj funkcje MarketplaceService.

Użyj GetProductInfo() aby uzyskać informacje o przepustce, takie jak nazwa i cena, a następnie wyświetl tę przepustkę użytkownikom. Możesz sprzedawać przepustkę w sklepie swojej gry, na przykład. Dla przepustek drugi parametr musi być Enum.InfoType.GamePass.

local MarketplaceService = game:GetService("MarketplaceService")

-- Zastąp identyfikator zastępczy swoim identyfikatorem przepustki
local productId = 000000

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

if success and productInfo then
	-- Sprawdź, czy produkt jest na sprzedaż
	if productInfo.IsForSale then
	-- Wyświetl informacje o produkcie
	-- Zamień instrukcje print na kod UI do wyświetlenia przepustki
  	print("Nazwa przepustki: " .. productInfo.Name)
  	print("Cena w Robuxach: " .. productInfo.PriceInRobux)
  	print("Opis: " .. productInfo.Description)
	else
		print("Ten produkt nie jest na sprzedaż")
	end
end

Użyj PromptGamePassPurchase() aby zachęcić do zakupu przepustki, jeśli użytkownik już jej nie ma w swojej inwentarzu. Możesz wywołać tę funkcję, gdy użytkownik wykonuje takie działania, jak naciśnięcie przycisku lub rozmowa z NPC sprzedawcą.

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

-- Zastąp identyfikator zastępczy swoim identyfikatorem przepustki
local passID = 0000000

-- Zachęć do zakupu przepustki
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("Błąd podczas sprawdzania, czy gracz ma przepustkę: " .. tostring(message))
		return
	end

	if hasPass then
		-- Pokaż komunikat, informujący użytkownika, że już posiada przepustkę
	else
		-- Zachęć do zakupu przepustki
		MarketplaceService:PromptGamePassPurchase(player, passID)
	end
end

Użyj PromptGamePassPurchaseFinished aby obsłużyć zakończoną prośbę o przepustkę i zakup oraz przypisać użytkownikowi związane z przepustką przywileje.

Umieść skrypt wewnątrz ServerScriptService, aby serwer obsługiwał przywileje użytkownika związane z przepustką.

local MarketplaceService = game:GetService("MarketplaceService")

-- Zastąp identyfikator zastępczy swoim identyfikatorem przepustki
local passID = 0000000  -- Zmień to na swój identyfikator przepustki

-- Obsłuż zakończoną prośbę i zakup
local function onPromptPurchaseFinished(player, purchasedPassID, purchaseSuccess)
	if purchaseSuccess and purchasedPassID == passID then
		print(player.Name .. " kupił przepustkę o ID " .. passID)
		-- Przypisz użytkownikowi możliwość lub bonus związany z przepustką
	end
end

-- Połącz zdarzenia PromptGamePassPurchaseFinished z funkcją
MarketplaceService.PromptGamePassPurchaseFinished:Connect(onPromptPurchaseFinished)

Poza twoim doświadczeniem

Aby sprzedać przepustkę na karcie Sklep na stronie szczegółów gry:

1. Przejdź do Monetyzacja ⟩ Przepustki.
2. Najedź kursorem na przepustkę i kliknij menu ⋯.
3. Wybierz przepustkę, którą chcesz sprzedać.
4. Wybierz Sprzedaż.
5. Włącz przełącznik Przedmiot na sprzedaż.
6. W polu Cena w Robuxach wprowadź kwotę Robuxów, którą chcesz pobrać od użytkowników za przepustkę. Wprowadzona przez ciebie cena wpływa na to, ile Robuxów zarobisz za każdą sprzedaż. Minimalna cena to 1 Robux, a maksymalna cena to 1 miliard Robuxów.
7. Kliknij Zapisz zmiany. Przepustka pojawia się na karcie Sklep na stronie szczegółów gry.

Przypisz przywileje przepustki

Musisz ręcznie przypisać przywileje przepustki użytkownikom, którzy kupują twoje przepustki. Aby to zrobić, użyj PlayerAdded kiedy użytkownik dołącza do twojej gry, aby sprawdzić, czy już posiada przepustkę i przypisać mu przywileje związane z przepustką.

Umieść skrypt wewnątrz ServerScriptService, aby serwer obsługiwał przywileje użytkownika związane z przepustką.

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

-- Zastąp identyfikator zastępczy swoim identyfikatorem przepustki
local passID = 0000000

local function onPlayerAdded(player)
	local hasPass = false

	-- Sprawdź, czy użytkownik już posiada przepustkę
	local success, message = pcall(function()
		hasPass = MarketplaceService:UserOwnsGamePassAsync(player.UserId, passID)
	end)

	if not success then
		-- Wydaj ostrzeżenie i wyjdź z funkcji
		warn("Błąd podczas sprawdzania, czy gracz ma przepustkę: " .. tostring(message))
		return
	end

	if hasPass then
		-- Przypisz użytkownikowi możliwość lub bonus związany z przepustką
		print(player.Name .. " posiada przepustkę o ID " .. passID)
	end
end

-- Połącz zdarzenia PlayerAdded z funkcją
Players.PlayerAdded:Connect(onPlayerAdded)

Spersonalizuj swój sklep w doświadczeniu

Możesz użyć interfejsów API inteligencji produktowej, aby sortować i polecać przepustki użytkownikom. Personalizacja twojego sklepu w grze pomaga wydobyć najbardziej odpowiednie przedmioty dla każdego użytkownika, zwiększając zaangażowanie i przychody. Dostosowując przepustki do preferencji użytkowników, możesz poprawić ich odkrywanie, zwiększyć wskaźniki konwersji i odblokować nowe możliwości monetyzacji.

Rankuj przepustki na sprzedaż

RankProductsAsync przyjmuje listę identyfikatorów produktów i zwraca spersonalizowaną uporządkowaną listę tych produktów. Możesz użyć tej metody, aby zapewnić swoim użytkownikom spersonalizowane rekomendacje przedmiotów w swoim sklepie w grze.

local MarketplaceService = game:GetService("MarketplaceService")

-- Utwórz tablicę produktów, które chcesz uporządkować
local productIdentifiers = {
    {InfoType = Enum.InfoType.GamePass, Id = 123},
    {InfoType = Enum.InfoType.Product, Id = 456},
    {InfoType = Enum.InfoType.Product, Id = 789}
}

-- Opcjonalnie: Owiń wywołanie w asynchroniczne zadanie, aby jeśli żądanie będzie wolne,
-- nie zamarzało interfejsu użytkownika / gry
task.spawn(function()
    -- Użyj pcall, aby obsłużyć błędy w sposób elegancki
    local success, result = pcall(function()
        return MarketplaceService:RankProductsAsync(productIdentifiers)
    end)

    if not success then
        -- Jeśli niepowodzenie, 'result' to wiadomość o błędzie.
        warn("Nie udało się uporządkować produktów:", result)
    end

    -- Załaduj zwrócone przedmioty do sklepu.
    for i, rankedItem in ipairs(rankedProducts) do
        local productIdentifier = rankedItem.ProductIdentifier
        local productInfo = rankedItem.ProductInfo
        -- ...
        -- Logika dodawania productInfo do sklepu
    end
end)

Wyświetl swoje najlepsze przepustki

RecommendTopProductsAsync przyjmuje tablicę wartości InfoType i zwraca do 50 przedmiotów, z którymi użytkownik jest najbardziej skłonny się zainteresować i zakupić. Możesz użyć tej metody, aby stworzyć sekcję "Najlepsze Wybory" w swoim sklepie w grze.

Jeśli nie można określić żadnych rekomendacji, RecommendTopProductsAsync zwraca 0 przedmiotów. Żadne przepustki, które użytkownik już posiada, nie są również zwracane.

W rzadkich przypadkach wywołania modelu rankingowego mogą być wolne. Aby pomóc zapobiec dodaniu "na później" dla użytkowników, zalecamy użycie task.spawn, aby uczynić wywołanie RecommendTopProducts nieblokującym.

local MarketplaceService = game:GetService("MarketplaceService")

-- Utwórz tablicę typów produktów do uwzględnienia. W tym przypadku zarówno przepustki gier, jak i produkty dewelopera
local productTypes = {Enum.InfoType.GamePass, Enum.InfoType.Product}

-- Opcjonalnie: Owiń wywołanie w asynchroniczne zadanie, aby jeśli żądanie będzie wolne,
-- nie zamarzało interfejsu użytkownika / gry
task.spawn(function()
    -- Użyj pcall, aby obsłużyć błędy w sposób elegancki
    local success, result = pcall(function()
        return MarketplaceService:RecommendTopProductsAsync(productTypes)
    end)

    if not success then
        -- Jeśli niepowodzenie, 'result' to wiadomość o błędzie.
        warn("Nie udało się uporządkować produktów:", result)
    end

    -- Załaduj zwrócone przedmioty do sklepu. Upewnij się, że filtrujesz wszelkie 
    -- niekwalifikujące się przedmioty z topRankedItems, takie jak produkty dewelopera, które
    -- użytkownik już nie może kupić
    for i, rankedItem in ipairs(rankedProducts) do
        local productIdentifier = rankedItem.ProductIdentifier
        local productInfo = rankedItem.ProductInfo
        -- ...
        -- Logika dodawania productInfo do sklepu
    end
end)

Promuj przepustkę

Aby pomóc większej liczbie użytkowników odkryć twoją grę, możesz zdecydować się na umieszczenie swoich przepustek na stronie Kup Robux na Robloxie. Zdecydowanie się na promowanie swoich przepustek może pomóc zwiększyć czas i Robuxy, które użytkownicy spędzają w twojej grze. Nie ma ograniczeń co do liczby przepustek, które możesz promować.

Użytkownikom pokazywane są przepustki, które są odpowiednie do ich historii gier i zaangażowania na platformie. Nie są im pokazywane przepustki, które już posiadają.

Gdy użytkownicy kupują kwalifikujący się pakiet Robuxów, otrzymują promowaną przepustkę i są zachęcani do odebrania jej, dołączając do twojej gry.

Aby zdecydować się na promowanie jednej ze swoich przepustek:

1. Przejdź do Monetyzacja ⟩ Przepustki.
2. Wybierz przepustkę, którą chcesz promować.
3. Wybierz Promocje.
4. Włącz Uwzględnij ten przedmiot w puli bonusów.
5. Kliknij Zapisz zmiany. Przepustka jest wyświetlana odpowiednim użytkownikom na stronie Kup Robux.

Promowana przepustka:

• Może być w sprzedaży lub nie w sprzedaży. Jeśli jest w sprzedaży, jej wartość Robux musi być większa niż 49 Robuxów i mniejsza niż 801 Robuxów.
• Musi zawierać miniaturę.
• Nie może przyznawać płatnych losowych przedmiotów.
• Musi być zgodna z Standardami społeczności.

Analiza przepustek

Użyj analizy przepustek, aby przeanalizować sukces poszczególnych przepustek, zidentyfikować trendy i przewidzieć potencjalne przyszłe przychody.

Dzięki analizie możesz:

• Wyświetlać swoje najlepsze przepustki przez wybrany okres czasu.
• Pokazać do ośmiu najlepiej sprzedających się przedmiotów na wykresie czasowym, aby analizować całkowitą sprzedaż i zysk netto.
• Monitorować swój katalog i sortować przedmioty według sprzedaży i zysku netto.
• Wyświetlać, ile przepustek zostało nabytych przez użytkowników dzięki promocji na stronie Kup Robux.
• Wyświetlać, ile użytkowników dołączyło do twojej gry po nabyciu przepustki na stronie Kup Robux.

Aby uzyskać dostęp do analizy przepustek:

1. Przejdź do Tworzenia i wybierz grę.
2. Przejdź do Monetyzacja ⟩ Przepustki.
3. Wybierz zakładkę Analiza.