Toegangspassen

Toegangspassen stellen je in staat om gebruikers een eenmalige Robux-kosten te laten betalen voor toegang tot speciale privileges in je game, zoals toegang tot een beperkt gebied, een in-game avatar-item of een permanente power-up.

Maak een toegangspas

Om een toegangspas te maken:

1. Ga naar Creaties en selecteer een game.
2. Ga naar Monetisatie ⟩ Toegangspassen.
3. Klik op Maak toegangspas.
4. Upload een afbeelding om weer te geven als het pasicoon. Zorg ervoor dat de afbeelding niet groter is dan 512x512 pixels, geen belangrijke details buiten de cirkelvormige grenzen bevat en in .jpg, .png of .bmp formaat is.
5. Voer een naam en een beschrijving voor de toegangspas in.
6. Selecteer een categorie voor de toegangspas. De categorie wordt gebruikt om items in je in-game winkel te organiseren.
7. Klik op Maak toegangspas.

Verkrijg de toegangspas-ID

Om scripting te gebruiken, heb je een toegangspas-ID nodig. Om de toegangspas-ID te verkrijgen:

1. Ga naar Monetisatie ⟩ Toegangspassen.

2. Beweeg de muis over de miniatuur van een toegangspas, klik op de ⋯ knop en selecteer Kopieer Asset-ID uit het contextmenu.

   

Verkoop een toegangspas

Je kunt toegangspassen op twee manieren verkopen:

• Binnen je game
• Buiten je game

Binnen je game

Om een toegangspas binnen een game te implementeren en te verkopen, roep je MarketplaceService functies aan.

Gebruik GetProductInfo() om informatie over een toegangspas op te halen, zoals naam en prijs, en om die toegangspas vervolgens aan gebruikers weer te geven. Je kunt de toegangspas bijvoorbeeld binnen de marktplaats van je game verkopen. Voor toegangspassen moet de tweede parameter Enum.InfoType.GamePass zijn.

local MarketplaceService = game:GetService("MarketplaceService")

-- Vervang de tijdelijke ID door je toegangspas-ID
local productId = 000000

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


if success and productInfo then
	-- Controleer of het product te koop is
	if productInfo.IsForSale then
	-- Toon productinformatie
	-- Vervang de print-instructies door UI-code om de toegangspas weer te geven
  	print("Toegangspas Naam: " .. productInfo.Name)
  	print("Prijs in Robux: " .. productInfo.PriceInRobux)
  	print("Beschrijving: " .. productInfo.Description)
	else
		print("Dit product is niet te koop")
	end
end

Gebruik PromptGamePassPurchase() om een aankoop van de toegangspas aan te vragen als de gebruiker de toegangspas nog niet in zijn inventaris heeft. Je kunt deze functie aanroepen wanneer een gebruiker acties uitvoert, zoals het indrukken van een knop of het praten met een verkoper NPC.

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

-- Vervang de tijdelijke ID door je toegangspas-ID
local passID = 0000000

-- Vraag aankoop van de toegangspas aan
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("Fout bij het controleren of speler de toegangspas heeft: " .. tostring(message))
		return
	end

	if hasPass then
		-- Toon een bericht dat de gebruiker al de toegangspas bezit
	else
		-- Vraag aankoop van de toegangspas aan
		MarketplaceService:PromptGamePassPurchase(player, passID)
	end
end

Gebruik PromptGamePassPurchaseFinished om een voltooide toegangspasprompt en aankoop te verwerken en de gebruiker de privileges die aan de toegangspas zijn gekoppeld toe te wijzen.

Plaats het script in de ServerScriptService zodat de server de passprivileges van de gebruiker beheert.

local MarketplaceService = game:GetService("MarketplaceService")

-- Vervang de tijdelijke ID door je toegangspas-ID
local passID = 0000000  -- Verander dit in je Toegangspas-ID

-- Verwerk een voltooide prompt en aankoop
local function onPromptPurchaseFinished(player, purchasedPassID, purchaseSuccess)
	if purchaseSuccess and purchasedPassID == passID then
		print(player.Name .. " heeft de Toegangspas met ID " .. passID .. " gekocht")
		-- Ken de gebruiker de mogelijkheid of bonus toe die aan de toegangspas is gekoppeld
	end
end

-- Verbind PromptGamePassPurchaseFinished evenementen met de functie
MarketplaceService.PromptGamePassPurchaseFinished:Connect(onPromptPurchaseFinished)

