Pases

Pases te permiten cobrar a los usuarios una tarifa única en Robux para acceder a privilegios especiales dentro de tu juego, como la entrada a un área restringida, un artículo de avatar en el juego o un potenciador permanente.

Crear un pase

Para crear un pase:

1. Ve a Creaciones y selecciona un juego.
2. Ve a Monetización ⟩ Pases.
3. Haz clic en Crear pase.
4. Sube una imagen para mostrar como el ícono del pase. Asegúrate de que la imagen no exceda los 512x512 píxeles, no incluya detalles importantes fuera de sus límites circulares y esté en formato .jpg, .png o .bmp.
5. Ingresa un nombre y una descripción para el pase.
6. Selecciona una categoría para el pase. La categoría se utiliza para organizar los artículos en tu Tienda dentro del juego.
7. Haz clic en Crear pase.

Obtener el ID del pase

Para usar la secuenciación, necesitas un ID de pase. Para obtener el ID del pase:

1. Ve a Monetización ⟩ Pases.

2. Pasa el cursor sobre la miniatura de un pase, haz clic en el botón ⋯ y selecciona Copiar ID de activo del menú contextual.

   

Vender un pase

Puedes vender pases de dos maneras:

• Dentro de tu juego
• Fuera de tu juego

Dentro de tu juego

Para implementar y vender un pase dentro de un juego, llama a las funciones de MarketplaceService.

Usa GetProductInfo() para recuperar información sobre un pase, como el nombre y el precio, y luego para mostrar ese pase a los usuarios. Puedes vender el pase dentro del mercado de tu juego, por ejemplo. Para los pases, el segundo parámetro debe ser Enum.InfoType.GamePass.

local MarketplaceService = game:GetService("MarketplaceService")

-- Reemplaza el ID de marcador de posición con tu ID de pase
local productId = 000000

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


if success and productInfo then
	-- Verifica si el producto está a la venta
	if productInfo.IsForSale then
	-- Muestra la información del producto
	-- Reemplaza las declaraciones de impresión con el código de UI para mostrar el pase
  	print("Nombre del Pase: " .. productInfo.Name)
  	print("Precio en Robux: " .. productInfo.PriceInRobux)
  	print("Descripción: " .. productInfo.Description)
	else
		print("Este producto no está a la venta")
	end
end

Usa PromptGamePassPurchase() para solicitar la compra de un pase si el usuario no tiene el pase en su inventario. Puedes llamar a esta función cuando un usuario realice acciones como presionar un botón o hablar con un NPC vendedor.

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

-- Reemplaza el ID de marcador de posición con tu ID de pase
local passID = 0000000

-- Solicitar compra del pase
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("Error al verificar si el jugador tiene el pase: " .. tostring(message))
		return
	end

	if hasPass then
		-- Muestra un mensaje diciendo al usuario que ya tiene el pase
	else
		-- Solicitar compra del pase
		MarketplaceService:PromptGamePassPurchase(player, passID)
	end
end

Usa PromptGamePassPurchaseFinished para manejar un aviso completado de compra de pase y asignar al usuario los privilegios asociados con el pase.

Coloca el script dentro de ServerScriptService para que el servidor maneje los privilegios del pase del usuario.

local MarketplaceService = game:GetService("MarketplaceService")

-- Reemplaza el ID de marcador de posición con tu ID de pase
local passID = 0000000  -- Cambia esto a tu ID de Pase

-- Manejar un aviso y compra completada
local function onPromptPurchaseFinished(player, purchasedPassID, purchaseSuccess)
	if purchaseSuccess and purchasedPassID == passID then
		print(player.Name .. " compró el Pase con ID " .. passID)
		-- Asigna al usuario la habilidad o bonificación relacionada con el pase
	end
end

-- Conectar eventos de PromptGamePassPurchaseFinished a la función
MarketplaceService.PromptGamePassPurchaseFinished:Connect(onPromptPurchaseFinished)

Fuera de tu juego

Para vender un pase en la pestaña de Tienda de la página de detalles del juego:

1. Ve a Monetización ⟩ Pases.
2. Pasa el cursor sobre el pase y haz clic en el menú ⋯.
3. Selecciona el pase que deseas vender.
4. Selecciona Ventas.
5. Activa el interruptor de Artículo a la venta.
6. En el campo de Precio en Robux, ingresa la cantidad de Robux que deseas cobrar a los usuarios por el pase. El precio que ingresas afecta cuántos Robux ganas por venta. El precio mínimo es 1 Robux y el precio máximo es 1 mil millones de Robux.
7. Haz clic en Guardar Cambios. El pase se mostrará en la pestaña de Tienda en la página de detalles del juego.

Asignar privilegios de pase

Debes asignar manualmente los privilegios del pase a los usuarios que compren tus pases. Para hacerlo, usa PlayerAdded cuando un usuario se una a tu juego para verificar si ya posee el pase y para asignarle los privilegios del pase.

Coloca el script dentro de ServerScriptService para que el servidor maneje los privilegios del pase del usuario.

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

-- Reemplaza el ID de marcador de posición con tu ID de pase
local passID = 0000000

local function onPlayerAdded(player)
	local hasPass = false

	-- Verifica si el usuario ya posee el pase
	local success, message = pcall(function()
		hasPass = MarketplaceService:UserOwnsGamePassAsync(player.UserId, passID)
	end)

	if not success then
		-- Emite una advertencia y sale de la función
		warn("Error al verificar si el jugador tiene el pase: " .. tostring(message))
		return
	end

	if hasPass then
		-- Asigna al usuario la habilidad o bonificación relacionada con el pase
		print(player.Name .. " posee el Pase con ID " .. passID)
	end
end

-- Conectar eventos PlayerAdded a la función
Players.PlayerAdded:Connect(onPlayerAdded)

