Passes

Passes permitem que você cobre uma taxa única em Robux dos usuários 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 í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. Digite 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 marketplace 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 declarações de print pelo código de UI 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 o possui em seu inventário. Você pode chamar esta função quando um usuário realiza 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 dizendo que o usuário já possui o pass
	else
		-- Solicitar compra do pass
		MarketplaceService:PromptGamePassPurchase(player, passID)
	end
end

Use PromptGamePassPurchaseFinished para lidar com uma solicitação de compra concluída 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 seu ID de Pass

-- Lidar com uma solicitação e compra concluída
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

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

Fora do seu jogo

Para vender um pass na aba Loja da página de detalhes do jogo:

1. Vá para Monetização ⟩ Passes.
2. Passe o mouse sobre o pass e clique no menu ⋯.
3. Selecione o pass que você deseja vender.
4. Selecione Vendas.
5. Ative a alternância Item à venda.
6. No campo Preço em Robux, insira a quantidade de Robux que deseja cobrar dos usuários pelo pass. O preço que você insere afeta quanto Robux você ganha por venda. O preço mínimo é 1 Robux, e o preço máximo é 1 bilhão de Robux.
7. Clique em Salvar Alterações. O pass será exibido na aba Loja da página de detalhes do jogo.

Atribuir privilégios do pass

Você deve atribuir manualmente privilégios de 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 para atribuí-los 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

-- Conectar 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 apresentar os itens mais relevantes para cada usuário, aumentando o engajamento e a receita. Ao adaptar os 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 este método para fornecer recomendações personalizadas de itens a seus usuários na sua loja do 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 UI / jogo
task.spawn(function()
    -- Use um pcall para lidar com erros de forma graciosa
    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 na loja
    end
end)

Exiba seus melhores 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 este método para criar uma seção "Escolhas Principais" na sua loja do 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, chamadas para o modelo de classificação podem ser lentas. Para ajudar a prevenir que os usuários adicionem atrasos, recomendamos usar task.spawn para tornar a chamada para RecommendTopProducts não bloqueante.

local MarketplaceService = game:GetService("MarketplaceService")

-- Crie um array de tipos de produto para incluir. Neste caso, passes do jogo e produtos do 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 UI / jogo
task.spawn(function()
    -- Use um pcall para lidar com erros de forma graciosa
    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 do 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 na 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 de 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 são mostrados passes que são relevantes para seu histórico de jogo e engajamento na plataforma. Eles não são mostrados 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 reclamar 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 na piscina de bônus.
5. Clique em Salvar Alterações. O pass será 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 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:

• Ver seus melhores 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.
• Ver quantos passes foram adquiridos por usuários por meio da promoção na página Comprar Robux.
• Ver quantos usuários entraram em 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álises.