Passes

Passes permitem que você cobre uma taxa única em Robux para acessar privilégios especiais dentro do seu jogo, como entrada em uma área restrita, um item de avatar no jogo ou um power-up permanente.

Criar um pass

Para criar um pass:

1. Vá para Criações e selecione um jogo.
2. Vá para Monetização ⟩ Passes.
3. Clique em Criar pass.
4. Faça o upload de uma imagem para exibir como o ícone do pass. Certifique-se de que a imagem não exceda 512x512 pixels, não inclua detalhes importantes fora de seus limites circulares e esteja no formato .jpg, .png ou .bmp.
5. Insira um nome e uma descrição para o pass.
6. Selecione uma categoria para o pass. A categoria é usada para organizar itens na sua Loja do jogo.
7. Clique em Criar pass.

Obter o ID do pass

Para usar a programação, você precisa de um ID de pass. Para obter o ID do pass:

1. Vá para Monetização ⟩ Passes.

2. Passe o mouse sobre a miniatura de um pass, clique no botão ⋯ e selecione Copiar ID do ativo no menu de contexto.

   

Vender um pass

Você pode vender passes de duas maneiras:

• Dentro do seu jogo
• Fora do seu jogo

Dentro do seu jogo

Para implementar e vender um pass dentro de um jogo, chame as funções MarketplaceService.

Use GetProductInfo() para recuperar informações sobre um pass, como nome e preço, e então exibir esse pass para os usuários. Você pode vender o pass dentro do mercado do seu jogo, por exemplo. Para passes, o segundo parâmetro deve ser Enum.InfoType.GamePass.

local MarketplaceService = game:GetService("MarketplaceService")

-- Substitua o ID de espaço reservado pelo seu ID de pass
local productId = 000000

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


if success and productInfo then
	-- Verifique se o produto está à venda
	if productInfo.IsForSale then
	-- Exiba as informações do produto
	-- Substitua as instruções de impressão pelo código da interface do usuário para exibir o pass
  	print("Nome do Pass: " .. productInfo.Name)
  	print("Preço em Robux: " .. productInfo.PriceInRobux)
  	print("Descrição: " .. productInfo.Description)
	else
		print("Este produto não está à venda")
	end
end

Use PromptGamePassPurchase() para solicitar a compra de um pass se o usuário ainda não tiver o pass em seu inventário. Você pode chamar essa função quando um usuário realizar ações como pressionar um botão ou conversar com um NPC vendedor.

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

-- Substitua o ID de espaço reservado pelo seu ID de pass
local passID = 0000000

-- Solicitar compra do 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("Erro ao verificar se o jogador possui o pass: " .. tostring(message))
		return
	end

	if hasPass then
		-- Mostre uma mensagem informando ao usuário que ele já possui o pass
	else
		-- Solicitar compra do pass
		MarketplaceService:PromptGamePassPurchase(player, passID)
	end
end

Use PromptGamePassPurchaseFinished para lidar com um prompt de compra de pass concluído e atribuir ao usuário os privilégios associados ao pass.

Coloque o script dentro do ServerScriptService para que o servidor gerencie os privilégios do pass do usuário.

local MarketplaceService = game:GetService("MarketplaceService")

-- Substitua o ID de espaço reservado pelo seu ID de pass
local passID = 0000000  -- Altere isso para o seu ID de Pass

-- Lidar com um prompt e compra concluídos
local function onPromptPurchaseFinished(player, purchasedPassID, purchaseSuccess)
	if purchaseSuccess and purchasedPassID == passID then
		print(player.Name .. " comprou o Pass com ID " .. passID)
		-- Atribua ao usuário a habilidade ou bônus relacionado ao pass
	end
end

-- Conecte os eventos PromptGamePassPurchaseFinished à função
MarketplaceService.PromptGamePassPurchaseFinished:Connect(onPromptPurchaseFinished)

Fora do seu jogo

O Roblox exibe seus passes Listados fora do seu jogo, incluindo na página inicial do Roblox, nos resultados de busca e na página pós-compra após um jogador comprar Robux. Um jogador pode comprar seu pass e, em seguida, entrar no seu jogo com ele já concedido.

Para tornar um pass elegível para vendas externas:

1. No Creator Hub, vá para Monetização ⟩ Loja.
2. Marque o pass como Listados.

Os passes não requerem uma correção de ProcessReceipt, mas devem ser Listados para aparecer fora do seu jogo. Recomendamos adicionar um ícone personalizado a cada pass para que os jogadores possam reconhecê-lo em superfícies externas; se você não adicionar um, o Roblox mostrará um ícone padrão.

Atribuir privilégios do pass

Você deve atribuir manualmente os privilégios do pass aos usuários que compram seus passes. Para fazer isso, use PlayerAdded quando um usuário entrar no seu jogo para verificar se ele já possui o pass e atribuir a ele os privilégios do pass.

Coloque o script dentro do ServerScriptService para que o servidor gerencie os privilégios do pass do usuário.

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

-- Substitua o ID de espaço reservado pelo seu ID de pass
local passID = 0000000

local function onPlayerAdded(player)
	local hasPass = false

	-- Verifique se o usuário já possui o pass
	local success, message = pcall(function()
		hasPass = MarketplaceService:UserOwnsGamePassAsync(player.UserId, passID)
	end)

	if not success then
		-- Emita um aviso e saia da função
		warn("Erro ao verificar se o jogador possui o pass: " .. tostring(message))
		return
	end

	if hasPass then
		-- Atribua ao usuário a habilidade ou bônus relacionado ao pass
		print(player.Name .. " possui o Pass com ID " .. passID)
	end
end

-- Conecte os eventos PlayerAdded à função
Players.PlayerAdded:Connect(onPlayerAdded)

