Pass

Pass consentono di addebitare agli utenti una tariffa unica in Robux per accedere a privilegi speciali all'interno del tuo gioco, come l'ingresso in un'area riservata, un oggetto avatar in-game o un potenziamento permanente.

Crea un pass

Per creare un pass:

1. Vai a Creazioni e seleziona un gioco.
2. Vai su Monetizzazione ⟩ Pass.
3. Clicca su Crea pass.
4. Carica un'immagine da visualizzare come icona del pass. Assicurati che l'immagine non superi i 512x512 pixel, non includa dettagli importanti al di fuori dei suoi confini circolari e sia in formato .jpg, .png o .bmp.
5. Inserisci un nome e una descrizione per il pass.
6. Seleziona una categoria per il pass. La categoria viene utilizzata per organizzare gli oggetti nel tuo negozio in-game.
7. Clicca su Crea pass.

Ottieni l'ID del pass

Per utilizzare la programmazione, hai bisogno di un ID pass. Per ottenere l'ID del pass:

1. Vai su Monetizzazione ⟩ Pass.

2. Passa il mouse sopra la miniatura di un pass, clicca sul pulsante ⋯ e seleziona Copia ID asset dal menu contestuale.

   

Vendi un pass

Puoi vendere pass in due modi:

• All'interno del tuo gioco
• All'esterno del tuo gioco

All'interno del tuo gioco

Per implementare e vendere un pass all'interno di un gioco, chiama le funzioni MarketplaceService.

Usa GetProductInfo() per recuperare informazioni su un pass, come nome e prezzo, e poi per visualizzare quel pass agli utenti. Puoi vendere il pass all'interno del marketplace del tuo gioco, ad esempio. Per i pass, il secondo parametro deve essere Enum.InfoType.GamePass.

local MarketplaceService = game:GetService("MarketplaceService")

-- Sostituisci l'ID segnaposto con il tuo ID pass
local productId = 000000

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


if success and productInfo then
	-- Controlla se il prodotto è in vendita
	if productInfo.IsForSale then
	-- Visualizza le informazioni sul prodotto
	-- Sostituisci le istruzioni di stampa con codice UI per visualizzare il pass
  	print("Nome del Pass: " .. productInfo.Name)
  	print("Prezzo in Robux: " .. productInfo.PriceInRobux)
  	print("Descrizione: " .. productInfo.Description)
	else
		print("Questo prodotto non è in vendita")
	end
end

Usa PromptGamePassPurchase() per richiedere l'acquisto di un pass se l'utente non possiede già il pass nel proprio inventario. Puoi chiamare questa funzione quando un utente esegue azioni come premere un pulsante o parlare con un NPC venditore.

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

-- Sostituisci l'ID segnaposto con il tuo ID pass
local passID = 0000000

-- Richiesta di acquisto del pass
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("Errore durante il controllo se il giocatore possiede il pass: " .. tostring(message))
		return
	end

	if hasPass then
		-- Mostra un messaggio che informa l'utente che possiede già il pass
	else
		-- Richiesta di acquisto del pass
		MarketplaceService:PromptGamePassPurchase(player, passID)
	end
end

Usa PromptGamePassPurchaseFinished per gestire un prompt di acquisto di pass completato e assegnare all'utente i privilegi associati al pass.

Posiziona lo script all'interno di ServerScriptService in modo che il server gestisca i privilegi del pass dell'utente.

local MarketplaceService = game:GetService("MarketplaceService")

-- Sostituisci l'ID segnaposto con il tuo ID pass
local passID = 0000000  -- Cambia questo con il tuo ID Pass

-- Gestisci un prompt e un acquisto completati
local function onPromptPurchaseFinished(player, purchasedPassID, purchaseSuccess)
	if purchaseSuccess and purchasedPassID == passID then
		print(player.Name .. " ha acquistato il Pass con ID " .. passID)
		-- Assegna all'utente l'abilità o il bonus relativo al pass
	end
end

-- Collega gli eventi PromptGamePassPurchaseFinished alla funzione
MarketplaceService.PromptGamePassPurchaseFinished:Connect(onPromptPurchaseFinished)