Personalizar tu tienda en el juego

Puedes usar APIs de inteligencia de productos para clasificar y recomendar pases a los usuarios. Personalizar tu tienda en el juego ayuda a presentar los artículos más relevantes a cada usuario, aumentando la participación y los ingresos. Al adaptar los pases a las preferencias de los usuarios, puedes mejorar su descubrimiento, aumentar las tasas de conversión y desbloquear nuevas oportunidades de monetización.

Clasificar pases para la venta

RankProductsAsync toma una lista de IDs de producto y devuelve una lista ordenada y personalizada de esos productos. Puedes usar este método para proporcionar a tus usuarios recomendaciones de artículos personalizadas en tu tienda del juego.

local MarketplaceService = game:GetService("MarketplaceService")

-- Crea el array de productos que deseas clasificar
local productIdentifiers = {
    {InfoType = Enum.InfoType.GamePass, Id = 123},
    {InfoType = Enum.InfoType.Product, Id = 456},
    {InfoType = Enum.InfoType.Product, Id = 789}
}

-- Opcional: ENVOLVER la llamada en una tarea asíncrona para que si la solicitud es lenta,
-- no congele la UI / juego
task.spawn(function()
    -- Usa un pcall para manejar errores de manera elegante
    local success, result = pcall(function()
        return MarketplaceService:RankProductsAsync(productIdentifiers)
    end)

    if not success then
        -- Si falla, 'result' es el mensaje de error.
        warn("No se pudo clasificar los productos:", result)
    end

    -- Carga los artículos devueltos en la tienda.
    for i, rankedItem in ipairs(rankedProducts) do
        local productIdentifier = rankedItem.ProductIdentifier
        local productInfo = rankedItem.ProductInfo
        -- ...
        -- Lógica para agregar productInfo a la tienda
    end
end)

Mostrar tus mejores pases

RecommendTopProductsAsync toma un array de valores InfoType y devuelve hasta 50 artículos con los que es más probable que un usuario interactúe y compre. Puedes usar este método para crear una sección de "Selecciones Principales" en tu tienda del juego.

Si no se pueden determinar recomendaciones, RecommendTopProductsAsync devuelve 0 artículos. Cualquier pase que el usuario ya posea tampoco será devuelto.

En casos raros, las llamadas al modelo de clasificación pueden ser lentas. Para ayudar a prevenir que los usuarios se sientan molestos, recomendamos usar task.spawn para hacer la llamada a RecommendTopProducts no bloqueante.

local MarketplaceService = game:GetService("MarketplaceService")

-- Crea un array de tipos de producto para incluir. En este caso, tanto pases de juego como productos de desarrollador.
local productTypes = {Enum.InfoType.GamePass, Enum.InfoType.Product}

-- Opcional: ENVOLVER la llamada en una tarea asíncrona para que si la solicitud es lenta,
-- no congele la UI / juego
task.spawn(function()
    -- Usa un pcall para manejar errores de manera elegante
    local success, result = pcall(function()
        return MarketplaceService:RecommendTopProductsAsync(productTypes)
    end)

    if not success then
        -- Si falla, 'result' es el mensaje de error.
        warn("No se pudo clasificar los productos:", result)
    end

    -- Carga los artículos devueltos en la tienda. Asegúrate de filtrar cualquier 
    -- artículo no elegible de topRankedItems, como productos de desarrollador que
    -- el usuario ya no puede comprar.
    for i, rankedItem in ipairs(rankedProducts) do
        local productIdentifier = rankedItem.ProductIdentifier
        local productInfo = rankedItem.ProductInfo
        -- ...
        -- Lógica para agregar productInfo a la tienda
    end
end)

Promocionar un pase

Para ayudar a que más usuarios descubran tu juego, puedes optar por incluir tus pases en la página de Compra Robux de Roblox. Optar por promocionar tus pases puede ayudar a aumentar el tiempo y Robux que los usuarios pasan en tu juego. No hay un límite en el número de pases que puedes promocionar.

Los usuarios ven pases que son relevantes para su historial de juego y participación en la plataforma. No se les muestran los pases que ya poseen.

Cuando los usuarios compran un paquete de Robux elegible, reciben el pase promocionado y se les pide que reclamen su pase al unirse a tu juego.

Para optar por promocionar uno de tus pases:

1. Ve a Monetización ⟩ Pases.
2. Selecciona el pase que deseas promocionar.
3. Selecciona Promociones.
4. Activa Incluir este artículo en el grupo de bonificación.
5. Haz clic en Guardar Cambios. El pase se mostrará a usuarios relevantes en la página de Comprar Robux.

El pase promocionado:

• Puede estar fuera de venta o en venta. Si están en venta, su valor en Robux debe ser mayor a 49 Robux y menor a 801 Robux.
• Debe incluir una miniatura.
• No puede otorgar artículos aleatorios pagados.
• Debe cumplir con los Estándares de la Comunidad.

Analítica de pases

Utiliza la analítica de pases para analizar el éxito de pases individuales, identificar tendencias y prever posibles ganancias futuras.

Con la analítica, puedes:

• Ver tus mejores pases durante un período de tiempo seleccionado.
• Mostrar hasta ocho artículos más vendidos en un gráfico de series temporales para analizar las ventas totales y los ingresos netos.
• Monitorear tu catálogo y clasificar artículos por ventas y ingresos netos.
• Ver cuántos pases fueron adquiridos por usuarios a través de la promoción en la página de Comprar Robux.
• Ver cuántos usuarios se unieron a tu juego después de adquirir el pase a través de la página de Comprar Robux.

Para acceder a la analítica de pases:

1. Ve a Creaciones y selecciona un juego.
2. Ve a Monetización ⟩ Pases.
3. Selecciona la pestaña Analítica.