Personalize sua loja no jogo

Você pode usar APIs de inteligência de produtos para classificar e recomendar passes aos usuários. Personalizar sua loja no jogo ajuda a exibir os itens mais relevantes para cada usuário, aumentando o engajamento e a receita. Ao adaptar passes às preferências dos usuários, você pode melhorar sua descoberta, aumentar as taxas de conversão e desbloquear novas oportunidades de monetização.

Classificar passes à venda

RankProductsAsync recebe uma lista de IDs de produtos e retorna uma lista ordenada personalizada desses produtos. Você pode usar esse método para fornecer recomendações de itens personalizadas aos seus usuários em sua loja no jogo.

local MarketplaceService = game:GetService("MarketplaceService")

-- Crie o array de produtos que você deseja classificar
local productIdentifiers = {
    {InfoType = Enum.InfoType.GamePass, Id = 123},
    {InfoType = Enum.InfoType.Product, Id = 456},
    {InfoType = Enum.InfoType.Product, Id = 789}
}

-- Opcional: Envolva a chamada em uma tarefa assíncrona para que, se a solicitação for lenta,
-- não congele a interface do usuário / jogo
task.spawn(function()
    -- Use um pcall para lidar com erros de forma elegante
    local success, result = pcall(function()
        return MarketplaceService:RankProductsAsync(productIdentifiers)
    end)

    if not success then
        -- Se falhar, 'result' é a mensagem de erro.
        warn("Falha ao classificar produtos:", result)
    end

    -- Carregue os itens retornados na loja.
    for i, rankedItem in ipairs(rankedProducts) do
        local productIdentifier = rankedItem.ProductIdentifier
        local productInfo = rankedItem.ProductInfo
        -- ...
        -- Lógica para adicionar productInfo à loja
    end
end)

Exibir seus principais passes

RecommendTopProductsAsync recebe um array de valores InfoType e retorna até 50 itens com os quais um usuário é mais provável de interagir e comprar. Você pode usar esse método para criar uma seção "Principais Escolhas" em sua loja no jogo.

Se nenhuma recomendação puder ser determinada, RecommendTopProductsAsync retorna 0 itens. Quaisquer passes que o usuário já possui também não são retornados.

Em casos raros, as chamadas para o modelo de classificação podem ser lentas. Para ajudar a evitar que os usuários sejam adicionados tarde, recomendamos usar task.spawn para tornar a chamada para RecommendTopProducts não bloqueante.

local MarketplaceService = game:GetService("MarketplaceService")

-- Crie um array de tipos de produtos a serem incluídos. Neste caso, tanto passes de jogo quanto produtos de desenvolvedor
local productTypes = {Enum.InfoType.GamePass, Enum.InfoType.Product}

-- Opcional: Envolva a chamada em uma tarefa assíncrona para que, se a solicitação for lenta,
-- não congele a interface do usuário / jogo
task.spawn(function()
    -- Use um pcall para lidar com erros de forma elegante
    local success, result = pcall(function()
        return MarketplaceService:RecommendTopProductsAsync(productTypes)
    end)

    if not success then
        -- Se falhar, 'result' é a mensagem de erro.
        warn("Falha ao classificar produtos:", result)
    end

    -- Carregue os itens retornados na loja. Certifique-se de filtrar quaisquer
    -- itens inelegíveis de topRankedItems, como produtos de desenvolvedor que
    -- o usuário não pode mais comprar
    for i, rankedItem in ipairs(rankedProducts) do
        local productIdentifier = rankedItem.ProductIdentifier
        local productInfo = rankedItem.ProductInfo
        -- ...
        -- Lógica para adicionar productInfo à loja
    end
end)

Promover um pass

Para ajudar mais usuários a descobrir seu jogo, você pode optar por ter seus passes destacados na página Comprar Robux do Roblox. Optar por promover seus passes pode ajudar a aumentar o tempo e os Robux que os usuários gastam em seu jogo. Não há limite para o número de passes que você pode promover.

Os usuários veem passes que são relevantes para seu histórico de jogo e engajamento na plataforma. Eles não veem passes que já possuem.

Quando os usuários compram um pacote de Robux elegível, eles recebem o pass promovido e são solicitados a reivindicar seu pass ao entrar no seu jogo.

Para optar por promover um de seus passes:

1. Vá para Monetização ⟩ Passes.
2. Selecione o pass que você deseja promover.
3. Selecione Promoções.
4. Ative Incluir este item no pool de bônus.
5. Clique em Salvar Alterações. O pass é exibido para usuários relevantes na página Comprar Robux.

O pass promovido:

• Pode estar fora de venda ou à venda. Se estiver à venda, seu valor em Robux deve ser maior que 49 Robux e menor que 801 Robux.
• Deve incluir uma miniatura.
• Não pode conceder itens aleatórios pagos.
• Deve cumprir com os Padrões da Comunidade.

Análise de passes

Use a análise de passes para analisar o sucesso de passes individuais, identificar tendências e prever potenciais ganhos futuros.

Com a análise, você pode:

• Visualizar seus principais passes ao longo de um período de tempo selecionado.
• Exibir até oito itens mais vendidos em um gráfico de séries temporais para analisar vendas gerais e receita líquida.
• Monitorar seu catálogo e classificar itens por vendas e receita líquida.
• Visualizar quantos passes foram adquiridos por usuários através da promoção na página Comprar Robux.
• Visualizar quantos usuários entraram no seu jogo após adquirir o pass através da página Comprar Robux.

Para acessar a análise de passes:

1. Vá para Criações e selecione um jogo.
2. Vá para Monetização ⟩ Passes.
3. Selecione a aba Análise.