All'esterno del tuo gioco

Roblox mostra i tuoi pass Elencati al di fuori del tuo gioco, inclusi sulla homepage di Roblox, nei risultati di ricerca e sulla pagina post-acquisto dopo che un giocatore acquista Robux. Un giocatore può acquistare il tuo pass e poi unirsi al tuo gioco con esso già concesso.

Per rendere un pass idoneo per le vendite esterne:

1. Nella Creator Hub, vai su Monetizzazione ⟩ Negozio.
2. Contrassegna il pass come Elencato.

I pass non richiedono una correzione ProcessReceipt, ma devono essere Elencati per apparire al di fuori del tuo gioco. Ti consigliamo di aggiungere un'icona personalizzata a ciascun pass in modo che i giocatori possano riconoscerlo su superfici esterne; se non ne aggiungi una, Roblox mostra un'icona predefinita.

Assegna privilegi del pass

Devi assegnare manualmente i privilegi del pass agli utenti che acquistano i tuoi pass. Per fare ciò, utilizza PlayerAdded quando un utente entra nel tuo gioco per controllare se possiede già il pass e per assegnargli i privilegi del pass.

Posiziona lo script all'interno di ServerScriptService in modo che il server gestisca i privilegi del pass dell'utente.

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

-- Sostituisci l'ID segnaposto con il tuo ID pass
local passID = 0000000

local function onPlayerAdded(player)
	local hasPass = false

	-- Controlla se l'utente possiede già il pass
	local success, message = pcall(function()
		hasPass = MarketplaceService:UserOwnsGamePassAsync(player.UserId, passID)
	end)

	if not success then
		-- Emmetti un avviso ed esci dalla funzione
		warn("Errore durante il controllo se il giocatore ha il pass: " .. tostring(message))
		return
	end

	if hasPass then
		-- Assegna all'utente l'abilità o il bonus relativo al pass
		print(player.Name .. " possiede il Pass con ID " .. passID)
	end
end

-- Collega gli eventi PlayerAdded alla funzione
Players.PlayerAdded:Connect(onPlayerAdded)

Personalizza il tuo negozio in-game

Puoi utilizzare le API di intelligenza dei prodotti per ordinare e raccomandare pass agli utenti. Personalizzare il tuo negozio in-game aiuta a mostrare gli oggetti più pertinenti a ciascun utente, aumentando il coinvolgimento e le entrate. Personalizzando i pass in base alle preferenze degli utenti, puoi migliorare la loro scoperta, aumentare i tassi di conversione e sbloccare nuove opportunità di monetizzazione.

Classifica i pass in vendita

RankProductsAsync accetta un elenco di ID prodotto e restituisce un elenco ordinato personalizzato di quei prodotti. Puoi utilizzare questo metodo per fornire ai tuoi utenti raccomandazioni personalizzate di oggetti nel tuo negozio in-game.

local MarketplaceService = game:GetService("MarketplaceService")

-- Crea l'array di prodotti che desideri classificare
local productIdentifiers = {
    {InfoType = Enum.InfoType.GamePass, Id = 123},
    {InfoType = Enum.InfoType.Product, Id = 456},
    {InfoType = Enum.InfoType.Product, Id = 789}
}

-- Facoltativo: Avvolgi la chiamata in un'attività asincrona in modo che se la richiesta è lenta,
-- non congeli l'interfaccia utente / il gioco
task.spawn(function()
    -- Usa un pcall per gestire gli errori in modo elegante
    local success, result = pcall(function()
        return MarketplaceService:RankProductsAsync(productIdentifiers)
    end)

    if not success then
        -- Se fallito, 'result' è il messaggio di errore.
        warn("Impossibile classificare i prodotti:", result)
    end

    -- Carica gli oggetti restituiti nel negozio.
    for i, rankedItem in ipairs(rankedProducts) do
        local productIdentifier = rankedItem.ProductIdentifier
        local productInfo = rankedItem.ProductInfo
        -- ...
        -- Logica per aggiungere productInfo nel negozio
    end
end)

Mostra i tuoi pass migliori

