Começando

Em uns 15 minutos você instala o plugin e o SDK, liga a chave, aperta Play e vê os eventos chegando no dashboard.

O que você precisa

• Um jogo publicado no Roblox (lugar não publicado tem Universe ID 0 e o servidor recusa).
• O jogo cadastrado no dashboard RoMetrics e uma chave de ingestão (rmk_live_...) gerada para ele.
• Allow HTTP Requests ligado: File → Experience Settings → Security.

1. Instale o plugin (opcional, recomendado)

Baixe RoMetricsPlugin.rbxm e copie para a pasta de plugins (no Studio: Plugins → Plugins Folder). Reabra o Studio: aparece o botão RoMetrics na aba Plugins. Detalhes.

2. Insira o SDK

Baixe RoMetrics.rbxm. No Explorer: ReplicatedStorage → botão direito → Insert from File…. Deve aparecer o ModuleScript ReplicatedStorage.RoMetrics. Outras formas de instalar.

3. Guarde a chave no Secrets Store

Creator Hub → sua experiência → Secrets → Create Secret: nome rometrics_key, valor = sua chave, domínio = host do ingest. Detalhes e como testar no Studio.

4. Inicie o SDK no servidor

Crie um Script em ServerScriptService chamado RoMetricsSetup:

--!strict
local HttpService = game:GetService("HttpService")
local MarketplaceService = game:GetService("MarketplaceService")
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local RoMetrics = require(ReplicatedStorage:WaitForChild("RoMetrics")) :: any

RoMetrics.init({
	key = HttpService:GetSecret("rometrics_key"),
})

-- Developer products: embrulhe o seu ProcessReceipt para contar as vendas.
MarketplaceService.ProcessReceipt = RoMetrics.wrapProcessReceipt(function(receiptInfo)
	local player = Players:GetPlayerByUserId(receiptInfo.PlayerId)
	if not player then
		return Enum.ProductPurchaseDecision.NotProcessedYet
	end
	-- entregue o item aqui (DataStore etc.)
	return Enum.ProductPurchaseDecision.PurchaseGranted
end)

Players.PlayerAdded:Connect(function(player)
	RoMetrics:LogOnboardingFunnelStepEvent(player, 1, "Entrou")
end)

Game passes, entradas/saídas de jogadores, servidores e plataforma são rastreados sozinhos depois do init.

5. Publique e jogue

Publique o jogo e entre num servidor ao vivo. Em segundos o dashboard mostra o jogador online (Ao vivo) e os eventos (Eventos).

Quer ver chegando já no Studio?

O SDK não envia nada durante o Play no Studio por padrão. Veja Testando no Studio.

Próximos passos

• Eventos: custom, economia, funis e progressão.
• Eventos sem código: marque Parts e prompts pelo plugin.
• Referência completa.
• Usa IA para programar? Envie o arquivo de referência para IA.