Buiten je game

Roblox toont je Gedeelde toegangspassen buiten je game, inclusief op de Roblox-startpagina, in zoekresultaten en op de pagina na aankoop nadat een speler Robux heeft gekocht. Een speler kan je toegangspas kopen en vervolgens je game betreden met de toegangspas al verleend.

Om een toegangspas in aanmerking te laten komen voor externe verkopen:

1. Ga in de Creator Hub naar Monetisatie ⟩ Winkel.
2. Markeer de toegangspas als Gedeeld.

Toegangspassen vereisen geen ProcessReceipt fix, maar ze moeten Gedeeld zijn om buiten je game te verschijnen. We raden aan om een aangepast pictogram aan elke toegangspas toe te voegen, zodat spelers deze op externe oppervlakken kunnen herkennen; als je er geen toevoegt, toont Roblox een standaardpictogram.

Ken passprivileges toe

Je moet handmatig passprivileges toekennen aan gebruikers die je toegangspassen kopen. Om dit te doen, gebruik je PlayerAdded wanneer een gebruiker je game betreedt om te controleren of ze de toegangspas al bezitten en om hen de passprivileges toe te kennen.

Plaats het script in de ServerScriptService zodat de server de passprivileges van de gebruiker beheert.

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

-- Vervang de tijdelijke ID door je toegangspas-ID
local passID = 0000000

local function onPlayerAdded(player)
	local hasPass = false

	-- Controleer of de gebruiker de toegangspas al bezit
	local success, message = pcall(function()
		hasPass = MarketplaceService:UserOwnsGamePassAsync(player.UserId, passID)
	end)

	if not success then
		-- Geef een waarschuwing en verlaat de functie
		warn("Fout bij het controleren of speler de toegangspas heeft: " .. tostring(message))
		return
	end

	if hasPass then
		-- Ken de gebruiker de mogelijkheid of bonus toe die aan de toegangspas is gekoppeld
		print(player.Name .. " bezit de Toegangspas met ID " .. passID)
	end
end

-- Verbind PlayerAdded evenementen met de functie
Players.PlayerAdded:Connect(onPlayerAdded)

Personaliseer je in-game winkel

Je kunt productintelligentie-API's gebruiken om toegangspassen te sorteren en aan gebruikers aan te bevelen. Het personaliseren van je in-game winkel helpt om de meest relevante items voor elke gebruiker naar voren te brengen, wat de betrokkenheid en inkomsten verhoogt. Door toegangspassen af te stemmen op gebruikersvoorkeuren, kun je hun ontdekking verbeteren, conversieratio's verhogen en nieuwe monetisatiekansen ontsluiten.

Rangschik toegangspassen voor verkoop

RankProductsAsync neemt een lijst van product-ID's en retourneert een gepersonaliseerde geordende lijst van die producten. Je kunt deze methode gebruiken om je gebruikers gepersonaliseerde itemaanbevelingen in je in-game winkel te bieden.

local MarketplaceService = game:GetService("MarketplaceService")

-- Maak de array van producten die je wilt rangschikken
local productIdentifiers = {
    {InfoType = Enum.InfoType.GamePass, Id = 123},
    {InfoType = Enum.InfoType.Product, Id = 456},
    {InfoType = Enum.InfoType.Product, Id = 789}
}

-- Optioneel: Wikkel de aanroep in een asynchrone taak zodat als het verzoek traag is,
-- het de UI / game niet bevriest
task.spawn(function()
    -- Gebruik een pcall om fouten op een nette manier af te handelen
    local success, result = pcall(function()
        return MarketplaceService:RankProductsAsync(productIdentifiers)
    end)

    if not success then
        -- Als het mislukt, is 'result' het foutbericht.
        warn("Mislukt om producten te rangschikken:", result)
    end

    -- Laad de geretourneerde items in de winkel.
    for i, rankedItem in ipairs(rankedProducts) do
        local productIdentifier = rankedItem.ProductIdentifier
        local productInfo = rankedItem.ProductInfo
        -- ...
        -- Logica om productInfo aan de winkel toe te voegen
    end
end)

Toon je top toegangspassen

RecommendTopProductsAsync neemt een array van InfoType waarden en retourneert tot 50 items waarmee een gebruiker het meest waarschijnlijk zal interageren en kopen. Je kunt deze methode gebruiken om een "Top Picks" sectie in je in-game winkel te creëren.

