Passer

Les passes vous permettent de facturer aux utilisateurs des frais Robux uniques pour accéder à des privilèges spéciaux dans votre expérience, tels que l'entrée dans une zone restreinte, un itemd'avatar dans l'expérience ou un power-up permanent.

Créer un passe

Pour créer un passe :

1. Allez dans Créations et sélectionnez une expérience.
2. Aller à Monétisation ⟩ Passes .
3. Cliquez sur Créer un passe .
4. Téléchargez une image à afficher comme icône de passe.Assurez-vous que l'image ne dépasse pas 512x512 pixels, n'inclut pas de détails importants en dehors de ses limites circulaires et est dans le format .jpg, .png ou .bmp.
5. Entrez un nom et une description pour le passe.
6. Cliquez sur Créer passe .

Obtenir l'ID du passe

Pour utiliser le scripting, vous avez besoin d'un ID de passe. Pour obtenir l'ID de passe :

1. Aller à Monétisation ⟩ Passes .

2. Passez la souris sur une miniaturede passe, cliquez sur le bouton ⋯ et sélectionnez Copier l'ID de la ressource dans le menu contextuel.

   

Vendre un passe

Vous pouvez vendre des passes de deux manières :

• À l'intérieur de votre expérience
• En dehors de votre expérience

Au sein de votre expérience

Pour implémenter et vendre un passe à l'intérieur d'une expérience, appelez les fonctions MarketplaceService .

Utilisez GetProductInfo() pour récupérer des informations sur un passe, comme le nom et le prix, puis pour afficher ce pas aux utilisateurs.Vous pouvez vendre le passe sur le marché de votre expérience, par exemple.Pour les passes, le deuxième paramètre doit être Enum.InfoType.GamePass .

local MarketplaceService = game:GetService("MarketplaceService")

-- Remplacez l'ID du paramètre par l'ID de votre passe
local productId = 000000

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


if success and productInfo then
	-- Vérifier si le produit est en offre
	if productInfo.IsForSale then
	-- Afficher les informations sur le produit
	-- Remplacer les déclarations d'impression par du code d'interface utilisateur pour afficher le passe
  	print("Pass Name: " .. productInfo.Name)
  	print("Price in Robux: " .. productInfo.PriceInRobux)
  	print("Description: " .. productInfo.Description)
	else
		print("This product isn't for sale")
	end
end

Utilisez PromptPurchase() pour demander l'achat d'un passe si l'utilisateur ne possède pas déjà le passe dans son inventaire.Vous pouvez appeler cette fonction lorsqu'un utilisateur effectue des actions comme appuyer sur un bouton ou parler à un PNJ marchand.

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

-- Remplacez l'ID du paramètre par l'ID de votre passe
local passID = 0000000

-- Achat de passe acheter
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 while checking if player has pass: " .. tostring(message))
		return
	end

	if hasPass then
		-- Afficher un message indiquant à l'utilisateur qu'il possède déjà le passe
	else
		-- Achat de passe acheter
		MarketplaceService:PromptGamePassPurchase(player, passID)
	end
end

Utilisez PromptGamePassPurchaseFinished() pour gérer une demande de passe terminée et acheter et attribuer aux utilisateurs les privilèges associés au passe.

Placez le script à l'intérieur du ServerScriptService afin que le serveur gère les privilèges de passe de l'utilisateur.

local MarketplaceService = game:GetService("MarketplaceService")

-- Remplacez l'ID du paramètre par l'ID de votre passe
local passID = 0000000  -- Changez-le en votre ID de passe

-- Gérer une demande terminée et un acheter
local function onPromptPurchaseFinished(player, purchasedPassID, purchaseSuccess)
	if purchaseSuccess and purchasedPassID == passID then
		print(player.Name .. " purchased the Pass with ID " .. passID)
		-- Attribuez à l'utilisateur la capacité ou la prime liée au passe
	end
end

-- Relier les événements PromptGamePassPurchaseFinished à la fonction
MarketplaceService.PromptGamePassPurchaseFinished:Connect(onPromptPurchaseFinished)

En dehors de votre expérience

Pour vendre un passe sur l'onglet magasin des détails de l'expérience :

1. Aller à Monétisation > Passes .
2. Passez la souris sur le passe et cliquez sur le menu ⋯ .
3. Sélectionnez le passe que vous souhaitez vendre.
4. Sélectionnez Ventes .
5. Activer le bouton Objet à vendre activer/désactiver.
6. Dans le champ prix en Robux , entrez le montant de Robux que vous souhaitez facturer aux utilisateurs pour le passe.Le prix que vous entrez affecte le montant de Robux que vous gagnez par offre.Le prix que vous entrez affecte le montant de Robux que vous gagnez par offre.Le prix minimum est de 1 Robux, et le prix maximum est de 1 milliard de Robux.
7. Cliquez sur Enregistrer les modifications . Le passe se remplit dans l'onglet magasin des détails de l'expérience.

Attribuer des privilèges de passe

Vous devez attribuer manuellement des privilèges de passe aux utilisateurs qui achètent vos passes.Pour ce faire, utilisez PlayerAdded lorsqu'un utilisateur rejoint votre expérience pour vérifier s'il possède déjà le passe et lui attribuer les privilèges du passe.

Placez le script à l'intérieur du ServerScriptService afin que le serveur gère les privilèges de passe de l'utilisateur.

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

-- Remplacez l'ID du paramètre par l'ID de votre passe
local passID = 0000000

local function onPlayerAdded(player)
	local hasPass = false

	-- Vérifier si l'utilisateur possède déjà le passe
	local success, message = pcall(function()
		hasPass = MarketplaceService:UserOwnsGamePassAsync(player.UserId, passID)
	end)

	if not success then
		-- Émettre un avertissement et quitter la fonction
		warn("Error while checking if player has pass: " .. tostring(message))
		return
	end

	if hasPass then
		-- Attribuer à l'utilisateur la capacité ou la prime liée au passe
		print(player.Name .. " owns the Pass with ID " .. passID)
	end
end

-- Relier les événements ajoutés au joueur à la fonction
Players.PlayerAdded:Connect(onPlayerAdded)

Analyse des passes

Utilisez l'analyse des passes pour analyser le succès des passes individuels, identifier les tendances et prévoir les gains futurs potentiels.

Avec l'analyse, vous pouvez :

• Affichez vos passes principaux sur une période sélectionnée.
• Affichez jusqu'à huit articles les plus vendus sur un graphique de série temporelle pour analyser les ventes globales et le revenu net.
• Surveillez votre catalogue et triez les articles par ventes et revenus nets.

Pour accéder à l'analyse des passes :

1. Allez dans Créations et sélectionnez une expérience.
2. Aller à Monétisation > Passes .
3. Sélectionnez l'onglet Analytics .