RecommendTopProductsAsync accetta un array di valori InfoType e restituisce fino a 50 oggetti con cui un utente è più probabile che interagisca e acquisti. Puoi utilizzare questo metodo per creare una sezione "Scelte migliori" nel tuo negozio in-game.

Se non è possibile determinare raccomandazioni, RecommendTopProductsAsync restituisce 0 oggetti. Qualsiasi pass che l'utente possiede già non viene restituito.

In rari casi, le chiamate al modello di classificazione possono essere lente. Per aiutare a prevenire ritardi per gli utenti, ti consigliamo di utilizzare task.spawn per rendere la chiamata a RecommendTopProducts non bloccante.

local MarketplaceService = game:GetService("MarketplaceService")

-- Crea un array di tipi di prodotto da includere. In questo caso sia pass di gioco che prodotti per sviluppatori
local productTypes = {Enum.InfoType.GamePass, Enum.InfoType.Product}

-- Facoltativo: Avvolgi la chiamata in un'attività asincrona in modo che se la richiesta è lenta,
-- non congeli l'interfaccia utente / il gioco
task.spawn(function()
    -- Usa un pcall per gestire gli errori in modo elegante
    local success, result = pcall(function()
        return MarketplaceService:RecommendTopProductsAsync(productTypes)
    end)

    if not success then
        -- Se fallito, 'result' è il messaggio di errore.
        warn("Impossibile classificare i prodotti:", result)
    end

    -- Carica gli oggetti restituiti nel negozio. Assicurati di filtrare eventuali
    -- oggetti non idonei da topRankedItems come prodotti per sviluppatori che
    -- l'utente non può più acquistare
    for i, rankedItem in ipairs(rankedProducts) do
        local productIdentifier = rankedItem.ProductIdentifier
        local productInfo = rankedItem.ProductInfo
        -- ...
        -- Logica per aggiungere productInfo nel negozio
    end
end)

Promuovi un pass

Per aiutare più utenti a scoprire il tuo gioco, puoi optare per avere i tuoi pass in evidenza sulla pagina Acquista Robux di Roblox. Optare per promuovere i tuoi pass può aiutare ad aumentare il tempo e i Robux che gli utenti spendono nel tuo gioco. Non c'è limite al numero di pass che puoi promuovere.

Gli utenti vedono pass che sono pertinenti alla loro cronologia di gioco e coinvolgimento sulla piattaforma. Non vengono mostrati pass che possiedono già.

Quando gli utenti acquistano un pacchetto Robux idoneo, ricevono il pass promosso e vengono invitati a richiedere il loro pass unendosi al tuo gioco.

Per optare per promuovere uno dei tuoi pass:

1. Vai su Monetizzazione ⟩ Pass.
2. Seleziona il pass che desideri promuovere.
3. Seleziona Promozioni.
4. Abilita Includi questo oggetto nel pool bonus.
5. Clicca su Salva modifiche. Il pass viene mostrato agli utenti pertinenti nella pagina Acquista Robux.

Il pass promosso:

• Può essere non in vendita o in vendita. Se sono in vendita, il loro valore in Robux deve essere maggiore di 49 Robux e inferiore a 801 Robux.
• Deve includere una miniatura.
• Non può concedere oggetti casuali a pagamento.
• Deve rispettare gli Standard della comunità.

Analisi dei pass

Utilizza l'analisi dei pass per analizzare il successo di singoli pass, identificare tendenze e prevedere potenziali guadagni futuri.

Con l'analisi, puoi:

• Visualizzare i tuoi pass migliori su un periodo di tempo selezionato.
• Mostrare fino a otto articoli più venduti su un grafico temporale per analizzare le vendite complessive e il reddito netto.
• Monitorare il tuo catalogo e ordinare gli oggetti per vendite e reddito netto.
• Visualizzare quanti pass sono stati acquisiti dagli utenti tramite promozione sulla pagina Acquista Robux.
• Visualizzare quanti utenti si sono uniti al tuo gioco dopo aver acquisito il pass tramite la pagina Acquista Robux.

Per accedere all'analisi dei pass:

1. Vai a Creazioni e seleziona un gioco.
2. Vai su Monetizzazione ⟩ Pass.
3. Seleziona la scheda Analisi.