Als er geen aanbevelingen kunnen worden bepaald, retourneert RecommendTopProductsAsync 0 items. Toegangspassen die de gebruiker al bezit, worden ook niet geretourneerd.

In zeldzame gevallen kunnen oproepen naar het rangmodel traag zijn. Om te helpen voorkomen dat gebruikers te lang moeten wachten, raden we aan om task.spawn te gebruiken om de aanroep naar RecommendTopProducts niet-blokkerend te maken.

local MarketplaceService = game:GetService("MarketplaceService")

-- Maak een array van producttypes om op te nemen. In dit geval zowel toegangspassen als ontwikkelaarsproducten
local productTypes = {Enum.InfoType.GamePass, Enum.InfoType.Product}

-- Optioneel: Wikkel de aanroep in een asynchrone taak zodat als het verzoek traag is,
-- het de UI / game niet bevriest
task.spawn(function()
    -- Gebruik een pcall om fouten op een nette manier af te handelen
    local success, result = pcall(function()
        return MarketplaceService:RecommendTopProductsAsync(productTypes)
    end)

    if not success then
        -- Als het mislukt, is 'result' het foutbericht.
        warn("Mislukt om producten te rangschikken:", result)
    end

    -- Laad de geretourneerde items in de winkel. Zorg ervoor dat je alle
    -- niet-geschikte items uit topRankedItems filtert, zoals ontwikkelaarsproducten die
    -- de gebruiker niet langer kan kopen
    for i, rankedItem in ipairs(rankedProducts) do
        local productIdentifier = rankedItem.ProductIdentifier
        local productInfo = rankedItem.ProductInfo
        -- ...
        -- Logica om productInfo aan de winkel toe te voegen
    end
end)

Promoot een toegangspas

Om meer gebruikers te helpen je game te ontdekken, kun je ervoor kiezen om je toegangspassen te laten presenteren op de Roblox Koop Robux pagina. Je aanmelden om je toegangspassen te promoten kan helpen om de tijd en Robux die gebruikers in je game doorbrengen te verhogen. Er is geen limiet aan het aantal toegangspassen dat je kunt promoten.

Gebruikers krijgen toegangspassen te zien die relevant zijn voor hun speelgeschiedenis en betrokkenheid op het platform. Ze krijgen geen toegangspassen te zien die ze al bezitten.

Wanneer gebruikers een in aanmerking komend Robux-pakket kopen, ontvangen ze de gepromote toegangspas en worden ze gevraagd om hun toegangspas te claimen door je game te betreden.

Om je aan te melden om een van je toegangspassen te promoten:

1. Ga naar Monetisatie ⟩ Toegangspassen.
2. Selecteer de toegangspas die je wilt promoten.
3. Selecteer Promoties.
4. Schakel Dit item opnemen in de bonuspool in.
5. Klik op Wijzigingen opslaan. De toegangspas wordt getoond aan relevante gebruikers op de Koop Robux pagina.

De gepromote toegangspas:

• Kan niet te koop zijn of te koop zijn. Als ze te koop zijn, moet hun Robux-waarde groter zijn dan 49 Robux en minder dan 801 Robux.
• Moet een thumbnail bevatten.
• Mag geen betaalde willekeurige items verlenen.
• Moet voldoen aan de Gemeenschapsnormen.

Toegangspasanalyses

Gebruik toegangspasanalyses om het succes van individuele toegangspassen te analyseren, trends te identificeren en potentiële toekomstige inkomsten te voorspellen.

Met analyses kun je:

• Je top toegangspassen over een geselecteerde periode bekijken.
• Tot acht best verkopende items op een tijdreeksdiagram tonen om de totale verkopen en netto-inkomsten te analyseren.
• Je catalogus volgen en items sorteren op verkopen en netto-inkomsten.
• Bekijken hoeveel toegangspassen door gebruikers zijn verworven via promotie op de Koop Robux pagina.
• Bekijken hoeveel gebruikers je game zijn binnengekomen nadat ze de toegangspas via de Koop Robux pagina hebben verworven.

Om toegang te krijgen tot toegangspasanalyses:

1. Ga naar Creaties en selecteer een game.
2. Ga naar Monetisatie ⟩ Toegangspassen.
3. Selecteer het tabblad Analyses.