Pass

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

Crea un pass

Per creare un pass:

1. Vai su 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 contenga dettagli importanti al di fuori dei suoi confini circolari ed 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 serve per organizzare gli oggetti nel tuo negozio in-game.
7. Clicca su Crea pass.

Ottieni l'ID del pass

Per utilizzare lo scripting, hai bisogno di un ID pass. Per ottenere l'ID pass:

1. Vai su Monetizzazione ⟩ Pass.

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

   

Vendi un pass

Puoi vendere i pass in due modi:

• All'interno del tuo gioco
• Al di fuori 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 print con codice UI per visualizzare il pass
  	print("Nome 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 invitare un acquisto del 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

-- Invita all'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
		-- Invita all'acquisto del pass
		MarketplaceService:PromptGamePassPurchase(player, passID)
	end
end

Usa PromptGamePassPurchaseFinished per gestire un acquisto e un invito a un acquisto completati e assegnare all'utente i privilegi associati al pass.

Posiziona lo script all'interno di ServerScriptService affinché il server gestisca i privilegi 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 invito e acquisto completato
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)

Al di fuori del tuo gioco

Per vendere un pass nella scheda Negozio della pagina dei dettagli del gioco:

1. Vai su Monetizzazione ⟩ Pass.
2. Passa il mouse sopra il pass e clicca sul menu ⋯.
3. Seleziona il pass che desideri vendere.
4. Seleziona Vendite.
5. Attiva l'interruttore Oggetto in vendita.
6. Nel campo Prezzo in Robux, inserisci l'importo di Robux che desideri addebitare agli utenti per il pass. Il prezzo che inserisci influisce su quanti Robux guadagni per ogni vendita. Il prezzo minimo è 1 Robux, e il massimo è 1 miliardo di Robux.
7. Clicca su Salva modifiche. Il pass verrà visualizzato nella scheda Negozio della pagina dei dettagli del gioco.

Assegna privilegi del pass

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

Posiziona lo script all'interno di ServerScriptService affinché il server gestisca i privilegi 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 possiede 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 usare le API di intelligenza sui prodotti per ordinare e raccomandare pass agli utenti. La personalizzazione del tuo negozio in-game aiuta a mettere in risalto gli oggetti più pertinenti per 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 prende in input 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 sugli 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 blocchi 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 nello store.
    for i, rankedItem in ipairs(rankedProducts) do
        local productIdentifier = rankedItem.ProductIdentifier
        local productInfo = rankedItem.ProductInfo
        -- ...
        -- Logica per aggiungere productInfo nello store
    end
end)

Mostra i tuoi pass migliori

RecommendTopProductsAsync prende un array di valori InfoType e restituisce fino a 50 oggetti con cui un utente ha maggiore probabilità di interagire e acquistare. Puoi utilizzare questo metodo per creare una sezione "Top Picks" nel tuo negozio in-game.

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

Nei rari casi in cui le chiamate al modello di classificazione possono essere lente. Per aiutare a prevenire il blocco dell'interfaccia utente, 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 blocchi 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 nello store. Assicurati di filtrare
    -- gli oggetti non idonei da topRankedItems come prodotti per sviluppatori che
    -- non possono più essere acquistati dall'utente
    for i, rankedItem in ipairs(rankedProducts) do
        local productIdentifier = rankedItem.ProductIdentifier
        local productInfo = rankedItem.ProductInfo
        -- ...
        -- Logica per aggiungere productInfo nello store
    end
end)

Promuovi un pass

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

Agli utenti vengono mostrati pass pertinenti alla loro storia 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 rivendicarlo 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. Attiva Includi questo oggetto nel bonus pool.
5. Clicca su Salva modifiche. Il pass viene mostrato agli utenti pertinenti nella pagina Acquista Robux.

Il pass promosso:

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

Analisi del pass

Usa l'analisi dei pass per analizzare il successo dei pass individuali, identificare tendenze e prevedere guadagni futuri potenziali.

Con l'analisi, puoi:

• Visualizzare i tuoi pass migliori su un periodo di tempo selezionato.
• Mostrare fino a otto articoli top-seller su un grafico temporale per analizzare le vendite e il fatturato netto complessivo.
• Monitorare il tuo catalogo e ordinare gli oggetti in base alle vendite e al fatturato netto.
• Visualizzare quanti pass sono stati acquisiti dagli utenti tramite promozione nella 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 su Creazioni e seleziona un gioco.
2. Vai su Monetizzazione ⟩ Pass.
3. Seleziona la scheda Analisi.